API 設備接入
所有類型的設備都可以通過 API 方式接入到 Neuron 平台。
1. 選擇接入方式
在 設備管理列表頁 點擊“添加”按鈕,進入設備接入流程
接入方式選擇 API,點擊 下一步
2. 選擇令牌
使用 API 推送設備數據,需要在 Neuron 平台先申請令牌,根據提供的 Demo 算法,調用 API 接口完成設備接入。
選擇已存在的令牌
選擇所需的令牌後點擊 下一步,進入物模型的配置。
支持通過令牌名稱快速檢索,點擊右側紅框處可以下載令牌文本。
新增令牌
點擊 新增令牌,進入新增界面,填寫令牌名稱(系統內不可重複)。
3. 配置物模型
物模型定義:在 Neuron 平台內,將某一類具有相同能力或特徵的設備的合集被稱為一款物模型。詳見【物模型管理】。
可以選擇 已存在 的物模型或 創建新的 物模型。
選擇已存在的物模型
選擇所需的物模型後點擊 下一步,進入設備註冊頁面。
支持通過物模型名稱/類型/品牌快速檢索。
新增物模型
點擊 新增物模型按鈕,進入新增界面,填寫物模型信息後,點擊“提交”按鈕創建物模型。
注意:物模型名稱不可重複,信息提交時系統會驗證名稱唯一性,名稱重複則添加不成功。
配置 Function Type (點)
創建物模型成功後,可直接進行該物模型下的 Function Type 配置。
點擊圖中所指的 “加號”按鈕,進入 Function Type 新增頁。
點擊 Function type 輸入框,選擇/新增 一個 Function type。其餘配置說明詳見【物模型管理】。
如該物模型有多個 Function Type,可重複上面步驟,添加多個 Function Type。配置完成後, 點擊 下一步,進入設備註冊頁面。
4. 設備註冊
支持兩種錄入方式:在線編輯 或 下載 Excel 批量錄入。
設備綁定平台項目
註冊設備前,請先選擇設備所屬的項目。點擊 項目下拉框 選擇現有項目。如尚未創建項目,請先新建一個,操作詳見【創建項目】。
批量 Excel
操作步驟:下載模板 -> 填寫 Excel -> 上傳 Excel -> 如有錯誤則進行在線編輯 -> 點擊 下一步 完成設備註冊。
下載模板
在設備註冊頁,點擊下圖紅框處,下載模板文件。
填寫 Excel
將需要錄入的設備信息填入 Excel。
- DevEUI:IoT 設備唯一標識,通常填寫設備上的 DevEUI 即可,必填。
- deviceName:設備名稱,不可重複,必填。
- buildingName:樓宇位置信息,必填。
- location:設備位置,非必填。
上傳 Excel
點擊/拖拽 下圖紅框處,將填寫好的 Excel 上傳至平台。上傳的設備信息將會展示在在線表格中,如有錯誤可以繼續增刪改。
在線編輯
在頁面上填寫設備信息,點擊 新增按鈕 添加新一行,繼續錄入設備信息。
設備信息填寫完成後,點擊 提交按鈕,出現確認窗口,確認後即可完成設備註冊。
註冊完成後會跳轉到 設備註冊頁,平台接收到規範的上報數據後,設備即接入成功。
設備註冊成功後,可在設備管理界面查看設備信息及數據,具體操作詳見【設備管理】。
API 調用方法
完成設備註冊後,需在您的系統內完成 API 調用,操作詳見【Open API 指南】。
注意:設備註冊成功表示已在 Neuron 平台登記,狀態為 已登記,但未接通實時數據。系統接收到上報的數據並清洗入庫後,設備狀態更新為 已連接,並顯示在設備列表中。