顶栏与快速操作
无论在哪个画面，网关 Web UI 的顶栏和正文底部的快速操作栏都会随之显示。这里是用于一眼查看“该图标指向何处”的索引。
顶栏 — 左侧为首页，右侧为导航
| 编号 | 图标 | 名称 (悬停时显示) | 功能说明 | 详情 |
|---|---|---|---|---|
| ① | Logo | — | 点击跳转至首页(/ui/main)。旁边的文字是该网关的名称，用于区分设备 | 首页 |
| ② | fa-plug | 连接协议 | 注册新的 PLC·OPC-UA·MQTT。首先从协议卡片中选择 | 协议选择 · 添加新 PLC 连接 |
| ③ | fa-list | 已连接列表 | 在一个画面中对已注册的连接及其标签进行启动、停止和编辑 | 连接列表与标签列表 |
| ④ | fa-cubes | 应用程序 | 启动、停止并查看运行在网关上的 Docker 应用日志 | 应用程序管理 |
| ⑤ | fa-sitemap | OPC UA 服务器 | 网关提供的 OPC-UA 树 —— 与外部 SCADA 查看到的完全一致 | OPC UA 服务器 |
| ⑥ | fa-database | 数据点检索 | 按时间段、连接、标签检索存储的时序值并导出为 CSV | 数据点检索 |
| ⑦ | fa-exclamation-triangle | 日志 | 系统日志。图标上的红色数字为今日错误数量 | 系统日志 |
| ⑧ | fa-project-diagram | 低代码流 | Node-RED — 读取标签值进行加工并发送至外部 | 流 |
| ⑨ | fa-tachometer-alt | 高级仪表盘 | 在新窗口中打开网关的 :3000(Grafana) | — |
| ⑩ | fa-cog | 设置 | 在浏览器中修改 app.properties | Web UI 环境设置 |
| ⑪ | fa-book-open | 手册 | 在新窗口中打开本文档网站(docs.kopens.io) | — |
| ⑫ | fa-sign-out-alt | 退出登录 | 结束当前会话 | 登录 |
⑨ 和 ⑪ 为新窗口打开
其余项在同一窗口中跳转。⑨ 为网关外部工具(默认为 Grafana)，可能因站点而异；若防火墙拦截了 3000，则无法打开 → 防火墙 — 开放端口
初次使用建议顺序
- ② 连接协议 — 选择并注册将要使用的 PLC 类型
- ③ 已连接列表 — 开始采集并确认数值是否正常进入
- ⑤ OPC UA 服务器 — 确认外部 SCADA 看到的呈现方式
- ⑧ 低代码流 — 对采集的值进行加工或发送至外部
- ⑩ 设置 — 细化 MQTT·Sparkplug·保留周期等策略
快速操作 — 正文底部
该栏不在顶栏，而是在正文最底部。将页面滚动至底端，其位于左下角；右侧末端会显示当前 S/W 版本及“可升级”徽标。
| 编号 | 图标 | 功能 | 影响程度 |
|---|---|---|---|
| ① | fa-projector | 系统重启 | 🔴 重启 OS — 期间采集将停止 |
| ② | fa-repeat-1-alt | 应用程序重启 | 仅重启网关应用 |
| ③ | fa-trash | 清理临时文件 | 磁盘空间不足时使用 |
| ④ | fa-stopwatch | 备份 | 将设置与数据打包 |
| ⑤ | fa-file-alt | 下载日志 | 提交咨询时附带的压缩包 |
| ⑥ | fa-microchip | OS 及 固件升级 | 🔴 风险最高 |
| ⑦ | fa-cloud-download | S/W 升级 | 从下载服务器获取新版本 |
① 和 ⑥ 会影响现场运行
重启和固件升级会导致采集中断。在执行操作前，请先确定允许的中断时间。各项操作的耗时与注意事项请参阅 状态栏快速操作。
各画面的其他导航路径
| 画面 | 专属功能 |
|---|---|
首页 (/ui/main) | 点击卡片跳转至对应画面。点击**「系统错误」的红色数字**直接进入日志 |
| 连接列表 | 通过卡片的 ▶ ◼ 开启或关闭采集。可直接在标签行写入数值 |
| OPC UA 服务器 | 在树状结构中选择节点，右侧显示详情与图表。可复制 NodeId |
| 应用程序 | 点击卡片端口，在新窗口中打开该应用 |
| 系统日志 | 通过左侧检索条件缩小范围，在右上方清除所有日志 |
| 设置 | 修改并保存后，将弹出重启引导提示 |
根据需求快速查找
| 需求 | 快速路径 |
|---|---|
| 仅查看今日发生的错误 | 顶栏 ⑦ 的红色数字 → 或 首页的「系统错误」 |
| 确认 PLC 当前是否连接 | 顶栏 ③ → 卡片的连接图标 (绿色 = 已连接) |
| 查询昨日某时刻的数值 | 顶栏 ⑥ → 按时间段·连接·标签检索 → CSV |
| 确认外部 SCADA 呈现方式 | 顶栏 ⑤ |
| 查看当前运行的容器 | 顶栏 ④ |
| 修改单条配置 | 顶栏 ⑩ → 修改并保存 → 快速操作 ② 重启 |
| 应用新版本 | 快速操作 ⑦ (仅在徽标为红色时) |