实训项目名称

实训时间

ESP32开发板型号

开发环境

实训小组人数

ESP32屏幕显示技术

2026.3.9

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 屏幕显示技术实训已全部完成，成功基于 ESP32S3 开发板结合 VSCode ESP-IDF 开发环境实现 I2C LCD1602 的点亮与稳定显示，完成了从开发环境搭建、硬件接线、代码编写烧录到功能调试与优化的全流程操作，优化后的程序可实现无闪烁、无乱码的字符显示，且封装了相关驱动函数，具备良好的可移植性，满足机器人 LCD 显示模块的基础开发需求。

. 熟练掌握了 ESP32S3 开发板的基础使用，包括引脚配置、I2C 通信协议实操、ESP-IDF 开发环境的搭建与工程配置，能独立完成 idf.py 相关命令的使用和代码烧录调试；2. 理解了 FreeRTOS 在 ESP32 开发中的任务调度逻辑，学会了简单的多任务基础编写，掌握了机器人开发中硬件与软件的联调方法；3. 积累了 ESP32 外设驱动开发的实操经验，能独立排查 I2C 通信异常、代码编译报错、烧录失败等常见问题，形成了 “硬件排查→代码核对→参数调试” 的问题解决思路；4. 掌握了机器人硬件电路搭建的基础要点，明确了 ESP32S3 的供电规范和外设接线原则，能规范完成核心控制板与外设的接线整合

1. 代码编写能力有待提升，对 ESP-IDF 框架的底层函数理解较浅，仅能完成基础的驱动和显示代码编写，复杂的程序逻辑和函数封装能力不足；2. 对 FreeRTOS 实时操作系统的运用较为基础，仅实现了简单的延时和任务创建，未深入研究多任务优先级分配、任务间通信等进阶内容，难以适配机器人复杂的多模块并行控制需求；3. 硬件问题排查的效率较低，遇到接线接触不良、电源供电不稳等问题时，未能快速定位故障点，对万用表等工具的使用不够熟练；4. 开发思维较为局限，仅关注 LCD 显示单一功能的实现，未结合机器人实际应用场景做拓展开发，如将传感器数据实时显示在 LCD 屏幕上的综合应用。

1. 加强 ESP-IDF 框架和 FreeRTOS 系统的学习，通过阅读官方文档、练习进阶例程，深入理解底层驱动原理和多任务调度机制，尝试编写机器人多模块协同的控制程序，提升代码编写和程序优化能力；2. 强化硬件实操能力，多进行机器人硬件电路的搭建和调试练习，熟练使用万用表、示波器等工具，总结各类硬件故障的快速排查方法，提升硬件问题解决效率；3. 结合机器人设计的实际需求做拓展开发，将本次的 LCD 显示技术与温湿度、红外等传感器结合，实现传感器数据的实时采集与屏幕显示，完成 “硬件采集 - 软件处理 - 屏幕展示” 的全流程实操；4. 整理本次实训的技术文档和问题解决方案，形成个人开发笔记，同时与同学交流实训心得，学习他人的优秀开发思路和问题解决方法，完善自身的 ESP32 开发知识体系；5. 尝试基于本次的开发基础，开发机器人简单的状态显示系统，如将机器人的运动模式、速度参数等实时显示在 LCD 上，为后续复杂机器人控制模块的开发打下基础。