在线文档

Haivivi 云端服务模拟器使用指南

绑定与解绑

完成 登录 → 输入 SN → 选择设备(模拟设备)后,左侧设备区点击「添加设备」发起绑定。真实设备模式可直接「添加设备」,无需右侧选 SN。

5.1 绑定新设备(正常流程)

  1. 模拟设备:确认右侧已选中目标 SN,且已开机、处于「待配网 / BLE 广播」。真实设备:确认设备开机并广播蓝牙
  2. 添加设备 → 选择「新记忆体」(无记忆体时跳过)→ 下一步
  3. 蓝牙扫描完成后,在列表中点选目标设备 → 同页填写 WiFi → 点击「开始绑定」
    • 选错设备可点「上一步」回到列表重选;列表底栏「忽略」可关闭弹窗
    • 模拟设备:SSID/密码须与顶栏当前模拟环境一致,否则提示「WiFi 不正确,请输入与右上角模拟环境一致的 WiFi」
    • 真实设备:填写设备实际要连接的路由器 WiFi;顶栏模拟网络不可用。WiFi 页上方可选 固件协议(见下)
  4. 成功后提示「绑定完成」,设备就绪,默认「对讲模式」

绑定流程始终下发完整配网包(含 UAT、API/MQTT 坐标等)。若设备已在当前账号下,仍会重新推送全量配置并等待上线确认,不会改成「仅更新 WiFi」。

真机固件协议(仅真实设备 WiFi 页显示;模拟设备固定 V2):

选项 适用 说明
V2(默认) H101 / H202 等 V2 固件 使用现行 @setup 配网;以 BLE 联网状态确认成功
V1 H100 / H200 等 V1 固件(Pal App 兼容) 下发 palgear/v1 与 MQTT TCP/TLS 坐标;不以 BLE 联网状态为准,改等服务端绑定落库 + 设备 MQTT 首帧上线(最长约 90 秒)

选错协议会导致配网 JSON 解析失败或长时间卡在「等待设备上线」,请按设备实际固件选择。

绑定进行中,左侧步骤条会逐步点亮:

  1. 权限及网络正常
  2. 扫描蓝牙设备
  3. 选择设备
  4. 输入 WiFi 信息
  5. 连接设备
  6. 准备设备网络(BLE WiFi 扫描,唤醒模块并校准 ATT MTU)
  7. 下发配网配置
  8. 等待设备上线
  9. 建立设备绑定

步骤 6–8 的详细进度可在底部「手机」日志中查看。

5.2 使用已有记忆体绑定

  • 添加设备 →「使用已有记忆体」→ 单选一条 → 下一步
  • 无可选记忆体(均已绑定)时,按新记忆体流程继续

5.3 绑定失败

情况 处理
WiFi 与环境不一致(模拟) 提示 WiFi 不正确,修正 SSID/密码后重试
扫不到设备(模拟) 确认模拟设备已开机、待配网
真机扫不到 / 选不到 使用 Chrome;设备开机且 BLE 广播;选择 YD- 开头或带海威威厂商标识的设备;排查时可勾选「显示全部蓝牙设备」
无法确定设备 SN 浏览器未读到广播名 YD-{SN}。开启 Chrome「Experimental Web Platform features」并重启,确认设备正在广播后重新扫描
V1 绑定卡在等待上线 确认固件协议选 V1;查看日志是否出现等待 MQTT 首帧相关记录;必要时将 ATT MTU 设为 185
未发现可绑定设备 检查设备是否已被其他账号绑定

5.4 解绑设备

  1. 点击「设置」→ 「解绑」→ 确认「确定解绑设备 {SN}」
  2. 可选「保留记忆体与聊天记录」
  3. 解绑后 App 与设备绑定关系清除;服务端同步解绑

5.5 设备运行数据

绑定成功并选中设备后,左侧 App 设备卡片下方展示「设备运行数据」只读面板(云端观测视角):

面板 内容
设备运行数据 在线、状态、网络、对话模式、电量、音量、亮度、BLE 广播、绑定状态、固件、kid/vid 等

调节设置、切换角色、对话、点播后,面板随设备上报刷新;联调时可对照右侧「设备运行信息」与底部日志。