设备配网全流程

sequenceDiagram
    participant MP as 小程序
    participant ztUtil as ztUtil SDK
    participant ztmp
    participant hapi
    participant GW as 网关

    MP->>ztmp: 1. 登录
    ztmp-->>MP: { token }
    MP->>ztmp: 2. 创建家庭
    ztmp-->>MP: { id, private_key }
    MP->>ztmp: 3. 绑定网关
    ztmp-->>MP: { id }
    MP->>ztmp: 4. 添加子设备
    ztmp-->>MP: { id }
    MP->>ztmp: 5. 生成配网Token
    ztmp-->>MP: { token, sn }
    MP->>hapi: 6. 获取MQTT信息
    hapi-->>MP: { mq_id, mq_pass }
    MP->>ztUtil: 7. setMode(MODE_BLE)
    MP->>ztUtil: 8. connectBle() + configWifi()
    ztUtil->>GW: 8a. BLE AT+CWJAP="ssid","psk"
    GW->>hapi: 9. module/login (获取MQTT地址)
    hapi-->>GW: { mqtt_host, mqtt_port }
    GW->>GW: 10. 连接MQTT + BLE Mesh组网
    MP->>ztUtil: 11. setMode(MODE_MQTT) + connectMqtt()
    ztUtil->>GW: 11a. MQTT ble_in (拉取节点列表)
    GW-->>ztUtil: 11b. MQTT ble_out (node, meshKey)
    MP->>ztmp: 12. 记录配网状态

ztUtil 在配网中的角色

配网流程中 ztUtil 承担两个阶段的通信：

阶段一：BLE 配网（步骤 7-8）

• setMode(MODE_BLE) → 切换到蓝牙直连模式
• connectBle({ gatewayMacList }) → BLE 连接网关（Service FFE0）
• configWifi({ ssid, psk, gatewayMac }) → 通过 AT 命令下发 WiFi 凭据
• 网关连上 WiFi 后，固件自行调用 hapi module/login 获取 MQTT 地址

阶段二：MQTT 远程（步骤 11）

• setMode(MODE_MQTT) → 切换到 MQTT 远程模式
• connectMqtt({ serverUrl, username, password, ... }) → 通过 WSS 连接网关
• 后续设备控制/状态查询/场景执行均通过 MQTT 通道