SPS-Programm dokumentieren ohne Originalunterlagen

Um ein undokumentiertes SPS-Programm zu dokumentieren, beginnen Sie mit dem, was sich automatisch auslesen lässt: Bausteinliste, Querverweisdaten und Belegungsliste. Dann arbeiten Sie das Programm systematisch Baustein für Baustein durch und verfolgen den Signalfluss von den physischen Eingängen über die Logik bis zu den Ausgängen. Benennen Sie dabei jede Adresse symbolisch. Das Ergebnis ist ein lebendiges Dokument, das das Programm wartbar macht.

Diese Situation ist extrem häufig. Der ursprüngliche Programmierer hat die Firma vor Jahren verlassen. Die Dokumentation war auf einem Laptop, der neu formatiert wurde. Der Ordner mit den Ausdrucken wurde beim Aufräumen entsorgt. Oder — am häufigsten — die Dokumentation hat nie existiert.

Schritt 1: Zuerst alles sichern#

Bevor Sie irgendetwas anfassen, erstellen Sie eine vollständige Sicherungskopie:

Für S7 (STEP 7 / TIA Portal):

• Komplettes Programm aus der SPS hochladen (alle Bausteine, Symboltabelle, Kommentare)
• Projekt archivieren (Datei → Archivieren)
• An mindestens zwei Orten speichern (USB-Stick + Netzlaufwerk)

Für S5 (STEP 5):

• Upload mit STEP 5 oder S5 for Windows (S5W)
• .S5D-Datei an mehreren Orten sichern

Wichtig: Beginnen Sie nie damit, ein Programm zu ändern, das Sie nicht verstehen. Die Sicherung ist Ihr Sicherheitsnetz.

Schritt 2: Automatische Berichte erzeugen#

Jedes Siemens-Programmierwerkzeug kann Referenzdaten automatisch generieren:

Querverweisliste (am wichtigsten)#

Die Querverweisliste zeigt jede im Programm verwendete Adresse und wo sie vorkommt. Für jeden Eingang, Ausgang, Merker, Timer, Zähler und Datenbaustein sehen Sie, welcher Baustein sie benutzt und wie (lesen, schreiben, oder beides).

STEP 7 Classic: Extras → Referenzdaten → Anzeigen → Querverweise

TIA Portal: Rechtsklick auf beliebige Variable → Querverweise (oder Strg+Alt+R für globale Ansicht)

Belegungsliste#

Zeigt alle verwendeten Eingangs- und Ausgangsadressen. Das verrät Ihnen, welche physischen E/A-Punkte das Programm tatsächlich nutzt.

Bausteinliste mit Aufrufstruktur#

Zeigt welche Bausteine existieren und welche andere aufrufen: OB1 ruft FB1, FB1 ruft FC10 usw.

Symboltabelle#

Falls der vorherige Programmierer symbolische Namen vergeben hat, sind sie in der Symboltabelle gespeichert. Selbst teilweise symbolische Namen sind wertvoll.

Viele undokumentierte Programme haben eine leere Symboltabelle. Dann erstellen Sie eine von Grund auf (Schritt 4).

Schritt 3: Signalfluss an der Maschine verfolgen#

Setzen Sie sich mit einem Laptop an die Maschine. Verbinden Sie sich mit der SPS im Beobachtungsmodus (online beobachten, ohne Änderungen). Dann systematisch Signale verfolgen:

Beginnen Sie mit der physischen E/A:

1. Schauen Sie sich die E/A-Baugruppen im Schaltschrank an. Notieren Sie welche Klemme mit welcher Adresse verbunden ist.
2. Betätigen Sie Eingänge manuell (Taster drücken, Sensoren auslösen) und beobachten Sie welche Adressen sich im SPS-Monitor ändern.
3. Bei Ausgängen: Beobachten Sie was passiert wenn ein Ausgang aktiv wird. Welcher Motor startet? Welches Ventil öffnet?

Dokumentieren Sie sofort:

• E 0.0 = Starttaster, grün, Bedienpult vorne
• E 0.1 = Stopptaster, rot, Bedienpult vorne (Öffner)
• E 1.0 = Näherungssensor, Förderband 1, Teil vorhanden
• A 4.0 = Motorschütz K1, Förderbandantrieb
• A 4.1 = Magnetventil Y1, Pneumatikzylinder ausfahren

Praxistipp: Fotografieren Sie die E/A-Baugruppen mit sichtbaren Klemmenbeschriftungen. Fotografieren Sie Stromlaufpläne, falls sie in der Schaltschranktür hängen.

Schritt 4: Symboltabelle erstellen#

Vergeben Sie aussagekräftige Namen für jede identifizierte Adresse. Das ist der wertvollste einzelne Dokumentationsschritt.

Namenskonvention (empfohlen):

Schritt 5: Baustein für Baustein dokumentieren#

Für jeden Baustein (OB, FB, FC):

1. Bausteintitel und vorhandene Kommentare lesen
2. Querverweise prüfen: Welche E/A-Adressen nutzt dieser Baustein?
3. Logik Netzwerk für Netzwerk nachvollziehen
4. Jedem Netzwerk einen Kommentar hinzufügen
5. Zusammengehörige Netzwerke gruppieren: "Netzwerk 1-5 = Förderbandsteuerung"

Typische Muster erkennen:

• Selbsthaltung: U E0.0 / S M10.0 / U E0.1 / R M10.0 → Start/Stop mit Selbsthaltung
• Zeitverzögerung: U M10.0 / L KT... / SD T1 / U T1 / = A4.0 → Verzögerter Motorstart
• Ablaufkette: Merker-Bits steuern eine Schrittfolge
• Analogwert-Skalierung: PEW laden → Rechnung → MW/DB → Anzeige/Regelung

Schritt 6: Dokumentationspaket erstellen#

Eine vollständige SPS-Dokumentation enthält:

1. Programmübersicht: Eine Seite mit Zweck, Maschinentyp, SPS-Hardware, Software-Version
2. Bausteinliste: Alle Bausteine mit Zweckbeschreibung
3. E/A-Liste: Alle Ein-/Ausgänge mit Symbolname, Adresse, Beschreibung, Klemme/Ader
4. Symboltabelle: Vollständig, gedruckt oder als CSV exportiert
5. Querverweisliste: Als Ausdruck oder PDF
6. Netzwerk-Kommentare: Jedes Netzwerk hat einen Kommentar
7. Datenbaustein-Aufbau: Alle DBs mit Feldbeschreibungen
8. Timer-/Zähler-Liste: Alle Timer und Zähler mit Zweck und Einstellwerten
9. Stromlaufpläne: Falls vorhanden, eingescannt und verknüpft
10. Änderungsprotokoll: Datum, Person und Beschreibung jeder Änderung

Was PLCcheck Pro für Sie tun kann#

Die manuelle Dokumentation eines undokumentierten Programms dauert 2–5 Arbeitstage für mittlere Programme. PLCcheck Pro kann den Großteil der Dokumentation automatisch erzeugen:

• AWL/STL-Code hochladen → sofortiges Bausteinverzeichnis mit Querverweisen
• Automatische E/A-Liste aus allen verwendeten Eingangs-/Ausgangsadressen
• Timer- und Zähler-Zusammenfassung mit berechneten Zeiten
• Verständliche Erklärung der Funktion jedes Netzwerks
• Exportierbare Dokumentation als strukturierter Bericht

Die KI kann Ihnen nicht sagen, dass E 0.0 ein "grüner Starttaster am Bedienpult" ist — dafür müssen Sie an der Maschine stehen. Aber sie kann Ihnen sagen, dass E 0.0 in einer Selbsthaltung verwendet wird, die über eine 5-Sekunden-Einschaltverzögerung A 4.0 ansteuert. Das reduziert Ihren Dokumentationsaufwand von Tagen auf Stunden.

Jetzt Code hochladen →

Häufig gestellte Fragen#

Wie lange dauert die Dokumentation eines undokumentierten SPS-Programms?

Mittleres Programm (50–100 Bausteine, 50–200 E/A-Punkte): 2–5 Arbeitstage. Kleines Programm (unter 30 Bausteine): 1–2 Tage. Großes Programm (200+ Bausteine): 1–3 Wochen.

Was wenn es gar keine Symboltabelle gibt?

Von Grund auf neu erstellen. Beginnen Sie mit den E/A-Adressen, die Sie an der Maschine identifizieren können. Eine teilweise Symboltabelle ist unendlich besser als keine.

Kann ich ein Programm dokumentieren, ohne an die Maschine zu gehen?

Teilweise. Bausteinlisten, Querverweise und Logik-Verfolgung gehen aus dem Code allein. Aber die physische Bedeutung der E/A-Adressen (welcher Sensor hängt an E 1.0) erfahren Sie nur an der Maschine oder aus Stromlaufplänen.

Was ist die Minimaldokumentation, die ich erstellen sollte?

Mindestens: eine Symboltabelle und Netzwerk-Kommentare. Die leben im SPS-Projekt selbst und stehen jedem zur Verfügung, der sich mit der SPS verbindet.

---

Gepflegt von PLCcheck.ai. Letztes Update: März 2026. Keine Verbindung zu Siemens AG.