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

前序系列文章>>>



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



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



一、数据类型



• 布尔型（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"。