一、WiFi配网概述：从零开始理解这件事
大家好，我是你们这门课的老朋友。做嵌入式这些年，我经手过不下几十种物联网模块——从早期的ESP8266到现在的各种WiFi+BLE SoC。每次给新人培训，我总会先问一个问题：“WiFi配网，到底配的是什么？”
很多人第一反应是“让设备连上路由器”。嗯，这话没错，但只说对了一半。今天咱们就把这件事彻底掰开揉碎，看看它的本质到底是什么。
1.1 什么是WiFi配网？
WiFi配网，说白了就是把路由器的SSID和密码，安全地告诉一个没有屏幕、没有键盘的物联网设备。
你想想看，我们手机连WiFi，打开设置列表，点一下，输密码，搞定。但一个智能灯泡、一个插座、一个传感器——它没有界面，你怎么告诉它“我家路由器的名字叫TP-LINK_5G，密码是12345678”？
这个过程，就是配网。
核心定义：WiFi配网 = 将无线网络凭证（SSID + Password）从配网终端（通常是手机App）传输到目标物联网设备的过程。
我在早期做智能家居项目时，遇到过最头疼的事：用户买回去一个WiFi插座，折腾半小时连不上网，最后退货。原因是什么？配网体验太差。所以你看，配网这件事，技术门槛不高，但用户体验的门槛极高。
1.2 配网的本质：一场“先有鸡还是先有蛋”的博弈
这里有个关键矛盾，我当年也是踩了坑才真正理解——
物联网设备要连WiFi，它得知道WiFi的SSID和密码。但它怎么知道？它自己还没连上WiFi呢！
这就陷入了一个死循环：
设备需要联网 → 需要WiFi凭证 → 但获取凭证本身需要一种通信方式 → 这种通信方式又不能依赖WiFi
所以，配网的本质，就是利用设备已有的另一种通信能力，来“捎带”传递WiFi凭证。
这种“另一种通信能力”是什么？
- 可能是设备自己先开一个WiFi热点（AP模式）
- 可能是利用WiFi数据帧中的某些字段“偷偷”传数据（SmartConfig）
- 可能是通过蓝牙、NFC、声波等非WiFi通道来传
嗯，这里要注意：配网不是目的，只是手段。配网完成后，设备连上路由器，进入正常工作状态，配网通道就可以关闭了。
我的经验：配网阶段是整个物联网产品中故障率最高的环节。我见过太多产品，正常工作很稳定，但第一次配网成功率不到60%。所以，配网设计一定要考虑异常重试、超时处理、用户反馈——这些细节决定了产品口碑。
1.3 常见配网方式对比
目前主流的配网方式有三种。我按自己的项目经验，给大家逐一拆解。
1.3.1 AP模式（热点模式）
这是最传统、兼容性最好的方式。原理很简单：
- 设备上电后，自己先开一个WiFi热点（比如叫“SmartBulb_XXXX”）
- 手机连上这个热点
- 手机App通过Socket/UDP把路由器信息发给设备
- 设备收到后，关闭热点，连上目标路由器
我记得2015年做第一个智能灯项目时，用的就是AP模式。当时觉得这方法太笨了——用户要手动切换WiFi连接，体验很割裂。但后来发现，笨有笨的好处：兼容性最好，几乎不会失败。
避坑指南：我曾经遇到过一个坑——某些Android手机在连接设备热点时，会自动检测到“该网络无法访问互联网”，然后弹窗提示是否切换回有网的WiFi。用户一不小心点错，配网就中断了。解决方案：在App端增加引导提示，或者让设备热点伪装成有互联网接入。
1.3.2 SmartConfig（智能配置）
SmartConfig是TI（德州仪器）提出的一种配网技术，后来被乐鑫（Espressif）发扬光大。它的核心思路是：利用WiFi数据帧的Length字段来编码信息。
具体原理：
- 手机App发送一系列UDP广播包
- 这些包的长度被精心设计，用来表示0和1
- 设备处于混杂模式（Promiscuous Mode），监听所有WiFi数据帧
- 设备解析帧长度，还原出SSID和密码
这样做的好处是：用户不需要切换WiFi连接，体验非常流畅。但缺点也很明显：
- 对路由器环境敏感（5GHz信道、加密方式都可能影响）
- 成功率不如AP模式稳定
- 需要设备芯片支持混杂模式
我个人的习惯是：SmartConfig作为首选方案，AP模式作为降级备用方案。这样既保证了大部分用户的流畅体验，又给极端情况留了后路。
1.3.3 蓝牙辅助配网
这是目前中高端物联网产品的主流方案。设备同时集成WiFi和蓝牙（BLE），配网流程变成：
- 手机通过BLE发现设备
- 通过BLE通道发送WiFi凭证
- 设备收到后，用WiFi连上路由器
- 配网完成，BLE通道可以关闭或保留用于后续控制
为什么这个方案越来越流行？因为BLE是双向、可靠的通信通道，不像SmartConfig那样“单向广播、听天由命”。而且BLE还能做设备发现、绑定、甚至后续的本地控制。
但代价是：硬件成本增加（需要双模芯片或两颗芯片），功耗和体积也会上升。
1.4 三种配网方式对比表
| 对比维度 | AP模式 | SmartConfig | 蓝牙辅助配网 |
|---|---|---|---|
| 用户体验 | 需手动切换WiFi，较繁琐 | 一键配网，体验流畅 | 自动发现，体验最佳 |
| 配网成功率 | 极高（>99%） | 中等（80-95%，依赖环境） | 高（>95%） |
| 硬件要求 | 仅需WiFi | 需支持混杂模式 | 需WiFi+BLE双模 |
| 成本 | 最低 | 低 | 较高 |
| 安全性 | 中等（热点可能被嗅探） | 较低（广播易被截获） | 高（BLE加密通道） |
| 典型应用 | 低成本设备、工业场景 | 智能家居单品 | 中高端智能设备 |
1.5 配网方式的选择策略
说了这么多，到底该选哪种？我给大家一个决策思路：
- 成本敏感、功能简单 → AP模式（比如智能插座、开关）
- 追求体验、环境可控 → SmartConfig（比如智能灯泡、传感器）
- 中高端产品、需要双向通信 → 蓝牙辅助配网（比如智能门锁、摄像头）
- 最稳妥的方案 → AP模式 + SmartConfig双模，自动切换
我的建议：如果你正在设计一款新产品，优先考虑蓝牙辅助配网。虽然成本高一点，但用户体验的提升是值得的。用户不会记得你的产品有多便宜，但一定会记得配网时有多折腾。
1.6 本章知识结构图
下面这张图，把WiFi配网的核心概念和三种方式的关系梳理清楚了：
1.7 小结
这一章我们聊了三个核心问题：
- WiFi配网是什么——传递网络凭证的过程
- 配网的本质——利用设备已有的通信能力打破“先有鸡还是先有蛋”的困局
- 三种主流方式——AP模式、SmartConfig、蓝牙辅助配网，各有优劣
配网是物联网设备的第一道门槛。这道门槛跨得好不好，直接决定了用户对产品的第一印象。后面的章节，我会带大家逐一深入每种配网方式的代码实现、调试技巧和实战踩坑记录。