实训项目名称

实训时间

ESP32开发板型号

开发环境

实训小组人数

ESP32 WIFI 功能开发（时间获取 + 天气显示）

2026/3/16

ESP32S3

ESP-IDF

1

知识点类别

具体知识点

核心原理简述

实训应用场景

（机器人相关）

备注

（易错点/重点）

引脚配置

WIFI 外设引脚复用

ESP32S3 内置 WIFI 模块，芯片自动完成引脚复用配置，无需手动指定 WIFI 相关引脚

机器人联网通信模块的硬件适配，为机器人获取网络时间、联网获取环境数据（如天气）提供硬件基础

无需手动配置 WIFI 引脚，避免误修改芯片默认引脚配置导致 WIFI 功能失效

外设驱动

WIFI 模块驱动、LCD 显示驱动、定时器驱动

通过编写 / 移植驱动代码初始化硬件外设，建立软件与硬件的通信桥梁，实现外设的功能调用

机器人的网络通信、数据可视化显示、时间同步定时控制

驱动文件需正确引入工程，头文件路径配置必须准确

通信协议

STA 模式 WIFI 通信、HTTP 协议、IIC 协议

STA 模式实现 ESP32 接入局域网；HTTP 协议实现网络数据的请求与获取；IIC 协议实现外设间的串行通信

机器人接入无线网络，联网请求天气数据、获取网络时间，外设（如 LCD、扩展口）间的数据交互

WIFI 需配置正确的账号密码（2.4GHz 频带）；HTTP 请求需保证网络通畅，替换专属密钥

代码开发

NVS 闪存初始化、FreeRTOS 系统调用、数据解析与显示

NVS 用于存储 WIFI 配置等信息；FreeRTOS 的 VTaskDelay 实现 CPU 资源释放；通过 sprintf 格式化数据，lv_label_set_text 实现 LCD 文本显示

机器人的系统初始化、防看门狗复位、网络数据（时间 / 天气）的解析与可视化展示

循环中需添加 CPU 释放操作，避免网络阻塞触发看门狗复位；格式化字符串需注意缓冲区大小

其他（自定义）

看门狗机制、工程文件管理

看门狗监控系统运行状态，超时未喂狗会触发系统复位；通过 CMakeLists.txt 配置工程的源文件和头文件路径

机器人系统的稳定性保障，工程代码的模块化管理与调用

网络操作前需初始化 NVS；CMakeLists.txt 中INCLUDE_DIRS 需正确添加所有自定义文件夹路径

步骤序号

实操内容

（ESP32相关）

操作步骤细节

使用工具/代码片段

操作结果

（成功/失败及原因）

1

开发环境搭建

1. 在 ESP-IDF 工程中创建 WIFI 文件夹，将 wifi.c、wifi.h 移植至该文件夹；2. 打开工程的 CMakeLists.txt 文件，在 INCLUDE_DIRS 中添加 "WIFI" 头文件访问路径；3. 确认源文件通过 file (GLOB RECURSE SOURCES ./*.c) 自动匹配，无需额外配置

ESP-IDF、文本编辑器代码片段：set(INCLUDE_DIRS"LCD""Timer""batch""

ui/generated

""ui/custom""u/

generated/

guider_customer_fonts""WIFI")

成功，工程可正常识别 WIFI 相关驱动文件和头文件

2

ESP32开发板调试

1. 初始化工程基础外设：调用 bsp_i2c_init () 初始化 IIC 接口、pca9557_init () 初始化扩展口、ESP_Timer_Init () 初始化定时器、bsp_lvgl_start () 初始化 LVGL；2. 在 app_main 函数中添加 Wifi_STA_Init () 进行 WIFI 初始化；3. 修改 wifi 配置，填入 2.4GHz 频带的局域网账号和密码

ESP32S3 开发板、串口工具代码片段：bsp_i2c_init();

pca9557_init();ESP_Timer_Init();

bsp_lvgl_start();

Wifi_STA_Init();

成功，开发板基础外设初始化完成，WIFI 模块进入待连接状态

3

外设与ESP32连接

1. 基于 IIC 协议完成 LCD、扩展口与 ESP32 的硬件连接；2. 软件层面完成各外设驱动的初始化调用，建立 ESP32 与 LCD、定时器等外设的通信链路

ESP32S3 开发板、LCD 模块、

杜邦线代码片段：setup_ui(&guider_ui);

custom_init(&guider_ui);

成功，ESP32 可正常向 LCD 发送显示指令，外设间通信正常

4

代码编写与烧录

1. 编写 WIFI 连接代码：在 Wifi_STA_Init () 中完成 NVS 闪存初始化、WifiConfig () 配置；2. 编写网络时间获取代码：添加 ESP_Network_Init () 初始化网络时间，通过 time (NULL) 获取时间戳，localtime () 解析时间；3. 编写时间显示代码：sprintf 格式化时间字符串，lv_label_set_text 在 LCD 显示；4. 编写天气获取代码：解除 http_post_request () 注释，替换专属密钥实现 HTTP 天气请求；5. 烧录代码至 ESP32S3 开发板

ESP-IDF 编译工具、烧录工具核心代码：

ESP_Network_Init();timer_sec= time(NULL);timeinfo = *localtime(timer_sec);sprintf

(str,"%02d:%02d:%02d",timeinfo.tm_hour, timeinfo.tm_min, timeinfo.tm_sec);

lv_label_set_text

(guider_ui.screen_label_1, str);

成功，代码无编译错误，可正常烧录至开发板

5

机器人功能调试

1. WIFI 连接调试：检查开发板是否成功接入配置的 2.4GHz 局域网；2. 网络时间调试：在循环中添加 VTaskDelay (10) 释放 CPU，查看 LCD 是否实时显示网络时间；3. 天气功能调试：解除 http_post_request () 注释，查看是否能成功请求并获取天气数据；4. 稳定性调试：检查是否因网络阻塞触发看门狗复位1. WIFI 连接调试：检查开发板是否成功接入配置的 2.4GHz 局域网；2. 网络时间调试：在循环中添加 VTaskDelay (10) 释放 CPU，查看 LCD 是否实时显示网络时间；3. 天气功能调试：解除 http_post_request () 注释，查看是否能成功请求并获取天气数据；4. 稳定性调试：检查是否因网络阻塞触发看门狗复位

串口工具、LCD 模块、局域网环境

成功，WIFI 正常连接，LCD 实时显示网络时间，天气数据可正常请求；添加 CPU 释放后，无看门狗复位问题

6

功能优化与完善

1. 关闭无用功能：注释掉天气数据获取代码（仅测试时间功能时），减少系统资源占用；2. 增加容错处理：NVS 初始化失败时，调用 nvs_flash_erase () 擦除闪存后重新初始化；3. 优化循环逻辑：通过判断 sec != timer_sec 实现时间的秒级刷新，避免重复刷新 LCD

文本编辑器、ESP-IDF 调试工具代码片段：esp_err_t ret = nvs_flash_init();if (ret== ESP_ERR_NVS_NO_FREE_PAGES

成功，系统资源占用降低，功能运行更稳定，时间显示刷新逻辑更合理

问题序号

问题描述（ESP32相关）

排查过程

解决方案

问题总结（避免方法）

1

WIFI 驱动文件无法识别，编译提示头文件找不到

1. 检查 WIFI 文件夹是否正确创建在工程指定目录；2. 检查 CMakeLists.txt 中 INCLUDE_DIRS 是否添加 "WIFI" 路径；3. 检查头文件引用是否为 #include "wifi.h"

1. 确保 WIFI 文件夹与 main、LCD 等文件夹同级；2. 在 CMakeLists.txt 的 INCLUDE_DIRS 中添加 "WIFI"；3. 确认头文件引用路径与文件夹名称一致

工程中添加新驱动文件夹后，必须在 CMakeLists.txt 中同步配置头文件访问路径，保持文件夹名称与引用路径一致

2

烧录后 WIFI 无法连接局域网

1. 检查配置的 WIFI 账号、密码是否正确；2. 检查 WIFI 频带是否为 2.4GHz（ESP32S3 部分版本不支持 5GHz）；3. 检查开发板是否在局域网信号覆盖范围内

1. 核对并修改为正确的 2.4GHz 频带 WIFI 账号和密码；2. 将开发板移至局域网信号良好的区域

配置 WIFI 时需确认频带为 2.4GHz，准确填写账号密码，避免因字符输入错误导致连接失败

3

网络操作时触发看门狗复位，系统自动重启

1. 检查网络请求（如 HTTP、时间同步）代码是否在死循环中；2. 检查循环中是否有 CPU 资源释放操作；3. 确认是否因网络阻塞导致系统长时间未喂狗

在包含网络操作的循环中添加 VTaskDelay (10) 等 FreeRTOS 延时函数，释放 CPU 资源，避免系统阻塞

所有包含网络、外设通信的循环操作，必须添加 CPU 释放代码，防止看门狗超时复位

4

NVS 闪存初始化失败，提示 ESP_ERR_NVS_NO_FREE_PAGES

1. 检查 NVS 闪存是否有剩余存储空间；2. 确认是否为 NVS 版本不兼容导致初始化失败

在 NVS 初始化代码中添加容错处理，失败时调用 nvs_flash_erase () 擦除闪存后重新初始化

初始化 NVS 时必须添加容错逻辑，处理闪存空间不足、版本不兼容等异常情况

5

LCD 无法显示网络时间，串口打印可正常输出时间

1. 检查 LVGL 初始化是否完成（bsp_lvgl_start () 是否调用）；2. 检查 lv_label_set_text 的控件句柄是否正确（guider_ui.screen_label_1）；3. 检查时间字符串格式化是否有错误

1. 确保在显示数据前完成 LVGL 和 UI 的初始化（setup_ui、custom_init）；2. 核对控件句柄名称与 UI 设计一致；3. 检查 sprintf 格式化符是否正确（%02d），缓冲区是否足够

显示数据前需完成所有显示相关外设和 UI 的初始化，核对控件句柄和格式化字符串，避免因参数错误导致显示失败

项目完成情况

ESP32开发重点收获

存在的不足

后续改进计划

本次实训的 ESP32 WIFI 核心功能（网络时间获取、LCD 时间显示、WIFI 连接、HTTP 天气请求）均成功实现，系统运行稳定，无看门狗复位、WIFI 断连等问题，功能达到预期效果

1. 掌握了 ESP32S3 WIFI 模块 STA 模式的开发流程，包括驱动移植、工程配置、WIFI 连接配置；2. 理解了 ESP-IDF 工程的文件管理方式，学会通过 CMakeLists.txt 配置头文件和源文件路径；3. 掌握了 NVS 闪存初始化、FreeRTOS 系统调用（如 VTaskDelay）的核心用法，理解了看门狗机制的原理和防复位方法；4. 学会了网络时间的获取、解析和 LCD 可视化显示，掌握了 HTTP 协议实现网络数据请求的基础步骤；5. 积累了 ESP32 开发的问题排查经验，能够快速定位并解决编译错误、硬件连接、功能异常等问题

1. 对 HTTP 协议的底层原理理解较浅，仅能调用现成函数实现数据请求，无法自主编写 HTTP 请求代码；2. 对 ESP32 的中断机制、多任务调度掌握不足，未在项目中实现复杂的多任务管理；3. 问题排查时思路不够系统，偶尔会花费较多时间定位简单问题；4. 未实现天气数据的解析和 LCD 显示，仅完成了天气数据的 HTTP 请求步骤

1. 深入学习 HTTP、TCP/IP 网络协议的底层原理，尝试自主编写网络数据请求和解析代码，实现天气数据的 LCD 可视化显示；2. 学习 ESP32 FreeRTOS 多任务调度和中断机制，将 WIFI 通信、数据显示、外设控制拆分为独立任务，提升系统的并发性和稳定性；3. 整理 ESP32 开发常见问题排查手册，形成系统的问题排查思路，提升问题解决效率；4. 基于本次 WIFI 功能，扩展开发机器人的远程控制、环境数据上传等功能，实现 ESP32 的综合应用；5. 尝试在项目中添加异常处理（如 WIFI 断连重连、网络数据请求失败重试），提升系统的鲁棒性