AN：Milesight UG56 网关 + WS101 传感器接入 ThinkLink

适用范围：Milesight UG56 LoRaWAN 网关 + WS101 LoRaWAN 传感器 → ThinkLink LoRaWAN 服务器（边缘 TKE 或 云平台），AS923 频段，OTAA 入网。 场景：把第三方网关经标准 GWMP/Semtech 协议指向 ThinkLink，加入白名单，注册传感器，并用物模型解析其上报数据。文中地址/EUI/密钥均为占位符，部署时请替换。

1. 边缘（TKE）与云平台 —— 仅连接端点不同

ThinkLink 有两种部署形态，两者的接入步骤完全一致，唯一区别是连接端点（服务器地址 + GWMP 端口）。本文其余内容——网关类型 GWMP、设备档案、物模型、设备挂载——边缘与云平台完全相同。

部署形态	网关「Server Address」	Port Up / Down	地址获取方式
边缘 — TKE（如 TKE132）	TKE 实际局域网 IP，如 192.168.1.100	1700 / 1700	经 tke-conf 控制台获取（见 §3）
云平台 — ThinkLink	云端部署的 LNS 主机/域名，如 lns.thinklink.example	1770 / 1770	随云账号一同提供

ThinkLink 支持 两种网关接入协议：GWMP（Semtech UDP）和 mqtt_mt。本文 UG56 经其 Semtech 数据包转发器走 GWMP，GWMP 端口 边缘 TKE 为 1700、云平台 ThinkLink 为 1770；当网关以门思 MQTT 格式上报时改用 mqtt_mt。

2. 拓扑

WS101 ─上行(LoRaWAN, AS923, OTAA)─▶ UG56（数据包转发器, Semtech）─GWMP:1700(TKE)/1770(云平台)─▶ ThinkLink LNS
                                                                                  └─ 物模型（ChirpStack 解码器）─▶ 遥测数据

3. 前提条件

• Milesight UG56 网关一台、WS101 传感器一台。
• 已运行的 ThinkLink 服务器（边缘 TKE 或云平台）及管理账号。
• 一台可访问网关与服务器的计算机（网络连通）。
• WS101 配置掌机（或带 Milesight App 的 NFC 读卡器）。
• WS101 的 DevEUI（设备标签或掌机读取）和一个 32 位十六进制 AppKey。

4. 获取服务器地址

• 云平台：使用随账号提供的 LNS 地址，直接跳到 §5。
• 边缘（TKE）：浏览器打开 tke-conf 控制台 http://www.thinklink-edge:19091，登录后记录 TKE 的运行 IP（如 192.168.1.100）。此步通常只在首次部署或网络变更时执行。

5. 配置 UG56 数据包转发器

登录 UG56 Web 管理界面（默认 192.168.1.1），进入 LoRaWAN → Packet Forwarder → General，点击「+」新增一个网络服务器目的地：

字段	取值
Enable	勾选
Type	Semtech（即 GWMP 协议）
Server Address	§1/§4 得到的 ThinkLink 服务器地址
Port Up	按部署形态填 GWMP 端口 —— TKE 1700，云平台 1770
Port Down	与 Port Up 相同 —— TKE 1700，云平台 1770

点击 Save & Apply。此后 UG56 会把收到的所有 LoRaWAN 数据包经 GWMP 转发到 ThinkLink。

6. 在 ThinkLink 中将 UG56 加入白名单

在 ThinkLink 控制台进入 网关管理 → 增加网关，在弹出对话框中：

字段	取值
名称	任意标识，如 UG56-AS923
EUI	UG56 的 Gateway EUI
类型	GWMP
pin_code	由用户自行管理填写

保存。只有白名单内的网关才会被接收。

7. 注册 WS101 设备档案（OTAA）

进入 运维 → 设备管理 → LoRaWAN 档案 → 新增：

字段	说明
devEui	WS101 的唯一标识符（须与实际设备一致）
standard	选择 AS923
app_key	32 位十六进制应用密钥，如 8888...8888（请妥善保管）

其他字段（lw_ver、class_mode 等）会按所选 standard 自动填充默认值，保持默认即可。保存。

8. 配置 WS101 并入网

用掌机/NFC 配置器打开 WS101 的 LoRaWAN 设置：

字段	取值
App Key	完全等于 §7 的 app_key
Device EUI / App EUI	从设备读取，与 §7 核对一致
Region	AS923
Join Mode	OTAA

写入配置。WS101 会立即经 UG56 尝试入网，设备 LED 指示入网状态（含义见 WS101 用户手册）。

9. 新增物模型（Payload 解码器）

从 Milesight 用户手册或 GitHub 获取 WS101 的 LoRaWAN Payload 解码器代码。在 ThinkLink 进入 模型管理 → 物模型 → 新增：

字段	取值
类型	ChirpStack（ThinkLink 的 LoRaWAN 核心基于 ChirpStack）
名称	如 WS101_AS923_Decoder
解码器	粘贴 WS101 Payload 解码器代码

保存。

10. 新增设备并挂载物模型

进入 运维 → 设备管理 → 设备 → 新增设备：

字段	取值
EUI	WS101 的 devEui（须与 §7 一致）
名称	如 WS101_Sensor_AS923
设备类型	LoRaWAN

保存后进入该设备详情页，找到 物模型 → 新增，挂载 WS101_AS923_Decoder。保存。

11. 验证

至此 WS101 已经 UG56 接入 ThinkLink，并由物模型解析数据。在 实时数据 / 历史数据 界面即可查看上报的遥测数据。

12. 故障排除

现象	可能原因	处理
UG56 连不上服务器	地址/端口错误；服务未运行；GWMP 端口被拦	核对 §1/§4 地址与端口（TKE 1700 / 云平台 1770）；确保全链路放通该 UDP 端口
WS101 无法入网	档案与设备的 devEui/app_key 不一致	使档案与设备取值完全一致；确认 Region=AS923、Join Mode=OTAA
WS101 入网但数据不解析	未挂物模型，或解码器不对	挂载物模型；核对解码器与 WS101 报文格式；类型须为 ChirpStack
上行间歇丢包	信号弱	将 WS101 靠近 UG56