跳至主要内容

MQTT 設備接入

提示

所有類型的設備都可以通過 MQTT 方式接入到 Neuron 平台。

您的設備將通過 MQTT 服务器發送數據，Neuron 平台會根據您配置的 MQTT 服务器和 Topic（主題）訂閱設備數據。因此，您需要先正確配置所使用的 MQTT 服务器和 Topic。在 Topic 的 Payload 中需包含設備各點位的實時數據，請確保 Payload 中的點位名稱（name）與 Neuron 平台內物模型的 Function Type（點） 名稱一致（忽略大小寫），否則平台將無法識別相應數據。

MQTT

預配置​

通過 MQTT 方式接入的設備需提前 確認或配置 所使用的：

  1. MQTT 服务器
  2. 主題
  3. 設備上報的數據格式

1. 配置 MQTT 服务器​

在左側菜單點擊 MQTT 管理 - MQTT 服务器，查看系統內已存在的 MQTT 服务器。點擊 添加 按鈕可新增您的 MQTT 服务器。

MQTT_List

填寫 MQTT 服务器信息：

  • 名稱：不可重複，必填
  • 主機/端口：根據 MQTT 服务器的信息輸入，必填
  • 用戶名/密碼：有則填入
  • 狀態：開啟

MQTT_Server_ADD

2. 配置主題​

在左側菜單點擊 MQTT 管理 - 主題，查看系統內已存在的主題。點擊 添加 按鈕可新增主題。

topic

填寫主題信息：

topic_add

  • 名稱：不可重複，必填
  • MQTT 服务器：選擇所使用的 MQTT 服务器，如沒有則需要先添加（見上文）
  • ETL 類型：必填，選擇數據的類型（IoT/BMS/OpenAPI等）。例如：若是 IoT 設備則選擇 IOT_DATA；BMS 設備則選擇 BMS_API；通過 openAPI 接入則選擇 openAPI
    • ETL_Type
    • ETL_Type_JSON
    • 選擇後需 檢查下方的 JSON 格式 是否與設備上報的數據格式一致。系統會按照 MQTT 服务器信息訂閱並解析此 JSON。若格式不匹配，設備接入將失敗，需要 選擇/新增 ETL 轉換器（詳見下文 3. ETL 轉換器）。
    • ETL_Converter_check
  • 狀態：開啟
  • ETL 轉換器：若默認的 JSON 格式與您的設備不匹配，則需要 新增並選擇 您的 ETL 轉換器（詳見下文 3. ETL 轉換器）。

3. 配置 ETL 轉換器​

配置設備上報數據 JSON 格式。

在左側菜單點擊 系統設置 - 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. 選擇接入方式​

在 設備管理列表頁 點擊“添加”按鈕，進入設備接入流程。

device_list

接入方式選擇 MQTT，點擊 下一步

deviceAccess

2. 選擇數據上報格式​

設備數據的推送有著嚴格的格式匹配規則，系統會按照您配置的 MQTT 服务器信息訂閱並解析。若已選擇的數據上報 JSON 格式與真實的上報格式不匹配，設備接入將失敗，需要 選擇/新增 ETL 轉換器（詳見上文或查看【ETL 轉換器】）。

選擇系統預置的格式​

列表默認展示系統預置的格式，選擇一個匹配的格式後，點擊 下一步 去配置物模型。

mqtt_dataFormat_default

選擇已創建的 ETL 轉換器​

如您的設備上報格式與系統預置的不匹配，則需要 選擇/新增 ETL 轉換器。系統會根據選擇的轉換器中的格式解析數據。

點擊切換到 轉換器 面板選擇一個已經創建的 ETL 轉換器。

mqtt_dataFormat_converter

如需新增 ETL 轉換器，操作詳見【ETL 轉換器】。

3. 配置物模型​

提示

物模型定義：在 Neuron 平台內，將某一類具有相同能力或特徵的設備的合集被稱為一款物模型。詳見【物模型管理】。

可以選擇 已存在 的物模型或 創建新的 物模型。

選擇已存在的物模型​

選擇所需的物模型後點擊 下一步，進入設備註冊頁面。

支持通過物模型名稱/類型/品牌快速檢索。

mqtt_check_device_twins

新增物模型​

點擊 新增物模型按鈕，進入新增界面，填寫物模型信息後，點擊“提交”按鈕創建物模型。

mqtt_add_device_twins

注意：物模型名稱不可重複，信息提交時系統會驗證名稱唯一性，名稱重複則添加不成功。

配置 Function Type（點）​

創建物模型成功後，可直接進行該物模型下的 Function Type 配置。

點擊圖中所指的 “加號”按鈕，進入 Function Type 新增頁。

lora_add_device_twins_functions

點擊 Function type 輸入框，選擇/新增 一個 Function type。其餘配置說明詳見【物模型管理】。

lora_adding_device_twins_functions

如該物模型有多個 Function Type 可重複上面步驟，添加多個 Function Type。配置完成後，點擊 下一步，進入設備註冊頁面。

mqtt_added_device_twins_functions

4. 選擇主題​

Neuron 平台會根據您配置的 MQTT 服务器 和 主題 訂閱設備數據。因此，您需要先正確配置所使用的 MQTT 服务器和主題。

選擇已存在的主題​

選擇所需的主題後點擊 下一步，進入設備註冊頁面。

支持基於名稱的快速檢索。

mqtt_add_device_networkServer

新增主題​

填寫主題信息：

topic_add

  • 名稱：不可重複，必填
  • MQTT 服务器：選擇所使用的 MQTT 服务器，如沒有則需要先添加（見上文）
  • ETL 類型：必填，選擇數據的類型（IoT/BMS/OpenAPI等）。例如：若是 IoT 設備則選擇 IOT_DATA；BMS 設備則選擇 BMS_API；通過 openAPI 接入則選擇 openAPI
    • ETL_Type
    • ETL_Type_JSON
    • 選擇後需 檢查下方的 JSON 格式 是否與設備上報的數據格式一致。系統會按照 MQTT 服务器信息訂閱並解析此 JSON。若格式不匹配，設備接入將失敗，需要 選擇/新增 ETL 轉換器。
    • ETL_Converter_check
  • 狀態：開啟
  • ETL 轉換器：若默認的 JSON 格式與您的設備不匹配，則需要 新增並選擇 您的 ETL 轉換器（詳見上文或查看【ETL 轉換器】）。

配置完成後，點擊 下一步，進入設備註冊頁面。

5. 設備註冊​

支持兩種錄入方式：在線編輯 或 下載 Excel 批量錄入。

設備綁定平台項目​

註冊設備前，請先選擇設備所屬的項目。點擊 項目下拉框 選擇現有項目。如尚未創建項目，請先新建一個，操作詳見【創建項目】。

lora_add_device_binding_project

批量 Excel​

操作步驟：下載模板 -> 填寫 Excel -> 上傳 Excel -> 如有錯誤則進行在線編輯 -> 點擊 下一步 完成設備註冊。

下載模板​

在設備註冊頁，點擊下圖紅框處，下載模板文件。

lora_add_device_download_temp

填寫 Excel​

將需要錄入的設備信息填入 Excel。MQTT 的模板分為 IoT 設備和非 IoT 設備兩種：

IoT 設備模板​

lora_add_device_download_temp_csv

  • DevEUI：IoT 設備唯一標識，通常填寫設備上的 DevEUI 即可，必填。
  • deviceName：設備名稱，不可重複，必填。
  • buildingName：樓宇位置信息，必填。
  • location：設備位置，非必填。
非 IoT 設備模板​

noniot_excel

  • rawId：IoT 設備唯一標識，通常填寫設備功能點的 ID 即可，必填。
  • buildingName：樓宇位置信息，必填。
  • deviceName：設備名稱，多个功能點可以填寫同一設備名稱，系統會認為這些功能點屬於同一設備，必填。
  • functionType：設備功能點位，需要和所選物模型下的功能點相匹配，必填。
  • location：設備位置，非必填。
  • isIot：標識是否為 IoT 設備，為空默認為非 IoT 設備，非必填。
上傳 Excel​

點擊/拖拽 下圖紅框處，將填寫好的 Excel 上傳至平台。上傳的設備信息將會展示在在線表格中，如有錯誤可以繼續增刪改。

mqtt_add_device_upload_temp

在線編輯​

在頁面上填寫設備信息，點擊 新增按鈕 添加新一行，繼續錄入設備信息。

mqtt_add_device_ui_add_iot

設備信息填寫完成後，點擊 提交按鈕，出現確認窗口，確認後即可完成設備註冊。

注意：設備註冊成功表示已在 Neuron 平台登記，狀態為 已登記，但未接通實時數據。系統會根據配置的參數去訂閱上報的數據並清洗入庫後，設備狀態更新為 已連接，並顯示在設備列表中。

mqtt_add_device_submit_confirm_iot

註冊完成後會跳轉到 設備註冊頁（見下圖紅框處為剛註冊的設備數據），平台訂閱到規範的上報數據後，設備即接入成功。

lora_add_device_submit_success

設備註冊成功後，可在設備管理界面查看設備信息及數據，具體操作詳見【設備管理】。