探索LilyGO T-Display S3：从入门到实践的嵌入式开发之旅

2026-04-21 11:46:36作者：范靓好Udolf

LilyGO T-Display S3是一款基于ESP32-S3芯片的高性能开发板，集成1.9英寸LCD显示屏与丰富外设接口，为嵌入式显示终端开发提供完整解决方案。本文将系统介绍ESP32-S3开发板的硬件特性、环境部署流程、实战项目开发及进阶功能实现，帮助开发者快速掌握从原型到产品的全流程开发技能。

核心特性解析：ESP32-S3开发板技术规格

LilyGO T-Display S3以ESP32-S3R8芯片为核心，融合低功耗与高性能特性，特别适合便携式智能设备开发。以下是其关键技术参数：

硬件模块	规格参数	功能说明
处理器	ESP32-S3双核240MHz	支持Wi-Fi 802.11b/g/n和蓝牙5.0，具备强大计算能力
存储配置	16MB Flash + 8MB PSRAM	提供充足空间存储程序与缓存数据
显示系统	1.9英寸ST7789驱动LCD	170×320分辨率，支持24位真彩色显示
GPIO接口	34个可编程I/O引脚	通用输入输出引脚，用于连接外部设备与传感器
电源管理	5V USB-C输入/锂电池接口	支持多种供电方式，适合移动场景应用
特殊功能	触摸输入/背光调节	集成电容触摸检测与LCD亮度控制功能

图1：ESP32-S3开发板引脚分布图，显示各接口位置与功能定义

环境部署指南：从配置到验证的开发环境搭建

开发工具链准备

目标：配置支持ESP32-S3的Arduino开发环境
操作：

安装Arduino IDE 1.8.10以上版本
添加ESP32开发板支持：文件 > 首选项 > 附加开发板管理器网址中输入https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
通过开发板管理器安装esp32平台（版本2.0.0+）
安装必要库文件：TFT_eSPI（LCD驱动）和lvgl（图形界面）

验证：打开Arduino IDE，在工具 > 开发板中选择ESP32S3 Dev Module

常见问题：若开发板列表中未显示ESP32S3选项，需检查网络连接并重试开发板索引更新

开发板参数配置

目标：设置与硬件匹配的编译参数
操作：

按下图配置开发板参数：
- Flash Size: 16MB(128Mb)
- Partition Scheme: 16M Flash(3M APP/9.9MB FATFS)
- USB CDC On Boot: Enabled（用于串口调试）
- PSRAM: OPI PSRAM

图2：ESP32-S3开发板在Arduino IDE中的配置参数表

验证：连接开发板后，在工具 > 端口中选择正确的COM端口，上传示例程序验证配置

注意事项：USB CDC On Boot设为Enabled可实现在线调试，这是获取程序运行日志的关键配置

实战案例开发：环境监测终端设计

项目概述

本案例将开发一个基于ESP32-S3开发板的环境监测终端，实时显示温度、湿度数据并通过LCD屏可视化展示。项目文件路径：HotHead/HotHead.ino

硬件连接

目标：连接DHT11温湿度传感器
操作：

VCC → 3V3
GND → GND
DATA → GPIO14

核心代码实现

#include <TFT_eSPI.h>
#include <DHT.h>

// 硬件引脚定义
#define DHT_PIN 14                  // DHT11数据引脚
#define PIN_LCD_BL 38               // 背光控制引脚
#define PIN_POWER_ON 15             // LCD电源控制引脚

TFT_eSPI tft = TFT_eSPI();          // 初始化LCD对象
DHT dht(DHT_PIN, DHT11);            // 初始化DHT11传感器

void setup() {
  pinMode(PIN_POWER_ON, OUTPUT);
  digitalWrite(PIN_POWER_ON, HIGH); // 开启LCD电源
  pinMode(PIN_LCD_BL, OUTPUT);
  analogWrite(PIN_LCD_BL, 128);     // 设置背光亮度50%
  
  tft.init();                       // 初始化LCD屏幕
  tft.setRotation(1);               // 设置屏幕方向
  dht.begin();                      // 初始化传感器
}

void loop() {
  // 读取环境数据
  float humidity = dht.readHumidity();
  float temperature = dht.readTemperature();
  
  // 清屏并显示标题
  tft.fillScreen(TFT_BLACK);
  tft.setTextColor(TFT_WHITE);
  tft.drawCentreString("环境监测终端", tft.width()/2, 10, 4);
  
  // 显示温湿度数据
  tft.setTextSize(2);
  tft.drawString("温度: " + String(temperature) + " C", 20, 60);
  tft.drawString("湿度: " + String(humidity) + " %", 20, 100);
  
  delay(2000); // 每2秒更新一次数据
}

验证：上传代码后，LCD屏幕应显示实时温湿度数据，数值每2秒刷新一次

常见问题：若屏幕无显示，检查PIN_POWER_ON和PIN_LCD_BL引脚定义是否正确，确保LCD电源已开启

进阶功能拓展：LCD背光智能调节

硬件原理

LilyGO T-Display S3的LCD背光通过PWM（脉冲宽度调制）控制，原理图如下：

图3：ESP32-S3开发板LCD背光控制电路原理图

实现自动亮度调节

目标：根据环境光强度自动调节屏幕亮度
操作：

连接光敏电阻至ADC引脚（GPIO35）
添加亮度调节代码：

// 新增代码片段
#define LIGHT_SENSOR_PIN 35  // 光敏电阻连接引脚

int getBrightnessLevel() {
  int lightValue = analogRead(LIGHT_SENSOR_PIN);
  // 将光照值(0-4095)映射为PWM值(0-255)
  return map(lightValue, 0, 4095, 50, 255); 
}

// 在loop()函数中添加
analogWrite(PIN_LCD_BL, getBrightnessLevel());