跳到主要内容

全流程与对接检查表

本页把指令参考整理成实际接入路径。以下报文全部使用合成标识符和仅用于测试的 PW DEMO00。

最小上线流程​

  1. 使用已批准的配置连接指定 MQTT Broker。
  2. 订阅 /{ProductKey}/{DeviceName}/user/get。
  3. 向 /{ProductKey}/{DeviceName}/user/update 发布设备消息。
  4. 发送 CN，未收到确认时每 60 秒重发。
  5. 只应用 CN.settings 中实际返回的键。
  6. 发送 DS 并接收确认。
  7. 发送 AC，之后按已配置的库存周期继续上报。

以下合成示例的 CRC 有效：

Device -> server
{CN,DEVICE-000001,MODEM-000001,V1.51,-67,SIM-000001,0,0,796B}

Server -> device
{CN,DEVICE-000001,HB:60;BP:180;,8E6D}

Device -> server
{AC,17000003,DEVICE-000001,MODEM-000001,SIM-000001,-67,V1.51,2,1:1:PB-000001:88:1110,2:1:NULL:0:0110,40AA}

租借时序​

仅用于测试的下行示例：

{BW,17000004,ORDER-0001,1,E6AD}
{BR,17000005,ORDER-0001,B87F}
{FB,17000006,ORDER-0001,2,8395}

归还时序​

  1. 机柜检测到插入并发送 RS；异常归还发送 FR。
  2. 服务端校验 CRC、设备、槽位、充电宝 ID 以及当前租借关系。
  3. 服务端分别保存原始报文和业务判断。
  4. 服务端使用新的消息 ID 发送 RS 确认。
  5. 机柜在后续 AC/CQ 库存中更新归还状态。
  6. 只有租借、归还和支付证据一致后，计费/对账流程才关闭。
{RS,17000007,DEVICE-000001,1,2,PB-000001,88,1,1,D1B9}

对接验收检查表​

传输与安全​

  • MQTT 认证和主题权限只覆盖目标设备。
  • 设备支持时启用 TLS 和证书校验。
  • 生产 PW 不进入浏览器代码、分析系统、截图或支持导出。
  • 解析前限制输入帧长度。
  • 高权限动作执行前完成 CRC、字段、身份和权限校验。

解析器​

  • 能处理跨多个传输包的完整帧，以及一个包中的多个帧。
  • 拒绝错误大括号、非 ASCII 指令字节和错误字段数。
  • 保留空的可选字段，并与 NULL 区分。
  • 只有在完成配置协商后才同时接受 3 位和 4 位槽位状态。
  • 未知枚举按未知处理，不能视为成功。

幂等​

  • 消息 ID 单调递增，并已测试重连后的行为。
  • BW、KW 和 FB 使用相同订单 ID 时返回历史结果。
  • 重复 RS/FR 不生成第二次归还。
  • 每个 BR 都使用新的消息 ID，并记录确认的是哪个阶段。

物理 UAT​

  • 上线/重连、弱信号和 Broker 中断。
  • 空槽、充电、满电、禁用、锁异常和品牌不匹配槽位。
  • 目标硬件实际支持的普通、22 W、45 W 和 65 W 配置。
  • 选宝、支付成功、支付失败、弹出成功、取宝超时和开锁失败。
  • 在线归还、离线归还、锁未到位和重复归还。
  • 在归还确认前后分别断电重启。
  • 带运营审计的维护弹出、槽位禁用/启用和 ID 写入。
  • 在非生产硬件上分批测试固件查询、升级、停止和恢复。

证据​

  • 分别保存原始接收时间、解析结果、CRC 结果、业务结果和设备结果。
  • 支付方、设备或服务证据不可用时保留 UNKNOWN。
  • 为每台机柜保存固件机型、版本和支持的指令配置。
  • 导出日志时脱敏设备、SIM、Wi-Fi、Broker 和凭据。

通过本检查表表示已测试设备配置符合协议，不自动代表所有机柜型号或固件都已认证。