1. 介绍

传统的一键配网指的是smartconfig、airkiss这些通过已经连接的无线路由器发送广播给设备，在使用过程中兼容性差、不稳定，

很多路由器不支持udp广播如果广播通过5G频段广播，设备无法收到路由器名称冲突会导致连接错误路由器等问题这两个协议都封装的比较多，不便于自己控制

根据微信官方提供API能力中的WiFi、UDP能力，可以用来开发Soft AP配网。加上良好的设计，可以实现一键配网的体验。同时成功率、适配率大大提升。

首先约定协议

2. 基础描述

WiFi设备进入配网状态，实际是进入AP模式，设备开放一个Wifi热点出来。手机通过连接上设备Wifi模块的热点，将路由器名字和密码直接发送给Wifi设备，同时从Wifi设备那边拿到MAC地址，然后与云端校验。

2.1. 各端交互流程图

此图来自腾讯云

3. 操作过程 用户长按按钮，触发WiFi设备进入配网模式。设备在此模式下创建wifi热点（单纯AP模式），开启UDP服务（默认 IP 为192.168.4.1，端口为8266），使指示灯闪烁小程序按照提示依次获取 Wi-Fi 列表，输入家里目标路由器的 SSID/PSW，再选择设备 softAP 热点的 SSID/PSW。手机连接设备 softAP 热点成功后，小程序作为 UDP 客户端会连接 Wi-Fi 设备上面的 UDP 服务。小程序给设备 UDP 服务，发送目标 Wi-Fi 路由器的 SSID/PSW 以及配网 Token，JSON 格式为： { "cmdType":1, "ssid":"Home-WiFi", "password":"abcd1234" } 属性名属性描述类型cmdType消息类型，手机向设备发送为1整数ssidWi-Fi 的 SSID字符串passwordWi-Fi 的 密码字符串

发送完成后，等待设备 UDP 回复设备信息及配网协议版本号：

{ "cmdType":2, "mac":"xxxxxxxx", "protoVersion":"2.0" } 属性名属性描述类型cmdType消息类型，设备手机发送正常响应为2整数mac设备的mac，无分隔符字符串固件版本固件的版本字符串

如果配网过程中出错，需要退出配网操作，那么响应

{ "cmdType":3, "log":"错误描述" } 属性名属性描述类型cmdType消息类型，设备手机发送异常响应为3整数log错误描述字符串

如果2秒之内，未收到设备回复，则重复步骤4，UDP 客户端重复发送目标 Wi-Fi 路由器的 SSID/PSW 。（如果重复发送5次，都没有收到回复，则认为配网失败，Wi-Fi 设备有异常）

如果步骤4收到设备回复，则说明设备端已收到 Wi-Fi 路由器的 SSID/PSW，正在连接 Wi-Fi 路由器，并连接物联网平台。此时小程序会提示手机也将连接 Wi-Fi 路由器，并轮询物联网后台，来确认配网及设备绑定上线成功。

设备端在成功连接 Wi-Fi 路由器后，通过 MQTT 连接物联网后台。如果连接不上，那么重新进入配网模式，指示灯再次闪烁

4. 设备热点信息规范 项描述SSID前缀"z_"加mac地址，如z_483FDA5319D0密码固定为z111111

设备端可以记录配网日志，如果配网或连接失败，可以在下次连接时向手机端反馈

{ "cmdType":31, "log":"错误描述" } 属性名属性描述类型cmdType消息类型，设备手机发送异常响，前一次日志类型为31整数log错误描述字符串 5. 实现过程 第一步，先分按钮验证 startWifi() { console.log('开始wifi接口'); wx.startWifi({ complete (res) { console.log(res) } }) }, connectWifi() { // 连接wifi wx.connectWifi({ SSID: 'TEST', forceNewApi: true, password: 'test1234', complete (res2) { console.log(res2) } }) }, connectUDP() { // 建立udp连接 debugger this.udp = wx.createUDPSocket() if(this.udp === null){ console.log('暂不支持') return ; } this.udp.connect({ address: '192.168.4.1', port: 8266 }) this.udp.bind() this.udp.onListening(function(res4){ console.log('4监听中...') console.log(res4) }) this.udp.onMessage(res3 => { console.log('3监听中...') console.log(res3); }) }, sendDataUDP() { const msgData = { "cmdType":1, "ssid":"31", "password":"fff316" } this.udp.send({ address: '192.168.4.1', port: 8266, message: JSON.stringify(msgData) }) }, 测试按钮 <u-button @click="startWifi()">1</u-button> <u-button @click="connectWifi()">2</u-button> <u-button @click="connectUDP()">3</u-button> <u-button @click="sendDataUDP()">4</u-button> 5. 加入业务实现

这里设计至少三个页面

设备状态确认页家庭wifi信息输入页配网过程页

---

1.本站遵循行业规范，任何转载的稿件都会明确标注作者和来源；2.本站的原创文章，会注明原创字样,如未注明都非原创，如有侵权请联系删除！；3.作者投稿可能会经我们编辑修改或补充；4.本站不提供任何储存功能只提供收集或者投稿人的网盘链接。