指令下发

指令下发

用户可以通过平台向设备下发指令，下发指令内容均按照JSON格式下发，报文长度支持2K。具体报文格式要求可参见业务数据开发。

用户可以在“设备管理”标签页里，点击设备列表右侧操作中的“指令下发”按钮，创建指令。

对于非透传设备，用户点击“指令下发”按钮后，选择或搜索物模型的指令下发服务标识，按照服务的参数要求依次填入各个参数的value值，平台会组成该特定主题的Topic报文，以JSON格式下发。

非透传设备在收到并执行指令后，需要对下发指令回复响应。用户可以在MQTT协议报文主题中，填入指令下发响应服务的Topic主题，具体报文格式要求可参见业务数据开发。

对于透传设备，用户需在指令下发框内填入完整的JSON结构体、指令超时时间（秒）（范围1-10天，不填则默认7200秒）

下发指令后，用户可以在“设备管理”标签页里，点击设备列表右侧操作中的“指令下发日志”按钮查询某一设备的指令下发日志，也可以在“指令下发日志”标签页的检索框填写设备ID，选择需查询的具体时间范围，直接查询指令下发日志。在指令下发日志里，可以查看指令下发时间、指令下发状态、指令级别、指令内容等信息，其中指令下发状态总共分为7种：

l  指令已保存：指令已到达天翼物联网平台（AIoT)并保存，未下发到设备

l  指令已发送：指令已下发到设备

l  指令已送达：指令已到达设备，且平台收到设备回复的ACK信息

l  指令已完成：指令执行的响应结果已到达天翼物联网平台（AIoT)

l  指令失败：指令执行失败

l  指令发送超时：指令已下发，但平台并未收到设备回复的ACK到达信息

l  指令ttl超时：指令未下发，缓存时间超时

对于透传设备，无法到达指令已完成状态，指令的最终状态即为指令已送达。