Skip to content

1. IP 数据

IP 数据用于查看串口网关通过 AS IP 通道产生的原始消息。当前平台处理 as/up/dataIP 上行主题,并在 RPC 或脚本下行时通过 as/dn/dataIP 向设备侧发送 gw-serial 指令。

该页面主要用于排查串口网关、RS-485/Modbus 透传、网关串口脚本和 gwSerial RPC 的通信链路。

IP 数据页面:串口网关透传数据

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动作类型,例如 dataattrsscriptsystemcronmodbusHistoryencrypt
mode模式,例如 readresponseError
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。
  • actionmode 是否符合设备或网关脚本的预期。
  • tokenseq_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 脚本只需要返回业务字段,平台会补齐 versiontokenifmoteeui。详情见 RPC 模型