跳到主要内容

术语表

本节解释本手册和界面中经常出现的术语。

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（计算公式、公式、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​

容器镜像的标识符 —— <version>-<build_date> 格式（例：2026-20260523）。build_date 是 OTA 比较的依据。可通过 /api/v1/system/version 或 cat /etc/kopens/version.env 确认。

OTA (Over-The-Air upgrade)​

远程升级。在盒子上由 upgrade.sh 检测 META-INF/VERSION.JSON 中新的 build_date → docker pull → 自动 pre-snapshot → systemctl restart → 90s health probe → 失败时 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 检测并处理。相比替代方案（Pattern A —— 直接使用 /var/run/docker.sock），可避免赋予等同 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）。