ESP32-S3驱动1.69寸触摸屏：从SPI优化到LVGL移植的嵌入式GUI实战

1. 项目概述：一块能“摸”的智能屏幕

最近在捣鼓一个智能家居中控的Demo，核心需求是找一块尺寸适中、带触摸、性能足够跑点简单UI、并且开发起来别太折腾的屏幕。市面上各种开发板琳琅满目，但要么是性能过剩价格感人，要么是接口复杂布线头疼。直到我把目光锁定在“ESP32-S3-Touch-LCD-1.69”这个组合上，感觉一下子对味了。这名字拆开看，就是“ESP32-S3主控” + “1.69英寸触摸LCD屏”的黄金搭档，它瞄准的正是嵌入式GUI、物联网人机交互（HMI）这些需要“小身材、大智慧”的应用场景。

简单来说，这不是一个具体的成品模块型号（像某品牌的特定开发板），而是一个极具代表性的技术方案组合。ESP32-S3是乐鑫推出的双核Xtensa LX7 MCU，主打AI加速和USB OTG，性能比经典的ESP32强不少；而1.69英寸的LCD通常指分辨率在240x280或240x320左右的IPS屏，搭配电容或电阻触摸层。把它们结合起来，你得到的就是一个能运行LVGL、LittlevGL等轻量级图形库，实现滑动、点击等交互，并且能通过Wi-Fi/蓝牙连上网的智能终端原型。无论是做智能手表、温控器面板、小型手持设备，还是工控设备的简易界面，这个组合都提供了一个非常平衡的起点：性能够用、成本可控、生态成熟。

我这次的目标，就是抛开现成的集成底板，从更底层的角度，把手头的ESP32-S3开发板和一块1.69寸SPI接口的LCD触摸屏“攒”起来，打通从驱动到UI的完整链路。过程中会遇到一堆典型问题：SPI速率上不去导致刷屏卡顿、触摸坐标漂移、DMA传输和图形刷新冲突、以及如何让ESP32-S3在驱动屏幕的同时还能稳健地跑网络服务。如果你也在为类似的项目选型或调试头疼，那这篇从零开始的踩坑和填坑记录，或许能给你省下不少时间。

2. 核心组件选型与硬件连接解析

为什么是ESP32-S3搭配1.69寸屏？这个选择背后有一连串的工程权衡。首先看主控，ESP32-S3相对于ESP32，除了CPU主频提升（240MHz），更重要的是增加了USB OTG和更强大的AI指令集，这对于未来想要增加语音唤醒或本地图像识别功能留出了余地。其丰富的GPIO和灵活的SPI、I2C控制器，驱动一块SPI屏绰绰有余。而1.69英寸这个尺寸，在分辨率和功耗之间取得了很好的平衡。常见的240x280分辨率，其像素总数（67，200）远低于480x320的屏（153，600），这意味着帧缓冲区（Frame Buffer）所需内存更小，刷屏所需的计算量和时间也更少，对于MCU来说压力骤减。

2.1 屏幕与触摸芯片的“摸底”

我手头这块屏的驱动芯片是ST7789V，这是一款非常流行的3线/4线SPI接口控制器，最高支持262K色。触摸芯片则是GT911，一款电容式触摸控制器，通过I2C接口通信。在你拿到任何一块屏幕时，第一件事就是找到它的数据手册（Datasheet）和初始化序列（Init Code）。ST7789V的初始化通常需要发送一长串命令和参数，用来设置扫描方向、颜色格式、电源模式等。这些代码往往由屏厂提供，但直接套用可能会因为PCB布线、电源噪声导致显示异常，所以理解每一条命令的含义至关重要。

例如，设置内存数据访问控制（MADCTL，Command 0x36）的这个字节，就决定了屏幕的旋转方向、RGB顺序和刷新顺序。我遇到的第一个坑就是屏幕颜色反了（红色和蓝色互换），就是因为这个寄存器的RGB位设置不对。通过查阅ST7789V的数据手册，我确认了正确的值应该是0x70（MY=1， MX=0， MV=1， ML=0， RGB=1），这代表垂直刷新、BGR顺序。如果你不做这一步，后续所有UI的颜色都是错的。

硬件连接是实打实的“体力活”，但接错了轻则不工作，重则烧芯片。我的连接方案如下：

这里有几个关键点：

1. 电源：绝大多数1.69寸屏和触摸芯片都是3.3V电平，ESP32-S3的GPIO也是3.3V，因此直接连接即可。千万不要接到5V引脚上，否则芯片大概率瞬间损坏。
2. SPI引脚选择：ESP32-S3有多个SPI控制器（SPI2， SPI3）。我选择了VSPI（SPI3）的默认引脚，但也可以使用spi_bus_initialize函数指定其他任意GPIO，非常灵活。关键是MOSI、CLK、CS必须配对使用。
3. 背光控制：背光（BLK）通常需要串联一个限流电阻。我直接接到了GPIO上，并通过PWM来控制亮度。初期调试可以先接3.3V让其常亮，确保屏幕本身是好的。
4. 触摸I2C：GT911的I2C地址通常是0x5D或0x14（取决于ADDR引脚的接法）。需要上拉电阻（通常4.7KΩ）到3.3V。如果读不到设备，首先用逻辑分析仪或示波器抓一下I2C波形，或者写个简单的扫描程序检查地址。

2.2 初始化代码的“魔鬼细节”

硬件连好后，软件的第一道坎就是初始化。这里不能简单地复制粘贴代码。以ST7789V为例，其初始化序列里有一个睡眠退出（SLPOUT， 0x11）命令，发送后必须等待至少120ms，再发送显示开启（DISPON， 0x29）命令。如果不等，屏幕可能无法正常唤醒。我在代码里是这样处理的：

// 发送睡眠退出命令 spi_write_cmd(0x11); // 关键：必须延时 vTaskDelay(pdMS_TO_TICKS(120)); // 发送显示开启命令 spi_write_cmd(0x29);

另一个细节是颜色格式。ST7789V支持12-bit， 16-bit， 18-bit多种格式。我们常用的是16位RGB565（R-5位， G-6位， B-5位）。这需要在初始化时通过COLMOD命令（0x3A）设置为0x55。同时，ESP32-S3的SPI发送数据时，也要确保每个像素点是两个字节（uint16_t）。

3. 驱动层构建：SPI优化与DMA实战

驱动屏幕，本质就是通过SPI总线不停地向屏幕的GRAM（图形内存）里填数据。最原始的方式是CPU通过spi_transmit一个像素一个像素地送，这效率极低，刷一屏会卡顿好几秒。我们的优化之路就此开始。

3.1 提升SPI时钟频率

ESP32-S3的SPI时钟最高可达80MHz，但实际能跑多快，取决于屏幕驱动芯片的能力和PCB走线质量。ST7789V的SPI接口最高时钟约62.5MHz。我们可以逐步尝试提高频率。在ESP-IDF中，初始化SPI总线时配置时钟：

spi_bus_config_t buscfg = { .mosi_io_num = GPIO_NUM_11, .miso_io_num = GPIO_NUM_12, .sclk_io_num = GPIO_NUM_13, .quadwp_io_num = -1, .quadhd_io_num = -1, .max_transfer_sz = 240 * 280 * 2, // 一屏数据大小 }; // 主机初始化 spi_bus_initialize(SPI3_HOST， &buscfg， SPI_DMA_CH_AUTO);

然后为SPI设备配置时钟分频：

spi_device_interface_config_t devcfg = { .clock_speed_hz = 40 * 1000 * 1000， // 先尝试40MHz .mode = 0， // SPI mode 0 .spics_io_num = GPIO_NUM_10， .queue_size = 7， .flags = SPI_DEVICE_HALFDUPLEX， };

如果屏幕显示出现雪花、错位或局部乱码，说明时钟太快，需要降低。我最终稳定在60MHz。注意：提高时钟也会增加功耗和EMI，在电池供电项目中需权衡。

3.2 引入DMA实现“后台”刷屏

直接CPU搬运数据（Polling Mode）会完全霸占CPU，导致其他任务（如网络、逻辑处理）无法执行。直接内存访问（DMA）是解决之道。它允许外设（如SPI）直接从内存读取数据并发送，无需CPU介入。ESP-IDF的SPI驱动已经集成了DMA支持，上述代码中的SPI_DMA_CH_AUTO就是自动分配DMA通道。

使用DMA的关键在于组织好发送数据。对于全屏刷新，我们通常会分配一个大小为width * height * 2字节的帧缓冲区（frame buffer）。LVGL等库会直接在这个缓冲区里作图。刷新时，我们只需将这个缓冲区的地址和长度交给SPI DMA事务。

// 定义帧缓冲区 static uint16_t frame_buffer[240][280]; // 配置一个SPI传输事务 spi_transaction_t t = { .length = 240 * 280 * 16， // 总数据位数 = 像素数 * 16位/像素 .tx_buffer = frame_buffer， }; // 将事务放入队列，DMA会在后台自动处理 spi_device_queue_trans(spi， &t， portMAX_DELAY);

这样，CPU在调用queue_trans后就可以立即返回去处理其他任务，而DMA和SPI控制器会协作完成整个屏幕数据的发送。这是实现流畅UI的基础。

3.3 处理SPI传输中的“撕裂”效应

当你使用双缓冲区（一个用于LVGL绘制，一个用于DMA发送）或局部刷新时，可能会遇到“撕裂”效应：即DMA正在发送旧缓冲区上半部分数据时，CPU已经更新了下半部分的新数据，导致屏幕上下两部分显示不同帧的内容。

解决方法是使用同步机制。一个简单有效的策略是使用事务回调（spi_transaction_ext_t中的post_cb）。在LVGL的刷新回调函数disp_flush中，我们不是直接启动DMA，而是将事务提交到SPI队列，并设置一个回调函数。当这个DMA传输完全完成时，回调函数会被触发，在这个回调里我们再通知LVGL“刷新完成”，并安全地交换或重用缓冲区。

static void spi_post_callback(spi_transaction_t *trans) { // DMA传输完成，通知LVGL可以继续使用这块缓冲区 lv_disp_flush_ready(disp_drv); } void disp_flush(lv_disp_drv_t * disp_drv， const lv_area_t * area， lv_color_t * color_p) { // ... 配置传输区域和数据 ... spi_transaction_ext_t t = {0}; t.base = (spi_transaction_t){ ... }; // 配置基础事务 t.base.flags = SPI_TRANS_USE_TXDATA; // 或其他标志 t.post_cb = spi_post_callback; // 设置完成回调 spi_device_queue_trans(spi， (spi_transaction_t*)&t， portMAX_DELAY); // 此处立即返回，不等待传输完成 }

这种方式确保了图形库只在缓冲区安全时进行绘制，完美避免了撕裂。

4. 触摸驱动集成与坐标校准

有了显示，下一步是让屏幕能“摸”。电容触摸芯片GT911通过I2C上报触摸点的坐标、面积和压力信息。集成它，远不止读几个寄存器那么简单。

4.1 I2C通信与中断处理

GT911通常使用中断（INT）引脚来通知主控有触摸事件发生。我们将ESP32-S3的一个GPIO（例如GPIO4）配置为下降沿中断。当手指触摸，GT911拉低INT引脚，触发ESP32-S3的中断服务程序（ISR）。在ISR内部，绝对不能进行复杂的I2C读取操作，应该只设置一个标志位，通知一个高优先级的任务（如touch_task）去处理。

touch_task的任务是：

1. 读取GT911的状态寄存器（0x814E）。
2. 检查是否有有效触摸点（最高支持5点）。
3. 读取触摸点数据寄存器（0x8150开始），解析出X， Y坐标。
4. 将坐标信息通过队列发送给LVGL的输入设备接口。
5. 向GT911写入0x00清除状态寄存器，准备下一次上报。

这里有个坑：GT911的坐标原始值是基于屏幕本身的，可能与LCD的扫描方向不一致。比如，你的LCD是竖屏模式（240x280），但GT911上报的X坐标范围可能是0~280， Y是0~240，正好是横屏的。这就需要我们在驱动层进行坐标交换。

4.2 精准的触摸校准

即使坐标轴对应了，你也会发现触摸点不准，点击的位置和实际响应的位置有偏移。这是由屏幕和触摸面板的物理装配公差、以及两者坐标系原点不一致导致的。我们必须进行校准。

校准的原理是：在屏幕上显示几个已知坐标的点（比如四个角），让用户依次点击，然后收集触摸芯片上报的原始坐标。通过这两组坐标（理论坐标和实际报告坐标），计算出一个转换矩阵（通常包含缩放、平移和旋转）。LVGL内置了校准接口，但我们需要自己实现校准过程。

一个简单的两点校准算法（假设只有平移和缩放，无旋转）：

1. 在屏幕左上角(10，10)显示一个点，用户点击，记录触摸值(Tx1， Ty1)。
2. 在屏幕右下角(230，270)显示一个点，用户点击，记录触摸值(Tx2， Ty2)。
3. 计算缩放系数和偏移量：scale_x = (230.0 - 10.0) / (Tx2 - Tx1);offset_x = 10.0 - Tx1 * scale_x;scale_y = (270.0 - 10.0) / (Ty2 - Ty1);offset_y = 10.0 - Ty1 * scale_y;
4. 后续所有触摸原始坐标(raw_x， raw_y)都经过公式转换：calibrated_x = raw_x * scale_x + offset_x;calibrated_y = raw_y * scale_y + offset_y;

更精确的可以用三点或四点校准，解算仿射变换矩阵。校准参数需要保存到非易失性存储（NVS）中，设备重启后直接加载。

4.3 滤波与防抖

触摸信号会有噪声，导致坐标轻微跳动。简单的软件滤波可以提升体验。我常用的方法是“移动平均滤波”：维护一个小的坐标历史缓冲区（比如最近5个点），上报的坐标取这些点的平均值。同时，可以设置一个最小移动阈值（如2个像素），只有当坐标变化超过此阈值时才认为是有效移动，否则视为抖动忽略。

#define FILTER_SIZE 5 static lv_coord_t x_buf[FILTER_SIZE]， y_buf[FILTER_SIZE]; static uint8_t buf_index = 0; // 在获取到原始坐标 raw_x， raw_y 后 x_buf[buf_index] = raw_x; y_buf[buf_index] = raw_y; buf_index = (buf_index + 1) % FILTER_SIZE; lv_coord_t filtered_x = 0， filtered_y = 0; for(int i=0; i<FILTER_SIZE; i++) { filtered_x += x_buf[i]; filtered_y += y_buf[i]; } filtered_x /= FILTER_SIZE; filtered_y /= FILTER_SIZE; // 再将 filtered_x， filtered_y 经过校准后上报给LVGL

这个小技巧能有效让滑动操作更跟手，点击更稳定。

5. 图形库（LVGL）移植与性能调优

驱动和触摸都通了，现在需要让它们协同工作，构建出漂亮的界面。LVGL是一个用C编写的开源嵌入式图形库，资源消耗小，功能强大，是ESP32-S3这类MCU的绝配。

5.1 LVGL移植的核心步骤

移植LVGL主要做三件事：

1. 初始化显示驱动接口：实现disp_flush函数。这个函数是LVGL通知底层“我需要刷新这一块区域”的接口。我们在这个函数里，根据传入的area区域和color_p颜色数据，组织SPI事务（支持局部刷新能极大提升效率）。
2. 初始化输入设备接口：实现touch_read函数。这个函数在LVGL的任务中被周期调用，我们需要从触摸任务设置的队列或全局变量中，读取最新的、经过校准和滤波的触摸坐标与状态（按下/移动/释放），并填充到lv_indev_data_t结构体中。
3. 配置LVGL心跳：LVGL需要系统提供一个毫秒级的时钟源，用于动画、定时器等。在ESP32上，最简单的方法是创建一个高优先级任务，里面调用lv_tick_inc(1)并vTaskDelay(1)，或者使用FreeRTOS的定时器。

移植成功后，你就能用LVGL的API创建按钮、标签、滑块等控件了。但默认配置可能很卡，需要调优。

5.2 关键性能优化参数

LVGL的配置文件lv_conf.h里有大量开关和参数，针对ESP32-S3和1.69寸屏，我调整了以下几个关键点：

• LV_MEM_SIZE： 设置LVGL的动态内存池大小。对于240x280的16位色深，全屏帧缓冲需要240*280*2 ≈ 131KB。再加上控件本身的内存，我设置为(200 * 1024UL)（200KB）。务必在idf.py menuconfig中也调整ESP32-S3的可用堆内存。
• LV_COLOR_DEPTH： 设为16，与屏幕物理色深匹配。
• LV_DISP_DEF_REFR_PERIOD： 默认30ms。可以改为10-20ms，让LVGL更积极地尝试刷新。
• LV_INDEV_DEF_READ_PERIOD： 触摸读取周期，设为10ms，保证触摸响应速度。
• 启用双缓冲区： 在显示驱动配置中启用LV_DISP_DOUBLE_BUF。这需要分配两个帧缓冲区。LVGL在一个缓冲区里绘制下一帧时，DMA正在发送另一个缓冲区里的当前帧内容，能有效提升帧率，也是避免撕裂的另一种方案。
• 谨慎使用特效： 阴影、模糊等效果非常消耗CPU。在资源紧张的项目中建议关闭LV_USE_SHADOW和LV_USE_BLUR。
• 使用LVGL的局部刷新： 确保在disp_flush函数中，我们只发送area参数指定的区域数据，而不是全屏。这能大幅减少SPI数据传输量。

5.3 内存管理与字体处理

嵌入式开发，内存永远是瓶颈。除了调整堆大小，还要注意：

• 使用静态内存分配： 对于界面中的主要控件（如背景、主要按钮），使用lv_obj_create创建后，尽量不要频繁删除和新建。可以复用或隐藏。
• 字体选择： 中文字体文件巨大。只嵌入UI中用到的字符（LVGL支持字体子集工具）。对于英文和数字，使用内置的LV_FONT_MONTSERRAT_14等字体即可。
• 图片处理： 将图片转换为C数组或二进制文件，并使用LVGL的“外部存储”功能，通过SPI Flash或SD卡读取，而不是全部编译进固件。对于小图标，可以转换为PNG（LVGL内置解码）或更高效的二进制格式。

经过这些优化，在我的ESP32-S3上，一个包含多个按钮和滑动条的界面，刷新率可以稳定在30-40 FPS，触摸响应延迟低于50ms，体验已经非常流畅。

6. 多任务架构与功耗平衡

一个完整的设备，UI只是前台，后台可能还需要连接Wi-Fi获取数据、通过蓝牙发送状态、处理传感器数据等。如何让这些任务和谐共处，不卡顿不掉线，是架构设计的重点。

6.1 基于FreeRTOS的任务划分

我建议将系统划分为几个独立的任务，并为它们分配合适的优先级和堆栈大小：

1. LVGL任务： 优先级设为configMAX_PRIORITIES - 2（次高）。它负责调用lv_timer_handler()和lv_task_handler()，处理所有UI渲染和事件响应。堆栈建议8KB以上。
2. 触摸采集任务： 优先级设为configMAX_PRIORITIES - 3，略低于LVGL任务。它等待中断信号，读取I2C数据，进行滤波校准，然后通过队列或全局变量将数据传递给LVGL的输入接口。
3. 网络任务（如Wi-Fi/MQTT）： 优先级设为中等（如tskIDLE_PRIORITY + 3）。它负责网络连接和数据收发。关键点：网络操作（如esp_wifi_connect，mqtt_client_publish）是阻塞式的，必须放在独立任务中，避免阻塞UI。
4. 应用逻辑任务： 优先级同网络任务或更低。处理业务逻辑，例如根据传感器数据更新UI上的数值。它通过LVGL的线程安全API（如lv_async_call）或队列向LVGL任务发送更新请求。

6.2 避免SPI/DMA与Wi-Fi/蓝牙的冲突

ESP32-S3的SPI和Wi-Fi/蓝牙共用某些硬件资源（如总线、缓存）。当SPI DMA正在高速刷屏时，如果Wi-Fi也需要大量吞吐（如下载固件），可能会引发总线冲突，导致Wi-Fi断流或屏幕花屏。

解决方案一：任务调度优化。提高LVGL/刷屏任务的优先级，确保刷屏事务能快速被提交到SPI队列。一旦事务进入DMA，CPU就释放了。网络任务作为低优先级任务，其数据传输会被短暂推迟，但不会被永久阻塞。对于大多数物联网设备（低频数据上报）来说，这种短暂的延迟是可以接受的。

解决方案二：速率限制与互斥。在disp_flush函数中，如果检测到当前正在大量刷屏（如播放动画），可以动态降低SPI时钟频率，或者主动让出CPU（taskYIELD()），给网络任务执行的机会。更严格的做法是使用互斥锁（mutex），在发起大规模SPI传输前锁住，传输完成后释放，确保关键网络通信不被中断。

解决方案三：硬件SPI总线分离。如果条件允许，可以使用ESP32-S3的另一组SPI总线（如HSPI）来驱动屏幕，与Wi-Fi使用的总线物理隔离，从根本上避免冲突。

6.3 低功耗设计考量

如果你的设备是电池供电，功耗就必须考虑。ESP32-S3的蓝牙模块在频繁唤醒时功耗不容忽视。

• 蓝牙功耗控制： 根据网络热词中提到的“如何避免ESP32-S3中蓝牙的休眠与唤醒”，关键在于合理配置蓝牙模式。如果仅作为从机（Slave）广播，可以增大广播间隔。如果不需要蓝牙，可以在idf.py menuconfig中完全禁用蓝牙以节省功耗。对于需要保持连接的应用，应使用ESP32-S3的Light-sleep或Deep-sleep模式，并让蓝牙控制器在睡眠期间由RTC定时器唤醒。在代码中，调用esp_bluedroid_disable()和esp_bt_controller_disable()可以关闭蓝牙栈，但重新启用需要时间。
• 屏幕背光控制： 背光是耗电大户。在无操作一段时间后，可以通过PWM将背光亮度调暗甚至关闭。触摸芯片GT911也支持低功耗模式，可以在初始化时配置。
• CPU频率动态调整： ESP-IDF支持动态调频。在UI空闲时，可以将CPU频率从240MHz降至80MHz。LVGL任务周期运行时，再临时提升频率。使用esp_pm_configure函数可以配置电源管理策略。

一个实用的策略是：设备大部分时间处于Light-sleep，屏幕和背光关闭。触摸芯片配置为中断唤醒模式。当用户触摸屏幕时，触摸中断唤醒ESP32-S3，主控迅速点亮背光、恢复全速运行、刷新UI。在用户停止操作一段时间后，再依次关闭背光、进入Light-sleep。这样能极大延长待机时间。

7. 实战问题排查与稳定性加固

项目联调阶段，总会冒出一些稀奇古怪的问题。这里记录几个我遇到的典型问题及其排查思路。

7.1 显示花屏、错位或颜色异常

这是最常见的问题。排查链如下：

1. 检查电源： 用万用表测量屏幕VCC引脚的实际电压。在ESP32-S3启动或Wi-Fi发射时，电源网络可能有压降，导致屏幕供电不足（低于3.0V）。解决方法是在屏幕VCC和GND之间并联一个100-470uF的电解电容。
2. 检查SPI时序： 确认SPI模式（CPOL， CPHA）与屏幕驱动芯片要求一致。ST7789V通常是Mode 0。用逻辑分析仪抓取SPI的CLK， MOSI， CS， DC信号，对照数据手册的时序图检查建立时间、保持时间是否满足。
3. 检查初始化序列： 逐条核对初始化命令，特别是睡眠退出、显示开启、颜色模式、内存访问控制这几条。延时是否足够？命令参数是否正确？可以尝试注释掉部分非关键初始化命令，看是否改善。
4. 检查帧缓冲区数据： 在发送前，将帧缓冲区的头几个像素数据通过串口打印出来，看看是不是你预期的颜色值。或者，写一个简单的测试函数，将整个缓冲区填充为单一颜色（如红色0xF800），看屏幕显示是否正确。

7.2 触摸无反应或坐标乱跳

1. I2C通信失败： 首先用i2c_scanner例程扫描I2C总线，看是否能找到GT911的地址（0x14或0x5D）。找不到，检查接线、上拉电阻、电源。SCL/SDA是否接反？
2. 中断信号问题： 用示波器或逻辑分析仪查看触摸芯片的INT引脚。当触摸发生时，是否产生了清晰的下拉脉冲？ESP32-S3这边是否配置了正确的中断边沿（通常是下降沿）？中断服务程序是否被触发？
3. 供电噪声： 触摸芯片对电源噪声非常敏感。同样，在触摸芯片的VCC和GND之间并联一个10uF和0.1uF的电容组合（一大一小）进行滤波，效果立竿见影。
4. 校准数据错误： 检查从NVS读取的校准参数是否正确。尝试恢复出厂校准值，或者重新进行一次校准流程。

7.3 系统运行一段时间后死机或重启

这通常是内存溢出、堆栈溢出或看门狗超时导致的。

1. 检查堆内存： 在代码中定期打印esp_get_free_heap_size()，观察内存是否在持续减少（内存泄漏）。重点检查LVGL对象创建后是否没有删除、网络数据接收缓冲区是否没有释放。
2. 检查任务堆栈： 在menuconfig中启用FreeRTOS的堆栈溢出检测功能（CONFIG_FREERTOS_USE_TRACE_FACILITY和CONFIG_FREERTOS_GENERATE_RUN_TIME_STATS）。运行一段时间后，通过vTaskList查看各任务的堆栈高水位线，适当增加LVGL任务或网络任务的堆栈大小。
3. 检查看门狗： ESP-IDF有任务看门狗（TWDT）。如果一个任务长时间阻塞（比如在disp_flush中等待DMA完成但用了阻塞方式），会导致看门狗复位。确保长时间循环中有vTaskDelay或taskYIELD，或者适当增加看门狗超时时间。

7.4 固件升级与工厂测试

产品化时，需要考虑后期升级。ESP32-S3支持OTA升级。可以将LVGL的图形资源（图片、字体）单独打包成文件系统分区（如SPIFFS或LittleFS），通过OTA只更新这个分区，而无需重刷整个固件，节省升级流量和时间。

在工厂生产时，可以编写一个简单的测试程序，烧录到设备中。这个程序依次进行以下测试并点亮不同颜色的LED指示：

1. 屏幕测试：全屏显示红、绿、蓝、白，检测坏点。
2. 触摸测试：在四个角显示靶点，要求工人依次点击，程序自动记录校准参数并存入NVS。
3. Wi-Fi/BLE测试：尝试扫描周边网络或广播信号。
4. SPI Flash测试：进行读写校验。

这个测试程序能快速筛出硬件装配不良的单元，保证出厂质量。

从一颗芯片、一块屏幕开始，到构建出一个稳定、流畅、可交互的智能设备原型，整个过程就像在微观世界里搭建一座城市。ESP32-S3-Touch-LCD-1.69这个组合，以其均衡的性能和丰富的生态，给了我们极大的发挥空间。调试中最深刻的体会是，嵌入式开发没有银弹，每一个稳定的表现背后，都是对电源、时序、中断、内存这些基础细节的反复打磨和验证。当你看到自己设计的界面在指尖流畅滑动，并且能稳定地从云端获取数据时，那种成就感，就是驱动我们这些开发者不断折腾下去的最大动力。希望这篇长文里记录的这些细节、坑点和思路，能帮你少走些弯路，更快地让你的想法在这块小小的屏幕上生动起来。