Skip to main content

数据中台的接入预配置

概述​

在设备完成硬件接入配置后，在接入数据中台前您需要在数据中台进行一系列预配置，以便平台能够识别、接收并处理设备数据。

开始之前​

权限配置​

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

前置配置​

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

预配置操作​

配置物模型​

无论选择哪种方式接入设备, 都需要提前配置物模型, 中台通过设备的物模型识别数据。

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

device_twins_list

通过 MQTT 方式接入的预配置​

通过 MQTT 方式接入的设备需提前确认并配置所使用的

  1. MQTT Server
  2. Topic
  3. 设备上报的数据格式

配置 MQTT Server​

在左侧菜单点击 MQTT 管理 - MQTT 服务器，查看系统内已存在的 MQTT Server。点击添加按钮可新增您的 MQTT Server。

MQTT_List

填写 MQTT Server 信息（需要项目管理员权限）：

  • 名称：不可重复，必填
  • 主机/端口：根据 MQTT Server 的信息输入，必填
  • 用户名/密码：有则填入
  • SSL证书：不带证书的host前缀为 tcp://，带证书的前缀为 ssl://
    • 不带证书的界面：
    • 带证书的界面(SSL配置)：
  • 状态：开启 MQTT_Server_ADD

配置 Topic​

在左侧菜单点击 MQTT 管理 - Topic，查看系统内已存在的 Topic。点击添加按钮可新增主题。

topic

  • Topic：必填，输入订阅的 Topic

  • MQTT Server：必填，选择所使用的 MQTT Server，如没有则需要先添加（配置 MQTT 服务器）

  • Category: 系统分为三类

    • Other: 默认选择, 表示 Topic 仅支持精确匹配 (topic name完全一致才能订阅成功, 只允许主题层级分隔符 / 和普通的UTF-8字符, 不能包含 + 和 #);
    • LoRaWAN NS: 表示 Topic 支持通配 (通配格式不是一个完整的、确定的主题名，而是一个主题过滤器，用于订阅，可以匹配多个具体的主题, 通常包含+/#字符);
    • Dataset: 此功能暂未开放; topic_add

  • ETL 类型：必填，选择数据的类型（IoT/BMS/OpenAPI 等）。例如：若是 IoT 设备则选择 IOT_DATA；BMS 设备则选择 BMS_API；通过 openAPI 接入则选择 openAPI

    • ETL_Type
    • ETL_Type_JSON
    • 选择后需检查下方的 JSON 格式是否与设备上报的数据格式一致。系统会按照 MQTT Server 信息订阅并解析此 JSON。若格式不匹配，设备接入将失败，需要选择/新增 ETL 转换器（详见下文 配置 ETL 转换器）
    • ETL_Converter_check

  • ETL 转换器类型：若默认的 JSON 格式与您的设备不匹配，则需要 ETL 转换器作为桥梁精准指定单设备数据对象与系统所需数据格式间的匹配关系，目前仅支持ETL转换器，JS转换器敬请期待。

  • ETL 转换器：鉴于数据格式不匹配，新增并选择您的 ETL 转换器（详见下文 配置 ETL 转换器）。

  • 状态：开启

配置设备上报的数据格式​

配置 ETL 转换器​

在左侧菜单点击系统设置 - ETL 转换器，查看系统内已存在的 ETL 转换器。点击添加按钮可新增 ETL 转换器。

ETL_Converter

填写 ETL 转换器信息

Add_Data_Converter

  • 名称：不可重复，必填；
  • 类型：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. LoRaWAN：连接您已有的LoRaWAN网络服务器，获取IoT设备数据。
  2. MQTT：支持所有类型设备通过MQTT协议接入（此方式需要提前确认并配置所使用的MQTT Server、ETL Converter和Topic）。
  3. API：调用API接口直接获取设备数据。
  4. Bluetooth：通过蓝牙连接的方式获取设备数据，仅适用于蓝牙电子锁。