跳到主要内容

我的板卡:微雪 ESP32-S3-Touch-LCD-1.28

本教程的主力板卡是你已有的 Waveshare ESP32-S3-Touch-LCD-1.28(带 Touch 的型号)。Zephyr v4.2.0 已包含该板专用配置,无需先自行移植。

固定编译目标

esp32s3_touch_lcd_1_28/esp32s3/procpu

板卡名称为 esp32s3_touch_lcd_1_28,SoC 为 esp32s3,主核为 procpu。不要再使用旧教程的经典 ESP32 目标,也不要混用外观相似的无 Touch 型号。

已核对的硬件连接

功能本板配置
主控 / 存储ESP32-S3,16 MB Flash,2 MB PSRAM
USB 接口Type-C,通过 CH343P 转 UART0
默认串口GPIO43 TX / GPIO44 RX,115200 波特率
屏幕GC9A01A,240×240,SPI
背光GPIO2;Zephyr 别名 pwm-lcd0,LEDC 通道 0
触摸CST816S;I²C SDA GPIO6 / SCL GPIO7,INT GPIO5,RST GPIO13
BOOTGPIO0;与 RESET 配合进入下载模式

这些连接以微雪硬件资料及 v4.2.0 的板卡 DTS / pinctrl 为依据。板上有传感器不代表每项功能已在本教程验证。

为什么改成背光实验

v4.2.0 这块板的 DTS 没有普通 GPIO LED 的 led0 别名,但有 pwm-lcd0。因此先跑 Hello World,再控制屏幕背光;不要直接构建普通 samples/basic/blinky,也不需要为了点灯先接外部 LED。

背光是照明,屏幕图像需要另一套显示初始化。Hello World 没有显示逻辑,屏幕没有新画面是正常的,应以串口输出判断。

本机状态

2026-09-18:已用 Python 3.12.14、SDK 0.17.2 和 Zephyr v4.2.0 为该目标成功生成 Hello World 固件。尚未烧录或观察你的实板。

下一步:Hello World:重新进入、编译与板卡验证

来源