实训项目名称

实训时间

ESP32开发板型号

开发环境

实训小组人数

ESP32 基于 FreeRTOS 的 LCD 定时器动态显示与动图播放实现

2026/3/11

ESP32-S3（实操适配型号）

ESP-IDF（FreeRTOS 内核）、PCtoLCD2002 取模软件、GIF 分解工具、VS Code

2

知识点类别

具体知识点

核心原理简述

实训应用场景

（机器人相关）

备注

（易错点/重点）

引脚配置

I2C 引脚配置、LCD 外设引脚配置

通过 ESP32 通用 IO 口配置 I2C 通信引脚，实现与 LCD、PCA9557 扩展口的硬件连接，为外设提供通信与控制通道

机器人显示模块硬件搭建，实现机器人状态 / 信息的 LCD 可视化展示

需匹配硬件电路定义，避免引脚冲突；初始化时先完成 I2C 和扩展口配置

外设驱动

LCD 外设驱动开发、PCA9557 扩展口驱动

基于 ESP-IDF 编写 LCD 底层驱动，实现位图 / 字模数据的屏幕绘制；PCA9557 实现 IO 口扩展，为 LCD 提供更多控制信号

机器人 LCD 显示模块，实现汉字（30*30）、图片、动图的屏幕输出

LCD 绘制需精准计算像素坐标和内存分配；字模数据需与取模参数一致

通信协议

I2C 通信协议

利用 I2C 主从通信机制，实现 ESP32 与 LCD、PCA9557 之间的字节数据传输，是外设硬件交互的基础

机器人外设间的短距离低速通信，支撑显示模块与主控的信息交互

I2C 初始化需配置正确的时钟频率，避免通信丢包

代码开发

FreeRTOS 系统配置、字模数据处理、动态内存管理、定时器开发、循环动图实现

1. 配置 FreeRTOS 时钟节拍为 1000Hz，提供 ms 级延时基础；2. 自定义结构体存储汉字字模，通过字符匹配实现汉字绘制；3. 利用heap_caps_malloc/free实现外部 SPIRAM 的动态内存分配与释放；4. 自定义定时器文件实现定时功能；5. 批量取模 GIF 帧图片，通过指针数组 + 循环实现动图播放

1. 机器人的定时任务触发（如定时刷新显示内容）；2. 机器人的中文状态提示、动态 logo / 动画展示；3. 基于 FreeRTOS 的机器人多任务调度

1. 汉字取模需严格设置 30*30 像素，字模数组长度匹配 120 字节；2. 内存分配后必须判断是否成功，使用后及时释放避免内存泄漏；3. FreeRTOS 延时使用vTaskDelay，单位为时钟节拍

其他（自定义）

PCtoLCD2002 字模取模、GIF 分解与批量取模

1. 取模软件将汉字转换为十六进制字模数据，供 LCD 驱动解析绘制；2. GIF 分解工具将动图拆分为单帧 BMP，批量取模后转换为 C/H 文件供工程调用

机器人 LCD 的汉字显示、动态图形 / 动画展示

1. 取模时选择正确的字体、像素大小，生成格式匹配代码解析规则；2. GIF 帧过多时可隔帧删除，降低工程内存占用

步骤序号

实操内容

（ESP32相关）

操作步骤细节

使用工具/代码片段

操作结果

（成功/失败及原因）

1

开发环境搭建

1. 安装 ESP-IDF 并配置环境变量，搭建 FreeRTOS 开发环境；2. 安装 PCtoLCD2002 取模软件、GIF 分解工具；3. 建立 ESP32 工程，创建 LCD、Timer、batch 子文件夹分别存放对应功能代码

ESP-IDF、VS Code、PCtoLCD2002、GIF 分解工具

成功

2

ESP32开发板调试

1. 连接 ESP32-S3 开发板与电脑，配置串口端口与波特率；2. 编写基础测试代码，烧录验证开发板与环境的连通性；3. 初始化 I2C 接口和 PCA9557 扩展口，验证硬件通信

c<br/>bsp_i2c_init();//IIC接口初始化<br/>pca9557_init();//扩展口初始化<br/>

成功

3

外设与ESP32连接

1. 完成 LCD 与 ESP32/PCA9557 的硬件接线；2. 在工程中编写 LCD 初始化代码，配置屏幕分辨率、显示参数；3. 验证 LCD 基础显示功能（如纯色屏幕）

c<br/>bsp_lcd_init();//LCD初始化<br/>//lcd_set_color(0x424F);//设置LCD颜色<br/>

成功

4

代码编写与烧录

1. 打开 PCtoLCD2002，设置 30*30 像素、宋体，输入目标汉字生成十六进制字模；2. 在 LCD.c 中自定义结构体typFNT_GB30，存储汉字索引和 120 字节字模数据；3. 编写lcd_draw_hz30汉字绘制函数和LCD_Showstring30字符串显示函数，实现汉字 / 中文串的 LCD 绘制；4. 实现动态内存分配与释放，避免内存泄漏

c<br/>while(1){<br/>for(uint8_ti=0;i<=5;i++){<br/>lcd_draw_pictrue(,,images[i]);//绘制帧图片<br/>vTaskDelay(100);//延时<br/>}<br/>}<br/>LCD_Showstring30(x,y,"XX专业XX班 姓名：XXX 学号：XXX",fc,bc);<br/>

成功

5

机器人功能调试

1. 进入 ESP-IDF 的 SDK 配置编辑器，搜索 FreeRTOS，将configTICK_RATE_HZ设置为 1000Hz（1ms / 次）；2. 在 components/FRTask 下创建 Timer 头文件和源文件，编写定时器初始化与功能代码；3. 在工程 CMakeLists.txt 中添加 Timer 文件的源文件和头文件目录

GIF 分解工具、批处理文件 c2h.batcmake<br/>set(INCLUDE_DIRS "." "LCD" "Timer" "batch")<br/>unsigned char *images []={gImage_IMG00000,gImage_IMG00001,...};<br/>

成功

6

功能优化与完善

1. 烧录后查看 LCD 显示效果，排查汉字显示乱码、动图播放卡顿、屏幕无显示等问题；2. 优化延时参数、内存分配方式，调整汉字 / 图片显示坐标，使页面布局美观；3. 验证定时器功能，实现定时刷新显示内容

ESP32 开发板、串口调试助手

成功

问题序号

问题描述（ESP32相关）

排查过程

解决方案

问题总结（避免方法）

1

LCD 屏幕无任何显示，硬件接线正常

1. 检查 I2C 和 PCA9557 初始化代码是否执行；2. 排查 LCD 初始化函数的参数配置是否正确；3. 验证 ESP32 开发板供电是否稳定

1. 确保代码中先执行bsp_i2c_init()和pca9557_init()，再执行bsp_lcd_init()；2. 核对 LCD 初始化的分辨率、引脚映射与硬件匹配；3. 更换数据线或供电口，保证开发板 5V/3.3V 供电稳定

初始化外设需遵循先通信接口、再扩展口、最后功能外设的顺序；定期检查硬件接线与供电

2

30*30 汉字显示乱码 / 缺笔画

1. 检查 PCtoLCD2002 的取模参数是否为 30*30 像素；2. 核对字模数据的十六进制值是否与生成结果一致；3. 检查typFNT_GB30结构体的字模数组长度是否为 120 字节

1. 重新打开取模软件，严格设置 3030 像素后重新生成字模；2. 逐行核对代码中字模数据，修正粘贴错误的十六进制值；3. 确保字模数组Msk[120]长度与 3030 取模结果匹配

取模后需核对取模参数和字模数据，避免粘贴时遗漏 / 错行；结构体定义需与取模像素匹配

3

代码编译报错，提示 “内存分配失败”

1. 检查heap_caps_malloc的内存大小计算是否正确；2. 排查是否未判断内存分配结果，直接使用指针；3. 验证是否开启 ESP32 外部 SPIRAM 的内存分配权限

1. 重新计算像素内存大小：32*30*2（适配 30*30 汉字的显示区域）；2. 添加内存分配判断：if(NULL ==pixels){ESP_LOGE(TAG,"Memory for char is not enough");return;}；3. 确保heap_caps_malloc的参数包含MALLOC_CAP_SPIRAM

内存分配前精准计算所需字节数，必须添加空指针判断；使用外部 SPIRAM 需明确指定内存权限

4

GIF 动图播放无效果 / 只显示单帧

1. 检查帧图片头文件是否全部引入，有无拼写错误；2. 排查指针数组images是否正确关联所有帧图片数据；3. 验证循环绘制代码的索引范围是否正确

1. 核对头文件引入名称与文件实际名称一致，修正拼写错误（如 IMG/MG 混淆）；2. 确保指针数组元素与帧图片数量一致，格式为gImage_XXX；3. 循环索引i的范围匹配帧图片数量（如 0~5 对应 6 帧）

批量引入文件时核对名称拼写；指针数组与实际资源数量保持一致，循环索引边界需准确

5

FreeRTOS 延时功能失效，显示刷新过快

1. 检查 SDK 配置中configTICK_RATE_HZ是否设置为 1000Hz；2. 排查延时函数是否使用 FreeRTOS 的vTaskDelay，而非普通延时；3. 核对vTaskDelay的参数值是否合理

1. 重新进入 ESP-IDF SDK 配置编辑器，将configTICK_RATE_HZ改为 1000 并保存配置；2. 替换普通延时为 FreeRTOS 的vTaskDelay，参数单位为 ms（基于 1000Hz 配置）；3. 增大vTaskDelay参数值（如 100），降低动图刷新速率

修改 FreeRTOS 内核配置后必须保存；ESP-IDF 中优先使用系统自带的延时 / 定时函数，适配内核机制

项目完成情况

ESP32开发重点收获

存在的不足

后续改进计划

成功实现 ESP32 LCD 的 30*30 汉字显示、个人信息展示、GIF 动图循环播放，FreeRTOS 定时器配置与延时功能正常，页面布局美观

1. 掌握了 ESP-IDF 开发环境的使用，熟悉了 FreeRTOS 内核的基础配置（如configTICK_RATE_HZ）和延时函数vTaskDelay的使用；2. 学会了 LCD 外设的驱动开发，掌握了 PCtoLCD2002 字模取模的方法，能实现自定义像素的汉字 / 字符串显示；3. 理解了 ESP32 动态内存管理的要点，掌握了heap_caps_malloc/free的使用，学会了外部 SPIRAM 的内存分配；4. 掌握了 GIF 动图分解、批量取模及在 ESP32 上的循环播放实现，理解了指针数组管理多帧图片数据的思路；5. 熟悉了 ESP-IDF 工程的目录管理，掌握了 CMakeLists.txt 的配置方法，能添加自定义源文件和头文件目录；6. 积累了 ESP32 外设开发的问题排查经验，能快速定位硬件通信、代码编译、显示异常等常见问题

1. 对 FreeRTOS 定时器的高级功能（如定时中断、任务触发）掌握不足，仅实现了基础延时功能；2. LCD 显示的优化不足，如汉字显示的抗锯齿、色彩搭配等细节处理不够；3. 代码的模块化设计不够完善，部分功能代码耦合度较高，不利于后续扩展；4. 对 ESP32 内存管理的理解不够深入，在大尺寸图片 / 多帧动图下，内存优化的方法较少；5. 硬件调试能力有待提升，遇到接线接触不良、引脚冲突等问题时，排查效率较低

1. 深入学习 FreeRTOS 内核的定时器功能，实现基于定时中断的 LCD 内容定时刷新，提升动态显示的灵活性；2. 学习 LCD 显示的高级优化技巧，尝试实现不同字体、大小的汉字显示，优化页面布局和色彩搭配；3. 对代码进行模块化重构，将汉字显示、图片显示、动图播放等功能封装为独立的函数库，降低耦合度；4. 学习 ESP32 内存优化的方法，如图片数据的压缩、内存池的使用，实现大尺寸资源的高效加载；5. 加强硬件调试能力，学习使用万用表、逻辑分析仪等工具，快速定位硬件通信和接线问题；6. 尝试在现有基础上扩展功能，如添加传感器数据采集并在 LCD 上实时显示，实现 “传感器 + 显示” 的综合应用