在一些物联网业务场景中,由于资源受限或配置较低,设备端不适合直接构造物模型的JSON数据结构体与物联网平台进行直接通信。这种情况下,可以将设备上报的原数据直接透传到物联网平台。物联网平台调用您提交的数据解析脚本,将设备上行数据解析为物联网平台定义的标准格式(Alink JSON),再进行业务处理。
目前支持解析两类数据:
- 自定义Topic上行数据,即将设备通过自定义Topic上报给云端的自定义格式数据Payload解析为JSON格式。
- 上、下行物模型Topic的数据,即将设备上报给云端的自定义格式物模型数据解析为Alink JSON格式,和将云端下发的Alink JSON格式数据解析为设备自定义的格式。
我们这里使用的是:物模型数据解析
数据格式为透传/自定义的产品下的设备与云端进行物模型数据通信时,需要物联网平台调用您提交的数据解析脚本,将上、下行物模型数据分别解析为物联网平台定义的标准格式(Alink JSON)和设备的自定义数据格式。
物联网平台接收到来自设备的数据时,先运行解析脚本,将透传的数据转换成Alink JSON格式的数据,再进行业务处理;物联网平台下发数据给设备前,也会先通过脚本将数据转换为设备的自定义格式,再下发给设备。
数据解析流程图:
设备上报透传格式的属性或事件(上行数据)全流程图:
调用设备服务或设置属性(下行数据)全流程图:
好了,接下来我们进行产品以及设备的配置:
1. 产品配置
参数 | 说明 |
---|---|
产品名称 | 自定义产品名称 |
所属品类 | 自定义品类 |
节点类型 | 直连设备 |
数据格式 | 透传/自定义 |
连网协议 | 蜂窝 (2G / 3G / 4G / 5G) |
产品物模型定义
设备物模型参数定义如下,这部分定义与自定义协议对应,非常重要
2. 设备端接入物联网平台
设备采用物模型通信 Topic中的透传上行用于设备发布属性、事件和扩展信息的数据。
这里我是用的是将Modbus数据通过MQTT协议发送到云平台的模块,设备发送到物联网平台的为16进制数据格式如下(Modbus帧):
0x010412003700132f014e1f2a081a02001800f40008965b
这里我用的是采用ModbusSlave软件模拟设备数据,然后模块去查询这个虚拟设备的数据,数据定义如下:
3. 数据解析脚本
本示例的数据解析脚本(javascript)如下:
/**
* 将设备自定义topic数据转换为json格式数据, 设备上报数据到物联网平台时调用
* 入参:topic 字符串,设备上报消息的topic
* 入参:rawData byte[]数组 不能为空
* 出参:jsonObj JSON对象 不能为空
*/
function transformPayload(topic, rawData) {
var jsonObj = {
}
return jsonObj;
}
var COMMAND_REPORT = 0x00; //属性上报
var COMMAND_SET = 0x01; //属性设置
var COMMAND_REPORT_REPLY = 0x02; //上报数据返回结果
var COMMAND_SET_REPLY = 0x03; //属性设置设备返回结果
var COMMAD_UNKOWN = 0xff; //未知的命令
var ALINK_PROP_REPORT_METHOD = 'thing.event.property.post'; //物联网平台Topic, 设备上传属性数据到云端
var ALINK_PROP_SET_METHOD = 'thing.service.property.set'; //物联网平台Topic, 云端下发属性控制指令到设备端
var ALINK_PROP_SET_REPLY_METHOD = 'thing.service.property.set'; //物联网平台Topic, 设备上报属性设置的结果到云端
/**
* 将设备的自定义格式数据转换为Alink协议的数据,设备上报数据到物联网平台时调用
* 入参:rawData byte[]数组 不能为空
* 出参:jsonObj Alink JSON对象 不能为空
*/
function rawDataToProtocol(bytes) {
uint8Array = new Uint8Array(bytes.length);
for(var i=0;i<bytes.length;i++){
uint8Array[i] = bytes[i] & 0xff;
}
var dataView = new DataView(uint8Array.buffer,0);