本文提供JavaScript語(yǔ)言的物模型消息解析腳本模板和示例。

腳本模板

以下為JavaScript腳本模板,您可以基于以下模板編寫物模型消息解析腳本。

說(shuō)明 本模板僅適用于數(shù)據(jù)格式透?jìng)?自定義的產(chǎn)品。
/**
 *  將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)ⅲ簀sonObj,對(duì)象,不能為空。
 *  出參:rawData,byte[]數(shù)組,不能為空。
 *
 */
function protocolToRawData(jsonObj) {
    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)ⅲ簉awData,byte[]數(shù)組,不能為空。
 * 出參:jsonObj,對(duì)象,不能為空。
 */
function rawDataToProtocol(rawData) {
    return jsonObj;
}
            

腳本編寫注意事項(xiàng)

  • 請(qǐng)避免使用全局變量,否則會(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ù)組。需要通過(guò)0xFF進(jìn)行與操作,獲取其對(duì)應(yīng)的補(bǔ)碼。
  • 解析物聯(lián)網(wǎng)平臺(tái)下發(fā)數(shù)據(jù)的函數(shù)(protocolToRawData)的返回結(jié)果為數(shù)組。數(shù)組元素為整型,取值為[0, 255]。

腳本示例

以下是基于提交物模型消息解析腳本中定義的屬性和通信協(xié)議編寫的腳本。

物模型消息中數(shù)據(jù)類型說(shuō)明,請(qǐng)參見(jiàn)物模型支持的數(shù)據(jù)類型。物模型屬性、事件上報(bào)數(shù)據(jù)后,物聯(lián)網(wǎng)平臺(tái)返回的Alink格式響應(yīng)結(jié)果,會(huì)通過(guò)腳本解析轉(zhuǎn)換后返回給設(shè)備。Alink數(shù)據(jù)格式說(shuō)明,請(qǐng)參見(jiàn)設(shè)備屬性、事件、服務(wù)

var COMMAND_REPORT = 0x00; //屬性上報(bào)。
var COMMAND_SET = 0x01; //屬性設(shè)置。
var COMMAND_REPORT_REPLY = 0x02; //上報(bào)數(shù)據(jù)返回結(jié)果。
var COMMAND_SET_REPLY = 0x03; //屬性設(shè)置設(shè)備返回結(jié)果。
var COMMAD_UNKOWN = 0xff;    //未知的命令。
var ALINK_PROP_REPORT_METHOD = 'thing.event.property.post'; //物聯(lián)網(wǎng)平臺(tái)Topic,設(shè)備上傳屬性數(shù)據(jù)到云端。
var ALINK_PROP_SET_METHOD = 'thing.service.property.set'; //物聯(lián)網(wǎng)平臺(tái)Topic,云端下發(fā)屬性控制指令到設(shè)備端。
var ALINK_PROP_SET_REPLY_METHOD = 'thing.service.property.set'; //物聯(lián)網(wǎng)平臺(tái)Topic,設(shè)備上報(bào)屬性設(shè)置的結(jié)果到云端。
var SELF_DEFINE_TOPIC_UPDATE_FLAG = '/user/update'  //自定義Topic:/user/update。
var SELF_DEFINE_TOPIC_ERROR_FLAG = '/user/update/error' //自定義Topic:/user/update/error。
/*
示例數(shù)據(jù):
設(shè)備上報(bào)屬性數(shù)據(jù):
傳入?yún)?shù):
    0x000000000100320100000000
輸出結(jié)果:
    {"method":"thing.event.property.post","id":"1","params":{"prop_float":0,"prop_int16":50,"prop_bool":1},"version":"1.0"}

屬性設(shè)置的返回結(jié)果:
傳入?yún)?shù):
    0x0300223344c8
輸出結(jié)果:
    {"code":"200","data":{},"id":"2241348","version":"1.0"}
*/
function rawDataToProtocol(bytes) {
    var 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);
    var jsonMap = new Object();
    var fHead = uint8Array[0]; // command
    if (fHead == COMMAND_REPORT) {
        jsonMap['method'] = ALINK_PROP_REPORT_METHOD; //ALink JSON格式,屬性上報(bào)topic。
        jsonMap['version'] = '1.0'; //ALink JSON格式,協(xié)議版本號(hào)固定字段。
        jsonMap['id'] = '' + dataView.getInt32(1); //ALink JSON格式,標(biāo)示該次請(qǐng)求id值。
        var params = {};
        params['prop_int16'] = dataView.getInt16(5); //對(duì)應(yīng)產(chǎn)品屬性中prop_int16。
        params['prop_bool'] = uint8Array[7]; //對(duì)應(yīng)產(chǎn)品屬性中prop_bool。
        params['prop_float'] = dataView.getFloat32(8); //對(duì)應(yīng)產(chǎn)品屬性中prop_float。
        jsonMap['params'] = params; //ALink JSON格式,params標(biāo)準(zhǔn)字段。
    } else if(fHead == COMMAND_SET_REPLY) {
        jsonMap['version'] = '1.0'; //ALink JSON格式,協(xié)議版本號(hào)固定字段。
        jsonMap['id'] = '' + dataView.getInt32(1); //ALink JSON格式,標(biāo)示該次請(qǐng)求id值。
        jsonMap['code'] = ''+ dataView.getUint8(5);
        jsonMap['data'] = {};
    }

    return jsonMap;
}
/*
示例數(shù)據(jù):
云端下發(fā)屬性設(shè)置指令:
傳入?yún)?shù):
    {"method":"thing.service.property.set","id":"12345","version":"1.0","params":{"prop_float":123.452, "prop_int16":333, "prop_bool":1}}
輸出結(jié)果:
    0x0100003039014d0142f6e76d

設(shè)備上報(bào)的返回結(jié)果:
傳入數(shù)據(jù):
    {"method":"thing.event.property.post","id":"12345","version":"1.0","code":200,"data":{}}
輸出結(jié)果:
    0x0200003039c8
*/
function protocolToRawData(json) {
    var method = json['method'];
    var id = json['id'];
    var version = json['version'];
    var payloadArray = [];
    if (method == ALINK_PROP_SET_METHOD) //屬性設(shè)置。
    {
        var params = json['params'];
        var prop_float = params['prop_float'];
        var prop_int16 = params['prop_int16'];
        var prop_bool = params['prop_bool'];
        //按照自定義協(xié)議格式拼接 rawData。
        payloadArray = payloadArray.concat(buffer_uint8(COMMAND_SET)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //ALink JSON格式 'id'。
        payloadArray = payloadArray.concat(buffer_int16(prop_int16)); //屬性'prop_int16'的值。
        payloadArray = payloadArray.concat(buffer_uint8(prop_bool)); //屬性'prop_bool'的值。
        payloadArray = payloadArray.concat(buffer_float32(prop_float)); //屬性'prop_float'的值。
    } else if (method ==  ALINK_PROP_REPORT_METHOD) { //設(shè)備上報(bào)數(shù)據(jù)返回結(jié)果。
        var code = json['code'];
        payloadArray = payloadArray.concat(buffer_uint8(COMMAND_REPORT_REPLY)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //ALink JSON格式'id'。
        payloadArray = payloadArray.concat(buffer_uint8(code));
    } else { //未知命令,對(duì)于這些命令不做處理。
        var code = json['code'];
        payloadArray = payloadArray.concat(buffer_uint8(COMMAD_UNKOWN)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //ALink JSON格式'id'。
        payloadArray = payloadArray.concat(buffer_uint8(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) {
    var 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);
    var jsonMap = {};

    if(topic.includes(SELF_DEFINE_TOPIC_ERROR_FLAG)) {
        jsonMap['topic'] = topic;
        jsonMap['errorCode'] = dataView.getInt8(0)
    } else if (topic.includes(SELF_DEFINE_TOPIC_UPDATE_FLAG)) {
        jsonMap['topic'] = topic;
        jsonMap['prop_int16'] = dataView.getInt16(5);
        jsonMap['prop_bool'] = uint8Array[7];
        jsonMap['prop_float'] = dataView.getFloat32(8);
    }

    return jsonMap;
}

//以下是部分輔助函數(shù)。
function buffer_uint8(value) {
    var uint8Array = new Uint8Array(1);
    var dv = new DataView(uint8Array.buffer, 0);
    dv.setUint8(0, value);
    return [].slice.call(uint8Array);
}
function buffer_int16(value) {
    var uint8Array = new Uint8Array(2);
    var dv = new DataView(uint8Array.buffer, 0);
    dv.setInt16(0, value);
    return [].slice.call(uint8Array);
}
function buffer_int32(value) {
    var uint8Array = new Uint8Array(4);
    var dv = new DataView(uint8Array.buffer, 0);
    dv.setInt32(0, value);
    return [].slice.call(uint8Array);
}
function buffer_float32(value) {
    var uint8Array = new Uint8Array(4);
    var dv = new DataView(uint8Array.buffer, 0);
    dv.setFloat32(0, value);
    return [].slice.call(uint8Array);
}