在2025年5月27日之前，最新的esp-idf5.4.1版本下，总共有6种配网形式

分别是softap、bluetooth low energy、blufi、smartconfig(分为esptouch和airkiss)、esp-easy-connect、web配网

！！！注意，一下所有例程都是esp-idf5.4.1版本下的，其余版本下路径可能会不一样

对应手机app要的权限一定要给，比如开启蓝牙定位什么的

苹果手机有链接的去链接下，没有的去苹果应用商店

SoftAP 配网：

ESP32 会建立一个 Wi-Fi 热点，用户将手机连接到这个热点后将要连接的 Wi-Fi 信息发送给 ESP32。这种配网模式需要用户手动连接到 ESP32 的热点网络，这会让用户感到奇怪和不友好，不过这种方式很可靠，设备端的代码也简单。

官方文档：

​​​​​​SoftAP 配网和 Bluetooth Low Energy 配网 — ESP-Moonlight 文档

对应官方例程：

esp-idf/examples/provisioning/wifi_prov_mgr at v5.4.1 · espressif/esp-idf · GitHub

softap和bluetooth low energy的配网例程是一样的，只需要改变menuconfig的选项，选择其中一个即可

需要安装对应的手机APP为ESP SoftAP Prov,去谷歌应用商店下载，需要“魔法”

手机端操作界面为

注意，毕竟都叫做softap了，扫描那个二维码后会连接esp的ap的

Bluetooth Low Energy 配网：

ESP32 会进行 Bluetooth Low Energy 广播，附近的手机收到该广播后会询问用户是否进行 Bluetooth Low Energy 连接，如选择连接，则手机即可将信息发送给 ESP32。在这个的过程中用户无需切换 Wi-Fi 网络，但是需要打开蓝牙，用户体验相对 SoftAP 配网好一些。但是，需要在设备端加入蓝牙相关代码，这会增加固件的大小，并在配网完成前占用一定内存。

这个官方文档和softap的一样

 对应官方例程：

esp-idf/examples/provisioning/wifi_prov_mgr at v5.4.1 · espressif/esp-idf · GitHub

需要安装对应的手机APP为ESP BLE Prov,去谷歌应用商店下载，需要“魔法”

手机端操作界面为

BluFi 配网:

在本节的例程中使用的是 Bluetooth Low Energy 的配网方式，ESP32 上提供了一个完整的解决方案——BluFi。它是一个基于蓝牙通道的 Wi-Fi 网络配置功能，通过安全协议将 Wi-Fi 配置和证书传输到 ESP32，然后 ESP32 可基于这些信息连接到 AP 或建立 SoftAP。

需要安装对应的手机APP为EspBluFi,去谷歌应用商店下载，需要“魔法”

对应官方介绍SoftAP 配网和 Bluetooth Low Energy 配网 — ESP-Moonlight 文档

对应手机APP下载连接https://github.com/EspressifApp/EspBlufiForAndroid/releases

对应例程为https://github.com/espressif/esp-idf/tree/v5.4.1/examples/bluetooth/blufi

注意，不只可以使用手机APP，也可以使用微信小程序（官方和第三方的都可以，第三方的下面会提到，官方的在文档中）

其手机APP下载链接https://github.com/EspressifApp/EspBlufiForAndroid/releases

Smartconfig 配网：

SmartConfigTM 是由 TI 开发的配网技术，用于将新的 Wi-Fi 设备连接到 Wi-Fi 网络。它使用移动应用程序将无线网凭据从智能手机或平板电脑端广播给未配网的 Wi-Fi 设备。

这项技术的优势在于，设备无需直接获知 AP 的 SSID 或密码，而是通过智能手机获取。这对于没有用户界面的无头设备和系统而言十分重要。

目前， ESP32 支持三种类型的 SmartConfig 配网： Airkiss、ESPTouch 和 ESPTouch v2。ESPTouch v2 自 SmartConfig v3.0 （SmartConfig 的版本可以从 esp_smartconfig_get_version() 获取）起开始支持，ESPTouch v2 和 vESPTouch 采用完全不同的配网算法，因此配网速度更快。此外，ESPTouch v2 还增加了 AES 加密功能和自定义数据字段。

从 SmartConfig v3.0.2 开始，ESPTouch v2 的 AES 加密支持随机 IV。在应用程序端，当随机 IV 的选项关闭的时候，默认的 IV 为 0，与旧版本保持一致，当随机 IV 的选项打开的时候，IV 为随机值。需要注意的是，当启用 AES 加密且 IV 为随机值时，配网时间会延长，因为需要将 IV 传输到配网设备。在配网设备端，设备会根据配网包中的 flag 来识别 AES 的随机 IV 是否开启。

这种方式不需要建立任何通信链路，手机端通过发送不同长度的 UDP 广播包来表示 Wi-Fi 信息，ESP32 在混杂模式监听信号覆盖范围内的所有数据帧，通过一定算法得到 Wi-Fi 信息。缺点是配网成功率受环境的影响较大（其实也还好，没那么严重）。

划重点：airkiss为微信配网，也可以通过扫描二维码配网成功

官方文档介绍为SmartConfig - ESP32 - — ESP-IDF 编程指南 v5.4.1 文档

例程https://github.com/espressif/esp-idf/tree/v5.4.1/examples/wifi/smart_config

对应手机App可以从谷歌应用商店下载esptouch

Wi-Fi Easy ConnectTM (DPP):

Wi-Fi Easy ConnectTM 是 Wi-Fi Alliance 认证的配网协议，也称为设备配网协议 (DPP) 或 Easy Connect，是一种安全和标准化的 Wi-Fi 设备配网协议。使用 Easy Connect 将新设备添加入网就像扫描二维码一样简单，特别是对于没有 UI 的智能家居和物联网产品而言，大大降低了联网复杂性，加强了的用户体验。与旧的协议如 Wi-Fi Protected Setup (WPS) 等旧协议相比，Wi-Fi Easy Connect 的公钥加密技术额外确保了添加新设备时的网络安全。

Easy Connect 从以下几个方面改善了用户体验：

• 操作简单直观，设置新设备时无需阅读冗长的指南

• 无需记住需配网设备的密码或输入密码

• 支持电子/打印的二维码以及其他人类可读的字符串

• 同时支持 WPA2 和 WPA3 网络

如需了解更多信息，请参考 Wi-Fi Alliance 的官方介绍：Easy Connect。

ESP32 支持 Easy Connect 的二维码配网模式，用户需要使用显示器显示二维码，随后使用兼容的设备（安卓10及以上）扫描此二维码，并将 ESP32 添加到自己的 Wi-Fi 网络中。此兼容设备需连接到无需支持 Wi-Fi Easy ConnectTM 的 AP 上。

Easy Connect 协议仍在不断发展。目前已知支持二维码的平台为部分运行 Android 10 及更高系统版本的 Android 智能手机等。使用 Easy Connect 时，无需在智能手机上安装额外的应用程序。

对应官方文档为Wi-Fi Easy ConnectTM (DPP) - ESP32 - — ESP-IDF 编程指南 v5.4.1 文档

对应例程为https://github.com/espressif/esp-idf/tree/v5.4.1/examples/wifi/wifi_easy_connect/dpp-enrollee

这个例程使用的时候需要注意，他会在日志中生成一个QR码，如果你这边生成的QR码有问题，直接将QR码下面的连接放进浏览器也会生成QR码；这个QR码是让wifi里面的扫一扫去扫的（此时你手机必须得连接网络才能扫），他会直接连接上你手机所连网络

WEB 配网：

在 ESP32 上建立热点，使用手机连接上后在浏览器打开配置网页，在网页中完成配网，这种方式很可靠，而且允许在电脑端完成配网，缺点是需要在设备端占用空间来嵌入网页。

这个就很难绷了，我没找到对应例程，但在其他例程中可以使用web配网，可以将其web配网部分解耦出来单独使用

例程https://github.com/espressif/esp-iot-bridge/tree/master/examples/wifi_router

这个例程使用起来有很大难度，极大概率折腾废

总结：

配网方式对比

	softap	bluetooth low energy	blufi	smartconfig	wifi-easy-connect	web配网
是否可以扫码配网	是	是	否	是	是	否
是否可以只对特定设备配网	是	是	否	否	是	是
是否可以同时为多个设备配网	否	否	是	是	否	否
配网时手机是否需要连接外部网络	需连接esp32的ap	否	否	是（连接外部网络不是esp32的ap）	否	需连接esp32的ap

微信安信可IOT小程序可以实现AirKiss配网和BluFi配网以及其他功能（不是配网的）

！！！注意，碰到问题后先看上述注意点和有颜色字体