通过 Basic Station 将 gwTool6/gwTool7 网关接入 TTN

本文适用于 The Things Stack/TTN 的 LoRa Basics Station 接入。GD61/GD61x 使用 gwTool6；GDI51、GDO51、GDI52 使用 gwTool7。旧批次 GDI51/GDO51 的 WebServer 操作保留在 GW-AN09。

注册网关

1. 在 The Things Stack Console 创建网关，填写网关 ID 和设备标签上的 Gateway EUI。
2. 选择与网关射频硬件一致的 Frequency Plan。
3. 记录当前部署的 Server Address。后续地址中的 <server-address> 必须使用该值。

官方说明：LoRa Basics Station。

选择 LNS 或 CUPS

• LNS 是传输 LoRaWAN 上下行数据所必需的连接。
• CUPS 用于集中配置并自动向网关下发 LNS 地址、信任证书和 LNS API Key。
• 成功配置 CUPS 后，不需要再手工维护一套独立的 LNS 凭据；CUPS 下发值会覆盖本地 LNS 凭据。

准备 LNS 凭据

1. 创建网关 API Key，只授予“Link as Gateway to a Gateway Server for traffic exchange”权限。
2. LNS 地址使用 wss://<server-address>:8887。
3. 从 The Things Stack Root Certificates 页面取得与部署域名匹配的 PEM 信任证书。
4. 将 API Key 格式化为以 CRLF 结尾的 Authorization 行，并保存为 lns.key：

Authorization: Bearer <LNS-API-Key>\r\n

不要把真实 API Key 写入文档、截图或工单。

准备 CUPS 凭据

仅在使用 CUPS 时执行：

1. 创建 CUPS API Key，授予查看网关信息、编辑基础设置和读取网关 Secret 的权限。
2. 另行保留上一节的 LNS API Key。
3. 在网关 General Settings 的 LoRa Basics Station LNS Authentication Key 中保存 LNS API Key，使 CUPS 可以下发 LNS 凭据。
4. CUPS 地址使用 https://<server-address>:443。
5. 准备域名信任 PEM，并将 CUPS API Key 格式化为以 CRLF 结尾的 cups.key：

Authorization: Bearer <CUPS-API-Key>\r\n

官方步骤：LNS；CUPS。

网关配置

配置前记录原 LoRaWAN 服务器参数。切换上行驱动会重启相关服务；不要在 OTA 或关键业务期间操作。

gwTool6

适用型号：GD61/GD61x。

直接使用 LNS：

1. 打开“LNS 配置”，选择 Basic Station 直连。
2. tc.uri 填写 wss://<server-address>:8887。
3. 上传 LNS Trust PEM，并在 Authorization/Key 字段上传或粘贴完整 lns.key 内容。
4. 保存，等待服务恢复并重新读取配置。

使用 CUPS：

1. 选择 Basic Station CUPS。
2. cups.uri 填写 https://<server-address>:443。
3. 上传 CUPS Trust PEM 和 cups.key。
4. 保存后等待 CUPS 下发 LNS 参数；不要再用旧的本地 LNS 值覆盖下发结果。

gwTool7

适用型号：GDI51、GDO51、GDI52。

直接使用 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：

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. 在 TTN Console 查看网关 Live data，确认连接事件和上行开始出现。
2. 触发一个已知终端上行，并核对 Gateway EUI、频段和时间。
3. gwTool6 查看 LoRa 服务状态；gwTool7 查看“LORAWAN → 报文监控”。
4. 使用 CUPS 时，确认网关已经取得 LNS 地址和凭据，而不是仍使用旧配置。

故障排查

现象	检查项
401 或鉴权失败	API Key 权限、是否误用 CUPS/LNS Key，以及 Authorization 行是否完整并以 CRLF 结束
TLS 失败	网关时间、Server Address、信任 PEM 和域名证书链
CUPS 成功但 LNS 不上线	TTN General Settings 中的 LNS Authentication Key、LNS Key 权限和 CUPS 下发结果
在线但无数据	Gateway EUI、Frequency Plan、网关射频区域、天线和终端信道
修改后管理会话中断	等待服务重启，通过备用管理链路重新登录并读取实际配置