操作指令

Topic

• 上行： indicate/dev/{productKey}/{sn}

• 下行： indicate/server/{productKey}/{sn}

• QoS： 1

下发操作指令operate

应用向设备发送操作指令，并且需要得到设备实时响应时，可以通过调用中台API下发操作指令。

1.中台使用Topic indicate/server/{productKey}/{sn}推送OTA信息， method为operate ，消息格式如下：

2.设备端收到消息后，对指令进行执行。

3.指令执行完成后，设备使用Topic indicate/dev/{productKey}/{sn}反馈执行结果， method为operate。

• 执行成功，消息格式如下：

• 执行失败，消息格式如下：

设备报警复位命令

平台向设备发送复位命令，对设备报警状态进行复位，当设备上报了多个报警编码后，可以对其中单个报警进行复位，也可以一次对全部报警进行复位。

这属于operate的一个子命令，消息格式如下：

• 复位单个报警状态

• 复位所有报警状态

多路DIDO控制

平台可以向设备发送命令，同时控制多个DI/DO，这属于operate的一个子命令，消息格式如下：

PT、CT设置

平台可以向设备发送命令，设置PT、CT，消息格式如下：

简化透传指令operate_raw

应用向设备发送透传指令，并且需要得到设备实时响应。

1.中台使用Topic indicate/server/{productKey}/{sn}， method为operate_raw ，消息格式如下：

2.设备端收到消息后，对指令进行执行。

3.指令执行完成后，设备使用Topic indicate/dev/{productKey}/{sn}反馈执行结果， method为operate_raw。

• 设备正常回复，消息格式如下：

• 执行失败，消息格式如下：

透传指令transport

应用向设备发送透传指令，并且需要得到设备实时响应。

1.中台使用Topic indicate/server/{productKey}/{sn}， method为transport ，消息格式如下：

2.设备端收到消息后，对指令进行执行。

3.指令执行完成后，设备使用Topic indicate/dev/{productKey}/{sn}反馈执行结果， method为transport。

• 设备正常回复，消息格式如下：

• 执行失败，消息格式如下：

主动抄表指令read

主动抄表指令通常用于需要平台主动获取实时数据的场景，例如：设备不会主动上报数据，或者需要触发设备上报一次数据的场景。

1.中台使用Topic indicate/server/{productKey}/{sn}， method为read ，消息格式如下：

2.设备端收到消息后，首先进行回复：

3.然后通过 设备投影 中的 report 或 update 正常上报数据。

批量操作指令multi

批量下发包括2种情况，一种是多网关的批量下发，这个由平台负责多线程并行发送，另一种是对单个网关下多个仪表的批量下发，这个由平台发送给网关，然后网关负责对下属各仪表进行依次下发，并将结果反馈给平台。此协议是针对单个网关下多个仪表的批量下发进行设计。

当前，中台协议中的指令下发包括3种，分别是operate操作指令，transport透传指令，read主动抄表，三种指令的报文非常相似，差别只在于method以及payload中的属性不同。

1.平台下发

• operate_multi

应用平台下发的中台协议指令，从应用平台的接口设计来看，不会存在一次下发多个命令的情况，所以此处只支持单条命令，当然，在中台转为设备协议的报文时，有可能会对应多条报文，例如需要分包进行下发时。

• transport_multi

下发透传时，单个仪表有可能存在多条透传报文，报文用半角逗号 “,” 隔开。

• read_multi

批量抄表

2.网关确认

• 网关收到消息后，先回复以确认收到，中台接口需要返回成功，并附带msgid，以确保应用平台能获取到消息标识ID；

• 如果网关无响应，中台需要向应用平台返回失败，原因是网关无响应/网关离线等。

3.网关上报结果

网关在命令执行完成后，上报执行结果。中台如果下发了多条透传报文，最终也会根据设备返回的多个透传报文，转换为一个最终成功或失败的结果。

4.中台确认结果

5.中台推送执行结果

在中台定义一个转发结果，将结果报文推送给应用平台。