检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
以NB-IoT场景为例,编解码插件将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”,将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备(UE)“理解执行”。
数据上报流程 图1 数据上报流程图 在数据上报流程中,有两处需要用到编解码插件: 将设备上报的二进制码流解码成JSON格式的数据,发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流,下发给设备。
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时,可调用此接口将设备的自定义数据格式上报给平台,平台对该消息不进行解析,该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别,请查看消息通信说明。
编解码插件是供物联网平台调用,完成二进制格式和JSON格式相互转换或JSON格式之间的转换。它将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”,将应用服务器下行的JSON格式命令编码为二进制或JSON格式数据供终端设备(UE)“理解执行”。
该接口支持设备将自定义数据通过请求中的body体上报给平台,平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制,小于1MB的数据可以通过该接口携带。
如果不实现mid,则应用服务器不能在物联网平台获取命令的执行结果,需要应用服务器自行实现解决方案。比如应用服务器在收到命令执行结果响应(不带commandId)后,可以根据如下方法来进行响应匹配: 根据命令下发的顺序。
设备属性上报:用于设备按产品模型中定义的格式将属性数据上报给平台。 网关批量属性上报:用于网关设备将多个设备的属性数据一次性上报给平台。 应用服务器下发指令给设备 设备接入物联网平台后,应用服务器可通过以下方式发送指令到设备。 平台消息下发:用于平台下发自定义格式的数据给设备。
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时,可使用此接口下发自定义格式的数据给设备。
上行数据JavaScript解码后的JSON数据需要符合平台的格式要求,具体格式要求见: 数据解码格式定义 。 平台下行指令的JSON格式定义见:数据编码格式定义,使用JavaScript编码时需要根据平台对应的JSON格式转换为对应的二进制码流或JSON。
其中固定报头(Fixed header)和可变报头(Variable header)格式的填写请参考MQTT标准规范,有效载荷(Payload)的格式(须使用UTF-8编码格式)由应用定义,即由设备和物联网平台之间定义。 MQTT的语法和接口细节,请以MQTT标准规范为准。
设备异步命令状态变更通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device.command.status,Event:update)、创建规则动作、修改规则触发条件接口配置并激活规则后,当命令状态变更时,物联网平台会向应用服务器推送通知消息。
设备属性上报通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device.property,Event:report)、创建规则动作、修改规则触发条件接口配置并激活规则后,当设备上报属性数据时,物联网平台会向应用服务器推送通知消息。
表2 鉴权参数 参数 说明 Client ID 固定格式: ${ClientId}|securemode=2,signmethod=hmacsha256|timestamp=${timestamp}| ${ClientId}: 固定格式 ${ProductId}.
para2用于存放私钥证书的密码,只有当设置私钥证书时有效,并且证书以字符串格式传输PEM。
在物联网平台的使用中,可用于物联网平台向应用服务器采用HTTPS协议推送数据时,物联网平台认证应用服务器的合法性。本文以Windows环境为例,介绍通过Openssl工具制作调测证书的方法,生成的证书为PEM编码格式的证书,后缀为.cer。 常见的证书存储格式如下表所示。
产品删除通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:product,Event:delete)、创建规则动作、修改规则触发条件接口配置并激活规则后,当物联网平台中的产品删除时,物联网平台会向应用服务器推送通知消息。
设备消息状态变更通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device.message.status,Event:update)、创建规则动作、修改规则触发条件接口配置并激活规则后,当设备消息状态变更时,物联网平台会向应用服务器推送通知消息。
批量任务状态变更通知 功能介绍 应用服务器在调用物联网平台创建规则触发条件(Resource:batchtask,Event:update)、创建规则动作、修改规则触发条件接口配置并激活规则后,当批量任务状态变更时,物联网平台会向应用服务器推送通知消息。
产品更新通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:product,Event:update)、创建规则动作、修改规则触发条件接口配置并激活规则后,当物联网平台中的产品更新时,物联网平台会向应用服务器推送通知消息。
服务器,AMQP服务器,以及华为云的其他存储服务器等, 详情参考设备命令状态变更通知。