【塗鴉物聯網足跡】塗鴉雲平臺資料型別和取值約束說明

IoT雲工坊發表於2020-11-16

前序系列文章>>>

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

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

一、資料型別

  • 布林型(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"。

相關文章