Git i wersje projektów TIA z AI
Projekt TIA Portal jest zapisany w plikach binarnych, więc sam Git nie pokaże, co się w nim zmieniło. TIA MCP eksportuje projekt do tekstu i zapisuje go jako wersję w Git. AI mówi Ci potem, co zmieniło się między wersjami w blokach, tagach, UDT i sprzęcie. Do tego kopie zapasowe przed każdym zapisem, porównanie z PLC oraz praca z VCI i Multiuser Engineering.
Dlaczego sam Git nie wystarcza dla projektu TIA
Git to narzędzie do plików tekstowych. Projekt TIA Portal składa się jednak z binarnych plików bazy danych projektu. Jeśli zapiszesz go w Git bezpośrednio, zobaczysz tylko, że pliki się zmieniły – a nie który blok, sieć czy tag. Nie da się tak porównać dwóch wersji ani napisać klientowi, co się zmieniło.
Dlatego TIA MCP najpierw eksportuje projekt do tekstu. Każdy blok PLC, UDT i tabela tagów ma własny plik XML, sprzęt jest w JSON. Eksport jest deterministyczny: z XML usuwane są znaczniki czasu i wewnętrzne identyfikatory, więc różnica pokazuje tylko rzeczywiste zmiany. Blok, który zniknie z projektu, znika też z eksportu, więc usunięcie widać w historii.
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\ …
Na eksporcie działa potem zwykły Git: commit, historia, gałęzie i push na serwer Twojej firmy. Raport zmian zamienia różnice XML na czytelną postać – interfejs, sieci jako pseudologika lub SCL, tytuły, a bloki safety osobno.
Git zmienia tylko pliki eksportu, a nie projekt w TIA Portal. Przełączenie gałęzi nie zmienia więc projektu, a z eksportu nic nie jest automatycznie wczytywane z powrotem. Pojedyncze obiekty przywracasz z kopii zapasowych sprzed zapisu, cały projekt z archiwum TIA Portal.
Co TIA MCP potrafi w zakresie wersji i zmian
Wydajesz polecenia zwykłym językiem, a AI wybiera właściwe narzędzie. W prawej kolumnie są ich nazwy dla tych, którzy chcą wiedzieć więcej.
| Zadanie | Jak to działa | Narzędzia |
|---|---|---|
| Zapisać wersję w Git | Eksportuje projekt do tekstu i commituje go z opisem. Przy pierwszym użyciu zakłada repozytorium. | tia_git_committia_export_project_to_text |
| Co zmieniło się od ostatniego commitu | Świeży eksport i różnica względem ostatniego commitu – zestawienie plików lub pełny diff. | tia_git_diff |
| Raport zmian | Czytelne zmiany między dwiema wersjami lub względem stanu bieżącego: bloki (interfejs, sieci, tytuły), bloki safety osobno, UDT, tagi i sprzęt. Zapisuje Markdown. | tia_change_report |
| Gałęzie, historia i serwer | Stan, historia, gałęzie, przełączanie, scalanie, tagi, push i pull. Push najpierw pokazuje podgląd commitów, pull tylko fast-forward. | tia_git |
| Kopie zapasowe przed zapisem | Przed każdym zapisem AI obiekt jest archiwizowany. Kopię możesz obejrzeć i przywrócić obiekt jednym poleceniem. Stare kopie usuwasz z podglądem. | tia_list_snapshotstia_read_snapshottia_restore_snapshottia_prune_snapshots |
| Odciski zawartości | Odciski TIA Portal nie zmieniają się przy kompilacji ani zapisie, tylko przy zmianie zawartości, i odróżniają zmianę kodu od zmiany komentarzy. Od TIA Portal V19. | tia_fingerprints |
| Czy w PLC jest ten program? | Sumy kontrolne oprogramowania offline – te same CPU pokazuje online. Porównanie programu offline z PLC lub PLCSIM bez zapisu. | tia_plc_checksumstia_online_fingerprinttia_compare_online |
| Porównanie PLC i projektów | Program dwóch PLC, PLC z innym projektem lub archiwum (otwieranym tylko do odczytu) i różnica dwóch bloków. | tia_compare_plc_softwaretia_compare_devicestia_compare_blocks |
| VCI (Version Control Interface) | Workspace TIA Portal w folderze repozytorium Git, eksport obiektów PLC do plików, stan i synchronizacja w obu kierunkach. | tia_list_vci_workspacestia_vci_workspacetia_vci_exporttia_vci_statustia_vci_sync |
| Multiuser Engineering | Serwery i projekty serwerowe, sesje lokalne, oznaczanie obiektów przed edycją, konflikty i check-in z komentarzem. | tia_mu_serverstia_mu_create_sessiontia_mu_open_sessiontia_mu_markingstia_mu_marktia_mu_commit |
| Historia projektu | Utworzenie, migracja, aktualizacja i importy zbiorcze z czasem, użyte produkty i których z nich brakuje na tym komputerze. | tia_project_history |
| Eksporty i archiwum | Eksport całego projektu do JSON i XML, bloki jako dokumenty SIMATIC SD (od V20) i archiwum projektu do kopii zapasowej lub przekazania. | tia_dump_alltia_export_documentstia_project_archive |
Jak pracować z Git w projekcie TIA
Typowy przebieg. Każdy krok zlecasz AI jednym zdaniem albo wykonujesz na stronie Wersje i zmiany w web GUI.
Pierwsza wersja
Podajesz folder repozytorium, a AI robi pierwszy commit: eksport projektu do tekstu i założenie repozytorium.
Praca w projekcie
Programujesz Ty albo AI. Każdy zapis AI ma kopię zapasową i wpis w audycie.
Co się zmieniło
Przed commitem prosisz o pokazanie różnicy lub raportu zmian.
Commit
Wersja zapisuje się z opisem, co i dlaczego się zmieniło.
Gałęzie i serwer
Gałąź na zmianę, push na serwer firmy po podglądzie commitów, pull tylko fast-forward.
Raport dla klienta
Raport zmian między wydaniami w Markdown do dokumentacji odbiorczej lub informacji o wydaniu.
Kopie zapasowe, Git, VCI, Multiuser czy archiwum?
Nie wykluczają się. Każdy sposób rozwiązuje coś innego, a TIA MCP potrafi pracować ze wszystkimi.
| Sposób | Do czego służy |
|---|---|
| Kopie zapasowe przed zapisem | Krok wstecz po zapisie AI. Powstają automatycznie, dla każdego obiektu, na Twoim komputerze. |
| Git z eksportem tekstowym | Historia wersji, porównanie, raport zmian i udostępnianie przez serwer. |
| VCI | Jeśli już używasz Version Control Interface w TIA Portal: obiekty jako pliki synchronizowane z projektem. |
| Multiuser Engineering | Kilku programistów jednocześnie w jednym projekcie przez serwer TIA Portal. |
| Archiwum projektu | Kompletny projekt do kopii zapasowej lub przekazania klientowi. |
Strona Wersje i zmiany w web GUI
Od wersji 2.18 interfejs webowy TIA MCP ma stronę Wersje i zmiany. Wszystko powyższe zrobisz tam klikając, bez pisania polecenia.
Kopie zapasowe
Lista kopii z filtrem, zawartość kopii (XML, JSON lub SCL), pobieranie, przywracanie obiektu i usuwanie starych kopii z podglądem.
Raport zmian
Dwie wersje (commit, gałąź, tag lub stan bieżący), podsumowanie zmian według urządzeń i zapis do Markdown.
Git
Stan, historia commitów, commit z eksportem projektu, kolorowana różnica od ostatniego commitu, gałęzie, push z podglądem i pull.
Historia projektu
Zdarzenia z TIA Portal, użyte produkty i czego brakuje na tym komputerze.
VCI
Przegląd workspace i stan zmapowanych obiektów: które różnią się między projektem a plikami.
Bezpieczne operacje w Git
AI pracuje z Git tylko w granicach, które nie mogą usunąć historii ani nadpisać pracy kolegów na serwerze:
- Nigdy force push, reset --hard, clean ani rebase.
- Push wysyła tylko bieżącą gałąź i dopiero po potwierdzeniu podglądu commitów.
- Pull tylko fast-forward. Rozbieżne gałęzie zostawia i zaleca scalenie.
- Scalanie gałęzi bez automatycznego rozwiązywania konfliktów: przy konflikcie jest cofane, wypisuje pliki z konfliktem, a repozytorium pozostaje czyste.
- Przełączenie gałęzi, scalanie i pull odrzucają niezacommitowane zmiany eksportu – najpierw commit.
- Logowanie do serwera przez credential helper lub klucz SSH. Git nigdy nie pyta o hasło.
- Repozytorium, którego ustawienia mogłyby uruchomić obcy program, TIA MCP odrzuca.
Przykładowe polecenia dla AI
Piszesz zwykłym językiem. Ścieżki oraz nazwy PLC i bloków zastąp własnymi.
Zapisz bieżący stan projektu w Git w D:\Git\Linia z opisem „Nowe alarmy przenośnika”.
Co zmieniło się w projekcie od ostatniego commitu?
Napisz raport zmian między tagiem v1.2 a stanem bieżącym i zapisz go jako Markdown.
Utwórz gałąź zmiana-napelniania, a gdy skończymy, pokaż mi, co zostałoby wysłane na serwer.
Czy w PLC_1 jest ten sam program co w projekcie? Porównaj offline i online bez zapisu.
Zapisz odciski bloków PLC_1 jako bazę i po zmianach powiedz mi, gdzie zmienił się kod, a gdzie tylko komentarze.
Co musi sprawdzić człowiek
Git i kopie zapasowe dają Ci przegląd i drogę powrotu. Decyzja, co trafi do PLC, pozostaje po Twojej stronie.
- Opis commitu. AI go zaproponuje, ale dlaczego zmiana została zrobiona, wiesz Ty.
- Konflikty. Przy konflikcie scalanie jest cofane. Jak połączyć pracę dwóch osób, decyduje człowiek.
- Zakres eksportu. Eksport tekstowy zawiera bloki PLC, UDT, tabele tagów i przegląd sprzętu. Ekranów HMI w nim nie ma, cały projekt archiwizuj.
- Synchronizacja VCI do projektu. Zmienia projekt. Uruchamiaj ją świadomie, w trybie tylko do odczytu się nie wykona.
- Sumy kontrolne. Zgodność mówi, że w PLC jest ten program. Nie mówi, że program jest poprawny.
Dokumentacja projektu TIA z AI
Częste pytania o Git i wersje projektów TIA
Czy projekt TIA Portal można wersjonować w Git?
Bezpośrednio tylko jako pliki binarne, w których Git nie pokaże, co się zmieniło. Z TIA MCP do Git trafia tekstowy eksport projektu: bloki, UDT, tabele tagów i sprzęt. Różnice między wersjami widać wtedy według bloków i sieci.
Czy potrzebuję Git na komputerze?
Tak, Git musi być zainstalowany i dostępny w PATH, na przykład Git for Windows. Do push na serwer potrzebujesz dostępu przez credential helper lub klucz SSH.
Czy operacje w Git zmieniają mój projekt TIA?
Nie. Eksport tylko odczytuje projekt, a polecenia Git zmieniają tylko repozytorium z eksportem. Przełączenie gałęzi nie zmienia więc projektu w TIA Portal.
Jak cofnąć zmianę zrobioną przez AI?
Przed każdym zapisem obiekt jest archiwizowany. Kopię przywracasz jednym poleceniem lub na stronie Wersje i zmiany w web GUI. Jeśli istniejącego obiektu nie da się zarchiwizować, zapis się nie wykona.
Jaka jest różnica między Git a Multiuser Engineering?
Multiuser Engineering to funkcja TIA Portal do jednoczesnej pracy kilku osób nad jednym projektem przez serwer. Git z eksportem tekstowym służy do historii wersji i porównań. TIA MCP potrafi pracować z oboma.
Czy TIA MCP obsługuje VCI (Version Control Interface)?
Tak. Zakłada workspace, na przykład w folderze repozytorium Git, mapuje do niego obiekty PLC, pokazuje ich stan i synchronizuje w obu kierunkach. Synchronizacja do projektu jest zapisem i w trybie tylko do odczytu się nie wykona.
Jak sprawdzić, czy w PLC działa wersja z projektu?
Porównujesz sumy kontrolne oprogramowania z projektu z wartościami, które CPU pokazuje online. Porównanie offline i online pokazuje, co się różni, i niczego nie zapisuje do PLC.
Dla jakich wersji TIA Portal?
TIA Portal od V17 do V21 w systemie Windows. Odciski zawartości bloków są od V19, dokumenty SIMATIC SD od V20, a metryki bloków w sumach kontrolnych w V21.
Ile to kosztuje?
Narzędzia do Git i wersji są częścią TIA MCP. Licencja PRO kosztuje 295 € rocznie za komputer bez VAT, a przez pierwsze 7 dni możesz wypróbować TIA MCP za darmo.
Siemens, SIMATIC, TIA Portal, WinCC i S7 są znakami towarowymi Siemens AG. TIA MCP jest samodzielnym produktem Benešl Automation, a nie produktem firmy Siemens; współpracuje z TIA Portal przez oficjalny interfejs Openness.