概述
最后更新时间:2020-10-26

动机

我们把通过云平台下发到设备的数据称为指令。在实际应用中,指令多为控制指令,例如给某个属性写入指定的值,或执行重启、关机、唤醒等。只有通过云mqtt协议连接到云平台,并且与平台之间有长连接的设备才可以接受下发的指令。

云平台提供开放的接口,用于向设备下发控制指令。

指令管理用来管理平台中物实例的指令规则配置,指令执行等,用户可以通过指令管理模块,对指令进行增加、删除、修改、查询、执行等操作,从而完成对指令的管理。

基础知识

指令下发流程:

用户调用云平台Open API,向设备下发写实时数据指令。

云平台收到调用信息后,向直连设备或网关下发指令,直连设备或网关接收到指令后,向平台返回ACK消息,向平台反馈其已经收到命令。

平台接收到直连设备或网关返回的参数后,等待设备的响应。

设备执行指令,并返回结果。

直连设备直接执行下发的指令,执行成功并返回结果。

网关则向非直连子设备发送下发的指令,子设备处理下发的指令,执行成功并向网关返回结果,再由网关向平台返回参数返回执行结果。

应用侧还可以调用API,查询某个命令的执行状态,查询设备是否已经收到该命令,是否已经执行完毕等信息。

特性

指令管理的API可以实现以下能力:

按条件查询、更新、删除指令。

查询指令执行情况、历史设备响应结果。

指令下发操作。

创建指令下发模板。

限制

指令配置类信息暂不开放。

示例场景

某厂房设备管理员可以通过指令管理,对机床的开关机进行远程操作控制。