适用场景：机器人设计与应用综合实训、课程设计、毕业设计复盘

开发平台：ESP32 系列（ESP32-WROOM-32D/32E）

一、实训项目档案与环境配置卡

1.1 项目基础信息表（项目立项必备）

文档性质：技术博客模板 | 实训报告辅助 | 工程实操复盘表

1.2 ESP32 开发环境搭建检查表（避坑指南）

二、核心功能模块与代码实现

2.1 ESP32 引脚功能定义表（硬件映射）

2.2 关键代码段与变量定义表（技术沉淀）

3.2 ESP32 开发疑难问题排查表（核心价值区）

四、成果展示与总结反思

实训总结与心得

五、代码附录

本次实训完整 LCD 点亮代码（ESP-IDF 版）

#include <stdio.h> #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "driver/gpio.h" // LCD引脚定义 #define LCD_RS 23 #define LCD_EN 25 #define LCD_D0 18 #define LCD_D1 19 #define LCD_D2 21 #define LCD_D3 22 // 延时宏定义 #define LCD_DELAY_MS(ms) vTaskDelay(ms / portTICK_PERIOD_MS) // 函数声明 void lcd_send_cmd(uint8_t cmd); void lcd_send_char(uint8_t ch); void lcd_init(void); void lcd_send_string(char *str); void app_main(void) { // 配置GPIO为输出模式 gpio_set_direction(LCD_RS, GPIO_MODE_OUTPUT); gpio_set_direction(LCD_EN, GPIO_MODE_OUTPUT); gpio_set_direction(LCD_D0, GPIO_MODE_OUTPUT); gpio_set_direction(LCD_D1, GPIO_MODE_OUTPUT); gpio_set_direction(LCD_D2, GPIO_MODE_OUTPUT); gpio_set_direction(LCD_D3, GPIO_MODE_OUTPUT); // 初始化LCD lcd_init(); // 显示测试字符串 lcd_send_string("ESP32 LCD Test"); while(1) { // 循环延时，保持显示 vTaskDelay(1000 / portTICK_PERIOD_MS); } } // 发送LCD指令 void lcd_send_cmd(uint8_t cmd) { gpio_set_level(LCD_RS, 0); // 指令模式 // 发送低4位 gpio_set_level(LCD_D0, (cmd >> 0) & 0x01); gpio_set_level(LCD_D1, (cmd >> 1) & 0x01); gpio_set_level(LCD_D2, (cmd >> 2) & 0x01); gpio_set_level(LCD_D3, (cmd >> 3) & 0x01); gpio_set_level(LCD_EN, 1); LCD_DELAY_MS(1); gpio_set_level(LCD_EN, 0); LCD_DELAY_MS(1); } // 发送LCD字符 void lcd_send_char(uint8_t ch) { gpio_set_level(LCD_RS, 1); // 数据模式 // 发送低4位 gpio_set_level(LCD_D0, (ch >> 0) & 0x01); gpio_set_level(LCD_D1, (ch >> 1) & 0x01); gpio_set_level(LCD_D2, (ch >> 2) & 0x01); gpio_set_level(LCD_D3, (ch >> 3) & 0x01); gpio_set_level(LCD_EN, 1); LCD_DELAY_MS(1); gpio_set_level(LCD_EN, 0); LCD_DELAY_MS(1); } // LCD初始化 void lcd_init(void) { LCD_DELAY_MS(20); // 上电延时 lcd_send_cmd(0x03); LCD_DELAY_MS(5); lcd_send_cmd(0x03); LCD_DELAY_MS(1); lcd_send_cmd(0x03); lcd_send_cmd(0x02); // 4位总线模式 lcd_send_cmd(0x02); lcd_send_cmd(0x08); // 显示关闭 lcd_send_cmd(0x00); lcd_send_cmd(0x0C); // 显示开启，光标关闭 lcd_send_cmd(0x00); lcd_send_cmd(0x06); // 光标自增 } // 发送字符串 void lcd_send_string(char *str) { while(*str) { lcd_send_char(*str++); } }