前序系列文章>>>对各种数据类型以及平台使用的数据做一个简单的说明~
一、数据类型
- 布尔型(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伏特)。
取值约束范围说明
本文档中在指定的取值范围约束为参考范围,实际每个设备有特定的具体取值约束范围。
(二)String 类型示例格式
{"maxlen":255}
取值约束说明
- maxlen:值最大长度。示例值:255。
(三)Enum 类型示例格式
{"range":["1","2","3","4","5"]}
取值约束说明
- range:枚举取值限定范围。示例为:"1","2","3","4","5"。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。