AN-25101701 UG56网关与WS101传感器连接TKE132 LoRaWAN服务器指导说明书

1. 引言

本指导说明书旨在详细阐述如何将Milesight UG56 LoRaWAN网关与WS101 LoRaWAN传感器设备连接至TKE132 LoRaWAN服务器。我们将以AS923标准为例，提供一步一步的图文指南，帮助用户快速完成设备的配置与入网。本说明书将侧重于关键配置步骤，不涉及UG56和WS101的详细网络配置。

2. 前提条件

在开始配置之前，请确保您已具备以下条件：

• Milesight UG56 LoRaWAN网关一台。
• Milesight WS101 LoRaWAN传感器设备一台。
• 已部署并运行的TKE132 LoRaWAN服务器。
• 用于访问TKE132管理界面的计算机，并确保网络连通。
• 用于配置WS101设备的掌机（或NFC读卡器及相应软件）。

3. 配置步骤

3.1. 登录TKE132并获取IP地址

首先，您需要登录TKE132管理界面并获取其IP地址。TKE132的GWMP端口默认为1770，第三方网关目前只能通过GWMP协议连接。

1. 访问tke-conf界面：在浏览器中输入 http://www.thinklink-edge:19091，登录tke-conf界面以获取TKE132的IP地址。具体登录方式和界面可能因您的部署环境而异，请参考[CN] TKE13 ThinkLink-edge技术规格书
   • 注意：此步骤通常用于首次部署或网络环境变更时获取TKE132的实际运行IP地址。一旦获取，后续配置可直接使用该IP。
2. 记录TKE132的IP地址：在tke-conf界面中找到TKE132的IP地址并记录下来，例如 192.168.1.100。此IP地址将在后续UG56网关配置中使用。

3.2. 配置UG56网关指向TKE132

登录ug56网关的管理界面，将其配置为数据包转发器（Packet Forwarder），并将数据指向TKE132服务器。

1. 登录ug56网关： 根据ug56的用户手册，通过其默认IP地址（通常为192.168.1.1）或有线连接方式登录Web GUI。
2. 导航至Packet Forwarder配置： 进入菜单 LoRaWAN -> Packet Forwarder -> General。

1. 新增一个网络服务器（Network Server）： 点击“+”按钮新增一个服务器目的地。
   • Enable: 勾选启用。
   • Type: 在下拉菜单中选择 Semtech。这对应于标准的GWMP协议。
   • Server Address: 填写在第一步中获取的 TKE132的IP地址。
   • Port Up: 填写 1770。
   • Port Down: 填写 1770。

1. 保存并应用配置： 点击“Save & Apply”按钮使配置生效。配置成功后，ug56网关会将接收到的所有LoRaWAN数据包通过GWMP协议转发至指定的TKE132服务器。

3.3. 在ThinkLink中将UG56添加至白名单

1. 在TKL的网关管理中，点击增加网关，在弹出对话框中，将网关的eui填写进去，类型选择GWMP。

pin_code 由用户自行管理填写即可。

3.4. 在TKE132中填写WS101设备信息（OTAA方式）

WS101将采用OTAA（Over-The-Air Activation）方式重新入网到新的网络。您需要在TKE132中预先注册WS101的设备档案。

1. 登录TKE132管理界面：使用您的账号登录TKE132的Web管理界面。
2. 导航至LoRaWAN设备档案：选择菜单 运维 -> 设备管理 -> LoRaWAN档案。
3. 新增设备档案：点击“新增”按钮，填写WS101的设备信息。

图 3-2 TKE132新增LoRaWAN设备档案界面 [2]

1. 保存设备档案：确认信息无误后，保存新增的LoRaWAN设备档案。

3.5. 修改WS101信息并入网

现在，您需要使用掌机（或NFC读卡器）配置WS101设备，使其使用在TKE132中注册的app_key，并触发其入网。

1. 连接WS101掌机：将WS101设备与掌机连接，或使用NFC功能读取设备信息。
2. 配置LoRaWAN参数：在掌机软件中找到WS101的LoRaWAN配置界面。

图 4-1 WS101 LoRaWAN参数配置界面示例 [3]

• App Key：填写在TKE132中为WS101设备档案设置的app_key（例如 88888888888888888888888888888888）。请确保两者完全一致。
• Device EUI 和 App EUI：通常会从设备中自动读取，请核对与TKE132中注册的信息是否一致。
• Region：选择 AS923。
• Join Mode：选择 OTAA。

1. 写入配置并触发入网：点击掌机软件中的“写入”或“保存”按钮，将配置写入WS101设备。设备在写入后会立即尝试通过UG56网关入网到TKE132 LoRaWAN服务器。
   • 入网成功指示：WS101设备上的LED指示灯通常会显示入网状态（例如，成功入网后可能常亮或闪烁特定次数）。请参考ws101-user-guide-en.pdf了解具体指示含义。

3.6. 增加物模型

为了正确解析WS101传感器上传的数据，您需要在TKE132中为WS101设备配置物模型。

1. 获取物模型解码器代码：在WS101的用户手册（ws101-user-guide-en.pdf）或Milesight官方GitHub仓库中查找WS101的LoRaWAN Payload Decoder代码。例如，在ws101-user-guide-en.pdf的第13页有Payload Decoder的说明。

图 5-1 WS101用户手册中的Payload Decoder示例 [3]

1. 登录TKE132管理界面：使用您的账号登录TKE132的Web管理界面。
2. 导航至物模型管理：选择菜单 模型管理 -> 物模型。

图 5-2 TKE132物模型管理界面 [2]

1. 新增物模型：点击“新增”按钮，创建一个新的物模型。

图 5-3 TKE132新增物模型配置界面 [2]

• 物模型类型：选择 ChirpStack 类型，因为TKE132的LoRaWAN核心是基于ChirpStack的。
• 物模型名称：为物模型命名，例如 WS101_AS923_Decoder。
• 解码器代码：将您获取的WS101 Payload Decoder代码粘贴到代码编辑器中。

1. 保存物模型：保存物模型配置。

3.7. 在TKE132运维管理中新增设备并挂载物模型

最后一步是将WS101设备添加到TKE132的运维管理中，并挂载刚刚创建的物模型，以便TKE132能够接收和解析WS101上传的数据。

1. 登录TKE132管理界面：使用您的账号登录TKE132的Web管理界面。
2. 导航至设备管理：选择菜单 运维 -> 设备管理 -> 设备。
3. 新增设备：点击“新增设备”按钮。

图 6-2 TKE132新增设备界面 [2]

• EUI：填写WS101设备的devEui，确保与LoRaWAN档案中的devEui一致。
• 名称：为设备命名，例如 WS101_Sensor_AS923。
• 设备类型：选择 LoRaWAN。

1. 挂载物模型：在新增设备后，进入该设备的详情页面，找到“物模型”部分，点击“新增”按钮，将您在步骤5中创建的WS101物模型挂载到此设备上。

1. 保存配置：保存设备配置。

至此，您的WS101传感器设备已通过UG56网关成功连接到TKE132 LoRaWAN服务器，并且TKE132已配置好物模型来解析WS101上传的数据。您可以在TKE132的“实时数据”或“历史数据”界面查看WS101传感器上传的数据。

4. 故障排除与常见问题

• UG56网关无法连接TKE132：
  • 检查TKE132的IP地址是否正确，并且TKE132服务是否正常运行。
  • 确保UG56网关与TKE132之间网络连通性良好，没有防火墙阻挡1770端口的通信。
  • 检查UG56网关的LoRaWAN配置中，NS服务器的IP地址和端口是否正确。
• WS101设备无法入网：
  • 检查TKE132中WS101设备档案的devEui和app_key是否与WS101设备实际配置一致。
  • 确保WS101设备的Region设置为AS923，Join Mode为OTAA。
  • 检查UG56网关是否已成功连接到TKE132 LoRaWAN服务器。
  • 尝试将WS101设备靠近UG56网关，排除信号覆盖问题。
• TKE132中WS101数据无法解析：
  • 检查TKE132中WS101设备的物模型是否已正确挂载。
  • 检查物模型中的Payload Decoder代码是否正确，是否与WS101设备上报的数据格式匹配。
  • 确保物模型类型选择为ChirpStack。