MQTT 設備接入
所有類型的設備都可以通過 MQTT 方式接入到 Neuron 平台。
您的設備將通過 MQTT 服务器發送數據,Neuron 平台會根據您配置的 MQTT 服务器和 Topic(主題)訂閱設備數據。因此,您需要先正確配置所使用的 MQTT 服务器和 Topic。在 Topic 的 Payload 中需包含設備各點位的實時數據,請確保 Payload 中的點位名稱(name)與 Neuron 平台內物模型的 Function Type(點) 名稱一致(忽略大小寫),否則平台將無法識別相應數據。
預配置
通過 MQTT 方式接入的設備需提前 確認或配置 所使用的:
- MQTT 服务器
- 主題
- 設備上報的數據格式
1. 配置 MQTT 服务器
在左側菜單點擊 MQTT 管理 - MQTT 服务器,查看系統內已存在的 MQTT 服务器。點擊 添加 按鈕可新增您的 MQTT 服务器。
填寫 MQTT 服务器信息:
- 名稱:不可重複,必填
- 主機/端口:根據 MQTT 服务器的信息輸入,必填
- 用戶名/密碼:有則填入
- 狀態:開啟
2. 配置主題
在左側菜單點擊 MQTT 管理 - 主題,查看系統內已存在的主題。點擊 添加 按鈕可新增主題。
填寫主題信息:
- 名稱:不可重複,必填
- MQTT 服务器:選擇所使用的 MQTT 服务器,如沒有則需要先添加(見上文)
- ETL 類型:必填,選擇數據的類型(IoT/BMS/OpenAPI等)。例如:若是 IoT 設備則選擇 IOT_DATA;BMS 設備則選擇 BMS_API;通過 openAPI 接入則選擇 openAPI
- 選擇後需 檢查下方的 JSON 格式 是否與設備上報的數據格式一致。系統會按照 MQTT 服务器信息訂閱並解析此 JSON。若格式不匹配,設備接入將失敗,需要 選擇/新增 ETL 轉換器(詳見下文 3. ETL 轉換器)。
- 狀態:開啟
- ETL 轉換器:若默認的 JSON 格式與您的設備不匹配,則需要 新增並選擇 您的 ETL 轉換器(詳見下文 3. ETL 轉換器)。
3. 配置 ETL 轉換器
配置設備上報數據 JSON 格式。
在左側菜單點擊 系統設置 - ETL 轉換器,查看系統內已存在的 ETL 轉換器。點擊 添加 按鈕可新增 ETL 轉換器。
填寫 ETL 轉換器信息:
- 名稱:不可重複,必填
- 類型: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. 選擇接入方式
在 設備管理列表頁 點擊“添加”按鈕,進入設備接入流程。
接入方式選擇 MQTT,點擊 下一步
2. 選擇數據上報格式
設備數據的推送有著嚴格的格式匹配規則,系統會按照您配置的 MQTT 服务器信息訂閱並解析。若已選擇的數據上報 JSON 格式與真實的上報格式不匹配,設備接入將失敗,需要 選擇/新增 ETL 轉換器(詳見上文或查看【ETL 轉換器】)。
選擇系統預置的格式
列表默認展示系統預置的格式,選擇一個匹配的格式後,點擊 下一步 去配置物模型。
選擇已創建的 ETL 轉換器
如您的設備上報格式與系統預置的不匹配,則需要 選擇/新增 ETL 轉換器。系統會根據選擇的轉換器中的格式解析數據。
點擊切換到 轉換器 面板選擇一個已經創建的 ETL 轉換器。
如需新增 ETL 轉換器,操作詳見【ETL 轉換器】。
3. 配置物模型
物模型定義:在 Neuron 平台內,將某一類具有相同能力或特徵的設備的合集被稱為一款物模型。詳見【物模型管理】。
可以選擇 已存在 的物模型或 創建新的 物模型。
選擇已存在的物模型
選擇所需的物模型後點擊 下一步,進入設備註冊頁面。
支持通過物模型名稱/類型/品牌快速檢索。
新增物模型
點擊 新增物模型按鈕,進入新增界面,填寫物模型信息後,點擊“提交”按鈕創建物模型。
注意:物模型名稱不可重複,信息提交時系統會驗證名稱唯一性,名稱重複則添加不成功。
配置 Function Type(點)
創建物模型成功後,可直接進行該物模型下的 Function Type 配置。
點擊圖中所指的 “加號”按鈕,進入 Function Type 新增頁。
點擊 Function type 輸入框,選擇/新增 一個 Function type。其餘配置說明詳見【物模型管理】。
如該物模型有多個 Function Type 可重複上面步驟,添加多個 Function Type。配置完成後,點擊 下一步,進入設備註冊頁面。
4. 選擇主題
Neuron 平台會根據您配置的 MQTT 服务器 和 主題 訂閱設備數據。因此,您需要先正確配置所使用的 MQTT 服务器和主題。
選擇已存在的主題
選擇所需的主題後點擊 下一步,進入設備註冊頁面。
支持基於名稱的快速檢索。
新增主題
填寫主題信息:
- 名稱:不可重複,必填
- MQTT 服务器:選擇所使用的 MQTT 服务器,如沒有則需要先添加(見上文)
- ETL 類型:必填,選擇數據的類型(IoT/BMS/OpenAPI等)。例如:若是 IoT 設備則選擇 IOT_DATA;BMS 設備則選擇 BMS_API;通過 openAPI 接入則選擇 openAPI
- 選擇後需 檢查下方的 JSON 格式 是否與設備上報的數據格式一致。系統會按照 MQTT 服务器信息訂閱並解析此 JSON。若格式不匹配,設備接入將失敗,需要 選擇/新增 ETL 轉換器。
- 狀態:開啟
- ETL 轉換器:若默認的 JSON 格式與您的設備不匹配,則需要 新增並選擇 您的 ETL 轉換器(詳見上文或查看【ETL 轉換器】)。
配置完成後,點擊 下一步,進入設備註冊頁面。
5. 設備註冊
支持兩種錄入方式:在線編輯 或 下載 Excel 批量錄入。
設備綁定平台項目
註冊設備前,請先選擇設備所屬的項目。點擊 項目下拉框 選擇現有項目。如尚未創建項目,請先新建一個,操作詳見【創建項目】。
批量 Excel
操作步驟:下載模板 -> 填寫 Excel -> 上傳 Excel -> 如有錯誤則進行在線編輯 -> 點擊 下一步 完成設備註冊。
下載模板
在設備註冊頁,點擊下圖紅框處,下載模板文件。
填寫 Excel
將需要錄入的設備信息填入 Excel。MQTT 的模板分為 IoT 設備和非 IoT 設備兩種:
IoT 設備模板
- DevEUI:IoT 設備唯一標識,通常填寫設備上的 DevEUI 即可,必填。
- deviceName:設備名稱,不可重複,必填。
- buildingName:樓宇位置信息,必填。
- location:設備位置,非必填。
非 IoT 設備模板
- rawId:IoT 設備唯一標識,通常填寫設備功能點的 ID 即可,必填。
- buildingName:樓宇位置信息,必填。
- deviceName:設備名稱,多个功能點可以填寫同一設備名稱,系統會認為這些功能點屬於同一設備,必填。
- functionType:設備功能點位,需要和所選物模型下的功能點相匹配,必填。
- location:設備位置,非必填。
- isIot:標識是否為 IoT 設備,為空默認為非 IoT 設備,非必填。
上傳 Excel
點擊/拖拽 下圖紅框處,將填寫好的 Excel 上傳至平台。上傳的設備信息將會展示在在線表格中,如有錯誤可以繼續增刪改。
在線編輯
在頁面上填寫設備信息,點擊 新增按鈕 添加新一行,繼續錄入設備信息。
設備信息填寫完成後,點擊 提交按鈕,出現確認窗口,確認後即可完成設備註冊。
注意:設備註冊成功表示已在 Neuron 平台登記,狀態為 已登記,但未接通實時數據。系統會根據配置的參數去訂閱上報的數據並清洗入庫後,設備狀態更新為 已連接,並顯示在設備列表中。
註冊完成後會跳轉到 設備註冊頁(見下圖紅框處為剛註冊的設備數據),平台訂閱到規範的上報數據後,設備即接入成功。
設備註冊成功後,可在設備管理界面查看設備信息及數據,具體操作詳見【設備管理】。