Skip to main content

LoRaWAN 设备接入

概述​

本文档指导您通过LoRaWAN协议将IoT设备接入Neuron平台。全程包含三个核心步骤：从配置LoRaWAN网络服务器（如ChirpStack、Netmore），到定义设备物模型，最终完成设备注册。

开始之前​

权限配置​

为确保以下操作流程正常进行，请您确认是否拥有项目管理员权限。

前置配置​

完成硬件接入配置​

在设备接入 Neuron 数据中台之前，请务必确保您已完成硬件接入配置。硬件接入配置是设备与网络服务器建立通信、完成数据解析的关键前提，如同为设备办理“入网许可”和“语言翻译”，确保其数据能够被正确接收和理解。 请您根据设备的来源与通信方式，选择并完成以下相应的预配置指南：

只有完成上述任一种预配置后，您才能顺利执行后续在中台的设备注册与接入操作。

配置物模型​

tip

物模型定义：在 Neuron 平台内，将某一类具有相同能力或特征的设备的合集被称为一款物模型。

设备接入前可在中台物模型列表中进行预配置，或在设备接入过程中逐一配置。详情请见【物模型管理】。

device_twins_list

选择接入方式​

在设备管理列表页点击“添加”按钮，进入设备接入流程。

device_list

接入方式选择 LoRaWAN，点击下一步。

deviceAccess

选择 LoRaWAN NS​

tip

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 平台登记，状态为已登记，但未接通实时数据。系统会根据配置的参数去订阅上报的数据并清洗入库后，设备状态更新为已连接，并显示在设备列表中。