跳到主要内容

plantpulse-plugin（工业标准插件）

功能​

工业标准协议连接插件。使外部系统/设备能够通过工业标准接口访问 PlantPulse 的数据。

项目值
模块名称plantpulse-plugin
安装路径/opt/kopens/plantpulse-platform/plantpulse-plugin/
OPC-UA 端口11004（TCP），11005（TLS）
AAS V2 端口8007
AAS V3 端口8090

架构​

目录结构​

plantpulse-plugin/
├── opc-ua/                          # OPC-UA 서버
│   ├── bin/start.sh stop.sh log-viewer.sh
│   ├── config/
│   │   ├── server.properties
│   │   └── address-space.xml
│   ├── lib/
│   └── logs/system.log
└── aasx-server/                     # AAS (Asset Administration Shell)
    ├── bin/
    ├── config/
    │   ├── BaSyx-V2.cfg
    │   └── BaSyx-V3.cfg
    ├── lib/
    └── logs/

OPC-UA Server（端口 11004）​

将 PlantPulse 的标签/资产数据通过 OPC-UA 标准暴露给外部。

核心配置​

# opc-ua/config/server.properties
opcua.server.port=${PP_OPCUA_TCP_PORT}
opcua.server.tls.port=${PP_OPCUA_TLS_PORT}
opcua.server.app.uri=${PP_TLS_OPCUA_APP_URI}
opcua.server.product.name=PlantPulse OPC-UA Server

opcua.security.policy=Basic256Sha256,None
opcua.security.user.token=Username,Anonymous

opcua.user=opcua
opcua.password=설치-시-변경

opcua.cassandra.host=${PP_CASSANDRA_HOST}
opcua.cassandra.keyspace=${PP_KEYSPACE}

客户端连接​

OPC-UA 端点 URL：

  • opc.tcp://[HOST]:11004（None）
  • opc.tcp://[HOST]:11005（Basic256Sha256，TLS）

已验证的 OPC-UA 客户端：

  • UaExpert（Unified Automation）
  • Prosys OPC UA Browser
  • Node-RED node-red-contrib-opcua

标准健康检查​

内置的 Browse UI HTTP 服务器提供 GET /api/health（端口通过 opc.ua.browser.ui.port 设置，默认 12780）：

curl -fsS http://127.0.0.1:12780/api/health
# → {"status":"UP","service":"plantpulse-plugin-opcua-server","ts":...}

AAS Server（资产管理壳）​

ISO 23252 / IEC 63278 标准的数字孪生接口。将 Industrie 4.0 中的资产数据以标准化外壳形式暴露。

版本端口标准
V2（BaSyx）8007Plattform Industrie 4.0 V2
V3（BaSyx）8090IEC 63278 V3

API 端点​

# V2
curl http://[HOST]:8007/registry/api/v1/registry

# V3
curl http://[HOST]:8090/api/v3.0/shells

# V3 표준 헬스체크 (익명, 순수 liveness)
curl http://[HOST]:8090/api/health
# → {"status":"UP","service":"plantpulse-plugin-aasx-server","ts":...}

运维命令​

OPC-UA 和 AAS 均作为独立容器（plantpulse-plugin-opcua · plantpulse-plugin-aasx）运行。请直接管理容器。

pd status                                 # 포트 표 — 전부 RUNNING 이어야 한다
docker restart plantpulse-plugin-opcua    # OPC-UA 만 재시작
docker restart plantpulse-plugin-aasx     # AAS 만 재시작
docker logs --tail 50 plantpulse-plugin-opcua
以前的 restart-plugin.sh · restart-opcua-server.sh · restart-aasx-server.sh 已不存在

自从插件变为独立容器而非数据湖中的模块后，它们已移除。 plantpulse-datalake-cli/bin/ 中仅剩下 pd。

常见问题​

现象原因处置
OPC-UA 客户端连接失败防火墙 / 证书检查 11004 端口和 pd_ssl_prepare 签发的 OPC-UA 应用 URI → 安全设置
OPC-UA "Bad Certificate"self-signed 证书不受信任在客户端中转到 rejected/ → trusted/
AAS 数据未更新元数据缓存重启或更新 AAS Registry

相关文档​