ESP32 AP模式下SmartConfig配网实践

admin 管理员组

文章数量: 1184232

ESP32 AP模式下SmartConfig配网实践

在智能家居设备日益普及的今天，你有没有遇到过这样的尴尬场景：新买的智能插座通上电，手机App提示“请连接设备热点进行配网”，于是你不得不退出自家Wi-Fi，连上一个叫 ESP_XXXX 的陌生网络——结果App卡住不动，配网失败，重启再试……反复三遍后，怒摔手机？😤

这背后的问题，正是 无屏设备联网体验差 的经典痛点。而我们今天的主角—— ESP32 在 AP 模式下实现 SmartConfig 配网 ，就是要彻底打破这种“断网—重连—失败—崩溃”的魔咒。

别急，这不是又要你先连热点再手动填密码。我们要玩点高级的：让 ESP32 一边当热点供你访问本地网页，一边偷偷监听手机发来的 Wi-Fi 配置信息 ，全程无需切换网络，真正做到“零感知配网”。

听起来像魔法？其实原理很清晰，关键就在于—— AP+STA 双模共存 + SmartConfig 隐式通信 。

想象一下这个画面：

你的 ESP32 上电后自动开启 Soft-AP 热点（比如 SSID 是 MySensor-1234 ），你用手机连上去，打开浏览器就能看到一个本地网页，显示当前温湿度、设备状态，甚至还能远程控制继电器。与此同时，在你不察觉的情况下，它正竖着“耳朵”监听空中飞过的 UDP 广播包。

你在 App 里输入家里的 Wi-Fi 账号密码，点击“一键配网”。下一秒，App 就通过局域网广播一串加密的 UDP 数据包，这些数据包本身并不直接发送给 ESP32，但它们的“长度”或“TOS 字段”被巧妙编码成了比特流——就像摩斯电码藏在心跳声里 ❤️。

ESP32 捕捉到这些“隐形信号”，默默解码出 SSID 和密码，尝试连接你家路由器。一旦成功，它会亮起绿灯，或者通过本地网页弹出提示：“已接入家庭网络！” 整个过程，你始终连着它的热点，没切过一次 Wi-Fi。

是不是有点酷？

那问题来了：为什么普通的 AP 模式做不到这一点？🤔

因为 SmartConfig 的本质是 抓空口报文 ，也就是所谓的“混杂模式”（Promiscuous Mode）。而这个能力，只有当 ESP32 启用了 Station 功能时才会激活。纯 AP 模式下，芯片只负责发 Beacon 帧、管理客户端连接，根本不会去监听外面的世界发生了什么。

所以，单独的 AP ❌
单独的 STA ✅
但我们需要的是： AP + STA 共存！

幸运的是，ESP32 支持 WIFI_MODE_APSTA 模式，允许它同时扮演“热点”和“客户端”两个角色。哪怕 STA 不主动连接任何网络，只要开启了这个接口，就可以用来监听 SmartConfig 广播包。

这就给了我们极大的灵活性：AP 提供本地服务（Web 页面、OTA 升级、调试接口），STA 则专职监听配网指令，互不干扰，各司其职。

来看一段核心代码，看看怎么把这套机制跑起来：

void wifi_init_ap_sta(void)
{
    ESP_ERROR_CHECK(esp_netif_init());
    ESP_ERROR_CHECK(esp_event_loop_create_default());

    // 创建 AP 和 STA 网络接口
    esp_netif_create_default_wifi_ap();
    esp_netif_create_default_wifi_sta();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    // 配置 AP 参数
    wifi_config_t ap_config = {
        .ap = {
            .ssid = "MyDevice_AP",
            .ssid_len = strlen("MyDevice_AP"),
            .password = "12345678",
            .max_connection = 4,
            .authmode = WIFI_AUTH_WPA2_PSK
        },
    };

    // STA 配置为空，仅用于监听 SmartConfig
    wifi_config_t sta_config = {0};

    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_APSTA));
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &ap_config));
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &sta_config));
    ESP_ERROR_CHECK(esp_wifi_start());

    // 稳定一下 AP，避免刚启动就丢包
    vTaskDelay(pdMS_TO_TICKS(1000));

    // 开始监听 SmartConfig
    start_smartconfig();
}

这段代码的关键点有几个：

• 必须调用 esp_netif_create_default_wifi_ap() 和 _sta() 分别创建两个网络层接口；
• 设置模式为 WIFI_MODE_APSTA ；
• STA 的配置可以为空，因为我们不打算让它主动连任何网络；
• 建议延时 1 秒再启动 SmartConfig，确保 AP 已稳定运行，否则可能影响广播接收成功率。

接着是 SmartConfig 的启动逻辑：

void start_smartconfig(void)
{
    ESP_ERROR_CHECK(esp_smartconfig_set_type(SC_TYPE_ESPTOUCH));

    smartconfig_start_config_t cfg = SMARTCONFIG_START_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_smartconfig_start(&cfg));

    xTaskCreate(smartconfig_task_handler, "smartconfig_task", 4096, NULL, 3, NULL);
}

事件处理任务也很简单：

static void smartconfig_task_handler(void *parm)
{
    EventBits_t uxBits;
    while(1) {
        uxBits = xEventGroupWaitBits(s_wifi_event_group,
                                     SC_EVENT_BIT_START | SC_EVENT_BIT_DONE,
                                     pdTRUE, pdFALSE, portMAX_DELAY);

        if (uxBits & SC_EVENT_BIT_START) {
            ESP_LOGI(TAG, "🎉 SmartConfig 已启动，等待手机发送配置...");
        }

        if (uxBits & SC_EVENT_BIT_DONE) {
            esp_smartconfig_stop();
            ESP_LOGI(TAG, "✅ 配网完成！设备将尝试连接目标网络");
            vTaskDelete(NULL);
        }
    }
}

一旦收到 SC_EVENT_GOT_SSID_PSWD 事件，系统就会自动尝试连接目标路由器。你可以在 Wi-Fi 事件回调中进一步处理连接结果，比如更新 LED 状态、通知本地 Web 页面等。

不过，理想很丰满，现实也有坑 🕳️

我们在实际项目中发现几个必须注意的细节：

🔧 信道一致性问题

SmartConfig 要求手机和 ESP32 处于 同一信道 才能可靠接收。而默认情况下，ESP32 的 AP 可能随机选择信道（1~11），如果手机连上的时候恰好不在同一个频道，那就听不到广播了。

✅ 解决方案： 固定 AP 的信道 ，比如设为信道 6。

.ap.channel = 6,

这样手机连接后大概率在同一信道，大幅提升配网成功率。

🛡 手机系统防火墙拦截

尤其是小米 MIUI、华为 EMUI 这类深度定制系统，出于安全考虑，默认会阻止 App 发送 UDP 广播包，导致 SmartConfig 根本发不出去。

✅ 应对策略：
- 在 App 中引导用户关闭“省电模式”或“安全加固”；
- 提示用户手动授予“允许后台自启动”和“允许使用无线设置”权限；
- 或者改用 AirKiss 协议（微信生态专用），兼容性更好。

⏳ 超时与用户体验设计

别让用户干等着！建议设置最大等待时间为 60 秒，超时后自动停止 SmartConfig，并给出明确提示。

同时，加入视觉反馈机制：
- LED 呼吸灯表示“正在等待配网”；
- 快闪表示“配网成功”；
- 网页端显示倒计时进度条；
- 配网失败后支持一键重试。

这些小细节，决定了产品到底是“极客玩具”还是“用户友好型设备”。

💾 非易失存储：NVS 的妙用

配网成功后，记得把 SSID 和密码保存到 NVS（Non-Volatile Storage）中：

nvs_handle_t handle;
ESP_ERROR_CHECK(nvs_open("wifi", NVS_READWRITE, &handle));
ESP_ERROR_CHECK(nvs_set_str(handle, "ssid", ssid));
ESP_ERROR_CHECK(nvs_set_str(handle, "pass", password));
ESP_ERROR_CHECK(nvs_commit(handle));
nvs_close(handle);

下次开机时读取 NVS，自动尝试连接上次的网络，真正实现“一次配置，永久记忆”。

📈 内存与性能权衡

AP+STA 双模运行比单模多消耗约 30~50KB RAM。对于资源紧张的设备（如 ESP32-PICO-D4），建议：
- 使用轻量级 Web 服务器（如 httpd 而非 Netty ）；
- 关闭不必要的日志输出；
- 或外挂 PSRAM 型号（如 ESP32-WROVER）提升缓存能力。

最后说说应用场景，你会发现这个技术真的非常实用：

🏠 智能家居中继器

设备出厂即开启 AP，你可以连上去配置它作为信号放大器，告诉它主路由的账号密码，它就能自动桥接并扩展 Wi-Fi 覆盖范围，整个过程不影响你查看设备状态页面。

🏭 工业传感器节点

部署在现场的温湿度传感器没有屏幕，但需要接入厂区内部网络。工人拿着手机连上设备热点，输入内网 Wi-Fi 信息，几秒钟完成配网，立即上传数据至本地服务器，无需联网互联网。

🧪 医疗设备调试

医院中的监护仪需定期升级固件。工程师现场连接设备热点，不仅可查看运行日志，还能重新配置其连接医院专网，所有操作离线完成，符合信息安全规范。

总结一下，虽然标题写着“AP模式下SmartConfig”，但真正的答案是： 不能只用 AP，必须启用 AP+STA 双模共存 。

但这不是缺陷，而是智慧的设计选择。ESP32 强大的双 Wi-Fi 接口能力，让我们可以在提供本地服务能力的同时，无缝集成远程联网功能，既满足开发调试需求，又保障最终用户的易用性。

✅ 实践建议：初学者不妨先跑通官方 smart_config 示例，验证基础功能；然后再叠加 AP 功能，逐步整合本地服务。调试时可用 Wireshark 抓包分析 UDP 广播是否正常发出，事半功倍！

这种“一边当热点，一边听指令”的配网逻辑，不只是技术炫技，更是物联网产品走向成熟的标志之一。未来，随着 Matter、Thread 等新协议兴起，配网方式还会进化，但在当下， SmartConfig + APSTA 双模方案，依然是最成熟、最稳定、最接地气的选择 。🚀

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

本文标签： 模式下 AP SmartConfig