Zum Inhalt

Erster Smoke-Test

Diese Seite prüft, ob eine neue Engineering-Workstation die Repository-Konfiguration lesen, den PLC-Source-Tree sehen, das lokale Tooling bauen und eine sichere Deployment-Vorschau ausführen kann.

Führe diesen Test nach Windows-Einrichtung (1), Git- und Repository-Einrichtung und Windows-Einrichtung (2) aus.

1. Frisches Terminal öffnen

Schließe und öffne VS Code oder PowerShell nach .\pcs.cmd install tools erneut. Der Befehl pcs hängt vom aktualisierten Benutzer-PATH ab.

Aus dem Repository-Root:

pcs config show

Erwartetes Ergebnis:

  • der konfigurierte Projektname wird ausgegeben,
  • der TIA-Projektpfad wird zu einem lokalen .ap19-, .ap20- oder neueren Projekt aufgelöst,
  • exportsRoot zeigt auf tia\exports,
  • die konfigurierte PLC-Liste wird angezeigt,
  • der Autorenwert wird aufgelöst.

2. Source-Bausteine auflisten

Bestätige, dass die CLI den Source Tree sehen kann:

pcs list blocks

Erwartetes Ergebnis:

  • Quelldateien unterhalb von tia\exports werden aufgelistet,
  • Bausteinnamen passen zu ihren Dateinamen,
  • für diesen Befehl ist kein TIA-Portal-Prozess erforderlich.

3. TIA-Openness-Tool bauen

Baue die lokale Deployment-Executable:

pcs build

Erwartetes Ergebnis:

  • tools\tia-openness\bin\tia-deploy.exe wird erstellt oder aktualisiert,
  • der Build verwendet die aus dem konfigurierten Projekt abgeleitete TIA-Openness-API-Version, sofern sie nicht überschrieben wird.

Wann Rebuilds nötig sind

Baue neu nach Pulls mit Änderungen in tools/tia-openness, nach Änderungen am Deployment-Tool-Source oder beim Wechsel zwischen TIA-Portal-Versionen.

4. Trockene Deployment-Vorschau ausführen

Verwende einen Dry Run, bevor TIA Portal geöffnet oder geändert wird:

pcs deploy plcs=PLC_1 blocks=FB_AlarmRouting dry-run no-compile

Erwartetes Ergebnis:

  • das ausgewählte PLC-Ziel wird aufgelöst,
  • die ausgewählte Quelldatei wird aufgelöst,
  • der Befehl öffnet TIA Portal nicht,
  • es werden keine Bausteine importiert oder generiert.

Wenn der Baustein in deinem aktuellen Source Tree nicht existiert, liste zuerst die Bausteine auf und wähle einen anderen kleinen Baustein:

pcs list blocks
pcs deploy plcs=PLC_1 blocks=FC_0test dry-run no-compile

5. Optionaler erster Openness-Check

Führe diesen Schritt nur aus, wenn TIA Portal und das konfigurierte Projekt auf der Workstation verfügbar sind.

Öffne das konfigurierte Projekt:

pcs tia open

Führe danach einen fokussierten Import ohne Compile aus:

pcs deploy plcs=PLC_1 blocks=FC_0test no-compile

Erste Openness-Abfragen

Die erste echte Openness-Aktion kann Windows-Firewall-, TIA-Portal-Autorisierungs- oder Trust-Abfragen auslösen. Öffne das Projekt vorher manuell, wenn Abfragen interaktiv bestätigt werden müssen.

Bereit für normales Deployment

Wenn der Smoke-Test erfolgreich ist, fahre mit TIA-Deployment für den normalen Source-to-TIA-Workflow fort.