涂鸦模组配网流程（详细中文描述）

涂鸦智能双模模组（BLE + Wi‑Fi）配网流程详解

前言

在智能家居场景下，涂鸦智能的双模（BLE + Wi‑Fi）模组能兼顾本地和云端两种接入方式，大大提升了配网的成功率和用户体验。本文将从模组上电开始，结合 BLE 与 Wi‑Fi 的状态值，逐步拆解完整的配网、绑定、切换逻辑，并附上状态对照表，帮助开发者快速掌握涂鸦模组的工作流程。

---

一、绑定 & 状态概念梳理

• 绑定（Binding）
  指设备在首次成功连入涂鸦云端后，自动与当前 App 用户账号建立“主人关系”，后续可远程访问与控制。
• 状态值含义

  类型	状态值	描述
  WIFI_STATE	0x00	快连配网（EZ 模式）
  	0x01	热点配网（AP 模式）
  	0x02	已配置 Wi‑Fi，正在连接路由器
  	0x03	已连路由器，未连云端
  	0x04	✅ 已连云端，云端在线
  	0x05	低功耗模式
  	0x06	混合模式（EZ + AP 双通道）
  BLE_STATE	0x00	未绑定，未连接
  	0x01	未绑定，已连接（BLE 配网阶段）
  	0x02	已绑定，未连接（云端控制阶段）
  	0x03	已绑定，已连接（本地 BLE 控制）
  	0x04	未知状态

---

二、初始化：模组上电

1. WIFI_STATE = 0x01
   • 模组进入热点配网（AP）模式，自动打开 Wi‑Fi 热点（SSID 如 SmartLife‑xxxx）。
2. BLE_STATE 暂无上报
   • BLE 开启广播，但尚未与 App 建立连接，不会上报 BLE_STATE。

---

三、优先 BLE 配网

1. App 扫描并连接 BLE
   • 手机打开蓝牙，App 搜索到模组 BLE 广播后发起连接。
2. BLE_STATE = 0x01
   • 模组上报“未绑定，已连接”，进入 BLE 配网阶段。
3. 下发 Wi‑Fi 配置信息
   • App 通过 BLE 通道发送路由 SSID、密码及区域参数。

---

四、备用 AP 热点配网

当 BLE 不可用或禁用时，App 会提示“手动配网”。

1. 用户连接 AP 热点
   • 手机在 Wi‑Fi 设置中选择 SmartLife‑xxxx。
2. 通过本地通道下发 Wi‑Fi 配置
   • App 在热点网络下，通过局域网协议将 SSID、密码下发给模组。

---

五、Wi‑Fi 连接与自动绑定

模组收到配网信息后自动切换到 STA 模式并尝试连接路由器。

1. WIFI_STATE = 0x02
   • 收到配网参数，正在连接路由器
2. WIFI_STATE = 0x03
   • 成功连接路由器，但未连上涂鸦云
3. WIFI_STATE = 0x04
   • 成功连接云端，设备在线
4. 自动完成绑定
   • 首次连云后，模组与当前用户账号绑定
   • BLE_STATE → 0x03（已绑定，已连接）
   • App 随后可断开 BLE，BLE_STATE → 0x02（已绑定，未连接）

---

六、本地与云端控制切换

• 云端在线（WIFI_STATE = 0x04）
  • App 优先走云端通道控制
  • BLE 连接处于“已绑定未连接”状态 (0x02)
• 云端不可达（WIFI_STATE < 0x04）
  • App 若在本地范围内，会自动切换到本地 BLE 控制
  • BLE_STATE = 0x03

---

七、恢复出厂 / 解绑

若用户通过 App “移除设备”或 MCU 发送清除配网命令：

1. 清除配网与绑定信息
2. 回到初始热点待配网（WIFI_STATE = 0x01）
3. BLE_STATE = 0x01（未绑定，已连接）

---

八、流程关键点回顾

1. 上电 → 默认热点配网（AP）
2. 检测 BLE → 若可用则走 BLE 配网 (BLE_STATE=0x01)
3. 下发 Wi‑Fi → BLE 或 AP 两种方式
4. 连接路由 → WIFI_STATE：0x02→0x03→0x04
5. 自动绑定 → BLE_STATE：0x03→断开→0x02
6. 控制切换 → 云端在线走云控，断网时切 BLE

---

结语

本文全面梳理了涂鸦智能双模模组的配网、绑定与控制切换流程，希望对快速集成与故障排查有所帮助。若有更多问题，欢迎留言交流！