Edge-spezifische Nodes

In der Kategorie PlantPulse Edge der Palette stehen Ihnen folgende Nodes zur Verfügung.

Node-Paket 2026.05+

node-red-contrib-plantpulse-edge befindet sich innerhalb des Images node/conf/plantpulse-edge-nodes/ und der Entrypoint erstellt bei jedem Bootvorgang node_modules/node-red-contrib-plantpulse-edge einen absoluten Pfad-Symlink. Bereitgestellte Nodes: pp-tag-value-read / pp-tag-value-write / pp-tag-values-read / pp-tag-list / pp-opc-get / pp-opc-start / pp-opc-stop (insgesamt 7). Werden bei einem Image-Upgrade automatisch aktualisiert.

---

1. Tag-Wert lesen (pp-tag-read)

Ruft den Wert eines einzelnen Tags vom Gateway ab. Intern wird hierbei GET /api/v1/tag/{tagId}/value aufgerufen.

Feld	Beschreibung
Name	(Optional) Name des Nodes
Tag ID	Zu lesender Tag (z. B. TAG_TEST_00042). Wenn leer gelassen, erfolgt die dynamische Zuweisung über msg.tag_id
Fresh	Wenn aktiviert, wird der PLC direkt gelesen (Cache-Umgehung). Identisch mit ?fresh=true. Im Normalbetrieb deaktiviert lassen (PLC-Last)
Host / Port	Gateway-Adresse (Standard 127.0.0.1:80 — beibehalten, wenn auf derselben Maschine)
API Key	Wert (edge.rest.api.key), der an X-API-Key gesendet wird, wenn die REST API-Authentifizierung (edge.rest.api.auth) aktiviert ist. Kann durch msg.api_key überschrieben werden

Eingänge (Optional):

• msg.tag_id — Dynamisches Überschreiben der Tag ID in den Node-Einstellungen (Ermöglicht die Wiederverwendung eines Nodes für mehrere Tags)
• msg.fresh — Boolean, zur dynamischen Steuerung der Cache-Umgehung

Ausgang:

msg.payload = {
  tag_id: "TAG_TEST_00042",
  value:  "1234",
  value_time: "2026-05-08 03:01:19.001",
  value_read_status: "OK",
  ...
}
msg.statusCode = 200
msg.tag_id = "TAG_TEST_00042"   // 실제 사용된 ID

Empfohlenes Muster für dynamische Tag IDs

Lassen Sie die Tag ID in den Node-Einstellungen leer und füllen Sie diese über den Node change mit msg.tag_id = "TAG_...". Dies bietet die höchste Flexibilität, da derselbe Lesen-Node für mehrere Tags wiederverwendet werden kann.

---

2. Tag-Wert schreiben (pp-tag-write)

Schreibt einen Wert in einen Tag des Gateways. Intern über POST /api/v1/tag/{tagId}/value.

Feld	Beschreibung
Name	(Optional)
Tag ID	Zu beschreibender Tag. Dynamische Zuweisung über msg.tag_id möglich
Value	Festgelegter Wert (Optional). Priorisierung: msg.value → msg.payload → Node-Wert
Host / Port	Gateway-Adresse
API Key	Identisch mit dem Lese-Node — Wert edge.rest.api.key

Ausgang:

msg.payload = {
  result: "SUCCESS",         // 또는 "ERROR"
  opc_id: "OPC_LS_TEST",
  plc_address: "D1000",
  value: "9999",             // 사용자가 보낸 값
  actual_read: "9999",       // 드라이버가 write 후 즉시 read 한 결과
  msg: ""
}
msg.statusCode = 200

Unterstützte Protokolle: HTTP / OPC-UA / Modbus TCP / MELSEC / S7 / LS XGT(XGI/XBC/XBM) / AB EtherNet/IP. Bei EtherNet/IP kann das Schreiben bestimmter Datentypen je nach PLC-Firmware oder Patch abgelehnt werden. Verifizieren Sie dies im Simulator, bevor Sie es an der realen Anlage anwenden.

Schreibzugriffe sind risikobehaftet

Das Schreiben von Werten in eine reale PLC kann physische Bewegungen der Anlage auslösen. Verifizieren Sie die Funktion ausreichend mit Test-Tags oder einem Simulator OPC, bevor Sie sie auf reale Anlagen-Tags anwenden. Schreibberechtigungen dürfen nur für Tags verwendet werden, die mit dem Betriebsteam abgestimmt wurden.

---

3. Nächste Schritte

• Details zu MQTT Nodes — Anbindung an externe SCADA / Cloud-IoT
• IIoT Beispielsammlung — Praxisbeispiele für kombinierte Lese- und Schreibvorgänge