跳至主要内容

數據中台的接入預配置

概述​

在設備完成硬體接入配置後，在接入數據中台前您需要在數據中台進行一系列預配置，以便平台能夠識別、接收並處理設備數據。

開始之前​

權限配置​

為確保以下操作流程正常進行，請您確認是否擁有專案管理員權限。

前置配置​

在設備接入 Neuron 數據中台之前，請務必確保您已完成硬體接入配置。硬體接入配置是設備與網路伺服器建立通訊、完成數據解析的關鍵前提，如同為設備辦理「入網許可」和「語言翻譯」，確保其數據能夠被正確接收和理解。

預配置操作​

配置物模型​

無論選擇哪種方式接入設備, 都需要提前配置物模型, 中台透過設備的物模型識別數據。

設備接入前可在中台物模型列表中進行預配置，或在設備接入過程中逐一配置。詳情請見【物模型管理】

device_twins_list

透過 MQTT 方式接入的預配置​

透過 MQTT 方式接入的設備需提前確認並配置所使用的

  1. MQTT Server
  2. Topic
  3. 設備上報的數據格式

配置 MQTT Server​

在左側選單點選 MQTT 管理 - MQTT 伺服器，檢視系統內已存在的 MQTT Server。點選新增按鈕可新增您的 MQTT Server。

MQTT_List

填寫 MQTT Server 資訊（需要專案管理員權限）：

  • 名稱：不可重複，必填
  • 主機/端口：根據 MQTT Server 的資訊輸入，必填
  • 使用者名稱/密碼：有則填入
  • SSL憑證：不帶憑證的host前綴為 tcp://，帶憑證的前綴為 ssl://
    • 不帶憑證的介面：
    • 帶憑證的介面(SSL配置)：
  • 狀態：開啟 MQTT_Server_ADD

配置 Topic​

在左側選單點選 MQTT 管理 - Topic，檢視系統內已存在的 Topic。點選新增按鈕可新增主題。

topic

  • Topic：必填，輸入訂閱的 Topic

  • MQTT Server：必填，選擇所使用的 MQTT Server，如沒有則需要先新增（配置 MQTT 伺服器）

  • Category: 系統分為三類

    • Other: 預設選擇, 表示 Topic 僅支援精確匹配 (topic name完全一致才能訂閱成功, 只允許主題層級分隔符 / 和普通的UTF-8字元, 不能包含 + 和 #);
    • LoRaWAN NS: 表示 Topic 支援萬用字元 (萬用字元格式不是一個完整的、確定的主題名，而是一個主題過濾器，用於訂閱，可以匹配多個具體的主題, 通常包含+/#字元);
    • Dataset: 此功能暫未開放; topic_add

  • ETL 類型：必填，選擇數據的類型（IoT/BMS/OpenAPI 等）。例如：若是 IoT 設備則選擇 IOT_DATA；BMS 設備則選擇 BMS_API；透過 openAPI 接入則選擇 openAPI

    • ETL_Type
    • ETL_Type_JSON
    • 選擇後需檢查下方的 JSON 格式是否與設備上報的數據格式一致。系統會按照 MQTT Server 資訊訂閱並解析此 JSON。若格式不匹配，設備接入將失敗，需要選擇/新增 ETL 轉換器（詳見下文 配置 ETL 轉換器）
    • ETL_Converter_check

  • ETL 轉換器類型：若預設的 JSON 格式與您的設備不匹配，則需要 ETL 轉換器作為橋樑精準指定單設備數據物件與系統所需數據格式間的匹配關係，目前僅支援ETL轉換器，JS轉換器敬請期待。

  • ETL 轉換器：鑑於數據格式不匹配，新增並選擇您的 ETL 轉換器（詳見下文 配置 ETL 轉換器）。

  • 狀態：開啟

配置設備上報的數據格式​

配置 ETL 轉換器​

在左側選單點選系統設定 - ETL 轉換器，檢視系統內已存在的 ETL 轉換器。點選新增按鈕可新增 ETL 轉換器。

ETL_Converter

填寫 ETL 轉換器資訊

Add_Data_Converter

  • 名稱：不可重複，必填；
  • 類型：IoT/Non IoT；
  • Payload content/有效負載內容：設備上報數據 JSON 格式，必填；
  • Device ID key：匹配 JSON 中用來識別設備的唯一 ID，通常為 Device ID / DevEUI，必填；
  • Device points object key：匹配 JSON 中設備上報數據的點位，必填；
  • Date key：匹配 JSON 中設備上報數據的時間；
  • Device name key：匹配後在平台中用於展示的設備名稱；
  • Device location key：匹配後在平台中用於標記設備的位置資訊；
  • 狀態：開啟。

操作詳見【ETL 轉換器】。

確認設備接入的方式​

當您完成以上所有預配置操作後，即可選擇您的設備接入數據中台的方式；數據中台目前支援四種設備接入方式，您可以根據實際需求選擇最合適的方式：

  1. LoRaWAN：連接您已有的LoRaWAN網路伺服器，獲取IoT設備數據。
  2. MQTT：支援所有類型設備透過MQTT協議接入（此方式需要提前確認並配置所使用的MQTT Server、ETL Converter和Topic）。
  3. API：呼叫API介面直接獲取設備數據。
  4. Bluetooth：透過藍牙連線的方式獲取設備數據，僅適用於藍牙電子鎖。