IO-Liste Roundtrip: CSV-Bruecke zwischen Elektriker und Programmierer

Betrifft: ForgeIEC Studio

Worum es geht

Im Maschinenbau arbeiten zwei Welten parallel an derselben Anlage: der Elektriker zeichnet im EPLAN den Schaltplan und weist jedem Klemmenpunkt eine SPS-Adresse zu — der Programmierer schreibt die IEC-Logik gegen genau diese Adressen. Bisher wurde diese Bruecke per E-Mail gepflegt: PDF-Auszug, Tabellen-Copy- Paste, manuelles Nachtragen. Jeder Drehgeber-Tausch, jede Klemmen-Umverdrahtung kostete eine Synchronisationsrunde.

Mit dem MCP-Bus-3-Sprint koennen ForgeIEC Studio und EPLAN P8 ihre IO-Listen direkt austauschen — ueber eine 14-Spalten-CSV mit EPLAN-Property-Headern, bidirektional und idempotent.

Die Konvention

Eine ForgeIEC-IO-Liste ist ein UTF-8/BOM/;-getrennter CSV mit Headern, die direkt aus den EPLAN-SPS-Eigenschaften (TechTipp “Übersicht der SPS-Eigenschaften”, AML AR APC) abgeleitet sind:

Warum nicht “EPLAN-CSV”?

Die Web-Recherche (EPLAN Help-Portal, TechTipp Plattform 2027) zeigt es klar: EPLAN P8 hat KEIN universelles IO-Listen-CSV- Format. Der primaere Datenaustausch laeuft ueber AutomationML AR APC (XML); CSV-Schemata variieren je SPS-Hersteller (verschiedene Hersteller-Toolchains haben jeweils eigene Export-Plug-ins) und je Export-Plug-in. Was es gibt, sind die EPLAN-SPS-Eigenschaften mit eindeutigen Property-IDs — wir nutzen die als Spaltennamen, schaffen aber explizit keine “EPLAN-CSV”-Marke, sondern ein ForgeIEC-IO-list-Format, das gegen EPLAN-Exporte mit denselben Spalten kompatibel ist.

Idempotenz und Sicherheits-Disziplin

Der Importer macht drei Dinge bewusst NICHT:

1. Keine Variablen-Erfindung. Variablen werden im FDD-Pfad (bus.add_module / bus.replace_device) materialisiert. Wenn das CSV eine Variable nennt, die nicht im Pool existiert, wird die Zeile als variables_skipped gezaehlt — nie als neue Pool-Variable angelegt. Wer eine neue Variable braucht, geht ueber das FDD.
2. Keine FDD-Materialisation bei neuen Geraeten. Existiert in der CSV ein Hostname, den das Projekt noch nicht kennt, wird das Geraet als leeres Geraet angelegt — der Operator muss anschliessend bus.replace_device mit der passenden Coupler-FDD aufrufen, um die Modul-Struktur reinzuziehen.
3. Keine Atomic-Transactions. Zeilen mit Parse-Fehlern landen in errors[], der Rest committet. Partielle Imports sind gewollt — EPLAN-Exporte tragen oft Zeilen mit leeren Adressen (Dokumentations-Eintraege), die der Operator trotzdem importieren will.

Die Roundtrip-Garantie ist hart: ein bus.export_iolist unmittelbar gefolgt von bus.import_iolist auf einem unveraenderten Projekt MUSS { segments_created: 0, devices_created: 0, variables_updated: 0, errors: [] } ergeben. Verifiziert end-to-end gegen die Ackersteuerung-Test-Anlage (2 Segmente, 6 Geraete, 100+ Pool-Variablen).

Workflow im Alltag

Elektriker (EPLAN P8)              Programmierer (ForgeIEC)
=====================              =========================
1. Schaltplan zeichnet
2. SPS-Adressen vergibt
3. Zuordnungsliste exportiert
   → ackersteuerung.csv
                          ─ Mail ─►
                                   4. File → Import → IO-Liste...
                                   5. (Confirm-Dialog: cascade-impact)
                                   6. Pool-Variable bekommen die
                                      neuen Adressen + Funktionstexte
                                   7. ST-Code arbeitet weiter
                                      gegen die alten symbolischen
                                      Namen — keine Re-Compile noetig

Beide Tools (bus.import_iolist / bus.export_iolist) sind sowohl als MCP-Werkzeug (LLM-getrieben) als auch ueber das File → Import / Export-Menue (operator-getrieben) verfuegbar — bit-identisches Verhalten. Die IO-Liste-Aktionen liegen zusaetzlich unter Tools → Import / Export, weil sie konzeptuell zur Bus-Familie gehoeren und nicht zum POU-Code.

Naechste Schritte

• Phase 4 (Backlog): BMK-Round-Trip-Persistenz — derzeit wird die BMK-Spalte nur informativ durchgereicht. Ein zukuenftiges Schema haengt sie als Variable-Annotation an.
• AutomationML AR APC: der “echte” EPLAN-Standard. Sobald ein Anwender das fordert, ergaenzen wir bus.import_aml / bus.export_aml parallel zur CSV-Variante.