DS2 v2 · Konzeptleitfaden · 09

Validierung: die benötigte Aussage gezielt prüfen

Ein erfolgreicher Compile-Vorgang beantwortet eine andere Frage als ein erfolgreicher Klemmzyklus. Wählen Sie das zu prüfende Verhalten, beschreiben Sie zuerst das erwartete Ergebnis und bewahren Sie den Nachweis für genau diesen Quellstand auf.

Aktuelle Sprache: ds2 v2;

Überarbeitet am 17. November 2026

Das Beispiel nutzt logische Zeiten ohne physische I/Os. Lesen Sie zuerst Systemgrenzen und Call-Reihenfolge; eine reale Anlage wird separat eingerichtet.

Fehlerhaftes Modell und auffällige Beobachtung unterscheiden

Vor der Kaffeeausgabe lässt sich prüfen, ob die Tasse vor dem Füllen bereitsteht. Während des Füllens lässt sich prüfen, ob der erwartete Pegel erreicht wird. Die erste Frage betrifft das Modell, die zweite diesen Lauf. Eine unauflösbare Clamp.Lock-Referenz ist ein Modellfehler. Fehlender Abschluss bei gültiger Referenz ist eine zu untersuchende Laufbeobachtung.

Kleine Fehlerfälle vor dem Produktionslauf
FallBeobachtungZu prüfende Definition
Fehlendes ZielEin Call kann seine API nicht auflösen.Systemkennung, API-Deklaration und Zielreferenzen.
Zyklische Call-AbhängigkeitInterne Calls warten gegenseitig auf ihren Abschluss.Interner DAG und erste zulässige Anforderung.
Fehlender WiederbereitschaftspfadErstes Teil gelingt; die nächste Anforderung aktiviert das Ziel nicht.Deklarierte Reset-/Rückführbeziehungen und Ausführungsbesitz.
Falsche ProduktgrenzeLogischer Abschluss wird falsch als Produktein- oder -austritt gezählt.Produktbezogene API-Verträge und erhaltene Wurzeln.
Unbeabsichtigter MehrfacheintrittGetrennte Eintrittsanweisungen aktivieren den Folgebereich zu oft.UND-Gruppierung, ODER-Eintritt und beabsichtigte Zusammenführung.
Unerreichbare ZusammenführungZusammenführung wartet auf einen hier nie ausgeführten Zweig.Zweigwahl, unterstützte Skip-Semantik und Pflichtvorgänger.
Schaubild
Derselbe Abschluss mit anderen ZeitbeobachtungenFrüh, spät und fehlend beziehen sich auf deklarierte Kriterien. Anlagenverzögerung von fehlenden oder ungültigen Daten unterscheiden.Derselbe Abschluss mit anderen ZeitbeobachtungenErwartetes Fenster[t_min, t_max]Frühe AntwortEreignisSpäte AntwortEreignisFehlende Antwort
Früh, spät und fehlend beziehen sich auf deklarierte Kriterien. Anlagenverzögerung von fehlenden oder ungültigen Daten unterscheiden.Das Diagramm in Originalgröße seitlich verschieben.
Muss jeder Projektgraph zyklenfrei sein?

Der interne Call-Abhängigkeitsgraph eines Works ist ein DAG. Ein deklarierter Produktionszyklus zwischen Works kann Rückführung und Wiederbereitschaft enthalten. Prüfen Sie den jeweiligen Graphen und die Sprachregeln, statt jede Schleife zu verbieten oder wegen wiederholender Maschinen einen Zyklus im Call-DAG zu erlauben.

Bedeutung des Modells

Prüfen Sie zuerst Syntax, Typen, Referenzen und den Call-Abhängigkeitsgraphen. Führen Sie danach Fälle mit bekannten Eingängen aus und beobachten Sie Zustände, Ausgänge und Produktfluss. Vergleichen Sie mit einer aus der Prozessanforderung abgeleiteten Erwartung. Zwei übereinstimmende Engines können denselben Fehler enthalten.

Die Beziehung lesen

Schaubild
Ein minimales Beispiel gegenseitigen WartensDie Annahmen des Fehlers sind angegeben. Ein gezeichneter Zyklus allein ist kein Testergebnis.Ein minimales Beispiel gegenseitigen WartensA · ReadyWartet auf Abschluss von BB · ReadyWartet auf Abschluss von AKein Initialabschluss, kein anderer Eintritt
Die Annahmen des Fehlers sind angegeben. Ein gezeichneter Zyklus allein ist kein Testergebnis.Das Diagramm in Originalgröße seitlich verschieben.

In DS2 v2 ausdrücken

Jedes Urteil braucht einen Geltungsbereich: Quellrevision, Ausführungsprofil, Eingänge, Testfall und beobachtetes Ergebnis. Ein Compile-Vorgang verifiziert noch keine Ausführung. Verwenden Sie NOT_RUN für nicht ausgeführte Tests und INCONCLUSIVE, wenn die Belege keine Entscheidung erlauben.

Konzeptnotation, kein ausführbarer DS2-Quelltext

verify.run.verdict: PASS | FAIL | NOT_RUN | UNSUPPORTED | INCONCLUSIVE
ai.probe.verdict: COMPILED_UNVERIFIED
ai.probe.canonicalVerdict: NOT_RUN

Die Erwartung vor dem Lauf festhalten

Für ProcessPart lautet eine sinnvolle Anforderung: Die Bearbeitung beginnt erst nach Clamp.Lock; Clamp.Unlock beginnt erst nach beiden Bearbeitungs-Calls. Diese Erwartung stammt aus dem vorgesehenen Prozess. Sie gilt unabhängig davon, welche Engine oder welches PLC-Backend das Modell ausführt.

Machen Sie die Prüfung beobachtbar: Bestimmen Sie beide Abschlussereignisse und den späteren Start und vergleichen Sie ihre Scanreihenfolge. Der bloße Vergleich zweier Zusammenfassungen kann einen zu früh gesetzten Ausgang übersehen. Lesen Sie die Ausgangs- oder Befehlsspur, die das behauptete Verhalten tatsächlich abbildet.

Die Ausführungsebene wählen

Statische Analyse prüft den Quelltext ohne Zyklusausführung, etwa API-Referenzen und Zyklen im internen Call-Graphen. Ein Modelllauf bewertet Steuerungsverhalten unter vorgegebenen Annahmen. Für einen Lauf mit virtueller Anlage sind zusätzlich ein Anlagenmodell und die definierte Verbindung von Ausgängen zu simulierten Eingängen nötig.

Beim Artefakttest wird das erzeugte ST- oder Ladder-Verhalten ausgeführt. Nennen Sie Software-Executor, Herstellerumgebung oder reale Hardware. Hardware-in-the-Loop und Feldabnahme benötigen weitere Verbindungen und Messungen. Die aufgezeichnete MODEL-Wiedergabe dieser Lernseite zeigt den protokollierten Modelllauf und die Darstellung; die späteren Prüfungen führt sie nicht aus.

Fälle wählen, die Fehler aufdecken

Führen Sie zuerst den Normalfall aus. Verzögern Sie dann RightTool.Process, während LeftTool.Process endet. Clamp.Unlock muss warten. Geben Sie den verzögerten Abschluss frei und prüfen Sie, dass die Zusammenführung einmal fortschreitet, ohne das Teil zu verlieren oder eine weitere Öffnungsanforderung auszugeben.

Sperren Sie außerdem eine erforderliche Bedingung, fordern Sie zwei gegenseitig ausgeschlossene Geräteaktionen an und führen Sie eine zweite Produktrunde aus. Wiederholungstests zeigen fehlende Wiederbereitschaft, die im ersten Zyklus verborgen bleibt. Dokumentieren Sie jede Eingangsänderung samt Zeitpunkt. Ein fehlender Sensor, der durch true ersetzt wird, ergibt einen anderen Testfall.

Das Ergebnis nachvollziehbar dokumentieren

Speichern Sie den genauen Quelltext oder seinen Inhaltshash, Compiler- und Engine-Version, aktives Ziel, Scanperiode, Eingangsfolge und Fallkennung. Sichern Sie bei generiertem Code auch Artefaktbytes und Hash. Ein Inhaltshash bezeichnet Bytes; ein Name wie latest.ds2 bezeichnet keine unveränderliche Revision.

Bewahren Sie Soll, Ist und Rohspur gemeinsam auf. Unterscheiden Sie die geprüfte Quellrevision von buildCommit, der den ausführbaren Build kennzeichnet. Nennen Sie bei Abweichungen beide Werte und die Zuordnung von Binärdatei zu Quelle. Ein früherer Prüfbeleg gilt nicht automatisch für geänderten Quelltext.

Urteil und Geltungsbereich zusammen lesen

PASS bedeutet, dass die genannte Prüfung unter den dokumentierten Bedingungen erfüllt wurde. FAIL bezeichnet einen Widerspruch zur Erwartung. NOT_RUN heißt nicht ausgeführt. INCONCLUSIVE heißt nicht entscheidbar, etwa bei erschöpftem Analysebudget oder fehlender Messung. UNSUPPORTED kennzeichnet einen benötigten Ausführungsweg, den das gewählte Werkzeug nicht bereitstellt.

COMPILED_UNVERIFIED ist ein detailliertes ai.probe-Ergebnis: Die Kompilierung gelang, aber die Ausführungsprüfung ist noch nicht abgeschlossen. Der zugehörige canonicalVerdict lautet NOT_RUN. Bei verify.run den verdict zusammen mit dem detaillierten evidenceStatus lesen. Eine Animation prüft die Anzeige; das Steuerungsverhalten braucht einen eigenen Ausführungstest.

Zeitverhalten und Quelländerungen nachprüfen

Beide Bearbeitungs-Calls laufen parallel; die Summe aller deklarierten Zeiten ist daher keine Zykluszeit. Auch eine Modellmessung hängt von Zulassung, Scangrenzen, Wartezeiten und Abschlussregeln ab. Reale Leistung benötigt zusätzlich gemessenes Anlagenverhalten und Betriebsbedingungen. Kennzeichnen Sie Rechnung, Modellmessung und Feldmessung getrennt.

Wiederholen Sie nach Änderungen an Abhängigkeiten, Bedingungen, API-Zuordnungen oder Zeiten die betroffenen Fälle und vergleichen Sie ihre Spuren. Erhalten Sie das frühere Ergebnis mit seinem Quellbezug. Erläutern Sie bei Änderungen die geänderte Anforderung oder den behobenen Fehler. Ein neuer Dateiname erklärt den Unterschied nicht.

Zulässige Werte und Zeiten getrennt festlegen

Erwartetes Ergebnis, geplante Dauer und zulässiges Zeitintervall sind verschiedene Anforderungen. Im Café-Lehrbeispiel beantworten 98–102mL, vier Sekunden Planzeit und Abschluss zwischen drei und fünf Sekunden unterschiedliche Fragen. Die Zahlen sind illustrative Abnahmekriterien, keine gemessene Leistung des Klemmbeispiels.

Benennen Sie für die Zelle den Eingang für verriegelt, die benötigte Signalqualität und das Intervall zwischen definiertem Start und Abschluss. Hinterlegen Sie Zeitgrenzen in der unterstützten Prüf- oder Ausführungskonfiguration. Ein erläuternder Begriff wird dadurch kein DS2-Schlüsselwort.

Beobachtungen am festgelegten Intervall messen
Beobachtung im LehrbeispielDeutungZusätzlich zu prüfen
Abschluss bei 2sFrüher als das festgelegte Minimum von 3s.Ob Ergebnis und Beobachtung tatsächlich stimmen.
Abschluss bei 3s, 4,3s oder 5sInnerhalb dieses ausdrücklich inklusiven Intervalls.Ergebnisannahme gilt auch bei zulässiger Zeit.
Abschluss bei 6sSpäter als das festgelegte Maximum von 5s.Geräteverzögerung, Eingangserfassung und Kommunikation.
Kein Abschluss nach 5sObergrenze ohne erwarteten Abschluss erreicht.Fehlenden Abschluss ausweisen; Zeitablauf erzeugt ihn nicht.
Ist ein schnellerer Abschluss immer besser?

Nein. Ein schon vorher aktives Signal, ein unvollständiger Hub oder eine falsche Beobachtung können schnell wirken. Vergleichen Sie Ergebnis und Ereignisfolge vor einer Änderung der Planzeit. Verbesserung setzt dasselbe akzeptierte Ergebnis unter vergleichbaren Bedingungen und eine dokumentierte Zeitmessung voraus.

Vier auffällige Beobachtungsmuster unterscheiden

Die Namen beschreiben Beobachtungen, weder elektrische Ursachen noch zusätzliche Work-Zustände. Sie übernehmen nützliche Diagnosebegriffe des früheren Leitfadens. Ein Profil kann andere Codes oder keine solche Einteilung liefern. Dokumentieren Sie tatsächliche Diagnose und Belege, statt einen passenden Code zu erzeugen.

Vor der Ursache die Beobachtung benennen
MusterbezeichnungBeobachtete TatsacheUntersuchungsrahmen
sensorOpenEin dauerhaft erforderlicher Eingang fällt im Prüfintervall ab.Signalqualität, Kontaktregeln, Quelle, Erfassung und Verdrahtung; nicht sofort Drahtbruch folgern.
sensorShortEin Eingang wird zu einem nicht erwarteten Zeitpunkt aktiv.Vorheriger Zustand, Polarität, alte Daten und Anlage; Kurzschluss ist nur eine mögliche Ursache.
actionUnderAbschluss wird vor der zulässigen Zeituntergrenze beobachtet.Ergebnis, Start, Beobachtung und Uhrdefinition prüfen.
actionOverAbschluss ist verspätet oder fehlt nach der Zeitobergrenze.Aktionsverzögerung von Kommunikations- und Messverzug trennen.
Beweist sensorShort einen Kurzschluss?

Hier bezeichnet es eine unerwartete Aktivierung. Die Quelle kann tatsächlich aktiv sein, die Polarität vertauscht oder ein alter Messwert wiederverwendet sein. Sichern Sie Rohwert, qualifizierten Wert, Zeitstempel und Erwartungsintervall, damit die Instandhaltung konkurrierende Erklärungen prüfen kann.

Erkennung, Reaktion und Wiederherstellung zuweisen

Eine Erkennung stellt Abweichung fest, ein Alarm teilt sie mit. Die Reaktion ändert Steuerungsfreigaben; die Wiederherstellung schafft einen gültigen Folgezustand. Zuständigkeiten und Abschlussbedingungen können verschieden sein. Eine Meldung über eine fehlende Tasse beschafft keine Tasse; eine Meldung über ein fehlendes Klemmsignal stellt keine Klemmung her.

Zuständigkeit und Nachweis je Stufe
StufeErforderliche EntscheidungAbschlussnachweis
ErkennenWelche Beobachtung verletzt welche Regel?Quelle, Qualität, Ereigniszeit und Vergleichsregel.
MeldenWer benötigt den Alarm mit welchem Kontext?Zum betroffenen Lauf und Asset zugeordnete Meldung.
ReagierenWelche Ausgänge oder Anforderungen sperren oder halten?Konfigurierte Reaktion und tatsächlich resultierende Ausgänge.
WiederherstellenWer gleicht Teil, Position und nächsten zulässigen Einstieg ab?Geprüfte Wiederherstellungsbedingungen und bewusste Neustartentscheidung.
Macht eine Alarmquittierung aus FAIL ein PASS?

Bewahren Sie Fehlerfall und Belege auf. Führen Sie nach einer Korrektur einen neu identifizierten Fall aus und dokumentieren Sie dessen Ergebnis getrennt. Alarmquittierung belegt die Bearbeitung einer Meldung, überschreibt aber keinen früheren Lauf und prüft keinen korrigierten Pfad.

Vor der Ausführung prüfen

Prüfen Sie einen gesperrten Eingang, unterschiedliche parallele Laufzeiten, wiederholte Aufrufe und eine weitere Produktrunde. Bewahren Sie Rohspuren und Hashes der erzeugten Artefakte auf. Deklarierte Zeiten und eine flüssige Animation messen keinen realen Durchsatz.

Die Diagramme erläutern den Sprachvertrag. Sie belegen weder physische Bewegung noch PLC-Ausführung oder Maschinensicherheit. Modellprüfung und reale Tests werden getrennt dokumentiert.

Sprachgrammatik und Ausführungsvertrag · DS2-SPEC-V2.0

Nach oben