塗鴉雲平臺資料型別和取值約束說明

前序系列文章>>>

【塗鴉物聯網足跡】塗鴉雲平臺介面列表—智慧門鎖

對各種資料型別以及平臺使用的資料做一個簡單的說明~

一、資料型別

• 布林型（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伏特)。

code	名稱	資料型別	取值約束
cur_voltage	當前電壓	Integer	{“unit”:“V”,“min”:0,“max”:5000,“scale”:1,“step”:1}

    取值約束範圍說明
本文件中在指定的取值範圍約束為參考範圍，實際每個裝置有特定的具體取值約束範圍。

（二）String 型別示例格式

{"maxlen":255}

    取值約束說明

• maxlen：值最大長度。示例值：255。

（三）Enum 型別示例格式

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

    取值約束說明

• range：列舉取值限定範圍。示例為："1","2","3","4","5"。