1. IP 数据
IP 数据用于查看串口网关通过 AS IP 通道产生的原始消息。当前平台处理 as/up/dataIP 上行主题,并在 RPC 或脚本下行时通过 as/dn/dataIP 向设备侧发送 gw-serial 指令。
该页面主要用于排查串口网关、RS-485/Modbus 透传、网关串口脚本和 gwSerial RPC 的通信链路。

1.1. 数据来源
当 AS Broker 收到以下主题时,平台会保存一条 IP 数据记录:
text
/v32/{tenant}/as/up/dataIP/{eui}其中 {tenant} 是组织账号,{eui} 是 topic 中的设备 EUI。平台优先使用消息体里的 moteeui 作为设备 EUI;如果消息体没有 moteeui,则使用 topic 中的 {eui}。
1.2. 字段说明
| 字段 | 说明 |
|---|---|
gw_eui | 网关 EUI,来自消息 extra.gweui。 |
dev_eui | 设备 EUI,优先来自 moteeui,缺失时使用 topic 中的 EUI。 |
action | 动作类型,例如 data、attrs、script、system、cron、modbusHistory、encrypt。 |
mode | 模式,例如 read、responseError。 |
content | 完整 MQTT 消息内容,用于查看原始 JSON。 |
seq_num | 消息序号,来自 seqno。 |
token | 请求或响应标识。 |
version | 协议版本。 |
if | 固定为 gw-serial。 |
update_time | 平台接收时间。 |
1.3. 页面筛选
IP 数据页面默认查询最近 1 天数据,并按 update_time 倒序展示。常用筛选条件包括:
- 时间范围。
- 设备 EUI。
- 网关 EUI。
action。mode。
1.4. 查看和复制原始内容
列表中的 content 可以展开查看完整 JSON,也可以通过复制操作复制原始内容。排查通信问题时,建议先确认:
gw_eui是否为预期网关。dev_eui是否匹配设备管理中的设备 EUI。action和mode是否符合设备或网关脚本的预期。token或seq_num是否能和下行请求对应。
1.5. 与物模型解析的关系
平台保存 IP 数据后,会尝试按设备 EUI 查找设备并更新设备活跃时间。消息也会进入设备 payload parser,因此符合设备脚本解析逻辑的 dataIP 上行可以继续参与物模型数据解析。
如果 IP 数据页面能看到上行,但实时数据没有更新,应继续检查:
- 设备的数据来源是否选择
gwSerial。 - 设备 EUI 是否和
moteeui一致。 - 设备是否挂载了正确的物模型。
- 物模型解析脚本是否支持该
dataIP消息结构。
1.6. 下行主题
gwSerial RPC 会通过以下主题下发:
text
/v32/{tenant}/as/dn/dataIP/{eui}RPC 脚本只需要返回业务字段,平台会补齐 version、token、if 和 moteeui。详情见 RPC 模型。