标准事物定义

标准事物定义

通过提供统一和开放的常用事物描述模板，既可以减少设备功能定义工作量，又可以提高产品可交互性。

用户在创建产品时，可以选择使用标准的事物描述，或者在自定义事物描述使用标准的属性或操作等。

关于如何自定义事物描述请参考设备管理后台界面。

标准事物描述

https://{domain-name}/v2/device/schema/list

标准事物描述模板 (schema) 定义了一些常见的标准类型的设备，并详细描述了其基本属性，操作和事件。

用户在开发和添加新产品前，可以指定其标准模式的名称，这样新创建的设备就包含这个标准模式的属性，操作和事件。

使用标准模式可以大大减少用户重复定义产品能力描述的时间，还可以促进物联网设备接口的标准化。

例如:

{
    "@context": "https://iot.domain-name.org/schemas",
    "@type": "OnOffSwitch",
    "id": "OnOffSwitch",
    "name": "On/Off Switch",
    "description": "On/Off 开关示例",
    "properties": {
        "temperature": {
            "@type": "temperature"
        }
    },
    "actions": {
        "setOn": {
            "@type": "setOn"
        }
    },
    "events": {
        "overheated": {
            "@type": "overheated"
        }
    }
}

上述文档描述了一个标准设备 OnOffSwitch 开关，它包含一个标准属性 temperature, 一个标准操作 setOn 以及一个标准事件 overheated

标准属性模板

https://{domain-name}/v2/device/schema/property/list

标准属性定义了标准模式 (schema) 包含的属性的描述

如温湿度等:

{
    "temperature": {
        "title": "Temperature",
        "type": "number",
        "unit": "°C"
    },
    "humidity": {
        "title": "Humidity",
        "type": "number",
        "unit": "%RH",
        "minimum": 0,
        "maximum": 100
    }
}

标准操作模板

https://{domain-name}/v2/device/schema/actions/list

标准操作定义了标准模式 (schema) 包含的操作的描述

例如:

{
    "setOff": {},
    "setOn": {},
}

标准事件模板

https://{domain-name}/v2/device/schema/events/list

标准事件定义了标准模式 (schema) 包含的事件的描述

例如:

{
    "overheated": {
        "type": "number",
        "unit": "degree celcius"
    }
}

常见单位

本节定义了常用的标准数据单位类型

未分类

  • % 百分比
  • %RH 相对湿度
  • m³/s 立方米每秒
  • kg/s 千克每秒
  • r/min 转每分钟
  • t/h 吨每小时
  • KCL/h 千卡每小时
  • L/s 升每秒
  • m³/h 立方米每小时
  • ppm 百万分率
  • pixel 像素
  • Lux 照度
  • grav 重力
  • dBm 分贝
  • lm 流明
  • rad 弧度
  • Hz 赫兹
  • N 牛

能量

  • cal 卡路里
  • kcal 千卡
  • kJ 千焦
  • J 焦耳

温度

  • K 开尔文
  • °C 摄氏度
  • °F 华氏度

容量

  • GB 吉字节
  • MB 兆字节
  • KB 千字节
  • B 字节
  • bit 比特

质量比

  • g/mL 克每毫升
  • g/L 克每升
  • mg/L 毫克每升
  • μg/L 微克每升
  • μg/m³ 微克每立方米
  • mg/m³ 毫克每立方米
  • g/m³ 克每立方米
  • kg/m³ 千克每立方米

电容

  • nF 纳法
  • pF 皮法
  • μF 微法
  • F 法拉

电流

  • μA 微安
  • mA 毫安
  • kA 千安
  • A 安培

电压

  • mV 毫伏
  • V 伏特

时间

  • ms 毫秒
  • s 秒
  • min 分钟
  • h 小时
  • day 日
  • week 周
  • month 月
  • year 年

速度

  • kn 节
  • km/h 千米每小时
  • m/s 米每秒

功率

  • μW 微瓦
  • mW 毫瓦
  • W 瓦特
  • kW 千瓦

电气

  • Ω 欧姆
  • kWh 千瓦时
  • Wh 瓦时
  • eV 电子伏

压力

  • Mpa 兆帕
  • mPa 毫帕
  • hPa 百帕
  • kPa 千帕
  • Pa 帕斯卡

重量

  • mg 毫克
  • g 克
  • kg 千克
  • t 吨

体积

  • mL 毫升
  • L 升
  • mm³ 立方毫米
  • cm³ 立方厘米
  • m³ 立方米
  • km³ 立方千米

面积

  • mm² 平方毫米
  • cm² 平方厘米
  • m² 平方米
  • km² 平方千米

长度

  • nm 纳米
  • μm 微米
  • mm 毫米
  • cm 厘米
  • dm 分米
  • km 千米
  • m 米

经纬度

  • ° 度
  • ′ 分
  • ″ 秒
image-modal