数据解析¶
由于低配置且资源受限,或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信,可将原数据透传到物联网平台。您需在物联网平台控制台,编写数据解析脚本,用于将设备上下行数据分别解析为物联网平台定义的标准格式(Alink JSON)和设备的自定义数据格式。
脚本解析:
可实现json<-->binary
数据解析流程:
脚本格式:
/**
* 将Alink协议的数据转换为设备能识别的格式数据, 物联网平台给设备下发数据时调用
* 入参:jsonObj 对象 不能为空
* 出参:rawData byte[]数组 不能为空
*
*/
function protocolToRawData(jsonObj) {
return rawdata;
}
/**
* 将设备的自定义格式数据转换为Alink协议的数据, 设备上报数据到物联网平台时调用
* 入参:rawData byte[]数组 不能为空
* 出参:jsonObj 对象 不能为空
*/
function rawDataToProtocol(rawData) {
return jsonObj;
}
实例:
1var COMMAND_REPORT = 0x00; //属性上报
2var COMMAND_SET = 0x01; //属性设置
3var COMMAND_REPORT_REPLY = 0x02; //上报数据返回结果
4var COMMAND_SET_REPLY = 0x03; //属性设置设备返回结果
5var COMMAD_UNKOWN = 0xff; //未知的命令
6var ALINK_PROP_REPORT_METHOD = 'thing.event.property.post'; //标准ALink JSON格式topic, 设备上传属性数据到云端
7var ALINK_PROP_SET_METHOD = 'thing.service.property.set'; //标准ALink JSON格式topic, 云端下发属性控制指令到设备端
8var ALINK_PROP_SET_REPLY_METHOD = 'thing.service.property.set'; //标准ALink JSON格式topic, 设备上报属性设置的结果到云端
9/*
10示例数据:
11设备上报数据
12传入参数 ->
13 0x000000000100320100000000
14输出结果 ->
15 {"method":"thing.event.property.post","id":"1","params":{"prop_float":0,"prop_int16":50,"prop_bool":1},"version":"1.0"}
16
17属性设置的返回结果
18传入参数 ->
19 0x0300223344c8
20输出结果 ->
21 {"code":"200","data":{},"id":"2241348","version":"1.0"}
22*/
23function rawDataToProtocol(bytes) {
24 var uint8Array = new Uint8Array(bytes.length);
25 for (var i = 0; i < bytes.length; i++) {
26 uint8Array[i] = bytes[i] & 0xff;
27 }
28 var dataView = new DataView(uint8Array.buffer, 0);
29 var jsonMap = new Object();
30 var fHead = uint8Array[0]; // command
31 if (fHead == COMMAND_REPORT) {
32 jsonMap['method'] = ALINK_PROP_REPORT_METHOD; //ALink JSON格式 - 属性上报topic
33 jsonMap['version'] = '1.0'; //ALink JSON格式 - 协议版本号固定字段
34 jsonMap['id'] = '' + dataView.getInt32(1); //ALink JSON格式 - 标示该次请求id值
35 var params = {};
36 params['prop_int16'] = dataView.getInt16(5); //对应产品属性中 prop_int16
37 params['prop_bool'] = uint8Array[7]; //对应产品属性中 prop_bool
38 params['prop_float'] = dataView.getFloat32(8); //对应产品属性中 prop_float
39 jsonMap['params'] = params; //ALink JSON格式 - params标准字段
40 } else if(fHead == COMMAND_SET_REPLY) {
41 jsonMap['version'] = '1.0'; //ALink JSON格式 - 协议版本号固定字段
42 jsonMap['id'] = '' + dataView.getInt32(1); //ALink JSON格式 - 标示该次请求id值
43 jsonMap['code'] = ''+ dataView.getUint8(5);
44 jsonMap['data'] = {};
45 }
46
47 return jsonMap;
48}
49/*
50示例数据:
51属性设置
52传入参数 ->
53 {"method":"thing.service.property.set","id":"12345","version":"1.0","params":{"prop_float":123.452, "prop_int16":333, "prop_bool":1}}
54输出结果 ->
55 0x0100003039014d0142f6e76d
56
57设备上报的返回结果
58传入数据 ->
59 {"method":"thing.event.property.post","id":"12345","version":"1.0","code":200,"data":{}}
60输出结果 ->
61 0x0200003039c8
62*/
63function protocolToRawData(json) {
64 var method = json['method'];
65 var id = json['id'];
66 var version = json['version'];
67 var payloadArray = [];
68 if (method == ALINK_PROP_SET_METHOD) // 属性设置
69 {
70 var params = json['params'];
71 var prop_float = params['prop_float'];
72 var prop_int16 = params['prop_int16'];
73 var prop_bool = params['prop_bool'];
74 //按照自定义协议格式拼接 rawData
75 payloadArray = payloadArray.concat(buffer_uint8(COMMAND_SET)); // command字段
76 payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); // ALink JSON格式 'id'
77 payloadArray = payloadArray.concat(buffer_int16(prop_int16)); // 属性'prop_int16'的值
78 payloadArray = payloadArray.concat(buffer_uint8(prop_bool)); // 属性'prop_bool'的值
79 payloadArray = payloadArray.concat(buffer_float32(prop_float)); // 属性'prop_float'的值
80 } else if (method == ALINK_PROP_REPORT_METHOD) { //设备上报数据返回结果
81 var code = json['code'];
82 payloadArray = payloadArray.concat(buffer_uint8(COMMAND_REPORT_REPLY)); //command字段
83 payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); // ALink JSON格式 'id'
84 payloadArray = payloadArray.concat(buffer_uint8(code));
85 } else { //未知命令,对于有些命令不做处理
86 var code = json['code'];
87 payloadArray = payloadArray.concat(buffer_uint8(COMMAD_UNKOWN)); //command字段
88 payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); // ALink JSON格式 'id'
89 payloadArray = payloadArray.concat(buffer_uint8(code));
90 }
91 return payloadArray;
92}
93//以下是部分辅助函数
94function buffer_uint8(value) {
95 var uint8Array = new Uint8Array(1);
96 var dv = new DataView(uint8Array.buffer, 0);
97 dv.setUint8(0, value);
98 return [].slice.call(uint8Array);
99}
100function buffer_int16(value) {
101 var uint8Array = new Uint8Array(2);
102 var dv = new DataView(uint8Array.buffer, 0);
103 dv.setInt16(0, value);
104 return [].slice.call(uint8Array);
105}
106function buffer_int32(value) {
107 var uint8Array = new Uint8Array(4);
108 var dv = new DataView(uint8Array.buffer, 0);
109 dv.setInt32(0, value);
110 return [].slice.call(uint8Array);
111}
112function buffer_float32(value) {
113 var uint8Array = new Uint8Array(4);
114 var dv = new DataView(uint8Array.buffer, 0);
115 dv.setFloat32(0, value);
116 return [].slice.call(uint8Array);
117}