切换深色模式
设备 Payload 解析
入口：首页 → 工具箱 → 设备 Payload 解析。输入是终端的应用载荷 HEX，通常来自平台解密后的业务数据；不是完整 LoRaWAN 无线帧。
准备三个信息
| 信息 | 从哪里确认 |
|---|---|
| 设备类型与协议 | 终端型号、固件交付说明 |
| FPort | 对应上行在平台中的端口记录 |
| 完整载荷 | 同一条上行的应用数据字节 |
不要把网关收到的整包 Base64 直接粘入 HEX 输入框。若只有完整无线帧，应先用LoRaWAN 数据包解析核对结构和会话，再取得应用载荷。
逐步解析
- 从工具箱打开时，选择与实际终端一致的设备类型；从设备配置页的 更多 → 设备 Payload 解析 打开时，已绑定当前设备类型，可能不显示类型选择框。
- 填对应上行的 FPort（范围 0～255），不能只沿用默认值。
- 在 HEX 输入框粘贴完整字节，去掉日志时间、字段名和其他前缀。
- 执行解析，查看右侧结果 JSON。
- 对照该型号协议检查字段、单位和状态。
- 如需交接，保留原始 HEX、FPort、型号、版本及解析结果。左侧 复制脚本 复制的是解码脚本，右侧结果旁的复制图标才复制结果 JSON；两者不要混淆。
一个可核对的示例
设备类型选择工具中的 0x01 温湿度，FPort 1，输入：
text
01 00 09 C4 13 88 04当前对应解码规则给出的数据包括：
| 字段 | 示例结果 |
|---|---|
| 设备 | Temperature & Humidity |
| 状态 | 正常 |
| 温度 | 25°C |
| 湿度 | 50% |
| 电量 | 100% |
此例用于理解操作和输出，不作为其他终端的 Payload 模板。不同设备的上报类型、启动包、异常包、量程和单位可能不同，应按型号及固件使用正确解析规则。
结果应该怎样判断
- 输出 JSON 只是所选解析器的结果，不证明终端无线通信或平台会话正常。
- 没报错也不保证选型正确。若只有空对象或缺少预期字段，应检查类型、FPort 和数据长度。
- 原始整数与最终工程量可能有倍率、符号或状态条件，按对应协议解释。
- 数据明显异常时，先保留原始载荷，不靠修改字节拼出“合理结果”。
解析失败或结果不合理
| 现象 | 检查顺序 |
|---|---|
| 输入不是有效 HEX | 是否带 Base64、日志前缀、无效字符或半个字节 |
| 长度不足 | 是否复制了全部载荷，是否误截一行 |
| 空结果/字段缺失 | 类型、FPort、包类型和固件协议是否匹配 |
| 数字能读但单位不对 | 传感器类型、倍率、版本和状态位 |
| 同设备不同包表现不同 | 是否为心跳/启动/业务等不同包，不能全部套一种格式 |
反馈时提供同一条记录的完整上下文，见日志模板。不需要将网络密钥放进 Payload 示例。