词汇表
本节详细解释本手册及界面中经常出现的术语。
A — F
API
Application Programming Interface。程序之间交换数据的约定。该网关通过 REST API 使外部系统能够查询或注册数值。
bdSeq / seq
Sparkplug B 消息的序列号。用于验证消息是否缺失或顺序是否正确的标准字段。普通用户无需关注。
CIP
Common Industrial Protocol。EtherNet/IP 通信的基本协议。
CPU 使用率
以 % 表示网关 PC 的工作负载。如果持续在 80% 以上,则表示资源不足。
Cassandra
该网关使用的时序/配置存储库。普通用户无需直接操作。
EtherNet/IP
Allen-Bradley / Rockwell 的 PLC 使用的工业通信协议。标准端口 44818。
FEnet
Fast Ethernet。LS ELECTRIC 的 PLC (XGI / XBC / XBM) 使用的通信协议。标准端口 2004。
Formula (计算公式)
对标签值进行后处理的算术公式。使用 ${VALUE}*0.1 等格式进行单位转换或零点校正。
别名: 计算公式 / 公式 / Formula — 均指同一功能。 → 应用计算公式
G — N
Grafana
随附安装的附属仪表板工具。将网关采集的值通过图表、仪表盘或报警进行可视化。默认端口 3000。
HTTP 推送
与网关像 PLC 一样主动“读取”值不同,由外部系统将值“推送”到网关的方式。
MES
Manufacturing Execution System。工厂的任务下达与业绩管理系统。
MELSEC
三菱 PLC 的通信协议 (MC 协议)。MELSEC = MELSEC Communication。
Modbus
最古老且广泛使用的工业通信协议。几乎所有仪表和逆变器均支持。
MQTT
轻量级 IoT 消息协议。适用于将一个 PLC 的值同时发送到多个系统。标准端口 1883。
Node-RED
随附安装的附属数据流工具。可通过可视化方式构建数据加工和外部联动。默认端口 1880。
NodeId
OPC-UA 的标签地址表示法。例如:ns=2;s=Channel1.Device1.Tag1。
O — S
OPC
OLE for Process Control。PLC 与计算机之间的标准数据交换协议。早期分为 OPC DA / HDA / AE,现在已统一标准化为 OPC-UA。
OPC-UA
OPC Unified Architecture。OPC 的最新标准 (IEC 62541)。Kepware、Matrikon 等大多数 SCADA 均支持。
PLC
Programmable Logic Controller。工厂自动化的核心。用于控制传感器和执行器的工业计算机。
REST API
基于 HTTP 的 API 格式。该网关的 v1 REST API 通过 /api/v1/... 路径公开。 → 高级 — REST API
SCADA
Supervisory Control and Data Acquisition。对工厂、电站等运营进行监视和控制的系统。代表产品有 Ignition、Wonderware 等。
Sparkplug B
在 MQTT 之上实现了生命周期和元数据标准化的工业消息协议。建议在与 SCADA 或 MQTT 兼容系统通信时使用。
S7
西门子 PLC 的通信协议。用于 SIMATIC S7 系列。标准端口 102。
T — Z, 韩文
TCP / UDP
网络通信的基本方式。通常 TCP 具有更好的可靠性,而 UDP 速度更快。PLC 通信大多使用 TCP。
TIA Portal
西门子 PLC 编写与管理工具。
XG5000
LS ELECTRIC PLC 编写与管理工具。
网关 (Gateway)
在不同系统或网络之间建立连接并中继数据的设备或软件。本系统是“现场 PLC ↔ PlantPulse 云端”之间的网关。
时序 (Time Series)
按时间顺序记录的数据。像 PLC 值一样,以时间轴收集“何时是多少”的数据。
自动采集 (auto_collect)
网关重启时是否自动重新开始 PLC 采集。
标签 (Tag)
为 PLC 的一个内存单元赋予人类可读的名称。例如:D100 → “1号泵转速”。
轮询 (Polling) / 采集周期
网关定期向 PLC 询问“请给出当前值”的行为。通常为 1 秒 (1000ms)。
健康指数 (Health Index)
用 01(或 0100%)表示设备健康状态的指数。主要由 MotorSense 等诊断解决方案使用。
2026.05 容器部署术语
容器模式 (Container Mode)
PlantPulse Edge 以 Docker 单一镜像 (docker.kopens.io/pe/plantpulse-edge) 形式部署的状态。2026.05+ 标准。当 systemctl is-active plantpulse-edge.service 为 active 时,即为容器模式。
Native 模式
2026.05 之前的直接安装形式。以 /opt/kopens/plantpulse-edge/bin/{start,stop,restart}.sh 方式运行。新部署建议使用容器模式。
Image Tag / Build Date
容器镜像的标识符 — YYYY.MM-YYYYMMDD-HHMM 格式 (例如:2026.11-20261103-1006)。build_date 是 OTA 对比的标准。可通过 /api/v1/system/version 或 cat /etc/kopens/version.env 确认。
OTA (Over-The-Air upgrade)
远程升级。盒子中的 upgrade.sh 检测到 META-INF/VERSION.JSON 的新构建版本 → docker pull → 签名验证 → 自动 pre-snapshot → 重启 → 试运行判定 (默认 300 秒) → 失败时 auto-rollback。
Pre-snapshot
OTA 升级前自动创建的数据备份 (/data1/pp-backups/pe-backup-<ts>.tar.zst)。若新镜像导致数据损坏,可通过 restore.sh 恢复。
Pattern B (Signal File)
在容器内请求主机操作 (重启/刷机/OTA) 的方式。当容器编写 /etc/kopens/upgrade.request 或 host-action.request JSON 时,主机的 inotify 将检测并处理。相比于直接使用 /var/run/docker.sock 的 Pattern A,此方案可规避 host root 等权限问题。
cgroup limit
容器的内存/CPU 上限。systemd unit 的 MemoryMax=12G CPUQuota=600% TasksMax=8192。在 8GB 盒子等小内存环境下,通过 systemd drop-in (override.conf) 进行调整。
credentials.txt
install.sh 在每台盒子上首次生成随机密码集 (/etc/kopens/credentials.txt, chmod 0600)。包含 admin / mqtt / opcua / API key。出货时打印/保存后封口。
pe-* 工具
容器模式运行脚本 8 种 (/opt/kopens/install/bin/):
status.sh (状态), health.sh (exit code 健康检查), logs.sh (组件日志 tail),
shell.sh (进入容器 bash), config.sh (编辑 app.properties + 重启),
backup.sh/restore.sh (数据快照/恢复), doctor.sh (故障升级 tarball)。
其他产品术语
PlantPulse 的四个产品共享相同的资产层级及标签、数据点。此处未提及的术语请参阅另外三本手册 — 平台词汇表 · AI 词汇表 · Studio 词汇表。