跳至主要内容

API 設備接入

提示

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

1. 選擇接入方式

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

device_list

接入方式選擇 API,點擊 下一步

deviceAccess

2. 選擇令牌

提示

使用 API 推送設備數據,需要在 Neuron 平台先申請令牌,根據提供的 Demo 算法,調用 API 接口完成設備接入。

選擇已存在的令牌

選擇所需的令牌後點擊 下一步,進入物模型的配置。

支持通過令牌名稱快速檢索,點擊右側紅框處可以下載令牌文本。

api_add_device_token

新增令牌

點擊 新增令牌,進入新增界面,填寫令牌名稱(系統內不可重複)。

api_add_token_name

3. 配置物模型

提示

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

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

選擇已存在的物模型

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

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

api_checked_device_twins

新增物模型

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

api_add_device_twins_name

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

配置 Function Type (點)

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

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

lora_add_device_twins_functions

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

lora_adding_device_twins_functions

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

api_added_device_twins_functions

4. 設備註冊

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

設備綁定平台項目

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

lora_add_device_binding_project

批量 Excel

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

下載模板

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

api_add_device_download_temp_iot

填寫 Excel

將需要錄入的設備信息填入 Excel。

lora_add_device_download_temp_csv

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

上傳 Excel

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

api_add_device_upload_temp_iot

在線編輯

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

lora_add_device_ui_add

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

lora_add_device_submit_confirm

註冊完成後會跳轉到 設備註冊頁,平台接收到規範的上報數據後,設備即接入成功。

api_add_device_submit_success_iot

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

API 調用方法

完成設備註冊後,需在您的系統內完成 API 調用,操作詳見【Open API 指南】。

注意:設備註冊成功表示已在 Neuron 平台登記,狀態為 已登記,但未接通實時數據。系統接收到上報的數據並清洗入庫後,設備狀態更新為 已連接,並顯示在設備列表中。

API 代碼示例下載

JAVA 示例文件

Golang 示例文件

.Net 示例文件