Appearance
Y511-L LoRaWAN 室内边缘网关使用说明书
1. 适用范围
适用于 Y511-L 的 8 通道（8 RX / 1 TX）和 16 通道（16 RX / 2 TX）配置。通道数表示并发无线路径，设备容量还取决于空中时间、上报周期和下行流量。支持远程 Network Server 转发，或选配本地 NS/AS。
2. 安装准备与硬件安装
使用稳定的 DC 9–28 V 电源，典型为 DC 12 V。准备 DC 12 V / 2 A 电源或满足电压和功率限制的等效电源、安装件、LoRa / Wi-Fi 天线及所选 4G 天线、网线或 Wi-Fi、已激活的标准 SIM 卡、本地配置电脑，以及服务器和终端凭据。
断电后更改接线、SIM、RS485 或安装位置。安装在室内干燥通风处，避开热源、水、强电磁干扰。升级或恢复配置期间不能断电。
- 检查外壳、连接器、电源线和天线是否受损，安装配套 DIN 导轨或壁挂支架，留出维护空间。
- 按现场接地设计连接外壳地。DC 插座和电源端子并联，只使用一个电源。
- 按通道及双工配置，将规定数量的 LoRa 天线接到标注 RX/TX 的接口。先接天线再上电，不能开路发射。
- 天线应架高，远离大面积金属、遮挡和大功率无线设备。
- 接 Wi-Fi 天线；4G 型号断电插 SIM 并接蜂窝天线。SIM、模块和天线须符合交付硬件频段。
- 接以太网或准备 Wi-Fi；使用 Modbus RTU 时按图连接 A/B 并核对极性。
- 检查后上电，等待启动完成。Power 常亮表示有电，LoRa 常亮表示无线模块启动；服务器连接和 Wi-Fi/4G IP 状态应另行检查。
3. 首次访问与基本设置
按交付网络参数通过以太网或网关 Wi-Fi AP 连接。DHCP 地址可从路由器租约查找；静态地址须让电脑处于同一子网。浏览器打开交付的管理地址及端口，使用所配凭据登录，投用前修改初始密码。
设置以太网 DHCP / 静态 IP、网关、DNS、Wi-Fi AP/STA、4G APN/SIM、时区和时间同步（如支持）、访问策略和密码。保存并按提示重启，然后以新地址重新访问。
4. 无线与网络服务
频率计划支持 CN470（默认）、EU433、EU868、AU915、IN865、AS923、RU864、US915。须选硬件支持且当地允许的计划，菜单出现其他计划不代表硬件支持。核对通道数、双工配置、天线，按区域限制设置功率和信道组。
网关接收信道、终端信道掩码、服务器计划须一致，包括 AS923 子计划。终端激活密钥、LoRaWAN 版本、Class A/C 在服务器设备配置中设置。
远程 Network Server
服务器负责网关注册及终端会话。按管理员提供的协议、地址、端口、认证和加密参数设置转发，向服务器注册网关页面或机身所列标识。检查服务器网关状态和流量。MQTT 网关转发须遵循服务器的主题及报文格式；应用 MQTT Broker 本身不能替代 Network Server。双方支持时启用 TLS。
本地 NS/AS
须订购对应软件。启用本地网络和应用服务，按交付界面建立应用 / 设备组，注册网关与终端，配置激活、密钥、路由和数据保留。先验证本地上行和下行，再接外部系统。除非部署支持共享会话，一个终端会话只归属一个 Network Server。
保存无线和服务参数，按提示重启，核对本机网络地址、连接状态和运行参数，查看认证、DNS、时间或区域配置错误。
5. 边缘应用集成
应用路由由本地 NS/AS 软件配置；使用远程报文转发时，应在外部服务器设置应用路由。由应用方提供端点和载荷结构。
| 接口 | 方向与运行 | 调试要点 |
|---|---|---|
| MQTT | 发布上行并接收应用下行 | Broker、客户端标识、认证、主题权限、TLS |
| HTTP | 推送支持的上行、确认及网关状态 | URL、方法、认证、响应码、超时；下行须另用支持的路径 |
| TCP | 网关客户端连接应用 TCP 服务端 | 地址、端口、分帧、保活、重连 |
| WebSocket | 双向应用会话 | URL、认证、心跳、重连、消息结构 |
MQTT、TCP、WebSocket 可承载应用下行。所述 API 的设备列表请求 / 响应及 Join 事件使用 MQTT；各消息是否支持仍按固件确认。网关 MQTT 传输和应用 MQTT 报文格式不同。用抓取消息验证 JSON 字段及大小写、编码、主题前缀，支持时启用 TLS。无线确认只表示收帧，执行结果须查终端或设备。
JavaScript
支持载荷解码 / 编码、上行结构转换、下行适配、定时采集、设备事件触发的本地规则。明确输入输出字段、单位和错误行为，以代表性数据测试；检查不预期的网络访问、无界循环和凭据泄漏。先启用一台测试设备，确认转换结果和边缘日志后扩展。脚本应随配置备份保留版本。
Modbus TCP / RTU
网关将 LoRaWAN 数据映射为虚拟保持寄存器。PLC / 上位机为客户端或主站，网关为服务端或从站；该接口暴露映射无线数据，不等于网关轮询 RS485 仪表。
- 在应用数据流启用 Modbus TCP 或 RTU 处理器，菜单名称以固件和语言为准。
- TCP 设置监听端口并启动；RTU 接 RS485 A/B 并与 PLC 匹配。文档初始值为 9600 bps、8 数据位、无校验、1 停止位。
- 编写上行解码到保持寄存器的脚本，明确符号、寄存器宽度、字节序、缩放、单位和过期处理。
- 将脚本绑定终端，分配双方支持的唯一 Unit ID / 从站地址，不同载荷使用不同映射。
- 以功能码 03 读取已知寄存器，与最新解码上行比较，检查客户端地址约定。
- 只有脚本将写寄存器映射成下行时才能启用写入。用安全测试负载验证一条写命令，并在终端核实执行。
读寄存器返回已存测量值，不触发新的无线采集。按上报周期定义数据有效期；Modbus 应答不能单独证明输出动作。记录 Unit ID、寄存器映射、串口 / TCP 参数、脚本版本和测试结果。
6. 终端调试
| 激活方式 | 凭据 |
|---|---|
| OTAA | DevEUI、JoinEUI/AppEUI 及对应 LoRaWAN 版本所需密钥（含 AppKey） |
| ABP | DevAddr 及服务器所需会话密钥 |
终端与服务器记录须一致。先调试一台：上电或复位后，OTAA 检查入网交换成功；ABP 不进行 Join，检查预置会话的上行是否获接收。查看 RSSI、SNR、频率和速率，确认服务器接受会话和帧计数，再核对应用解码值。稳定上行后测试一条允许的下行，端到端数据和控制均通过后再扩展。
7. 验收与交接
确认电源稳定且无反复重启、回传 IP 正常、频率及信道正确、网关服务器连接正常、至少一台终端入网或建立会话、上行到达应用、下行到达终端，已启用的本地脚本或 Modbus 工作正常，日志没有未解决的认证、DNS、时间、应用或无线错误。
交接记录包含网关标识、最终地址、频率计划、通道、固件、服务模式、应用路由、脚本 / 寄存器版本及负责人；密钥和密码单独存放于项目凭据库。
8. 维护与升级
变更前备份网络、无线、转发、应用路由、寄存器映射和脚本，并与网关标识关联。仅用对应具体硬件配置的固件包。升级时保持电源、网络和浏览器，完成后重新验证回传、无线、注册、上行、下行及使用的应用 / Modbus 集成。出厂复位前备份参数并准备本地恢复访问及所需凭据。
9. 故障排查
| 现象 | 检查 |
|---|---|
| 无电源灯 | 极性、电压、插头、电源型号 |
| 网页无法访问 | 子网、DHCP 租约、网线 / Wi-Fi、管理地址；复位前备份并安排本地访问 |
| 4G 不连接 | SIM 激活、APN、天线、覆盖、模块与运营商频段 |
| 远程服务离线 | 地址可达性、DNS、时间、凭据、证书、防火墙及服务状态 |
| 网关在线但无上行 | 区域计划、信道组、网关注册、终端密钥、天线和服务器 |
| 本地服务无数据 | NS/AS 归属、网关及设备注册、频率、密钥、路由 |
| 应用或 Modbus 数据错误 | 脚本输入、字节序、缩放、单位、端口、映射；RTU 另查 A/B、串口、从站地址和权限 |
| 上行正常但下行失败 | 终端类别、窗口时机、信道、发射状态、区域占空比和功率限制 |
| 频繁掉线 | 天线位置、干扰、供电、时间同步及两端日志 |
| 配置不生效 | 保存、按提示重启，并核对运行值 |
排查资料应含型号配置、频率、服务模式、固件、网关标识、故障时间及脱敏日志，去除密码、终端密钥和服务器私密凭据。