編寫自定義腳本
數(shù)據(jù)解析任務(wù)中源節(jié)點(diǎn)的Topic數(shù)據(jù)格式為原始數(shù)據(jù)時(shí),可以使用自定義腳本進(jìn)行解析。物聯(lián)網(wǎng)平臺(tái)支持配置JavaScript(ECMAScript 5)、Python 2.7和PHP 7.2語(yǔ)言的腳本。本文介紹自定義Topic數(shù)據(jù)解析腳本模板和示例。
JavaScript腳本示例
腳本模板
/**
* 將設(shè)備自定義Topic數(shù)據(jù)轉(zhuǎn)換為JSON格式數(shù)據(jù),設(shè)備上報(bào)數(shù)據(jù)到物聯(lián)網(wǎng)平臺(tái)時(shí)調(diào)用。
* 入?yún)ⅲ篸ata,byte[]數(shù)組,不能為空。
* 出參:jsonObj,對(duì)象,不能為空。
*/
function executeScript(data) {
var jsonObj = {};
return jsonObj;
}
腳本示例
/*
示例數(shù)據(jù):
自定義Topic:
/user/update,上報(bào)數(shù)據(jù)。
輸入?yún)?shù):
data: 0x000000000100320100000000
輸出參數(shù):
{
"prop_float": 0,
"prop_int16": 50,
"prop_bool": 1
}
*/
function executeScript(data) {
var uint8Array = new Uint8Array(data.length);
for (var i = 0; i < data.length; i++) {
uint8Array[i] = data[i] & 0xff;
}
var dataView = new DataView(uint8Array.buffer, 0);
var jsonMap = {};
jsonMap['prop_int16'] = dataView.getInt16(5);
jsonMap['prop_bool'] = uint8Array[7];
jsonMap['prop_float'] = dataView.getFloat32(8);
return jsonMap;
}
Python腳本示例
腳本模板
# 將設(shè)備自定義Topic數(shù)據(jù)轉(zhuǎn)換為JSON格式數(shù)據(jù),設(shè)備上報(bào)數(shù)據(jù)到物聯(lián)網(wǎng)平臺(tái)時(shí)調(diào)用。
# 入?yún)? data,列表,列表元素取值為int類型,不能為空。
# 出參: jsonObj,字典。
def execute_script(data):
jsonObj = {}
return jsonObj
腳本示例
# coding=UTF-8
# 示例數(shù)據(jù):
# 自定義Topic:/user/update,上報(bào)數(shù)據(jù)。
# 輸入?yún)?shù):
# data: 0x000000000100320100000000
# 輸出參數(shù):
# {
# "prop_float": 0,
# "prop_int16": 50,
# "prop_bool": 1
# }
def execute_script(data):
uint8Array = []
for byteValue in data:
uint8Array.append(byteValue & 0xff)
jsonMap = {}
jsonMap['prop_int16'] = bytes_to_int(uint8Array[5:7])
jsonMap['prop_bool'] = bytes_to_int(uint8Array[7: 8])
jsonMap['prop_float'] = bytes_to_int(uint8Array[8:])
return jsonMap
# byte數(shù)組轉(zhuǎn)換為整型。
def bytes_to_int(bytes):
data = ['%02X' % i for i in bytes]
return int(''.join(data), 16)
PHP腳本示例
腳本模板
<?php
/**
* 將設(shè)備自定義Topic數(shù)據(jù)轉(zhuǎn)換為JSON格式數(shù)據(jù),設(shè)備上報(bào)數(shù)據(jù)到物聯(lián)網(wǎng)平臺(tái)時(shí)調(diào)用。
* 入?yún)ⅲ?data,普通數(shù)組,數(shù)組元素為整數(shù)。
* 出參:$jsonObj,關(guān)聯(lián)數(shù)組,關(guān)聯(lián)數(shù)組key取值為英文字符串不能是字符的數(shù)字如"10",不能為空。
*/
function executeScript($data)
{
$jsonObj = array();
return $jsonObj;
}
請(qǐng)避免使用全局變量或者static變量,否則會(huì)造成執(zhí)行結(jié)果不一致。
腳本中,處理數(shù)據(jù)采用補(bǔ)碼的方式, [-128, 127]補(bǔ)碼范圍為[0, 255]。例如:-1對(duì)應(yīng)的補(bǔ)碼為255(10進(jìn)制表示)。
自定義協(xié)議解析的函數(shù)(executeScript)的入?yún)檎蛿?shù)組,需要通過0xFF進(jìn)行與操作,獲取其對(duì)應(yīng)的補(bǔ)碼。返回結(jié)果為關(guān)聯(lián)數(shù)組,要求key取值包含非數(shù)組字符(例如:數(shù)組key為“10”,PHP數(shù)組中會(huì)獲取到整數(shù)10)。
PHP執(zhí)行環(huán)境對(duì)于異常處理要求嚴(yán)格,例如:發(fā)生錯(cuò)誤會(huì)直接拋出異常,后續(xù)代碼不會(huì)執(zhí)行。為保證代碼的健壯性,對(duì)于異常需要捕獲并進(jìn)行處理。
腳本示例
<?php
/*
示例數(shù)據(jù)
自定義Topic:
/user/update,上報(bào)數(shù)據(jù)。
輸入?yún)?shù):
data: 0x000000000100320100000000。
輸出參數(shù):
{
"prop_float": 0,
"prop_int16": 50,
"prop_bool": 1
}
*/
function executeScript($bytes)
{
$data = array();
$length = count($bytes);
for ($i = 0; $i < $length; $i++) {
$data[$i] = $bytes[$i] & 0xff;
}
$jsonMap = array();
$jsonMap['prop_int16'] = getInt16($data, 5);
$jsonMap['prop_bool'] = $data[7];
return $jsonMap;
}
function getInt16($bytes, $index)
{
$array = array($bytes[$index], $bytes[$index + 1]);
return hexdec(byteArrayToHexString($array));
}
function byteArrayToHexString($data)
{
$hexStr = '';
for ($i = 0; $i < count($data); $i++) {
$hexValue = dechex($data[$i]);
$tempHexStr = strval($hexValue);
if (strlen($tempHexStr) === 1) {
$hexStr = $hexStr . '0' . $tempHexStr;
} else {
$hexStr = $hexStr . $tempHexStr;
}
}
return $hexStr;
}
相關(guān)文檔
選擇腳本語(yǔ)言,完成自定義腳本編輯和調(diào)試。具體操作,請(qǐng)參見配置源節(jié)點(diǎn)。