跳至主要内容

LoRaWAN 設備接入

概述​

本文檔指導您透過LoRaWAN協議將IoT設備接入Neuron平台。全程包含三個核心步驟：從配置LoRaWAN網路伺服器（如ChirpStack、Netmore），到定義設備物模型，最終完成設備註冊。

開始之前​

權限配置​

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

前置配置​

完成硬體接入配置​

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

只有完成上述任一種預配置後，您才能順利執行後續在中台的設備註冊與接入操作。

配置物模型​

提示

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

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

device_twins_list

選擇接入方式​

在設備管理列表頁點選“新增”按鈕，進入設備接入流程。

device_list

接入方式選擇 LoRaWAN，點選下一步。

deviceAccess

選擇 LoRaWAN NS​

提示

LoRaWAN NS 是 LoRaWAN 網路中的核心組件之一，負責處理終端節點（如感測器、執行器等）與應用伺服器之間的通訊【如 ChirpStack、Activiti、Netmore等】。它作為數據傳輸的樞紐，管理著終端節點的連線、數據的轉發、儲存以及協議轉換等關鍵任務。

可以選擇已存在的 NS 或建立自己的 NS。

選擇已存在的 LoRaWAN NS​

選擇時需注意 MQTT 伺服器的資訊，以及數據接入的 JSON 格式，系統會嚴格按照 MQTT 伺服器資訊進行設備數據訂閱，並按照 NS 的數據接入 JSON 進行數據解析，如不匹配，則設備接入不成功。

選擇所需的 NS 後點選下一步，進入物模型的配置。

支援透過 NS 名稱或類型快速檢索。

device_access_step

新增 LoRaWAN NS​

點選新增 LoRaWAN NS 按鈕，進入新增介面，填寫您的 NS 資訊。

added_lora_ns

  1. LoRaWAN NS 名稱：不可重複，必填。

  2. LoRaWAN NS 類型：選擇連線的類型（例如：ChirpStack / Actility / Netmore），必填。

    • 若透過 Netmore 營運商網路接入, 則需要選擇 Netmore。
    • 若透過 Neuron 的技術支援團隊索提供 chirpstack 平台接入, 則需要選擇 ChirpStack V4。

  3. MQTT Broker (Server)：選擇所需的 Broker (MQTT Server)，必填。

    • 若透過 Neuron 的技術支援團隊索提供 Chirpstack 平台接入, 則需要選擇 Neuron SEA MQTT Server。

    • 新增：輸入MQTT Server 名稱以及所需的 Broker URL (代理地址) / Port (端口)；MQTT 的使用者名稱和密碼（非必填，有則填入）。

    註：頁面新增SSL憑證配置介面;不帶憑證的host前綴為tcp://,帶憑證的前綴為ssl://
    (1) 不帶憑證的頁面： (2) 帶憑證的頁面(SSL配置)：

  4. Topic：必填， 輸入設備上報數據時使用的 Topic (如在Chirpstack 平台接入設備時產生的 Topic )，支援萬用字元格式 (萬用字元格式不是一個完整的、確定的主題名，而是一個主題過濾器，用於訂閱，可以匹配多個具體的主題, 通常包含+/#字元)。

LoRaWAN NS 資訊填寫完成後點選提交按鈕，系統會驗證 MQTT 資訊的連線是否正常，異常則新增不成功。連線成功後點選下一步，進入物模型的配置。

選擇物模型​

選擇已存在的物模型​

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

lora_check_device_twins

新增物模型​

點選新增物模型按鈕，進入新增介面，填寫物模型資訊後，點選“提交”按鈕建立物模型。

lora_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。配置完成後，點選下一步，進入設備註冊頁面。

lora_added_device_twins_functions

設備註冊​

支援兩種錄入方式：線上編輯或下載 Excel 批次錄入。

設備綁定平台專案​

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

lora_add_device_binding_project

批次 Excel​

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

下載範本​

在設備註冊頁，點選下圖紅框處，下載範本檔案。

lora_add_device_download_temp

填寫 Excel​

將需要錄入的設備資訊填入 Excel。

lora_add_device_download_temp_csv

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

上傳 Excel​

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

lora_add_device_upload_temp

線上編輯​

在頁面上填寫設備資訊，點選新增按鈕新增新一行，繼續錄入設備資訊。

lora_add_device_ui_add

設備資訊填寫完成後，點選提交按鈕，出現確認視窗，確認後即可完成設備註冊。

lora_add_device_submit_confirm

註冊完成後會跳轉到設備註冊頁（見下圖紅框處為剛註冊的設備數據），平台訂閱到規範的上報數據後，設備即接入成功。設備註冊成功後，可在設備管理介面檢視設備資訊及數據，具體操作詳見【設備管理】。

lora_add_device_submit_success

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