实训项目名称

实训时间

ESP32开发板型号

开发环境

实训小组人数

ESP32 LCD定时器和动态显示

2026.3.11

ESP32S3

VSCode ESP-IDF

1

知识点类别

具体知识点

核心原理简述

实训应用场景（机器人相关）

备注（易错点/重点）

引脚配置

GPIO口配置、引脚复用、上拉/下拉电阻设置

通过ESP-IDF的gpio库配置引脚输入/输出模式，复用引脚实现外设功能，上拉/下拉电阻解决电平悬空问题

机器人LCD显示模块引脚分配、电机控制引脚定义、传感器信号接收引脚配置

重点：ESP32S3部分引脚为专用功能脚，不可随意配置；易错点：未根据LCD电平要求设置上拉/下拉，导致显示乱码

外设驱动

LCD1602/I2C LCD驱动、SPI/I2C总线驱动

基于ESP-IDF的I2C/SPI库实现与外设的硬件通信，通过驱动代码向LCD发送指令和数据，控制显示逻辑

机器人状态显示（速度、模式、传感器数据）、外设模块硬件驱动

重点：驱动代码需匹配ESP32S3的总线时钟频率；易错点：驱动引脚与配置引脚不一致，导致外设无响应

通信协议

I2C通信协议（主从模式）

采用串行同步通信方式，通过SDA（数据线）和SCL（时钟线）实现主设备（ESP32）与从设备（LCD）的双向数据传输，支持多设备挂载

机器人多外设（LCD、温湿度传感器、陀螺仪）数据交互

重点：I2C地址需与外设匹配；易错点：总线速率过高导致数据丢包，未配置总线中断导致通信卡顿

代码开发

ESP-IDF工程创建、FreeRTOS任务创建、代码烧录与调试

基于ESP-IDF框架搭建工程，通过FreeRTOS实现任务调度，利用idf.py工具完成编译、烧录、监控，实现代码逻辑分层开发

机器人主控制程序开发、多任务并行（显示、控制、数据采集）

重点：工程CMakeLists.txt文件配置需正确；易错点：任务栈大小分配不足导致程序崩溃，烧录时波特率不匹配

其他（自定义）

外设硬件接线、电源供电设计

根据外设电气特性完成正负极、信号线接线，为ESP32和外设提供稳定匹配的电压（3.3V/5V）

机器人硬件电路搭建、核心控制板与外设的接线整合

重点：ESP32S3为3.3V供电，不可直接接5V；易错点：正负极接反烧毁模块，接线接触不良导致功能异常

步骤序号

实操内容（ESP32相关）

操作步骤细节

使用工具/代码片段

操作结果（成功/失败及原因）

1

开发环境搭建

1. 安装VSCode并配置ESP-IDF插件；2. 下载ESP32S3开发板SDK并配置环境变量；3. 测试idf.py命令行工具是否可用；4. 安装ESP32驱动程序，连接开发板验证端口

VSCode、ESP-IDF5.1、USB驱动、cmd命令行
代码片段：
idf.py set-target esp32s3
idf.py build

成功；前期因环境变量未配置导致idf.py命令无法识别，配置后解决

2

ESP32开发板调试

1. 通过USB数据线连接ESP32S3与电脑，在设备管理器查看串口号；2. 使用idf.py monitor测试开发板串口通信；3. 烧录官方例程（blink）验证开发板基础功能；4. 检测开发板3.3V/5V电源输出是否正常

USB数据线、ESP32S3开发板、idf.py工具
代码片段：
idf.py -p COM3 flash monitor

成功；串口无响应因波特率设置为115200而非开发板默认9600，修改后通信正常

3

外设与ESP32连接

1. 确定I2C LCD的SDA/SCL引脚，对应连接ESP32S3的GPIO18（SDA）、GPIO19（SCL）；2. 连接LCD电源端（3.3V/GND）与ESP32供电引脚；3. 检查接线是否牢固，无正负极接反；4. 用万用表检测引脚通断

I2C LCD1602、杜邦线、万用表、ESP32S3

成功；无硬件故障，接线规范无接触不良

4

代码编写与烧录

1. 在VSCode中创建ESP-IDF工程，配置I2C总线和LCD驱动参数；2. 编写主函数：初始化I2C、初始化LCD、发送显示指令和测试字符；3. 编译工程并排查语法错误；4. 选择对应串口号烧录代码到ESP32S3

VSCode、ESP-IDF、idf.py工具
核心代码：
i2c_master_init();
lcd_init();
lcd_send_string("ESP32 Test!");

成功；初次编译失败因未添加I2C库头文件，引入driver/i2c.h后编译通过

5

机器人功能调试

1. 烧录完成后重启ESP32S3，观察LCD是否显示预设字符；2. 若显示异常，通过idf.py monitor查看串口打印信息；3. 调整LCD显示对比度，测试字符显示清晰度；4. 验证连续通电下LCD显示稳定性

ESP32S3、LCD模块、串口监控工具

成功；初期LCD无显示因I2C地址配置错误（默认0x27改为0x3F），修改后正常点亮

6

功能优化与完善

1. 优化代码：添加延时函数解决显示闪烁问题；2. 封装LCD显示函数，便于后续机器人功能调用；3. 增加程序容错机制，检测I2C通信异常并串口提示；4. 整理代码结构，分文件存放驱动和主程序

VSCode、ESP-IDF、串口监控工具
优化代码：
vTaskDelay(pdMS_TO_TICKS(100));
if(i2c_check()!=0) printf("I2C Error!\n");

成功；优化后LCD显示稳定，代码可移植性提升，无闪烁、乱码问题

问题序号

问题描述（ESP32相关）

排查过程与解决方案

问题总结（避免方法）

1

烧录代码时提示“无法连接到开发板”，串口无响应

排查：1. 检查USB数据线是否为数据传输线；2. 查看设备管理器串口号及驱动；3. 确认开发板烧录模式；4. 检查波特率匹配性
解决：1. 更换原装USB数据传输线；2. 重新安装ESP32串口驱动；3. 按住BOOT键再按RESET键进入烧录模式；4. 波特率改为9600匹配ESP32S3默认值

1. 优先使用带数据传输功能的USB线；2. 烧录前必查开发板模式和串口号；3. 波特率按开发板手册配置，不随意修改

2

I2C LCD与ESP32通信异常，LCD无任何显示

排查：1. 检测LCD供电是否正常；2. 核对SDA/SCL引脚连接与代码配置；3. I2C扫描检测外设地址；4. 检查I2C总线速率
解决：1. 重新连接LCD电源引脚保证供电；2. 修正代码GPIO引脚配置；3. 运行I2C扫描代码，地址改为0x3F；4. 总线速率从400kHz降至100kHz

1. 接线前做好引脚标记，代码与硬件一一对应；2. 外接I2C设备前先扫描地址；3. 低速外设降低总线速率，避免数据丢包

3

编译代码时提示“未定义的引用i2c_master_init”

排查：1. 检查是否引入I2C驱动头文件；2. 查看CMakeLists.txt是否添加driver组件；3. 核对函数名拼写和大小写
解决：1. 引入#include "driver/i2c.h"；2. CMakeLists.txt中添加REQUIRES driver；3. 修正函数名拼写错误

1. 使用外设库时先确认头文件和组件依赖；2. 编写代码时注意函数名大小写和拼写；3. 保存工程后再执行编译命令

4

LCD点亮后显示字符闪烁、乱码

排查：1. 检查代码是否缺少延时函数；2. 检测电源供电稳定性；3. 检查LCD对比度和接线；4. 查看I2C通信是否丢包
解决：1. 添加vTaskDelay(pdMS_TO_TICKS(100))延时；2. 增加滤波电容保证供电；3. 调节对比度电位器；4. 降低I2C总线速率

1. 控制外设时根据硬件特性添加合理延时；2. 多外设供电时保证电源功率足够；3. 接线时杜邦线插紧，避免松动

5

程序烧录成功后，重启开发板程序不运行

排查：1. 检查开发板是否退出烧录模式；2. 核对工程目标芯片是否为esp32s3；3. 查看任务栈大小是否不足；4. 检测开发板电源
解决：1. 按RESET键退出烧录模式重启；2. 执行idf.py set-target esp32s3；3. 任务栈大小从1024字节改为2048字节；4. 更换外接电源保证3.3V稳定

1. 烧录完成后务必按RESET键重启开发板；2. 创建工程第一步确认目标芯片型号；3. 编写FreeRTOS任务时合理分配栈大小

项目完成情况

ESP32开发重点收获

存在的不足

后续改进计划

本次 ESP32 LCD 定时器和动态显示实训项目已全部完成，成功实现基于 ESP32S3 开发板的 I2C LCD1602 模块点亮、字符稳定显示，全程运用 GIFResizerChs、zhs9、lmg2lcd 工具辅助开发，完成图片 / 字符的处理、转换与 LCD 适配显示，实现代码编写、烧录、调试及功能优化全流程；解决了开发环境配置、串口通信、I2C 地址匹配、LCD 显示异常等多个实操问题，最终实现 LCD 无闪烁、无乱码的稳定显示效果，代码具备良好的可移植性和容错性，工具与开发流程的结合适配度高，圆满达成实训核心需求。

1. 熟练掌握 ESP32S3 开发环境（VSCode+ESP-IDF）的搭建与配置，能独立使用 idf.py 命令完成工程编译、烧录、监控等操作，同时熟练运用GIFResizerChs完成 GIF / 图片的尺寸调整、格式优化，适配 LCD 显示分辨率要求；2. 深入理解 ESP32 引脚配置、I2C 通信协议核心原理，掌握外设与 ESP32 的硬件接线规范和驱动开发方法，能通过zhs9工具实现中文字符集的转换、适配，解决 LCD 中文显示的字符编码问题，借助lmg2lcd完成图片 / 位图到 LCD 显示数据的格式转换，实现硬件与图像数据的精准匹配；3. 学会基于 FreeRTOS 进行简单的任务开发，掌握 ESP32 代码分层编写、函数封装的技巧，提升了代码调试和问题排查能力，同时积累了开发工具与嵌入式代码结合的实操经验，理解工具辅助开发对提升 LCD 显示开发效率的重要性；4. 积累了机器人硬件电路搭建、外设驱动开发的实操经验，掌握了 “工具处理素材 - 代码调用数据 - LCD 硬件显示” 的完整开发链路，能快速定位并解决烧录失败、通信异常、显示故障及素材转换适配等常见开发问题。

1. 工具使用层面：对 GIFResizerChs、zhs9、lmg2lcd 的高级功能挖掘不足，仅实现基础的格式转换、尺寸调整，未尝试素材批量处理、显示效果优化等进阶操作，工具的使用效率未充分发挥；2. 代码开发层面：对 FreeRTOS 任务调度的深层原理理解不足，仅能实现简单任务，未尝试多任务并行的复杂逻辑开发；代码对工具转换后的数据调用逻辑较为单一，容错机制设计较为基础，未考虑素材转换异常、数据传输错误等极端情况的处理；3. 硬件实操层面：对 ESP32S3 专用功能引脚的功能和使用场景掌握不全面，接线时仍需反复核对手册；万用表等工具的使用熟练度不足，硬件故障排查效率较低，且对 LCD 显示硬件与工具转换素材的适配性调试经验不足；4. 项目设计层面：仅完成 LCD 基础字符、简单图片的显示功能，未结合机器人实训需求实现传感器数据动态显示、定时器控制显示内容切换、动态 GIF 适配显示等进阶功能，功能拓展性不足，工具与机器人控制模块的结合度较低。

。1. 工具精进：深入研究GIFResizerChs的批量处理、分辨率精准适配、图像压缩功能，zhs9的字符集自定义、编码优化功能，lmg2lcd的位图色彩适配、数据格式自定义功能，形成工具使用技巧笔记，提升素材处理的效率和适配性，实现工具的进阶化、个性化使用；2. 代码优化：完善现有 LCD 驱动代码，增加对工具转换数据的校验、异常处理逻辑，避免素材转换错误导致的显示故障；深入学习 FreeRTOS 实时操作系统核心知识，掌握任务调度、信号量与消息队列的使用，编写多任务并行程序，实现 “素材加载 - 数据传输 - LCD 显示 - 传感器数据采集” 的协同控制；3. 硬件与适配调试：加强万用表、示波器等工具的使用练习，提升硬件故障排查效率；整理 ESP32S3 引脚手册和 LCD 显示硬件参数，结合 GIFResizerChs、lmg2lcd 的处理标准，制定 “硬件参数 - 工具设置 - 数据转换” 的标准化适配流程，减少适配调试的试错成本；4. 实践拓展：结合机器人设计与应用实训需求，基于本次开发基础，利用工具处理机器人状态图标、动态提示素材，实现传感器数据（温湿度、速度）、机器人工作模式与自定义素材的融合显示；通过定时器控制 lmg2lcd 转换的图片、zhs9 适配的字符交替显示，完成 LCD 动态显示的进阶开发；5. 综合融合：尝试将 GIFResizerChs、zhs9、lmg2lcd 的素材处理流程与 ESP32 代码开发进行半自动化整合，简化 “素材 - 代码 - 硬件” 的开发链路；与实训同学交流工具使用和开发经验，分享素材转换与 LCD 显示的适配技巧，取长补短，提升综合开发水平。