本文提供PHP語(yǔ)言的物模型數(shù)據(jù)解析腳本模板和示例。
腳本模板
PHP腳本模版,您可以基于以下模版編寫數(shù)據(jù)解析腳本。
說明 本模板僅適用于數(shù)據(jù)格式為透?jìng)?自定義的產(chǎn)品。
<?php
/**
* 將Alink協(xié)議的數(shù)據(jù)轉(zhuǎn)換為設(shè)備能識(shí)別的格式數(shù)據(jù),物聯(lián)網(wǎng)平臺(tái)給設(shè)備下發(fā)數(shù)據(jù)時(shí)調(diào)用
* 入?yún)ⅲ?jsonObj 關(guān)聯(lián)數(shù)組
* 出參:$rawData 普通數(shù)組,數(shù)組元素為整數(shù),取值范圍為0~255,不能為空
*/
function protocolToRawData($jsonObj)
{
$rawData = array();
return $rawData;
}
/**
* 將設(shè)備的自定義格式數(shù)據(jù)轉(zhuǎn)換為Alink協(xié)議的數(shù)據(jù),設(shè)備上報(bào)數(shù)據(jù)到物聯(lián)網(wǎng)平臺(tái)時(shí)調(diào)用
* 入?yún)ⅲ?rawData 普通數(shù)組,數(shù)組元素為整數(shù)
* 出參:$jsonObj 關(guān)聯(lián)數(shù)組,關(guān)聯(lián)數(shù)組key取值為英文字符串,不能是字符類型的數(shù)字如"10", 不能為空
*/
function rawDataToProtocol($rawData)
{
$jsonObj = array();
return $jsonObj;
}
/**
* 將設(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)ⅲ?topic 字符串,設(shè)備上報(bào)消息的Topic
* 入?yún)ⅲ?rawData 普通數(shù)組,數(shù)組元素為整數(shù)
* 出參:$jsonObj 關(guān)聯(lián)數(shù)組,關(guān)聯(lián)數(shù)組key取值為英文字符串,不能是字符的數(shù)字如"10", 不能為空
*/
function transformPayload($topic, $rawData)
{
$jsonObj = array();
return $jsonObj;
}
腳本編寫注意事項(xiàng)
- 請(qǐng)避免使用全局變量或者static變量,否則會(huì)造成執(zhí)行結(jié)果不一致。
- 腳本中,處理數(shù)據(jù)采用補(bǔ)碼的方式, [-128, 127] 補(bǔ)碼范圍為[0, 255]。例如,-1對(duì)應(yīng)的補(bǔ)碼為255(10進(jìn)制表示)。
- 解析設(shè)備上報(bào)數(shù)據(jù)的函數(shù)(rawDataToProtocol)的入?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)。 - 解析物聯(lián)網(wǎng)平臺(tái)下發(fā)數(shù)據(jù)的函數(shù)(protocolToRawData)的返回結(jié)果為數(shù)組,要求為PHP普通數(shù)組。數(shù)組元素為整形,取值范圍為0~255。
- 自定義協(xié)議解析的函數(shù)(transformPayload)的入?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ì)于異常處理會(huì)很嚴(yán)格,如發(fā)生錯(cuò)誤會(huì)直接拋出異常,后續(xù)代碼不會(huì)執(zhí)行。保證代碼的健壯性,對(duì)于異常需要捕獲并進(jìn)行處理。
腳本示例
以下是基于物模型數(shù)據(jù)解析使用示例中定義的屬性和通信協(xié)議編寫的腳本。
<?php
/*
示例數(shù)據(jù):
設(shè)備上報(bào)數(shù)據(jù)
傳入?yún)?shù) ->
0x0000000001003201
輸出結(jié)果 ->
{"method":"thing.event.property.post","id":"1","params":{"prop_int16":50,"prop_bool":1},"version":"1.0"}
屬性設(shè)置的返回結(jié)果
傳入?yún)?shù) ->
0x0300223344c8
輸出結(jié)果 ->
{"code":"200","id":"2241348","version":"1.0"}
*/
function rawDataToProtocol($bytes)
{
$data = [];
$length = count($bytes);
for ($i = 0; $i < $length; $i++) {
$data[$i] = $bytes[$i] & 0xff;
}
$jsonMap = [];
$fHead = $data[0]; // command
if ($fHead == 0x00) {
$jsonMap['method'] = 'thing.event.property.post'; //ALink JSON格式,屬性上報(bào)topic
$jsonMap['version'] = '1.0'; //ALink JSON格式,協(xié)議版本號(hào)固定字段
$jsonMap['id'] = '' . getInt32($data, 1); //ALink JSON格式,標(biāo)示該次請(qǐng)求id值
$params = [];
$params['prop_int16'] = getInt16($data, 5); //對(duì)應(yīng)產(chǎn)品屬性中 prop_int16
$params['prop_bool'] = $data[7]; //對(duì)應(yīng)產(chǎn)品屬性中 prop_bool
$jsonMap['params'] = $params; //ALink JSON格式,params標(biāo)準(zhǔn)字段
} else if ($fHead == 0x03) {
$jsonMap['version'] = '1.0'; //ALink JSON格式,協(xié)議版本號(hào)固定字段
$jsonMap['id'] = '' . getInt32($data, 1); //ALink JSON格式,標(biāo)示該次請(qǐng)求id值
$jsonMap['code'] = getInt8($data, 5);
}
return $jsonMap;
}
/*
示例數(shù)據(jù):
屬性設(shè)置
傳入?yún)?shù) ->
{"method":"thing.service.property.set","id":"12345","version":"1.0","params":{"prop_int16":333, "prop_bool":1}}
輸出結(jié)果 ->
0x013039014d01
設(shè)備上報(bào)的返回結(jié)果
傳入數(shù)據(jù) ->
{"method":"thing.event.property.post","id":"12345","version":"1.0","code":200,"data":{}}
輸出結(jié)果 ->
0x023039c8
*/
function protocolToRawData($json)
{
$method = $json['method'];
$id = $json['id'];
$version = $json['version'];
$payloadArray = [];
if ($method == 'thing.service.property.set') // 屬性設(shè)置
{
$params = $json['params'];
$prop_int16 = $params['prop_int16'];
$prop_bool = $params['prop_bool'];
//按照自定義協(xié)議格式拼接 rawData
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(0x01)));// command字段
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(intval($id)))); // ALink JSON格式 'id'
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex($prop_int16))); // 屬性'prop_int16'的值
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex($prop_bool))); // 屬性'prop_bool'的值
} else if ($method == 'thing.event.property.post') { //設(shè)備上報(bào)數(shù)據(jù)返回結(jié)果
$code = $json['code'];
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(0x02))); //command字段
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(intval($id)))); // ALink JSON格式 'id'
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex($code)));
} else { //未知命令,對(duì)于有些命令不做處理
$code = $json['code'];
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(0xff))); //command字段
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex(intval($id)))); // ALink JSON格式 'id'
$payloadArray = concat($payloadArray, hexStringToByteArray(toHex($code)));
}
return $payloadArray;
}
/*
示例數(shù)據(jù)
自定義Topic:/user/update上報(bào)數(shù)據(jù)
輸入?yún)?shù):topic: /{productKey}/{deviceName}/user/update和bytes: 0x000000000100320100000000
輸出參數(shù):
{
"prop_float": 0,
"prop_int16": 50,
"prop_bool": 1,
"topic": "/{productKey}/{deviceName}/user/update"
}
*/
function transformPayload($topic, $bytes)
{
$data = array();
$length = count($bytes);
for ($i = 0; $i < $length; $i++) {
$data[$i] = $bytes[$i] & 0xff;
}
$jsonMap = array();
if (strpos($topic, '/user/update/error') !== false) {
$jsonMap['topic'] = $topic;
$jsonMap['errorCode'] = getInt8($data, 0);
} else if (strpos($topic, '/user/update') !== false) {
$jsonMap['topic'] = $topic;
$jsonMap['prop_int16'] = getInt16($data, 5);
$jsonMap['prop_bool'] = $data[7];
}
return $jsonMap;
}
function getInt32($bytes, $index)
{
$array = array($bytes[$index], $bytes[$index + 1], $bytes[$index + 2], $bytes[$index + 3]);
return hexdec(byteArrayToHexString($array));
}
function getInt16($bytes, $index)
{
$array = array($bytes[$index], $bytes[$index + 1]);
return hexdec(byteArrayToHexString($array));
}
function getInt8($bytes, $index)
{
$array = array($bytes[$index]);
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;
}
function hexStringToByteArray($hex)
{
$result = array();
$index = 0;
for ($i = 0; $i < strlen($hex) - 1; $i += 2) {
$result[$index++] = hexdec($hex[$i] . $hex[$i + 1]);
}
return $result;
}
function concat($array, $data)
{
return array_merge($array, $data);
}
function toHex($data)
{
$var = dechex($data);
$length = strlen($var);
if ($length % 2 == 1) {
$var = '0' . $var;
}
return $var;
}