9 Web 管理界面使用说明
IMX93-GW8016 网关提供基于 OpenWrt LuCI 的 Web 管理界面，通过浏览器即可完成日常配置与状态监控，无需命令行操作。本章介绍网关前端各主要页面的功能与使用方法。
9.1 LoRa 网关状态页面
入口：菜单 Network（网络） → LoRa GW（LoRa 网关） → Status（状态）
LoRa 状态页面实时显示网关无线转发器的运行状态与统计信息，帮助用户监控网关工作是否正常。
9.1.1 连接状态面板
页面顶部显示网关与 NS（网络服务器）之间的 GWMP 连接状态，包括：
| 字段 | 说明 |
|---|---|
| GWMP PUSH 状态 | 上行数据通道状态（在线/离线） |
| PUSH ACK 百分比 | 上行数据包确认率（%） |
| 网络延迟 | PUSH 延迟（毫秒） |
| GWMP PULL 状态 | 下行数据通道状态（在线/离线） |
| PULL ACK 百分比 | 下行数据包确认率（%） |
9.1.2 统计信息面板
| 字段 | 说明 |
|---|---|
| 网关 ID | 网关 EUI（8 字节 MAC 地址衍生） |
| 运行时间（Uptime） | 网关持续运行时长 |
| 总计接收 RF 数据包 | 累计接收到的 LoRa 数据包数量 |
| 上行 ACK 百分比 | 上行包的 ACK 成功率 |
| 下行 ACK 百分比 | 下行包的 ACK 成功率 |
| 总计发送 LoRa 数据包 | 累计下发的 LoRa 数据包数量 |
| 成功数 / 碰撞数 | 下行发送成功与碰撞统计 |
| 信标发送数 | Class B 信标发送次数 |
| RF 温度 | 射频模块当前温度（°C） |
9.1.3 频段配置信息
显示当前生效的 LoRaWAN 区域参数，包括全部 9 个信道（Channel 0–7 BW125、Channel 8 BW250/BW500、Channel 9 FSK）的频率与扩频因子（SF）配置。
9.1.4 MQTT 连接状态
显示已启用的 MQTT 连接状态，包括：
- NS MQTT：NS 方向 MQTT（发送数/接收数/Topic）
- APP1/APP2/APP3 MQTT：应用层 MQTT 连接状态
- ChirpStack MQTT：内置 NS 的 MQTT 状态
9.1.5 上行/下行数据列表
页面底部以表格形式显示最近接收的上行数据包和待下发的下行队列，支持按 DevEUI 搜索，以及分页浏览（10/20/50 条/页）：
上行列表字段：时间、类型、DevEUI、DevAddr、频率、数据速率、帧数据、长度、计数、端口、频率偏移、RSSI/SNR、负载、解析对象
下行队列字段：类型、DevEUI、DevAddr、频率、数据速率、帧、计数、端口、负载
9.2 LoRa 网关配置页面
入口：菜单 Network（网络） → LoRa GW（LoRa 网关） → Configuration（配置）
LoRa 配置页面用于设置网关的射频参数、LoRaWAN 区域频段和工作模式，分为两个标签页：
9.2.1 通用设置（General Settings）
| 设置项 | 说明 |
|---|---|
| 工作模式（Mode） | Normal Mode：正常工作模式；TX power test：发射功率测试模式 |
| 全双工模式 | 仅 CN470 全双工硬件支持，其他频段为半双工 |
| LoRaWAN 区域（Region） | 选择 LoRaWAN 频段：CN470、EU868、RU864、IN865、US915、AU915、AS923-1/2/3/4、KR920 |
| 初始化频段参数 | 每次切换频段后，必须点击 Switch LoRaWAN frequency band 按钮使参数生效 |
切换 LoRaWAN 频段后，必须先点击 Switch LoRaWAN frequency band 初始化按钮，再点击 保存并应用，否则射频参数不会正确更新。
9.2.2 详细设置（Detailed Settings）
高级用户可在此标签页中手动调整：
| 设置项 | 说明 |
|---|---|
| 接收射频类型 | SX1250 / SX1255 / SX1257（根据硬件自动适配） |
| RX0 中心频率 | 第一组 8 个信道的 RF0 中心频率 |
| RX1 中心频率 | 第二组 8 个信道的 RF1 中心频率 |
| 各信道偏移频率 | Channel 0…7 相对于中心频率的偏移 |
| LoRa Standard 信道（Ch8） | BW250/BW500 宽带信道频率与 SF |
| FSK 信道（Ch9） | 是否启用 FSK 及信道频率/速率 |
| TX 最低/最高频率 | 合规下行频率范围 |
| LBT 配置 | 监听前发送（Listen Before Talk）开关及 RSSI 阈值 |
| 频谱扫描（Spectral Scan） | 底噪扫描起始频率、信道数、扫描次数和间隔 |
9.3 IoT 设备资产状态页面
入口：菜单 Network（网络） → IoT Hub → Status（状态）
IoT 设备资产管理页面用于查看所有已注册 LoRaWAN 设备的物模型映射状态与实时数据，是 IoT Hub 功能的核心监控界面。
9.3.1 全局统计面板
页面顶部显示设备总数、在线设备数、离线设备数，方便快速掌握整体网络状态。
9.3.2 设备列表
以表格形式列出所有设备，主要字段：
| 字段 | 说明 |
|---|---|
| DevEUI | 设备唯一标识符 |
| 设备名称 | 用户自定义名称 |
| 传感器类型 | 设备型号（如 AN-301、AN-303、W8004 等） |
| 在线状态 | 绿色（在线）/ 灰色（离线） |
| 最后更新时间 | 最近一次收到数据的时间戳 |
| Modbus 配置 | 已启用的 Modbus TCP 端口和从机 ID |
| BACnet 配置 | 已启用的 BACnet 设备实例 ID |
支持按 DevEUI、传感器类型、在线/离线状态 过滤设备，分页浏览（20 条/页，可调）。
9.3.3 编辑设备
在列表中点击 编辑 按钮，可修改：
- 设备名称、掉线检测时间
- Modbus TCP 映射：启用开关、端口号、从机 ID
- BACnet BIP 映射：启用开关、设备实例 ID
9.3.4 设备详情
点击 详情 按钮，可查看设备所有属性的当前值，以卡片形式展示，包含：属性名、当前值、单位、数据类型、Modbus 寄存器地址、BACnet 对象实例号、最近更新时间。
9.4 IoT Hub 全局配置页面
入口：菜单 Network（网络） → IoT Hub → Configuration（配置）
IoT Hub 配置页面用于管理 IoT Hub 服务的全局参数，分为多个标签页：
9.4.1 服务（Service）标签
| 配置项 | 说明 |
|---|---|
| 启用 HTTP 服务器 | 开启 IoT Hub HTTP REST API 服务 |
| HTTP 端口 | HTTP 服务端口（默认 6060） |
| BACnet 实例号 | 本网关的 BACnet Device 实例号基址 |
| 自动保存 | 定时将运行时数据持久化到存储器 |
| 保存间隔 | 自动保存间隔（秒） |
| 检修间隔 | 存储空间巡检间隔（秒） |
| 清理阈值 | 存储使用率超过此值（%）时触发自动清理 |
| 清理删除百分比 | 每次清理删除最旧的数据比例（%） |
9.4.2 同步（Sync）标签
| 配置项 | 说明 |
|---|---|
| 启用同步 | 开启设备注册信息同步功能 |
| 同步间隔 | 同步间隔时间（秒） |
9.4.3 默认值（Defaults）标签
用于设置新设备注册时的默认参数：
| 配置项 | 说明 |
|---|---|
| 默认保活时间 | 设备超过该时长未上报数据则标记为离线（秒） |
| 默认传感器类型 | 新增设备时的默认传感器型号 |
| 默认 Modbus TCP | 默认是否启用 Modbus 映射、端口、从机 ID |
| 默认 BACnet | 默认是否启用 BACnet 映射、设备实例 ID |
9.4.4 重试（Retry）标签
| 配置项 | 说明 |
|---|---|
| 单播最大重试次数 | 下发命令单播失败时自动重试的最大次数 |
| 组播最大重试次数 | 下发组播命令失败时自动重试的最大次数 |
9.4.5 参考（Reference）标签
只读参考表，列出每种传感器型号支持的所有属性字段，包含：
- 字段名称（JSON Key）、属性名称、数据类型、单位、访问权限（读/写）
- 值范围（最小值/最大值）
- Modbus 寄存器偏移地址及数据类型
- BACnet 对象实例偏移及对象类型
Modbus 地址计算公式：运行时 Modbus 寄存器地址 = 头部 6 个固定寄存器 + 从机 ID × 传感器跨度（span） + 字段偏移
BACnet 对象实例计算公式：运行时 BACnet 对象实例 = 头部 2 个固定对象 + 设备实例 ID × 传感器跨度（span） + 字段偏移
9.5 LoRaWAN 应用服务器状态页面
入口：菜单 Network（网络） → grpc-bridge → Status（状态）
grpc-bridge 服务负责将 ChirpStack 内置 NS 的设备数据桥接到 IoT Hub、Modbus、BACnet 等下游系统。此页面显示各设备的接入状态和实时上/下行数据。
9.5.1 全局统计
显示已接入的设备总数、在线设备数和离线设备数。
9.5.2 设备列表
以表格形式显示所有已接入设备，支持按 DevEUI 搜索、分页浏览，主要字段：
| 字段 | 说明 |
|---|---|
| DevEUI | 设备唯一标识符 |
| 设备名称 | ChirpStack 中的设备名称 |
| 传感器类型 | 设备型号 |
| 应用 ID | 所属 ChirpStack 应用 ID |
| 应用名称 | 所属 ChirpStack 应用名称 |
操作按钮：编辑（修改 Modbus/BACnet 映射配置）、详情（查看属性详情）、删除
9.5.3 上行数据列表
实时显示最新收到的上行数据包，字段包括：时间戳、DevEUI、DevAddr、帧类型、帧数据、计数器、MAC 命令、端口、负载长度、负载内容、解析对象。
9.5.4 下行队列
显示待下发的下行数据包列表，字段包括：时间戳、DevEUI、网关 ID、DevAddr、帧类型、帧数据、计数器、MAC 命令、端口、负载长度、下行负载内容。
9.5.5 设备导入/导出
- 导入设备：从 CSV/JSON 文件批量导入设备，可指定租户、应用、设备配置文件
- 导出设备：将当前设备列表导出为文件，用于备份或迁移
9.6 LoRaWAN 历史数据查询页面
入口：菜单 Network（网络） → grpc-bridge → History（历史数据）
历史数据查询页面提供对 PostgreSQL 数据库中存储的 LoRaWAN 历史数据的查询与导出功能。
9.6.1 数据库统计
页面顶部以表格形式显示所有数据表的统计信息：
| 字段 | 说明 |
|---|---|
| 表名 | 数据表名称（如 device_join、device_up、device_down） |
| 大小 | 数据表占用空间 |
| 记录数 | 总记录条数 |
| 最早记录时间 | 最旧一条记录的时间戳 |
| 所属数据库 | PostgreSQL 数据库名称 |
9.6.2 查询配置
| 配置项 | 说明 |
|---|---|
| DevEUI | 填写要查询的目标设备 DevEUI |
| 查询类型 | 按数量限制（推荐）：搜索最多 200 条，导出最多 10000 条；按时间范围：最多 100 条（内存限制） |
| 数量选项 | 20 / 50 / 100 / 200 / 1000 / 10000 条 |
| 时间范围 | 指定起止时间（最早可查时间由数据库最旧记录决定） |
9.6.3 查询结果表格
查询结果分三个独立表格展示：
Join 记录：时间、DevEUI、TX 信息（入网请求记录）
上行记录：时间、DevEUI、DevAddr、帧类型、帧数据、计数器、MAC 命令、端口、负载长度、负载内容、解析对象
下行记录：时间、DevEUI、网关 ID、DevAddr、帧类型、帧数据、计数器、MAC 命令、端口、负载长度、下行负载内容
每个表格支持独立分页（20/50/100 条/页）。
9.6.4 导出 Excel
查询完成后，点击 导出 Excel 按钮，可将 Join、上行、下行三个表的数据一次性导出为 Excel 文件（.xlsx），便于离线分析与存档。
导出说明：搜索预览上限 200 条，批量导出上限 10000 条，建议分段按时间范围导出。按时间范围查询每次不超过 100 条，避免内存溢出。