查看实时值
这是实时确认已注册 PLC / 标签的当前值的方法。网关提供三种实时视图。
| 视图 | 轮询周期 | 用途 |
|---|---|---|
/ui/connect/list (左侧 OPC + 右侧 标签表) | 5 秒 | 一眼查看单个 OPC 的所有标签值 |
/ui/connect/tag-view/{opc_id}/{tag_id} (单标签实时图表) | 1 秒 | 查看特定标签的趋势和时序 |
/ui/main 卡片 | 1 秒 | 网关系统状态 (CPU/内存/网络/Sparkplug 等) |
1. 在 [连接列表] 界面查看 (/ui/connect/list)
这是最简单的方法。
- 点击顶栏的已连接列表图标或首页卡片的 已连接列表 (N)
- 在左侧 [OPC 列表] 中点击想要查看的 PLC 行
- 右侧将显示该 PLC 的标签列表 + 当前值
- 每 5 秒自动刷新
详细列定义 / 操作请参考 连接列表 / 标签列表界面。
2. 单标签实时图表 (/ui/connect/tag-view/{opc_id}/{tag_id})
如果需要深入查看特定标签的时序，点击标签行 → 将跳转至独立的 tag-view 页面 (或直接通过 URL 进入)。
2.1 界面构成
┌────────────────────────────────────────────────────────────┐
│ ⊙ {OPC_ID} / {TAG_ID} [←] [↻] │
├────────────────────────────────────────────────────────────┤
│ [태그 메타 패널] │
│ tag_id / java_type / plc_address / opc_id / 마지막 갱신 │
├────────────────────────────────────────────────────────────┤
│ [값 추이 차트] [범위 콤보 ▼] │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ (수치/불리언 — ECharts 라인 / STRING — vis 박스) │ │
│ │ │ │
│ │ [── dataZoom 슬라이더 (연한 그레이) ────────] │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
2.2 图表类型 (自动分支)
| 数据类型 | 图表 |
|---|---|
Integer / Long / Float / Double | ECharts Line — 平滑样条线 + 右侧 Y 轴 |
Boolean | ECharts step end — 0/1 阶梯型 |
String | vis-timeline 框 — 将连续相同值的区间合并为一个框 (状态机可视化) |
2.3 图表交互
| 功能 | 说明 |
|---|---|
| 范围组合 | 1분 / 5분 / 10분 / 30분 / 1시간(default) / 3시간 / 12시간 / 24시간 — 选择后立即从 Cassandra tm_tag_point 重新 fetch |
| dataZoom 滑块 | 图表底部的水平条 — 通过鼠标拖拽进行水平缩放/平移。浅灰色调 (由之前的深色更改) — 不遮挡图表主体 |
| 自动添加 | 1 秒轮询将新值 push 至图表 (增量添加，无需全局 redraw) |
| 鼠标悬停 | 通过 tooltip 显示 ms 级时间 + 数值 |
| STRING 图表更新 | 将 history 按 ASC 排序后重新构建整个 vis dataset — 连续相同值区间无闪烁 |
使用与 OPC UA 服务器 右侧图表相同的色调 / 相同数据 — 不同之处在于 tag-view 是单标签全屏，opcua viewer 是树形结构 + 小图表面板。
3. 表格列 (参考)
左侧 [OPC 列表]
| 列 | 含义 |
|---|---|
| PLC | 协议 | 协议 Logo + 类型 |
| 连接状态 | 🟢 连接 / 🔴 断开 / ⬜ 未知 |
| OPC ID / 名称 / 说明 | 标识 / 用户标签 |
| 采集周期 (ms) | timecycle |
| 自动启动 / 异步 | 选项 ✓ / - |
| 已连接标签数 | 该 OPC 的标签数量 |
| 采集次数 | 启动后累计读取数 (point_count) |
| 采集状态 | 🟢 正常 / 🟧 异常 / ⬜ 停止 |
| 操作 | ▶ 开始 / ⏹ 停止 / 🔧 编辑 / 🗑 删除 |
(详细的 14 列原文请参阅 连接列表)
右侧 [标签列表]
| 列 | 含义 |
|---|---|
| TAG ID / 名称 | 标识 / 用户标签 |
| PLC 地址 | 读取位置 (例如：D0, M10, 40001) |
| 数据类型 | INT / DOUBLE / BOOL / STRING ... |
| 最后值 | 最近一次采集 (圆角实心徽章 — pp-cell-pill 色调。列宽 160px) |
| 更新时间 | 最后更新时刻 |
| 读取状态 | OK (绿色实心) / ERROR (红色实心) |
| 读取错误消息 | 失败原因 (成功时为空) |
| 操作 | ✏ 行内写入 / 📈 图表 (跳转至 tag-view) |
主界面概览
返回顶部 [首页] (或点击左上角 Logo) 可在一个界面中查看网关整体状态。
| 显示区域 | 内容 |
|---|---|
| CPU / 内存 / 磁盘 仪表盘 | 网关 PC 资源状态 |
| 连接 / 标签 数量 | 整体注册数量摘要 |
| PLC 连接及采集状态 | 连接正常 / 失败数量, 累计采集次数 |
| 处理速度 (mps) | 每秒处理次数趋势图 |
如果仪表盘变为红色，表示资源不足。请咨询系统管理员。
Motor Sense 的情况
MOTOR_SENSE 类型连接将以资产 (Asset) 独立卡片形式显示，而非普通标签表。
- HEALTH INDEX 卡片 — 资产健康指数 (不平衡 / 对齐 / 轴承等)
- SIGNAL 卡片 — 振动 / 温度 / 电压等信号值
每 1 秒自动更新，无独立刷新标志。
从外部系统获取数值
如果其他系统 (仪表盘、分析工具等) 需要从网关获取数值，可以选择以下方法。
| 方法 | 适用场景 |
|---|---|
| MQTT 订阅 | 普通 IIoT 系统 |
| Sparkplug B 订阅 | Ignition / HiveMQ Edge / 标准 SCADA |
| REST API 查询 | 自研仪表盘 / 后端 |
| 暴露为 OPC-UA 服务器 | 外部 SCADA 作为 OPC-UA 客户端接入 |
详细配置 / Topic / Endpoint 规格请参阅 高级 — REST API / 高级 — Sparkplug B。
常见问题
Q. 有数值进入，但更新太慢
很可能是注册标签时的采集周期设置得太长。请在 PLC 注册 [编辑] 中减小 수집 주기 (ms)。通常 1000ms (= 1秒) 较为合适。
Q. 界面 5 秒刷新一次太慢了
/ui/connect/list 的表格刷新周期为 5 秒。如果想更快地观察某个标签，请点击该标签进入 单标签实时图表 (/ui/connect/tag-view) — 该页面为 1 秒轮询。若需同时快速查看多个标签，请配合使用独立仪表盘工具 (如 Grafana)。参考 应用程序管理。
Q. 同一个 PLC 中，部分标签正常，部分标签报错
如果仅特定标签报错，绝大多数情况是该标签的 PLC 地址标注 错误或 格式辅助 (format) 不匹配。请单独对该行进行 [编辑] 巡检。