Git und Versionen von TIA-Projekten mit KI
Ein TIA-Portal-Projekt wird in Binärdateien gespeichert, daher kann Git allein nicht zeigen, was sich darin geändert hat. TIA MCP exportiert das Projekt als Text und speichert es als Version in Git. Die KI sagt Ihnen dann, was sich zwischen Versionen in Bausteinen, Variablen, UDTs und Hardware geändert hat. Dazu Sicherungen vor jedem Schreiben, Vergleich mit der SPS und Arbeit mit VCI und Multiuser Engineering.
Warum Git allein für ein TIA-Projekt nicht reicht
Git ist ein Werkzeug für Textdateien. Ein TIA-Portal-Projekt besteht jedoch aus den Binärdateien der Projektdatenbank. Legen Sie es direkt in Git ab, sehen Sie nur, dass sich Dateien geändert haben – nicht welcher Baustein, welches Netzwerk oder welche Variable. Zwei Versionen vergleichen oder dem Kunden mitteilen, was sich geändert hat, geht so nicht.
TIA MCP exportiert das Projekt deshalb zuerst als Text. Jeder SPS-Baustein, jeder UDT und jede Variablentabelle erhält eine eigene XML-Datei, die Hardware steht in JSON. Der Export ist deterministisch: Zeitstempel und interne Kennungen werden aus dem XML entfernt, sodass der Diff nur echte Änderungen zeigt. Ein Baustein, der aus dem Projekt verschwindet, verschwindet auch aus dem Export, das Löschen ist also in der Historie sichtbar.
D:\Git\Linka\ ├── project.json ├── PLC_1\ │ ├── blocks\Motors\FB_Pump.xml │ ├── blocks\Main.xml │ ├── types\typMotor.xml │ ├── tags\IO.xml │ └── hardware.json └── PLC_2\ …
Auf dem Export funktioniert dann normales Git: Commit, Historie, Branches und Push auf den Server Ihrer Firma. Der Änderungsbericht macht aus den XML-Unterschieden eine lesbare Form – Schnittstelle, Netzwerke als Pseudologik oder SCL, Titel und Safety-Bausteine separat.
Git ändert nur die Exportdateien, nicht das Projekt im TIA Portal. Ein Branch-Wechsel ändert das Projekt also nicht, und aus dem Export wird nichts automatisch zurückgeladen. Einzelne Objekte stellen Sie aus den Sicherungen vor dem Schreiben wieder her, das ganze Projekt aus einem TIA-Portal-Archiv.
Was TIA MCP für Versionen und Änderungen kann
Sie geben Aufträge in normaler Sprache, die KI wählt das passende Werkzeug. Die rechte Spalte zeigt deren Namen für alle, die mehr wissen wollen.
| Aufgabe | So funktioniert es | Werkzeuge |
|---|---|---|
| Version in Git speichern | Exportiert das Projekt als Text und committet es mit einer Beschreibung. Legt das Repository bei der ersten Verwendung an. | tia_git_committia_export_project_to_text |
| Was sich seit dem letzten Commit geändert hat | Frischer Export und der Unterschied zum letzten Commit – Dateiübersicht oder vollständiger Diff. | tia_git_diff |
| Änderungsbericht | Lesbare Änderungen zwischen zwei Versionen oder gegenüber dem aktuellen Stand: Bausteine (Schnittstelle, Netzwerke, Titel), Safety-Bausteine separat, UDTs, Variablen und HW. Speichert Markdown. | tia_change_report |
| Branches, Historie und Server | Status, Historie, Branches, Wechsel, Zusammenführen, Tags, Push und Pull. Push zeigt zuerst eine Vorschau der Commits, Pull nur Fast-Forward. | tia_git |
| Sicherungen vor dem Schreiben | Vor jedem Schreiben der KI wird das Objekt gesichert. Sie sehen die Sicherung ein und stellen das Objekt mit einem Befehl wieder her. Alte Sicherungen räumen Sie mit Vorschau auf. | tia_list_snapshotstia_read_snapshottia_restore_snapshottia_prune_snapshots |
| Inhalts-Fingerabdrücke | Die Fingerabdrücke des TIA Portals ändern sich nicht durch Übersetzen oder Speichern, nur durch Inhalt, und unterscheiden Codeänderungen von Kommentaränderungen. Ab TIA Portal V19. | tia_fingerprints |
| Ist dieses Programm in der SPS? | Software-Prüfsummen offline – dieselben zeigt die CPU online. Vergleich des Offline-Programms mit SPS oder PLCSIM ohne Schreiben. | tia_plc_checksumstia_online_fingerprinttia_compare_online |
| Vergleich von SPS und Projekten | Programme zweier SPS, eine SPS gegen ein anderes Projekt oder Archiv (schreibgeschützt geöffnet) und der Unterschied zweier Bausteine. | tia_compare_plc_softwaretia_compare_devicestia_compare_blocks |
| VCI (Version Control Interface) | TIA-Portal-Workspace im Ordner des Git-Repositorys, Export von SPS-Objekten in Dateien, Status und Synchronisation in beide Richtungen. | tia_list_vci_workspacestia_vci_workspacetia_vci_exporttia_vci_statustia_vci_sync |
| Multiuser Engineering | Server und Serverprojekte, lokale Sessions, Markieren von Objekten vor der Bearbeitung, Konflikte und Check-in mit Kommentar. | tia_mu_serverstia_mu_create_sessiontia_mu_open_sessiontia_mu_markingstia_mu_marktia_mu_commit |
| Projekthistorie | Erstellung, Migration, Hochrüstung und Massenimporte mit Zeit, verwendete Produkte und welche davon auf diesem PC fehlen. | tia_project_history |
| Exporte und Archiv | Export des gesamten Projekts nach JSON und XML, Bausteine als SIMATIC-SD-Dokumente (ab V20) und ein Projektarchiv zur Sicherung oder Übergabe. | tia_dump_alltia_export_documentstia_project_archive |
So arbeiten Sie mit Git an einem TIA-Projekt
Ein typischer Ablauf. Jeden Schritt geben Sie der KI in einem Satz vor oder erledigen ihn auf der Seite Versionen und Änderungen in der Web-GUI.
Erste Version
Sie geben den Repository-Ordner an und die KI macht den ersten Commit: Export des Projekts als Text und Anlegen des Repositorys.
Arbeit im Projekt
Sie oder die KI programmieren. Jedes Schreiben der KI hat eine Sicherung und einen Audit-Eintrag.
Was sich geändert hat
Vor dem Commit lassen Sie sich den Diff oder den Änderungsbericht zeigen.
Commit
Die Version wird mit einer Beschreibung gespeichert, was und warum geändert wurde.
Branches und Server
Ein Branch für die Änderung, Push auf den Firmenserver nach Commit-Vorschau, Pull nur Fast-Forward.
Bericht für den Kunden
Ein Änderungsbericht zwischen Ausgaben in Markdown für die Übergabedokumentation oder Release Notes.
Sicherungen, Git, VCI, Multiuser oder Archiv?
Sie schließen sich nicht aus. Jeder Weg löst etwas anderes, und TIA MCP kann mit allen arbeiten.
| Weg | Wofür |
|---|---|
| Sicherungen vor dem Schreiben | Ein Schritt zurück nach einem Schreiben der KI. Entstehen automatisch, pro Objekt, auf Ihrem PC. |
| Git mit dem Textexport | Versionshistorie, Vergleich, Änderungsbericht und Teilen über einen Server. |
| VCI | Wenn Sie das Version Control Interface im TIA Portal bereits nutzen: Objekte als Dateien, synchronisiert mit dem Projekt. |
| Multiuser Engineering | Mehrere Programmierer gleichzeitig in einem Projekt über einen TIA-Portal-Server. |
| Projektarchiv | Das komplette Projekt zur Sicherung oder Übergabe an den Kunden. |
Die Seite Versionen und Änderungen in der Web-GUI
Seit Version 2.18 hat die Weboberfläche von TIA MCP die Seite Versionen und Änderungen. Alles oben Genannte erledigen Sie dort per Klick, ohne einen Auftrag zu schreiben.
Sicherungen
Liste der Sicherungen mit Filter, Inhalt der Sicherung (XML, JSON oder SCL), Download, Wiederherstellen des Objekts und Aufräumen alter Sicherungen mit Vorschau.
Änderungsbericht
Zwei Versionen (Commit, Branch, Tag oder aktueller Stand), Zusammenfassung der Änderungen pro Gerät und Speichern als Markdown.
Git
Status, Commit-Historie, Commit mit Projektexport, farbiger Diff seit dem letzten Commit, Branches, Push mit Vorschau und Pull.
Projekthistorie
Ereignisse aus dem TIA Portal, verwendete Produkte und was auf diesem PC fehlt.
VCI
Übersicht der Workspaces und Status der zugeordneten Objekte: welche sich zwischen Projekt und Dateien unterscheiden.
Sichere Git-Operationen
Die KI arbeitet mit Git nur in Grenzen, die weder Historie löschen noch die Arbeit von Kollegen auf dem Server überschreiben können:
- Nie Force-Push, reset --hard, clean oder Rebase.
- Push sendet nur den aktuellen Branch und erst nach Bestätigung der Commit-Vorschau.
- Pull nur Fast-Forward. Auseinandergelaufene Branches bleiben unberührt, ein Merge wird empfohlen.
- Zusammenführen ohne automatische Konfliktlösung: Bei einem Konflikt wird es zurückgenommen, die Konfliktdateien werden aufgelistet und das Repository bleibt sauber.
- Branch-Wechsel, Merge und Pull lehnen nicht committete Exportänderungen ab – zuerst Commit.
- Anmeldung am Server über einen Credential Helper oder SSH-Schlüssel. Git fragt nie nach einem Passwort.
- Ein Repository, dessen Einstellungen ein fremdes Programm starten könnten, lehnt TIA MCP ab.
Beispielaufträge für die KI
Sie schreiben in normaler Sprache. Ersetzen Sie Pfade und die Namen von SPS und Bausteinen durch Ihre eigenen.
Speichere den aktuellen Projektstand in Git unter D:\Git\Linie mit der Beschreibung „Neue Förderband-Alarme“.
Was hat sich im Projekt seit dem letzten Commit geändert?
Schreibe einen Änderungsbericht zwischen Tag v1.2 und dem aktuellen Stand und speichere ihn als Markdown.
Lege den Branch fuellung-aenderung an und zeig mir, wenn wir fertig sind, was auf den Server gesendet würde.
Ist in PLC_1 dasselbe Programm wie im Projekt? Vergleiche offline und online ohne Schreiben.
Speichere die Fingerabdrücke der Bausteine von PLC_1 als Baseline und sag mir nach den Änderungen, wo sich Code und wo nur Kommentare geändert haben.
Was ein Mensch prüfen muss
Git und Sicherungen geben Ihnen Überblick und einen Weg zurück. Die Entscheidung, was in die SPS geladen wird, bleibt bei Ihnen.
- Commit-Beschreibung. Die KI schlägt sie vor, aber warum die Änderung gemacht wurde, wissen Sie.
- Konflikte. Bei einem Konflikt wird der Merge zurückgenommen. Wie die Arbeit zweier Personen zusammengeführt wird, entscheidet ein Mensch.
- Umfang des Exports. Der Textexport enthält SPS-Bausteine, UDTs, Variablentabellen und eine Hardwareübersicht. HMI-Bilder sind nicht enthalten, sichern Sie das ganze Projekt mit einem Archiv.
- VCI-Synchronisation ins Projekt. Sie ändert das Projekt. Starten Sie sie bewusst, im Nur-Lese-Modus wird sie nicht ausgeführt.
- Prüfsummen. Eine Übereinstimmung sagt, dass dieses Programm in der SPS ist. Sie sagt nicht, dass das Programm richtig ist.
TIA-Projektdokumentation mit KI
Häufige Fragen zu Git und Versionen von TIA-Projekten
Lässt sich ein TIA-Portal-Projekt in Git versionieren?
Direkt nur als Binärdateien, in denen Git nicht zeigt, was sich geändert hat. Mit TIA MCP wird ein Textexport des Projekts in Git gespeichert: Bausteine, UDTs, Variablentabellen und Hardware. Unterschiede zwischen Versionen sind dann pro Baustein und Netzwerk sichtbar.
Brauche ich Git auf dem Rechner?
Ja, Git muss installiert und im PATH verfügbar sein, zum Beispiel Git for Windows. Für Push auf einen Server brauchen Sie Zugang über einen Credential Helper oder SSH-Schlüssel.
Ändern Git-Operationen mein TIA-Projekt?
Nein. Der Export liest das Projekt nur, und Git-Befehle ändern nur das Repository mit dem Export. Ein Branch-Wechsel ändert das Projekt im TIA Portal also nicht.
Wie mache ich eine Änderung der KI rückgängig?
Vor jedem Schreiben wird das Objekt gesichert. Die Sicherung stellen Sie mit einem Befehl oder auf der Seite Versionen und Änderungen in der Web-GUI wieder her. Lässt sich ein vorhandenes Objekt nicht sichern, wird nicht geschrieben.
Was ist der Unterschied zwischen Git und Multiuser Engineering?
Multiuser Engineering ist eine Funktion des TIA Portals, mit der mehrere Personen gleichzeitig über einen Server an einem Projekt arbeiten. Git mit Textexport dient der Versionshistorie und dem Vergleich. TIA MCP kann mit beidem arbeiten.
Unterstützt TIA MCP VCI (Version Control Interface)?
Ja. Es legt einen Workspace an, etwa im Ordner des Git-Repositorys, ordnet ihm SPS-Objekte zu, zeigt deren Status und synchronisiert in beide Richtungen. Die Synchronisation ins Projekt ist ein Schreibvorgang und wird im Nur-Lese-Modus nicht ausgeführt.
Wie finde ich heraus, ob in der SPS die Version aus dem Projekt läuft?
Sie vergleichen die Software-Prüfsummen aus dem Projekt mit den Werten, die die CPU online anzeigt. Der Offline-Online-Vergleich zeigt, was sich unterscheidet, und schreibt nichts in die SPS.
Für welche TIA-Portal-Versionen?
TIA Portal V17 bis V21 unter Windows. Inhalts-Fingerabdrücke von Bausteinen gibt es ab V19, SIMATIC-SD-Dokumente ab V20 und Bausteinmetriken in den Prüfsummen in V21.
Was kostet es?
Die Werkzeuge für Git und Versionen sind Teil von TIA MCP. Eine PRO-Lizenz kostet 295 € pro Jahr und Rechner zzgl. MwSt., und die ersten 7 Tage können Sie TIA MCP kostenlos testen.
Siemens, SIMATIC, TIA Portal, WinCC und S7 sind Marken der Siemens AG. TIA MCP ist ein eigenständiges Produkt von Benešl Automation und kein Produkt der Siemens AG; es arbeitet mit dem TIA Portal über die offizielle Openness-Schnittstelle.