如何向基于Raspberry Pi的IoT设备发送SSID与WiFi连接密码

主流无外设IoT设备的配网核心原理 #

Echo Dot这类无屏幕、无输入接口的封闭式IoT设备，配网逻辑本质是：设备首次启动/重置后进入待配网状态，通过临时通信通道接收用户端（手机APP/小程序）发送的WiFi凭证，拿到凭证后切换到用户指定的WiFi网络完成联网，同步完成账号绑定。

适合树莓派的3种可落地方案 #

方案1：SoftAP热点配网（兼容性最高，推荐作为基础方案） #

这是消费级IoT设备最常用的标配配网方式，实现成本低、适配所有路由器场景：

• 树莓派首次启动/长按重置按键后，自动开启自身WiFi热点，SSID可预设为你的产品名_XXXX（XXXX为设备序列号后4位），热点可设为无密码或通用初始密码
• 用户手机手动连接该热点后，打开配套APP/小程序，可自动发现同局域网下的设备，也可以直接访问设备内置的默认Web配置页（固定IP可设为192.168.4.1）
• 用户在配置页输入家庭WiFi的SSID和密码提交后，树莓派接收凭证，自动关闭自身热点，切换到STA模式连接目标WiFi，配网完成
• 树莓派端可通过LED灯提示状态：慢闪代表待配网、常亮代表配网成功、快闪代表配网失败

树莓派端实现细节：

• 用hostapd + dnsmasq组件实现热点开启和DHCP服务，配置文件提前预制到系统镜像中即可
• 写一个轻量Web服务监听配置请求，拿到SSID和密码后修改wpa_supplicant.conf配置，重启无线网络即可生效

优点：不依赖手机系统权限，所有路由器场景都能适配；缺点：需要用户手动切换一次热点，多一步操作。

方案2：蓝牙配网（操作更流畅，适合作为升级方案） #

适合带蓝牙模块的树莓派型号，用户操作步骤更少：

• 树莓派待配网状态下开启BLE广播，广播包携带设备标识信息
• 用户打开手机蓝牙和配套APP，APP自动扫描到附近待配网的设备，用户选中对应设备后输入WiFi密码
• APP将加密后的WiFi凭证通过蓝牙通道发送给树莓派，树莓派接收后关闭蓝牙广播，切换到STA模式连接目标WiFi完成配网

树莓派端实现细节：

• 用bluez蓝牙栈实现BLE广播和数据接收，用Python的pybluez库或者原生C开发都可以
• 注意对传输的WiFi凭证做对称加密，避免明文传输被抓包泄露

优点：用户无需切换热点，操作流程更短；缺点：需要用户授权手机蓝牙权限，部分老旧手机适配存在问题。

方案3：SmartConfig一键配网（体验最流畅，类似Echo Dot的无感配网） #

就是你提到的Echo Dot类设备用的无接触配网方案，原理如下：

用户手机连接家庭WiFi后，APP将SSID、密码信息编码到802.11数据帧的特定字段（比如数据包长度字段），发送广播/组播包；待配网设备的无线网卡开启混杂模式，监听空中的所有WiFi数据包，按照约定规则解码得到WiFi凭证。

树莓派端实现细节：

• 需要给树莓派的无线网卡开启混杂模式，自行实现对应编码协议的解码逻辑，也可以适配开源的ESP-Touch协议
• 该方案对路由器兼容性要求较高，部分开启了AP隔离、双频合一的路由器场景下配网成功率较低，建议作为可选配网方式，不要作为唯一方案

优点：用户不需要切换热点、不需要开蓝牙，操作几乎无感；缺点：兼容性不稳定，特殊网络场景下容易配网失败。

绑定逻辑闭环 #

树莓派成功连接WiFi后，将自身设备序列号、MAC地址等唯一标识上传到你的云服务端，和当前操作的用户账号做关联，即可完成设备绑定的全流程。

内容的提问来源于stack exchange，提问作者spike32