MQTT 设备接入
所有类型的设备都可以通过 MQTT 方式接入到 Neuron 平台。
您的设备将通过 MQTT Server 发送数据,Neuron 平台会根据您配置的 MQTT Server 和 Topic 订阅设备数据。因此 ,您需要先正确配置所使用的 MQTT Server 和 Topic 。在 Topic 的 Payload 中需包含设备各点位的实时数据,请确保 Payload 中的点位名称(name)与 Neuron 平台内物模型的 Function Type 名称一致(忽略大小写),否则平台将无法识别相应数据。
预配置
通过 MQTT 方式接入的设备需提前确认或配置所使用的
- MQTT 服务器
- 主题
- 设备上报的数据格式
1. 配置 MQTT 服务器
在左侧菜单点击 MQTT 管理 - MQTT 服务器,查看系统内已存在的 MQTT 服务器。点击添加按钮可新增您的 MQTT 服务器。
填写 MQTT 服务器信息:
- 名称:不可重复,必填
- 主机/端口:根据 MQTT 服务器的信息输入,必填
- 用户名/密码:有则填入
- 状态:开启
2. 配置主题
在左侧菜单点击 MQTT 管理 - 主题,查看系统内已存在的主题。点击添加按钮可新增主题。
填写主题信息
- 名称:不可重复,必填
- MQTT 服务器:选择所使用的 MQTT 服务器,如没有则需要先添加(见上文)
- ETL 类型:必填,选择数据的类型(IoT/BMS/OpenAPI 等)。例如:若是 IoT 设备则选择 IOT_DATA;BMS 设备则选择 BMS_API;通过 openAPI 接入则选择 openAPI
- 选择后需检查下方的 JSON 格式是否与设备上报的数据格式一致。系统会按照 MQTT 服务器信息订阅并解析此 JSON。若格式不匹配,设备接入将失败,需要选择/新增 ETL 转换器(详见下文 3. ETL 转换器)。
- 状态:开启
- ETL 转换器:若默认的 JSON 格式与您的设备不匹配,则需要新增并选择您的 ETL 转换器(详见下文 3. ETL 转换器)
3. 配置 ETL 转换器
配置设备上报数据 JSON 格式。
在左侧菜单点击系统设置 - ETL 转换器,查看系统内已存在的 ETL 转换器。点击添加按钮可新增 ETL 转换器。
填写 ETL 转换器信息
- 名称:不可重复,必填
- 类型: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. 选择接入方式
在设备管理列表页点击“添加”按钮,进入设备接入流程
接入方式选择 MQTT,点击下一步
2. 选择数据上报格式
设备数据的推送有着严格的格式匹配规则,系统会按照您配置的 MQTT 服务器信息订阅并解析。若已选择的数据上报 JSON 格式与真实的上报格式不匹配,设备接入将失败,需要选择/新增 ETL 转换器(详见上文或查看【ETL 转换器】)。
选择系统预置的格式
列表默认展示系统预置的格式,选择一个匹配的格式后,点击下一步去配置物模型。
选择已创建的 ETL 转换器
如您的设备上报格式与系统预置的不匹配,则需要选择/新增 ETL 转换器。系统会根据选择的转换器中的格式解析数据。
点击切换到 转换器 面板选择一个已经创建的 ETL 转换器。
如需新增 ETL 转换器,操作详见【ETL 转换器】