Projekt anfragen
Benešl Automation / Artikel / TIA-Projektdokumentation
Fachartikel · SPS- und HMI-Dokumentation

Dokumentation eines TIA-Portal-Projekts in Minuten: was die KI kann und was der Mensch prüfen muss

Jeder Kunde will eine Softwaredokumentation, und fast niemand will sie schreiben. Dabei steckt ein großer Teil des Inhalts schon im Projekt: Hardware, IP-Adressen, Bausteine, Aufrufhierarchie, Ein- und Ausgänge, Alarme. Eine mit dem TIA Portal verbundene KI kann das auslesen, Beschreibungen ergänzen und als PDF oder Excel zusammenstellen. Wir beschreiben, was ein einziger Auftrag erledigt und was der Mensch vor der Übergabe prüfen muss.

Ing. Tomáš Benešl · 21.10.2026 · 6 Minuten Lesezeit

Was in der Dokumentation eines TIA-Projekts meist fehlt

Ein typischer Stand vor der Übergabe: Netzwerke ohne Titel, Variablen ohne Kommentare, eine E/A-Liste in Excel, die nicht zum Projekt passt, und eine Bedienungsanleitung, die von einer älteren Maschine übernommen wurde. Dokumentation wird am Ende geschrieben, wenn keine Zeit mehr bleibt, und veraltet nach jeder Änderung.

Die gute Nachricht: Die meisten Fakten lassen sich maschinell aus dem Projekt lesen. Handarbeit bleibt vor allem bei der Erklärung, warum das Programm etwas tut, und bei den Anweisungen für die Bediener.

Was die KI selbst aus dem TIA-Projekt ausliest

  • Projektübersicht: SPS und HMI, Anzahl der Bausteine nach Typ und Sprache, F-CPUs, Variablentabellen und UDTs.
  • Hardware und Netzwerk: Module, IP-Adressen und ein Diagramm der Netzwerktopologie.
  • Die Aufrufhierarchie der Bausteine als Diagramm.
  • KOP- und FUP-Netzwerke als SVG-Bilder und GRAPH-Schrittketten mit Schritten und Transitionen.
  • Physische Ein- und Ausgänge mit Kommentaren und daraus eine FAT- und SAT-Checkliste in Excel mit den Spalten OK und NOK.
  • Eine Störungstabelle: WinCC-Unified-Alarme und Meldungen aus der SPS mit leeren Spalten für mögliche Ursache und Abhilfe.
  • Bausteine und UDTs als lesbare SIMATIC-SD-Textdokumente, ab TIA Portal V20.

All das sind Fakten aus dem Projekt. Die KI erfindet sie nicht, sie liest sie nur und setzt sie zusammen.

Kommentare und Titel direkt in den Bausteinen

Die nützlichste Dokumentation ist die im Projekt. TIA MCP stellt für jeden Baustein die Grundlagen bereit: Schnittstelle, Code, vorhandene Titel und Kommentare, was fehlt und wer den Baustein aufruft. Daraus schreibt die KI Titel und Kommentar des Bausteins, Netzwerktitel und Variablenkommentare und schreibt sie in den Baustein. Der Code ändert sich dabei nicht, vor dem Schreiben wird eine Sicherung gespeichert.

Hier ist die Prüfung am wichtigsten. Die KI beschreibt, was der Code tut. Warum er es tut, erkennt sie nur aus Namen und Kommentaren. Der Kommentar „Verzögerung 5 s“ ist wahr, nützlich ist aber erst „Verzögerung 5 s, damit das Ventil vor dem Pumpenstart öffnen kann“.

Übergabedokumentation und Bedienungsanleitung als PDF

Die Software-Übergabedokumentation enthält Projektübersicht, Hardware und IP-Adressen, Aufrufhierarchie, Bausteinbeschreibungen, Datenbausteine und UDTs, Ein- und Ausgänge, HMI-Alarme, den Fingerabdruck des Safety-Programms, eine Zusammenfassung des Code-Reviews und ein Übergabeprotokoll zur Unterschrift. Bei der nächsten Ausgabe vergleicht TIA MCP sie mit der vorherigen und listet die Änderungen auf.

Die Bedienungsanleitung entsteht in zwei Schritten. TIA MCP sammelt Daten aus dem Projekt einschließlich der HMI-Bilder, die KI schreibt die Kapiteltexte und die Vorlage wird als PDF gesetzt. Screenshots der WinCC-Unified-Bilder werden automatisch aus der laufenden Simulation aufgenommen. Ändert sich das Projekt, zeigt die Aktualisierung der Anleitung zuerst einen Plan: welche Kapitel unverändert sind, welche aus den Daten neu erzeugt werden und welche jemand umschreiben muss. Die neue Version erhält einen Eintrag in der Revisionshistorie.

Das PDF wird mit LaTeX gesetzt, auf dem Rechner muss daher pdflatex (MiKTeX oder TeX Live) installiert sein. Ohne es erhalten Sie die Quelldatei .tex.

Die Seite Projektdokumentation in der Weboberfläche

Seit Version 2.19.0 hat die Weboberfläche von TIA MCP eine Seite Projektdokumentation. Nach Auswahl von SPS und HMI bietet sie Registerkarten: Bedienerhandbuch, Übergabedokumentation, E/A-Liste und Checkliste, Bausteindokumentation, Änderungsbericht, Safety (nur bei Projekten mit F-CPU) und Export von Dokumenten und Texten. Die Dateien werden im Ordner exports gespeichert und lassen sich sofort herunterladen oder in der Vorschau anzeigen.

Auf derselben Seite finden Sie auch die Projekttexte: Export nach Excel, Übersetzung mit KI und Import nach Bestätigung. Nach dem Import exportiert TIA MCP die Texte erneut und zeigt, was unübersetzt geblieben ist.

Beispiele für Aufträge an die KI

Erstelle eine Projektübersicht und erzeuge die Aufrufhierarchie für PLC_1. Liste dann die Bausteine auf, denen Netzwerktitel oder Variablenkommentare fehlen.
Ergänze Netzwerktitel und Variablenkommentare in FB_Doser auf Deutsch. Zeig mir die Texte zuerst, schreibe sie erst nach Freigabe. Wo du den Zweck des Codes nicht erkennst, schreibe eine Frage statt einer Vermutung.
Erstelle die Software-Übergabedokumentation für PLC_1 und HMI_1 auf Deutsch mit Zusammenfassung des Code-Reviews. Vergleiche sie mit der Baseline der letzten Ausgabe.
Erzeuge eine E/A-Checkliste für die FAT in Excel und eine Störungstabelle aus den Alarmen von HMI_1 und PLC_1.

Worauf Sie achten sollten: was der Mensch prüfen muss

  • Zweck und Zusammenhänge. Die KI beschreibt den Code, kennt aber weder die Technologie noch die Absprachen mit dem Kunden. Bausteinbeschreibungen und Kapitel der Anleitung muss jemand lesen, der die Maschine kennt.
  • Sicherheit der Bediener. Warnhinweise, Vorgehen bei Störungen und Anweisungen für sicheres Arbeiten muss die dafür verantwortliche Person schreiben oder freigeben. Für die Betriebsanleitung der Maschine ist ihr Hersteller verantwortlich.
  • Das Safety-Programm. Fingerabdruck und Signaturen aus dem Projekt sind Fakten, die Validierung des Safety-Programms bleibt aber Aufgabe einer qualifizierten Person.
  • Zahlen und Parameter. Vergleichen Sie Sollwerte, Zeiten und Grenzen im Text mit dem Projekt und mit der Spezifikation. Widersprechen sie sich, kann der Fehler im Programm oder in der Vorgabe liegen.
  • Übersetzungen. Prüfen Sie Fachbegriffe und Abkürzungen anhand des Glossars des Kunden oder mit einem Muttersprachler. Platzhalter in Alarmtexten müssen unverändert bleiben, eine Übersetzung mit beschädigten Platzhaltern lehnt TIA MCP ab.
  • Aktualität. Die Dokumentation gilt für eine bestimmte Projektversion. Nennen Sie diese im Dokument und aktualisieren Sie die Dokumentation nach Änderungen.

Fazit

Mit KI sind das Sammeln der Fakten aus dem TIA-Projekt und das Zusammenstellen der Dokumente eine Sache von einem Auftrag. Die gesparte Zeit gehört der Prüfung: Zweck der Bausteine, Sicherheitshinweise, Zahlen und Übersetzungen. Die Dokumentation passt dann zum Projekt und lässt sich nach Änderungen aktualisieren, statt neu geschrieben zu werden.

Eine Übersicht aller Dokumentationswerkzeuge finden Sie auf der Seite TIA-Projektdokumentation mit KI.

Häufige Fragen

Kann KI die Dokumentation zu einem SPS-Programm im TIA Portal schreiben?

Ja, wenn sie das Projekt sieht. Über TIA MCP liest die KI Bausteine, Hardware, Ein- und Ausgänge sowie Alarme, ergänzt Titel und Kommentare und erstellt eine Übergabedokumentation als PDF. Beschreibungen des Zwecks und Anweisungen für die Bediener muss ein Mensch prüfen.

Ändert die KI beim Ergänzen von Kommentaren den Bausteincode?

Nein. Geschrieben werden nur Titel und Kommentare von Baustein, Netzwerken und Variablen. Vor dem Schreiben wird eine Sicherung gespeichert, die sich mit einem Befehl zurückholen lässt.

In welchen Formaten entsteht die Dokumentation?

Übergabedokumentation und Bedienungsanleitung als PDF über LaTeX, E/A-Checkliste und Störungstabelle in Excel, Diagramme als SVG oder Mermaid und der Änderungsbericht in Markdown. Bausteine lassen sich auch als SIMATIC-SD-Textdokumente exportieren.

Wie halte ich die Dokumentation nach Projektänderungen aktuell?

Die Übergabedokumentation wird mit der vorherigen Ausgabe verglichen und listet die Änderungen auf. Die Bedienungsanleitung wird nach einem Änderungsplan kapitelweise aktualisiert. Ein Änderungsbericht zwischen Projektversionen entsteht aus dem Textexport des Projekts in Git.

Verwandte Artikel und Seiten

Dokumentieren Sie Ihr Projekt mit KI

TIA MCP verbindet ChatGPT, Claude, Copilot oder Gemini mit dem TIA Portal V17–V21 unter Windows. Eine PRO-Lizenz kostet 295 € pro Jahr und Rechner zzgl. MwSt., die ersten 7 Tage sind kostenlos.

Siemens, SIMATIC, TIA Portal, WinCC und S7 sind Marken der Siemens AG. TIA MCP ist ein eigenständiges Produkt von Benešl Automation, kein Produkt der Siemens AG und arbeitet mit dem TIA Portal über die offizielle Schnittstelle TIA Portal Openness.