简介
EXXN IoT Gateway是一款配备ARM处理器的多功能设备，可适应多种应用场景，包括环境传感器监测、能耗监测、氡气浓度监测、海洋环境监测以及边缘计算。本指南概述如何将EXXN IoT Gateway与ThingsBoard平台集成，以实现设备的远程监测与管理。
使用ThingsBoard开发的示例仪表板，展示EXXN IoT Gateway采集的指标。
前置条件
本教程中，我们将配置EXXN IoT网关通过MQTT API集成到ThingsBoard。为此需要：
- EXXN IoT网关”Cell 1024”
- 设备需可连接，且已通过以太网、调制解调器或Wi-Fi接入互联网
技术特性
本指南的EXXN IoT网关”Cell 1024”技术规格如下：
- ARM Cortex-A53四核64位处理器
- GPU Mali 470
- 2GB DDR4
- 8GB eMMC
- 10/100 Mbit/s以太网
- Wi-Fi 802.11 b/g/n/AC
- 蓝牙4.2
- PoE
- 可进行硬件定制开发
<img src="/images/samples/exxn/cell_1024.jpg"alt="cell 1024">
为ThingsBoard配置设备
下面介绍将设备连接到ThingsBoard所需的步骤说明。
创建设备
在浏览器中打开平台实例或ThingsBoard云平台并以租户管理员身份登录。进入”设备群组“选项卡 -> “All“，点击”+”按钮添加新设备。输入设备名称，选择现有或新建设备配置，点击”添加”按钮。
设备已创建。打开其详情，点击”复制访问令牌”按钮复制自动生成的访问令牌。
设备配置
在浏览器中打开Cell 1024管理页面：https://[IP_DEVICE]，进入”云平台”选项卡：
<img src=”/images/samples/exxn/conn1.png”alt=”conn1”>
启用云平台控制并配置所有参数，通过MQTT将设备连接到指定的ThingsBoard平台：
配置参数：
- 云平台：选择ThingsBoard
- MQTT Broker地址：要集成的服务器Broker的地址
- MQTT Broker端口：服务器的端口号
- TLS：若服务器使用传输层安全协议则选择true
- 连接类型：选择”访问令牌”选项。我们将使用在ThingsBoard中预先创建的访问令牌
- 访问令牌：填入在ThingsBoard中复制的访问令牌
说明
当前EXXN IoT网关使用”访问令牌”集成方式。我们正在开发预配置（Pre-Provisioning）集成方式，届时将无需在设备上复制此访问令牌。
点击”保存配置”按钮。
要验证设备是否正确连接到ThingsBoard，进入 设备groups 菜单 -> All 设备，选择您的设备。在设备详情中选择 客户端 属性 选项卡，检查客户属性是否已同步到设备。若配置正确，应能看到 serial_number、last_rebbot、device_model 等客户属性。
ThingsBoard配置
EXXN IoT网关将使用MQTT API连接到ThingsBoard。
此前已介绍如何配置设备连接ThingsBoard。下面展示在ThingsBoard中配置设备以监测数据并管理设备的步骤。要配置EXXN IoT网关的数据记录选项，需为设备创建一个键为”config”的JSON”Shared”属性。
-
在设备详情的attributes选项卡中，添加键为”config”、类型为JSON的新”Shared“属性。
-
展开属性内容至全屏以便编写。将设备配置内容粘贴到属性值中。
可从此链接下载该JSON文件示例。通过该JSON文件正确配置设备的所有信息，请参阅EXXN IoT网关手册。
- 点击”添加”保存属性。
数据可视化
创建仪表板以在部件中可视化遥测数据。
-
进入仪表板群组选项卡 -> All。点击仪表板页面右上角的”+”按钮创建新仪表板。输入仪表板名称，点击”添加”按钮。
-
在模拟仪表部件包中创建径向仪表部件。更多关于部件及其创建方法，请参阅此指南。设备JSON配置文件中已启用的测量项，均会以文件中指定的名称作为指标。
RPC命令
可以向设备发送命令执行特定任务。方法参数须为JSON格式。
可发送给设备的所有命令请参阅EXXN IoT网关手册。
更多信息
故障排查
- 集成过程中最常见的问题是无法与MQTT Broker建立连接。请确保设备已接入互联网且能通信到ThingsBoard Broker。
- 另一常见问题是访问令牌配置错误。请检查设备上配置的访问令牌是否与ThingsBoard中为该设备提供的一致。
反馈与集成支持
更多信息请访问EXXN Engineering。
如有问题或疑问，请随时联系：troubleshooting@exxn.es