JavaScript脚本示例

本文提供JavaScript语言的物模型数据解析脚本模板和示例。

脚本模板

以下为JavaScript脚本模版,您可以基于以下模版编写物模型数据解析脚本。

说明 本模板仅适用于数据格式透传/自定义的产品。

// 以下为脚本模版,您可以基于以下模版进行脚本编写


/**
 * 将设备的自定义格式数据转换为Yelink协议的数据,设备上报数据到物联网平台时调用
 * 入参:rawData byte[]数组     不能为空
 * 出参:json Yelink JSON字符串 不能为空
 */
function rawDataToProtocol(rawData) {
    var jsonMap = {};
    return JSON.stringify(jsonMap);
}

/**
 *  将Yelink协议的数据转换为设备能识别的格式数据,物联网平台给设备下发数据时调用
 *  入参:jsonObj Yelink JSON对象  不能为空
 *  出参:rawData byte[]数组      不能为空
 *
 */
function protocolToRawData(jsonObj) {
    var rawdata = [];
    return rawdata;
}

脚本编写注意事项

  • 请避免使用全局变量,否则会造成执行结果不一致。
  • 脚本中,处理数据采用补码的方式, [-128, 127]补码范围为[0, 255]。例如,-1对应的补码为255(10进制表示)。
  • 解析设备上报数据的函数(rawDataToProtocol)的入参为整形数组。需要通过0xFF进行与操作,获取其对应的补码。
  • 解析物联网平台下发数据的函数(protocolToRawData)的返回结果为数组。数组元素为整形,取值为[0, 255]。

脚本示例

以下是基于物模型数据解析使用示例中定义的属性和通信协议编写的脚本。

var COMMAND_REPORT = 0x00; //属性上报。
var COMMAND_SET = 0x01; //属性设置。
var COMMAND_REPORT_REPLY = 0x02; //上报数据返回结果。
var COMMAND_SET_REPLY = 0x03; //属性设置设备返回结果。
var COMMAD_UNKOWN = 0xff;    //未知的命令。
var YELINK_PROP_REPORT_METHOD = 'thing.event.property.post'; //物联网平台Topic,设备上传属性数据到云端。
var YELINK_PROP_SET_METHOD = 'thing.service.property.set'; //物联网平台Topic,云端下发属性控制指令到设备端。
var YELINK_PROP_SET_REPLY_METHOD = 'thing.service.property.set'; //物联网平台Topic,设备上报属性设置的结果到云端。

/*
示例数据:
设备上报属性数据:
传入参数:
    000000000100320100000000
输出结果:
    {"method":"thing.event.property.post","id":"1","params":{"prop_float":0,"prop_int16":50,"prop_bool":1},"version":"1.0"}

属性设置的返回结果:
传入参数:
    0300223344c8
输出结果:
    {"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'] = YELINK_PROP_REPORT_METHOD; //YELINK JSON格式,属性上报topic。
        jsonMap['version'] = '1.0'; //YELINK JSON格式,协议版本号固定字段。
        jsonMap['id'] = '' + dataView.getInt32(1); //YELINK JSON格式,标示该次请求id值。
        var params = {};
        params['prop_int16'] = dataView.getInt16(5); //对应产品属性中prop_int16。
        params['prop_bool'] = uint8Array[7]; //对应产品属性中prop_bool。
        params['prop_float'] = dataView.getFloat32(8); //对应产品属性中prop_float。
        jsonMap['params'] = params; //YELINK JSON格式,params标准字段。
    } else if(fHead == COMMAND_SET_REPLY) {
        jsonMap['version'] = '1.0'; //YELINK JSON格式,协议版本号固定字段。
        jsonMap['id'] = '' + dataView.getInt32(1); //YELINK JSON格式,标示该次请求id值。
        jsonMap['code'] = ''+ dataView.getUint8(5);
        jsonMap['data'] = {};
    }

    return JSON.stringify(jsonMap);
}
/*
示例数据:
云端下发属性设置指令:
传入参数:
    {"method":"thing.service.property.set","id":"12345","version":"1.0","params":{"prop_float":123.452, "prop_int16":333, "prop_bool":1}}
输出结果:
    0100003039014d0142f6e76d

设备上报的返回结果:
传入数据:
    {"method":"thing.event.property.post","id":"12345","version":"1.0","code":200,"data":{}}
输出结果:
    0200003039c8
*/
function protocolToRawData(json) {
    var method = json['method'];
    var id = json['id'];
    var version = json['version'];
    var payloadArray = [];
    if (method == YELINK_PROP_SET_METHOD) //属性设置。
    {
        var params = json['params'];
        var prop_float = params['prop_float'];
        var prop_int16 = params['prop_int16'];
        var prop_bool = params['prop_bool'];
        //按照自定义协议格式拼接 rawData。
        payloadArray = payloadArray.concat(buffer_uint8(COMMAND_SET)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //YELINK 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 ==  YELINK_PROP_REPORT_METHOD) { //设备上报数据返回结果。
        var code = json['code'];
        payloadArray = payloadArray.concat(buffer_uint8(COMMAND_REPORT_REPLY)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //YELINK JSON格式'id'。
        payloadArray = payloadArray.concat(buffer_uint8(code));
    } else { //未知命令,对于这些命令不做处理。
        var code = json['code'];
        payloadArray = payloadArray.concat(buffer_uint8(COMMAD_UNKOWN)); //command字段。
        payloadArray = payloadArray.concat(buffer_int32(parseInt(id))); //YELINK JSON格式'id'。
        payloadArray = payloadArray.concat(buffer_uint8(code));
    }
    return payloadArray;
}


//以下是部分辅助函数。
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);
}

results matching ""

    No results matching ""