ESP32一键配置 SmartConfig

最新推荐文章于 2026-03-29 10:15:24 发布

原创

最新推荐文章于 2026-03-29 10:15:24 发布 · 2.9k 阅读

文章标签：

#嵌入式

本文详细介绍了如何使用ESP32进行SmartConfig配置，包括SmartConfig的工作原理、函数介绍、实验代码解析和配置步骤。在实验中，ESP32启动后红灯亮起，当SmartConfig成功连接WiFi后红灯熄灭，蓝灯亮起。实验过程涉及WiFi初始化、SmartConfig任务创建、回调函数处理以及停止SmartConfig。通过手机APP进行一键配网，实现ESP32与WiFi的快速连接。

这个实验的功能演示 ESP32 smartconfig 的使用方法。这个实验的代码为工程“4_3_wifi_SmartConfig”目录。

4.3.1. 实验内容

(1) 学习 SmartConfig 原理和工作过程
(2) 学习乐鑫的 ESP32 的 SmartConfig 程序设计

4.3.2. 一键配置 SmartConfig 简介

SmartConfig 模式，采用 UDP 广播模式（UDP 接收 IP 地址是 255.255.255.255）。WiFi 设备先 scan 环境下 AP，得到 AP 的相关信息,如工作的 channel,然后配置 WiFi 芯片工作在刚才 scan 到的 channel 上去接收 UDP 包，如果没有接收到，继续配置工作在另外的 channel 上，如此循环，直到收到 UDP 包为止。随意此种办法的致命缺点是成功率只有 70%，而且有些路由器不支持；优点显而易见，一键完成。
一键配网连接过程：
1）ESP32 开启混杂模式监听所有网络数据包。
2）手机连上 WiFi，开启 APP 软件，输入手机所在 WiFi 密码，请求配网。
3）手机通过广播、组播循环发送路由 SSID 和 PASSWD 数据包，一定格式加密。
4）ESP32 通过 UDP 包（长度）获取配置信息捕捉到路由 SSID 和 PASSWD，连接路由器。

4.3.3. ESP32 SmartConfig 函数介绍

这个实验会使用到 AP 和 STA 实验里的大部分函数，在以下只列出没有介绍过的函数。

 SmartConfig 配置类型设置函数
函数定义：
esp_err_t esp_smartconfig_set_type(smartconfig_type_t type); 参数说明：
smartconfig_type_t type:配置类型，在这个实验里选择 SC_TYPE_ESPTOUCH 返回值：ESP_OK（成功）。

 SmartConfig 开始一键配置
函数定义：
esp_err_t esp_smartconfig_start(sc_callback_t cb, …); 参数说明：
sc_callback_t cb:smartconfig 的回调函数，从回调函数里可以得到 smartconfig 的结果返回值：ESP_OK（成功）。

 SmartConfig 一键配置回调函数
函数定义：
void (*sc_callback_t)(smartconfig_status_t status, void *pdata); 参数说明：
smartconfig_status_t status:smartconfig 状态，这是一个枚举，具体定义在后面有说明返回值：无

 SmartConfi