物模型说明

    设备模型使用场景:

    1. 前端通过模型定义动态展示设备运行状态或者设备操作界面
    2. 服务端可通过统一的API获取设备模型并进行相关操作,如: 在发送设备消息时进行参数校验, 在收到设备消息进行类型转换处理.

    数据结构:

    用于定义设备属性,运行状态等如: 设备SN,当前CPU使用率等. 平台可主动下发消息获取设备属性,设备也通过事件上报属性.

    数据结构:

    2.    "id": "cpu_usage", //属性标识
    3.    "name": "CPU使用率",
    4.    "valueType": {   //值类型
    5.      "type": "double", //类型标识,见类型表
    6.      "maxValue":100,
    7.      "minValue":0,
    8.      "unit":"percent",     //单位
    9.      "expands":{"key1":"value1"} //其他自定义拓展定义
    10.    },
    11.    "expands":{"key1":"value1"} //其他自定义拓展定义
    12.  }

    数据结构:

    1. {
    2.    "id": "playVoice", //功能标识
    3.    "name": "播放声音", //名称
    4.    "inputs": [  //输入参数
    5.      {
    6.        "id": "text",
    7.        "name": "文字内容",
    8.        "valueType": { //参数类型
    9.          "type": "string"
    10.        },
    11.        "expands":{"key1":"value1"} //其他自定义拓展定义
    12.      }
    13.    ],
    14.    "output": { //输出
    15.      "type": "boolean" //输出类型
    16.    },
    17.    "expands":{"key1":"value1"} //其他自定义拓展定义
    18.  }

    用于定义设备事件, 如: 定时上报设备属性, 设备报警等.

    数据结构:

    1. {
    2.    "id": "fire_alarm", //事件标识
    3.    "name": "火警",
    4.    "valueType": {
    5.      "type": "object",  //对象(结构体)类型
    6.        {
    7.          "id": "location",
    8.          "name": "地点",
    9.          "valueType": {
    10.            "type": "string"
    11.          }
    12.        },
    14.          "id": "lng",
    15.          "name": "经度",
    16.          "valueType": {
    17.            "type": "double"
    18.          },
    19.          "expands":{"gis":"lng"} //其他自定义拓展定义
    20.        },
    21.        {
    22.          "id": "lat",
    23.          "name": "纬度",
    24.          "valueType": {
    25.            "type": "double"
    26.          },
    27.           "expands":{"gis":"lat"} //其他自定义拓展定义
    28.        }
    29.      ]
    30.    },
    31.    "expands":{"key1":"value1"} //其他自定义拓展定义
    32. }

    所有类型共有属性:

    • id 唯一标识
    • name 名称
    • description 描述
    • expands 自定义配置

    2. long 长整型

    3. float 单精度浮点型

    4. double 双精度浮点型

      以上均为数字类型,共有属性:

      • max 最大值
      • min 最小值
      • unit 单位

    boolean 布尔类型

    1.  属性
    2.   - trueText 为true时的文本,默认为`是`
    3.   - falseText 为false时的文本,默认为`否`
    4.   - trueValue  为true时的值,默认为`true`
    5.   - falseValue 为false时的值,默认为`false`
    7.   例:
    9.     {
    10.         "type":"boolean",
    11.         "trueText":"开启",
    12.         "falseText":"关闭",
    13.         "trueValue":"1",
    14.     }

    string 字符类型

    1.   例:
    3.     {
    4.        "type":"string",
    5.        "expands":{"maxLen":"255"}
    6.     }
    1. 属性:
    2.  - elements (Element)枚举中的元素
    4. Element:
    5.  - value 枚举值
    6.  - text 枚举文本
    7.  - description 说明
    9. 例:
    11.     {
    12.         "type":"enum",
    13.         "elements":[
    14.             {"value":"1","text":"正常"},
    15.             {"value":"-1","text":"警告"},
    16.             {"value":"0","text":"未知"}
    17.         ]
    18.     }

    date 时间类型

    password 密码类型

    1. 与string类型相同
    1. 属性:
    2.   - bodyType 类型: url,base64,binary
    4. 例:
    6.     {
    7.        "type":"file",
    8.        "bodyType":"url"
    9.     }

    array 数组(集合)类型

    1. 属性:
    2.   - elementType 元素类型
    4. 例:
    6.     {
    7.         "type":"array",
    8.         "elementType":{ 
    9.             "type":"string"
    10.         }
    11.     }

    object 对象(结构体)类型

    支持以逗号分割的经纬度字符串以及map类型. 默认支持3种格式转换: 逗号分割字符:145.1214,126.123 ,json格式:{"lat":145.1214,"lon":126.123}.

    1.   例:
    3.     {
    4.       "type":"geoPoint"