16

【涂鸦物联网足迹】涂鸦云平台数据类型和取值约束说明

 3 years ago
source link: https://segmentfault.com/a/1190000038181580
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

前序系列文章>>>

【涂鸦物联网足迹】涂鸦云平台接口列表—智能门锁

对各种数据类型以及平台使用的数据做一个简单的说明~

一、数据类型

  • 布尔型(Boolean):非真即假的二值型变量。例如,开关功能,取值为开或关。
  • 数值型(Integer):适用于可线性调节类型的数据。例如:温度调节,温度范围 20-40℃。
  • 枚举型(Enum):有限集合值。例如:工作档位,低档、中档或高档。
  • 字符串型(String):字符串类型。
  • 对象类型(Json):下发的值是一个对象的 Json 格式,会有对应对象属性的说明解释。

二、数据传输类型:

  • 可下发可上报:指令数据可以下发给设备,设备数据可以上报给云端。
  • 只上报:数据只支持从设备上报。
  • 只下发:数据只支持从云端下发。

三、取值约束

(一)Integer 类型示例格式:

{"min":11,"unit":"s","scale":0,"max":86400,"step":1}

取值约束说明

  • min:最小取值。示例值:11。
  • max:最大取值。示例值:86400。
  • unit:数值的单位。示例值:s 。
  • scale:数据将以 10 的指数转换进行传输。示例:0, 表示 10 的 0 次方,即1。
  • step:数据增量间距(即步长)。示例值:1。

    Scale 参数说明

以下为当前电压取值的取值约束示例。scale 的取值是 1。

如果查询设备状态得到的值是 {"cur_voltage":2230},那么用户可读值为 2230/(10^1 )= 223V (即电压是:223伏特)。

VNbyEv6.png!mobile

取值约束范围说明

本文档中在指定的取值范围约束为参考范围,实际每个设备有特定的具体取值约束范围。

(二) String 类型示例格式

{"maxlen":255}

取值约束说明

  • maxlen:值最大长度。示例值:255。

(三)Enum 类型示例格式

{"range":["1","2","3","4","5"]}

取值约束说明

  • range:枚举取值限定范围。示例为:"1","2","3","4","5"。

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK