设备事件与命令

设备事件

事件是设备在运行中主动上报的通知（在设备类型的功能定义中定义）。在设备详情中点击「事件」页签查看事件上报记录：

• 可按事件标识符筛选某一类事件。
• 每条记录包含事件标识符、事件名称和事件上报时间。
• 点击记录可查看事件的出参内容。

事件上报后除了在设备详情中查看，还可以：

• 配置告警规则，在事件上报时触发告警通知。
• 配置消息规则，将事件数据转发到外部 MQTT 或 URL。

设备命令

命令是平台下发、设备执行的动作（在设备类型的功能定义中定义）。在设备详情中点击「命令」页签：

下发命令

1. 点击「下发命令」。
2. 选择要下发的命令，填写入参。
3. 提交后平台通过接入通道向设备发送命令报文。
4. 设备执行后返回出参和返回码，返回码 200 表示设备执行成功；同步调用时接口会等待设备回复，超时时间可在下发时指定。

查看命令记录

命令列表显示每条命令的标识符、名称、状态和创建时间，点击「查看命令」可查看命令的完整报文（入参、出参和设备返回码），是排查设备控制问题的主要依据。

TIP

命令下发后设备长时间没有回复，通常原因是设备离线或设备端未实现该命令。可以在「消息日志」中查看「功能调用」与「功能调用回复」消息确认交互过程。