前序系列文章>>>
對各種資料型別以及平臺使用的資料做一個簡單的說明~
一、資料型別
-
布林型(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"。