协议规格

连接参数

该设备只支持配置一个上行 Topic 和一个下行 Topic。服务端应按设备配置的 Topic 接收和下发。

主题配置

{IMEI} 为设备 IMEI，作为设备唯一标识。实际项目中 Topic 字符串可以按 MQTT 服务器要求配置，但设备侧仍只有一个上行 Topic 和一个下行 Topic。建议使用普通业务主题，不使用 /sys/ 或 $SYS/ 前缀，避免与服务器系统主题、平台预留主题或访问控制规则混淆。

上行报文

设备通过 Pub Topic 上报 JSON 字符串。根对象必须包含 params，设备数据字段放在 params 对象内。

{
  "params": {
    "INDEX": 1,
    "IMEI": "862177241709877",
    "PID": 386025,
    "XANG": 0.000,
    "YANG": 0.000,
    "ZANG": 0.000,
    "XACC": 0.000,
    "YACC": 0.000,
    "ZACC": 0.000,
    "ALARM_FLG": 0,
    "ALARM_TYPE": 0,
    "ANG": 0.000,
    "ACC": 0.000,
    "CLR_FLG": 0,
    "FIX": 0,
    "FREQ": 28800,
    "RFAA": 600,
    "ACTC": 0,
    "CSQ": 0,
    "EQC": 0,
    "TEMP": 0.00,
    "LNGTD": 0.00,
    "LATTD": 0.00,
    "SOFTVERSION": "205A220916"
  }
}

上行报文为设备 JSON，不包含设备时间戳字段。服务端入库时可使用 MQTT 接收时间作为数据时间。

报文关键字说明

以下关键字均位于 params 对象内。

解析说明

• 服务端应先读取根对象 params，再解析其中的设备字段。
• 字段名区分大小写，必须按上表的大写关键字解析。
• INDEX 是报文序号，不是时间戳。上行报文不包含设备时间字段，数据时间建议使用服务端收到 MQTT 消息的时间。
• IMEI 是设备唯一标识，建议校验 Topic 中的 {IMEI} 与报文中的 params.IMEI 是否一致。
• ANG 和 ACC 是当前配置阈值，不是实时测量值。实时测量值分别为 XANG、YANG、ZANG 和 XACC、YACC、ZACC。
• 角度告警由 XANG、YANG 与 ANG 判断；ZANG 只上报，不参与清零和告警。
• 加速度告警由 XACC、YACC、ZACC 与 ACC 判断。
• FIX 表示设备安装方向，服务端展示或计算角度时应保留该配置值。

下行报文

服务端通过 Sub Topic 下发 JSON 字符串。根对象必须包含 params，配置字段放在 params 对象内。字段名保持设备定义的大写格式。

批量配置

{
  "params": {
    "ANG": 5,
    "ACC": 0.082,
    "FREQ": 43200,
    "RFAA": 1200,
    "ACTC": 3,
    "CLR_FLG": 1
  }
}

单项配置

{"params":{"ANG":5}}

{"params":{"ACC":0.082}}

{"params":{"FREQ":43200}}

{"params":{"RFAA":1200}}

{"params":{"ACTC":3}}

{"params":{"CLR_FLG":1}}

下行字段

下发时直接发布完整 JSON 对象字符串，不要把整个 JSON 再作为字符串值封装；不要使用单引号、注释或尾逗号；所有下行参数必须放在 params 对象内，字段名区分大小写。

配置下发后，服务端可通过后续上行报文中的 ANG、ACC、FREQ、RFAA、ACTC 等字段确认设备当前配置值；清零动作可结合后续角度数据判断是否生效。

告警与清零

服务端解析上行数据时应优先判断 ALARM_FLG，再根据 ALARM_TYPE 区分告警类型。