ThinkLink

中文

English

中文

English

Appearance

通过 Basic Station 将 gwTool6/gwTool7 网关接入 TTN / The Things Stack ​

本文介绍门思网关接入 The Things Stack（TTN）的两种 LoRa Basics Station 方式：推荐的 CUPS，以及直接 LNS。GD61/GD61x 使用 gwTool6；GDI51、GDO51、GDI52 使用 gwTool7。旧批次 GDI51/GDO51 的 WebServer 操作保留在 GW-AN09。gwTool6 v1.0.3 的步骤已按当前界面与源码复核，但未在文档测试网关上保存配置、切换驱动或验证平台连通性。

注册网关 ​

  1. 在 The Things Stack Console 创建网关，填写设备的 16 位十六进制 Gateway EUI。
  2. 选择与网关射频硬件、出厂区域和工作频点一致的 Frequency Plan。
  3. 记录 Console 显示的 Server Address。下文的 <server-address> 必须替换为该值。
  4. 打开网关 Live data，供配置后核对连接和报文。

官方概念说明：LoRa Basics Station。

选择 LNS 或 CUPS ​

  • LNS 是 LoRaWAN 上下行数据连接，地址通常为 wss://<server-address>:8887。
  • CUPS 是配置与更新连接，地址通常为 https://<server-address>:443。它向网关下发 LNS URI、信任链和 LNS 凭据。
  • gwTool6 在 TTN 供应商下默认选择 CUPS；没有集中配置需求时也可直接使用 LNS。
  • CUPS API Key 和 LNS API Key 权限不同，不能互换。

GD61/GD61x 直接连接 The Things Stack LNS 的路径

GD61/GD61x 通过 CUPS 获取 LNS 配置的路径

CUPS 会覆盖 LNS 配置

CUPS 返回的配置优先于本地 LNS 值。由 CUPS 改为直接 LNS 时，保存结果必须清除旧的 CUPS URI；保存后重新读回并确认 CUPS 不再处于活动状态，否则网关仍可能继续向 CUPS 取配置。

准备 LNS 凭据 ​

  1. 为该网关创建 LNS API Key，只授予 Link as Gateway to a Gateway Server for traffic exchange 权限。
  2. LNS 地址使用 wss://<server-address>:8887。
  3. 从 The Things Stack Root Certificates 页面取得与 Server Address 匹配的 PEM 根证书。
  4. 将 API Key 组成完整 Authorization 行，并确保以 CRLF 结尾：
text
Authorization: Bearer <LNS-API-Key>\r\n

在 gwTool6 中，trust 与令牌密钥是不同字段。不要把 API Key 填入客户端私钥，也不要上传真实密钥到工单或公开文档。

准备 CUPS 凭据 ​

仅在使用 CUPS 时执行：

  1. 创建 CUPS API Key，授予查看网关信息、编辑基础网关设置和读取网关 Secret 所需权限。
  2. 另行保留上一节的 LNS API Key；两把 Key 不得互换。
  3. 在网关 General Settings 的 LoRa Basics Station LNS Authentication Key 中保存 LNS API Key，使 CUPS 可以把它作为 LNS 凭据下发。
  4. CUPS 地址使用 https://<server-address>:443。
  5. 准备匹配 Server Address 的根证书，并将 CUPS API Key 组成以 CRLF 结尾的 Authorization 行：
text
Authorization: Bearer <CUPS-API-Key>\r\n

官方步骤：LNS；CUPS；根证书。

网关配置 ​

配置前核对 ​

在 gwTool6“概览”和“LoRaWAN NS”记录固件、区域标准、Gateway EUI、当前驱动、出口方式和服务器。确认管理链路不会因 LoRa 驱动切换而断开，并避开 OTA、配置写入和关键下行业务。

Semtech UDP 使用 Packet Forwarder，LNS/CUPS 使用 Basic Station。两种驱动互斥，保存后切换会使 LoRa 转发冷重启约 30～60 秒。

gwTool6 ​

适用型号：GD61/GD61x。

使用 CUPS（推荐） ​

gwTool6 中文 TTN BasicStation CUPS 配置示例

  1. 打开“LoRaWAN NS”，“供应商”选择 TTN。
  2. “协议”选择 BasicStation CUPS（默认）。
  3. “CUPS 地址”填写 https://<server-address>:443。
  4. 认证方式选择令牌；在 trust 字段填写匹配域名的 PEM 根证书，在令牌密钥字段填写完整 CUPS Authorization 行。
  5. 在维护窗口“保存并应用”，等待 LoRa 转发恢复。
  6. 重新进入本页并检查系统日志，确认 CUPS 已返回 LNS URI、信任链和 LNS 凭据。
  7. 在 TTN Console 的 Live data 核对连接事件和上行。

截图中的 server-address 是格式占位符，灰色遮罩覆盖测试环境标识。凭据状态标签只表示设备已有材料，不代表本次配置值。

直接使用 LNS ​

gwTool6 中文 TTN BasicStation LNS 配置示例

  1. “供应商”选择 TTN，“协议”选择 BasicStation LNS。
  2. “LNS 地址”填写 wss://<server-address>:8887。
  3. 认证方式选择令牌；在 trust 字段填写匹配域名的 PEM 根证书，在令牌密钥字段填写完整 LNS Authorization 行。
  4. 若设备此前使用 CUPS，确认本次保存会清除旧 CUPS URI。
  5. “保存并应用”，等待驱动恢复后重新读回；确认当前生效的是直接 LNS，而不是旧 CUPS 配置。
  6. 在 Live data 核对连接、上行和受控下行。

常见 TTN 云部署使用服务器 TLS ＋ API Key，不需要网关客户端证书。只有目标部署明确要求 mTLS 时，才选择客户端证书并使用该部署提供的证书和私钥。

gwTool7 ​

适用型号：GDI51、GDO51、GDI52。

直接使用 LNS：

gwTool7 中文 TTN BasicStation LNS 配置页面

  1. 进入“LORAWAN → LoRaWAN NS”，在 NS1 将“服务器位置”设为“远端”，“供应商”选择 The Things Network，“协议”选择 BasicStation LNS (basicstation_lns)。
  2. 在“服务器 URI”填写 wss://<server-address>:8887。截图使用 eu1.cloud.thethings.network 展示格式，实际必须替换为 TTN Console 显示的 Server Address。
  3. 配置对应的信任 PEM 和 LNS Key；若当前交付固件没有 Authorization/Key 控件，不要把 API Key 填入客户端私钥字段，应联系技术支持确认该固件支持的凭据导入方式。

使用 CUPS：

gwTool7 中文 TTN BasicStation CUPS 配置页面

  1. 保持“供应商”为 The Things Network，将“协议”切换为 BasicStation CUPS (basicstation_cups)。
  2. 在“服务器 URI”填写 https://<server-address>:443，并配置对应的信任 PEM 和 CUPS Key。
  3. 保存后等待 CUPS 下发 LNS 参数，再重新读取页面；不要用旧的本地 LNS 参数覆盖下发结果。
  4. 在“报文监控”和 TTN Console 同时验证连接与上下行数据。

固件差异

gwTool7 的证书、Authorization/Key 和 CUPS 控件会随交付固件变化。CA、客户端证书、客户端私钥和 TTN API Key 的用途不同；若页面没有对应的 Authorization/Key 控件，不要通过相似字段猜测，请联系技术支持确认该固件支持的凭据导入方式或升级路径。

验证连接 ​

  1. gwTool6 核对“当前生效”为 Basic Station 和目标服务器；gwTool7 重新读取 LoRaWAN NS，确认协议、地址和凭据状态没有回退。
  2. 检查系统日志；gwTool7 同时打开“LORAWAN → 报文监控”，排除 DNS、TLS、Authorization、CUPS 和 LNS 错误。
  3. 在 TTN Console Live data 确认网关连接事件开始出现。
  4. 触发一个已知终端上行，核对 Gateway EUI、Frequency Plan、频点和时间。
  5. 在允许的维护窗口执行一次受控下行。
  6. 使用 CUPS 时，额外确认下发的 LNS 地址与凭据已生效；使用直接 LNS 时，确认旧 CUPS URI 已清除。

页面可选、保存成功或单次连接事件都不足以证明对接完成；至少应验证持续在线、已知上行和受控下行。

故障排查 ​

现象检查项
401 / 鉴权失败API Key 是否属于当前网关、权限是否正确、是否混用了 CUPS/LNS Key、Authorization 行和 CRLF 是否完整
TLS 失败网关时间、Server Address、端口、根证书和域名证书链
CUPS 成功但 LNS 不上线General Settings 中的 LNS Authentication Key、LNS Key 权限和 CUPS 下发结果
切换直接 LNS 后仍走 CUPS保存结果是否清除了旧 CUPS URI；重新读取配置和日志确认活动端点
在线但无上行Gateway EUI、Frequency Plan、网关射频区域与工作频点、天线和终端信道
上行正常但无下行下行窗口、网络延迟、网关时间、TTN Live data 和发射频点
保存后短暂离线等待驱动冷重启约 30～60 秒，再重新登录；不要连续重复保存或重启

官方排查参考：The Things Stack 网关故障排查。

Copyright © 2025 ThinkLink Email : info@manthink.cn