VS Code dla automatyka: jak porównać dwie wersje programu PLC — karta uczestnika

Cel

Otworzyć cały folder w VS Code, przeszukać obie kopie programu, porównać je obok siebie i zapisać wniosek: skąd wziąć nastawę, a skąd tekst alarmu.

Potrzebujesz

Kroki

  1. Otwórz cały folder: VS Code → File → Open Folder… → folder CB_GIT_01_why_project_v4_is_not_enough_template → Select Folder. Jeśli VS Code zapyta o zaufanie do autorów plików, wybierz Yes, I trust the authors. W panelu Explorer widać:

    CB_GIT_01_WHY_PROJECT_V4_IS_NOT_ENOUGH_TEMPLATE
    ├── project_v3
    │   └── PLC_PRG.st
    ├── project_v4
    │   └── PLC_PRG.st
    └── README.txt
    
  2. Karty:

    • jedno kliknięcie w Explorerze otwiera plik w podglądzie (pochylona nazwa na karcie, następny plik zajmie tę samą kartę),
    • dwa kliknięcia otwierają plik na stałe,
    • którą kopię oglądasz, sprawdzisz na pasku ścieżki nad tekstem (project_v3 > PLC_PRG.st).

    Na pasku stanu w prawym dolnym rogu jest Plain Text: bez rozszerzeń VS Code nie koloruje składni ST. To nie jest błąd.

  3. Przeczytaj project_v3/PLC_PRG.st: deklaracje VAR … END_VAR, podtrzymanie Start/Stop, przegrzanie rTemperature >= 80.0, sterowanie grzałką, tekst alarmu sAlarmText.

  4. Wyszukaj w całym folderze: Ctrl+Shift+F, wpisz rSetpoint.

    6 results in 2 files
    

    W każdej kopii: deklaracja (wiersz 9) i dwa warunki grzania (wiersze 22 i 24).

  5. Porównaj kopie obok siebie (wróć do Explorera: Ctrl+Shift+E):

    • prawy przycisk na project_v3/PLC_PRG.st → Select for Compare,
    • prawy przycisk na project_v4/PLC_PRG.st → Compare with Selected.

    Po lewej jest plik zaznaczony jako pierwszy (v3), po prawej v4. Podświetlone są tylko dwa wiersze:

    project_v3:  9  rSetpoint    : REAL := 60.0;
    project_v4:  9  rSetpoint    : REAL := 65.0;
    
    project_v3: 30  sAlarmText := 'Sealing heater: temperature at or above 80 C';
    project_v4: 30  sAlarmText := 'High temperature';
    
  6. Zapisz wniosek w folderze głównym, obok project_v3 i project_v4:

    • w Explorerze kliknij puste miejsce pod plikami, potem ikonę New File…,
    • nazwa comparison-result.md,
    • wpisz lub wklej treść poniżej i zapisz Ctrl+S.
    # Comparison project_v3 / project_v4
    
    | Item | project_v3 | project_v4 | Needed |
    |---|---|---|---|
    | rSetpoint | 60.0 | 65.0 | 65.0 from v4 (new foil) |
    | sAlarmText | Sealing heater: temperature at or above 80 C | High temperature | text from v3 |
    
    Neither copy meets both requirements. The folder name does not say
    what changed, why, or which state is verified and running in the PLC.
    

    Podgląd tabeli: Ctrl+Shift+V. Wynik możesz porównać z comparison-result.md z archiwum CB_GIT_01_why_project_v4_is_not_enough_done.zip.

Sprawdź się

Umiesz powiedzieć: „Nastawę 65.0 biorę z v4 (wiersz 9), dokładny tekst alarmu z v3 (wiersz 30). Samo v4 nie wystarczy, bo zgubiło tekst alarmu. Porównanie nie mówi, kto i dlaczego zmienił nastawę ani która kopia jest w sterowniku”.

Gdy coś nie działa

Objaw Przyczyna i rozwiązanie
W Explorerze widać tylko jeden plik albo jeden folder Otwarty pojedynczy plik albo tylko project_v3. File → Open Folder… → cały folder ćwiczenia.
Drugi plik zastępuje pierwszy na tej samej karcie To podgląd. Kliknij plik dwa razy, żeby został na osobnej karcie.
Nie ma opcji Compare with Selected Najpierw na pierwszym pliku wybierz Select for Compare, dopiero potem prawy przycisk na drugim.
Wychodzi, że 60.0 jest w v4 Strony porównania są zamienione. Najedź myszą na kartę porównania, podpowiedź pokazuje pełne ścieżki.
comparison-result.md jest w project_v4 Przy tworzeniu pliku zaznaczony był folder. Przeciągnij plik do folderu głównego albo utwórz go jeszcze raz.
Kropka zamiast krzyżyka na karcie Plik nie jest zapisany. Ctrl+S.

Zapamiętaj