更新时间:2022-02-21 GMT+08:00

命令

在设备列表中,单击具体的设备进入到设备的详情页面。

  • 您可以使用该功能对单个设备进行命令下发操作,单击“命令下发”按钮,在弹出的窗口中选择需要下发的命令和设置命令参数,然后单击“确认”
    说明:
    • 仅NB-IoT设备支持通过设备管理服务进行下发命令操作,MQTT设备不支持,MQTT设备的命令下发,请通过北向API接口实施。
    • 设备支持的命令,需要由产品模型定义后,才能在此进行命令下发操作。
    • 下发命令的参数中,带“*”的参数为必选配置项,选择不同的命令,界面所呈现的参数不同。
  • 用于展示通过IoT平台或北向应用服务器给设备下发的历史命令列表,通过该功能可以详细查看命令下发任务的创建时间、平台发送命令的时间、送达的时间、发送的状态等信息,便于用户了解命令的执行状态,任务状态的转换关系如表1所示。同时,如果历史命令列表过多,可以通过“命令ID”、“状态”和“时间段”对历史命令列表进行过滤筛选,便于快速找到需要的命令下发记录。
表1 命令下发任务的状态变更说明

任务状态

转换说明

等待

  • NB-IoT设备采用缓存下发模式下发命令时,如果设备未上报数据,IoT平台会将命令进行缓存,此时任务状态为“等待”状态。
  • NB-IoT设备采用立即下发模式下发命令时,无此状态。
  • MQTT设备下发命时令,无此状态。

超期

  • NB-IoT设备采用缓存下发模式下发命令时,如果在设置的超期时间内,IoT平台未将命令下发给设备,则状态变更为“超期”。超期时间会根据北向接口中携带的expireTime为准,如果未携带,默认48h。
  • NB-IoT设备采用立即下发模式下发命令时,无此状态。
  • MQTT设备下发命时令,无此状态。

取消

如果命令下发任务为“等待”状态时,用户人工取消了命令下发任务,则任务状态变更为“取消”。

已发送

  • NB-IoT设备采用缓存下发模式下发命令时,设备上报数据,IoT平台会将缓存的命令发送给设备,此时状态会由“等待”变为“已发送”。
  • NB-IoT设备采用立即下发模式下发命令时,如果设备在线,状态为“已发送”。
  • MQTT设备下发命时令,如果设备在线,状态为“已发送”。

超时

NB-IoT设备收到命令后,IoT平台在180秒内未收到设备反馈的收到命令响应,此时状态会变为“超时”。MQTT设备无此状态。

已送达

IoT平台收到设备反馈的已收到下发命令响应后,状态变为“已送达”。

成功

如果设备在执行完命令后,会给IoT平台反馈命令执行成功的结果,将任务状态变更为“成功”。

失败

  • 如果设备在执行完命令后,会给IoT平台反馈命令执行失败的结果,将任务状态变更为“失败”。
  • NB-IoT设备采用立即下发模式下发命令时,如果设备离线,状态为“失败”。
  • MQTT设备下发命令时,如果设备离线,状态为“失败”。

如果北向应用服务器调用IoT平台的“创建批量任务”接口,对批量设备下发控制指令,则可以在批量命令下发界面查看当前任务执行的状态和结果。