Skip to content

设备消息 ​

设备与平台之间的每一次交互都会产生一条消息日志。在项目控制台的左侧导航「维护」中点击「消息日志」,可以按设备查看消息日志,用于排查设备是否上报成功、平台是否回复、上下线是否正常。

智联.云 消息日志

支持按设备码、消息类型和时间段筛选。列表中每一行显示时间、设备码、消息类型和消息内容,点击「详情」可查看完整的报文数据。

消息类型 ​

平台按消息类型记录日志,常见的类型包括:

类型说明
1 / 2属性上报 / 属性上报回复
3 / 4事件上报 / 事件上报回复
5 / 6属性设置(平台下发)/ 属性设置回复
7 / 8功能调用(平台下发命令)/ 功能调用回复
9 / 10连接事件 / 断开连接事件
11心跳
12 / 13设备获取平台属性 / 回复
14 / 15上线 / 下线
16 / 17属性采集 / 属性采集回复
18 / 19批量上报 / 批量上报回复
20 / 21自定义上报 / 自定义下发回复
22 / 23获取期望值 / 回复
24 / 25清除期望值 / 回复

每一类消息都区分「请求」和「回复」两条日志。设备上报后如果长时间看不到对应的回复日志,通常是设备端没有应答,可以从这里入手排查。

上下线日志 ​

设备的每次上线和下线都会记录:

  • 上线:设备与平台建立连接,记录上线时间。
  • 下线:设备断开连接,记录下线时间和下线原因,例如设备主动断开、心跳超时、连接被平台踢出等。

频繁出现"心跳超时"下线时,请检查设备网络稳定性或在线超时时间设置(设备类型中的在线超时时间)。

属性消息 ​

设备上报属性后,可以在属性消息中查看本次上报的原始数据,包括属性标识、属性值和时间戳。属性的展示与图表分析请浏览设备详情中的属性页签。

平台向设备下发属性(例如在控制台或 App 中修改可写属性)会产生「属性设置」消息;设备执行后回复「属性设置回复」,其中包含设备返回码,用于判断本次下发是否被设备成功执行。

命令消息 ​

通过控制台或 API 向设备下发命令时,会产生「功能调用」与「功能调用回复」消息。命令消息记录了命令标识、入参和设备返回的出参,是排查设备控制问题的主要依据。

TIP

接口下发属性或命令时,外层接口返回 200 只代表平台已受理;设备是否执行成功,要以「属性设置回复」「功能调用回复」消息中的设备返回码为准。

自定义数据流消息 ​

设备类型开启自定义数据流后,设备上报的自定义数据(JSON / HEX / 文本)会以「自定义上报」类型记录。