API: Anforderung und Abschluss vereinbaren
Eine API benennt eine anforderbare Operation. Sie legt den zu startenden Work und den Work für die Abschlussbeobachtung fest. Deklarierte lokale I/O-Zuordnungen stehen an der Aufrufstelle.
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.
Fünf verschiedene Ereignisse einer Anforderung verfolgen
Im Café werden Senden, Annahme, Extraktionsstart, Ergebnisbeobachtung und Abschlussanerkennung beim Aufrufer unterschieden. Dasselbe gilt für Clamp.Lock. Ein Annahmebeleg zeigt bestandene Zulassungsprüfung, misst aber keine Klemmenposition. Beobachtungsvertrag und aktuelle Ausführung bestimmen den Call-Abschluss.
Bei verschiedenen command- und observe-Works beide Kennungen zeigen. Der command-Work kann fertig sein, während die API auf das spätere Beobachtungsziel wartet. Ausgangsabschaltung ist ein weiteres Ereignis: Ein Impuls kann abgelaufen sein, ein Latch nach logischem Abschluss bestehen bleiben. Diese Ereignisse getrennt diagnostizieren.
Ist die Operation fertig, wenn die Starttaste grün wird?
Prüfen, ob Grün gesendet, angenommen, laufend oder abgeschlossen bedeutet, dann zugehörigen Beleg und Beobachtung lesen. Abhängige Bearbeitungsaufrufe benötigen Lock-Abschluss der aktuellen Ausführung. Eine Farbe ersetzt kein API-Ergebnis und belegt keine physische Bewegung.
Bedeutung des Modells
command benennt das Startziel, observe das Ziel für den Abschluss. Eine Kurzdeklaration kann einen Work oder einen Bereich vom Start bis zum End-Work referenzieren. Die API gehört zum System und ist von ihren einzelnen Calls getrennt. Das Anlagenverhalten bleibt wiederverwendbar; die Aufrufstelle bindet deklarierte Standortadressen, Typen und Erwartungswerte.
Ausgangs- und Erfassungsrichtlinien
action normal [T] | Während freigegebener Ausführung EIN, bei normalem Finish AUS. Mit T bleibt der Ausgang nach dem normalen Finish-Commit noch T reale Zeit aktiv und schaltet dann AUS. |
|---|---|
action pulse [T] | Ein Impuls je Ausführung ab dem ersten erfolgreichen aktiven Ausgangs-Commit: ohne T ein Ausgabeintervall, sonst T. Der bestätigte Impulsablauf ist ebenfalls Abschlussbedingung; ein früheres Sensorsignal allein genügt nicht. |
action latch | Angenommene Aktivierung bleibt über Finish hinaus erhalten. Akzeptierter Reset, entgegengesetzte <|>-Aktion oder Sicherheitsabschaltung lösen oder sperren sie. Wiederhergestellte Freigabe allein schaltet nicht erneut EIN; eine ausdrückliche Fortsetzung für die aktuelle Ausführungs-/Abschaltgeneration ist erforderlich. |
sensing normal [T] | Passenden Erwartungswert sofort oder nach T durchgehend gültiger, passender Abtastwerte qualifizieren. Beim ersten passenden Wert beginnt die Zeit bei null. |
sensing latch T | Gültige Erfassung der aktuellen Ausführung merken; danach T ununterbrochene Stabilität seit letzter Rohwertänderung oder Gültigkeitswiederherstellung verlangen. Der aktuelle Rohwert muss nicht weiter passen; dies unterscheidet sich von normal. |
sensing virtual [T] | Ausdrücklich deklarierte Modell-/Open-Loop-Verzögerung verwenden; kein Nachweis einer physischen Sensorprüfung im Realbetrieb. Erfassungsqualifikation ersetzt weder Work-Dauer noch erforderliche Call-Abschlüsse oder aktuelle Freigaben. |
Die Beziehung lesen
In DS2 v2 ausdrücken
Die beispielhafte Bindung fordert true an einer Ausgangsadresse und erwartet true an einer Eingangsadresse. Der input-Vergleich lautet ==; ST-Guards verwenden = und <>. Die Beispieladressen müssen vor physischer Nutzung durch die geprüfte Zuordnung der tatsächlichen Anlage ersetzt werden.
Syntaxfragmente: kein vollständiges Projekt
api Move = Motion.Forward;
// Caller work body:
Device.Move {
output bool at "%QX0.0" = true;
input bool at "%IX0.0" == true;
}API-Definition und Aufrufstelle unterscheiden
Clamp deklariert Lock als API. ProcessPart in Controller verwendet sie über Clamp.Lock. Die Definition beschreibt verfügbare Operation und Ergebnisbeobachtung. Der Call legt die Anforderungsstelle in dieser Aufgabe fest. Eine Steuerungsdarstellung zeigt deshalb den Verweis des Calls auf die API und dahinter den Anlagen-Work.
API-Name und dokumentiertes Verhalten zusammenhalten. Wird Lock umbenannt oder seine Abschlussgrenze geändert, sind auch die Aufrufer zu prüfen. Übersetzte Anzeigenamen helfen beim Lesen der Oberfläche; die API-Kennung im Modell muss weiterhin die beabsichtigte Definition auflösen.
Startziel und Abschlussbeobachtung wählen
Bei einer API für einen Work sind command und observe identisch. Eine längere Operation kann einen Work starten und einen späteren End-Work beobachten. Eine Steuerungs-API kann etwa den Einstieg einer Bearbeitungsfolge starten und am Ausgang den Abschluss melden. Nur der Abschluss des Einstiegs beendet diese öffentliche Operation nicht.
Auch die Ausführung festhalten, zu der ein Abschluss gehört. Startbeleg und beobachteter Abschluss sind unterschiedliche Tatsachen, besonders bei verschiedenen Works. Ein Ergebnis eines früheren Produkts oder anderen Aufrufers darf den aktuellen Call nicht allein wegen des gleichen Beobachtungsnamens erfüllen.
I/O nach der logischen Anforderung zuordnen
Zuerst vereinbaren, dass Lock das Schließen der Klemme anfordert und welcher Nachweis als gespannt gilt. Danach Ausgang und Eingang an der Aufrufstelle zuordnen. Steuerungskanal, Datentyp, Erwartungswert und Polarität gemeinsam prüfen. Eine Ausgangsadresse beschreibt nur das Schreibziel; warum der Wert Spannen bedeutet, muss ebenfalls klar sein.
Die dokumentierte Zuordnung der Anlageninstanz verwenden. Unbekannte Adressen oder Sensoren bleiben als offene Integrationsanforderung sichtbar. Keine Kennung erfinden und ein reines Zeitmodell nicht als geprüften physischen Sensorkreis beschreiben.
Ausgangs- und Erfassungspolitik getrennt lesen
action beschreibt die Ausgangsansteuerung einer angenommenen Operation, sensing die Qualifikation des erwarteten Eingangs. Das sind unterschiedliche Fragen: Wie lange bleibt der Ausgang aktiv, und wann zählt die Beobachtung? Beide zusammen mit Work-Dauer, erforderlichen Kindergebnissen und aktuellen Freigaben lesen. Ein qualifizierter Sensorwert hebt andere Abschlussbedingungen nicht auf.
Die Referenz unterscheidet normal, pulse, latch und virtual. Zuerst das tatsächlich benötigte Verhalten wählen, dann dessen Unterstützung im Ausführungsprofil prüfen. Nur den Namen durch eine unterstützte Politik zu ersetzen und anderes Verhalten zu erwarten, verändert die Modellbedeutung.
Wiederholte Calls und fehlende Antworten prüfen
Nach einem erfolgreichen Lock-Call prüfen, wie das Gerät für den nächsten Durchlauf verfügbar wird. Deklarierte Rücksetzung oder Gegenaktion und Abschlussbestätigung verfolgen. Logische Wiederbereitschaft von der physischen Öffnungsbewegung trennen. Ist Öffnen eine reale Operation, wird sie modelliert und aufgerufen, statt in einem leeren Hilfs-Work versteckt.
Eine verspätete und eine ausbleibende Antwort testen. Der Aufrufer meldet das tatsächliche Warten, den Fehler oder die nicht unterstützte Ausführung des Profils. Das Bild einer geschlossenen Klemme ersetzt weder Erwartungseingang noch Ergebnisbeleg dieses Calls.
Den ganzen Anforderungs- und Ergebnispfad prüfen
Für Clamp.Lock API-Deklaration, aufgerufene Systeminstanz, command-Work und observe-Work zeigen. Danach vorhandene lokale Bindung und das Ergebnis nachweisen, das den Aufrufer erfüllt hat. So fällt ein falsches Ziel auch bei einem plausiblen Anzeigenamen auf.
- Beendet der command-Abschluss immer den Call? Nur wenn auch die deklarierte Beobachtung und die weiteren Abschlussbedingungen des aktuellen Calls erfüllt sind.
- Belegt eine Eingangsadresse einen Sensortest? Nein, das Protokoll muss reale Abtastung, Zuordnung und geprüftes Profil ausweisen.
Einen Befehlswert senden und das Ergebnis bewerten
Ein Lehrbeispiel nimmt 100 mL als Ziel und misst die abgegebene Menge für jede Anforderung separat. Als zulässiges Ergebnis werden einschließlich Grenzen 98 bis 102 mL vereinbart. Das ist ein Beispielvertrag, kein Rezept oder Genauigkeitsversprechen. Gesendete und beobachtete 100 sind verschiedene Daten und benötigen nicht denselben Kanal.
Einzelwert, Wertemenge und kontinuierlicher Bereich akzeptieren unterschiedliche Beobachtungen. Vor der Adressbindung auch Skalartyp, Einheit und Skalierung vereinbaren. Unbekannte oder ungültige Daten sind keine bequeme Null. Die Tabelle vergleicht nur Wertannahme; Zeit, Gültigkeit und Ausführungszuordnung gelten zusätzlich.
| Gemessene Menge | Genau 100 | Menge {98, 100, 102} | Bereich [98, 102] |
|---|---|---|---|
| 97 mL | Nein | Nein | Nein |
| 98 mL | Nein | Ja | Ja |
| 99 mL | Nein | Nein | Ja |
| 100 mL | Ja | Ja | Ja |
| 103 mL | Nein | Nein | Nein |
Ist eine neue Anforderung fertig, wenn der Sensor bereits passt?
Nicht aus dem Wert allein. Ausgangsfreigabe, gültiges Ergebnis der aktuellen Anforderung und altes Ergebnis unterscheiden. Auch keine erfundene Flanke verlangen, sondern dem Vertrag folgen. Messidentität, Gültigkeit und aktueller Call-Beleg müssen die Deutung tragen.
Ausgangszeit nach dem empfangenden Gerät wählen
Das Gerät kann einen kurzen Auslöser, einen gehaltenen Befehl oder eine nach logischem Abschluss gespeicherte Aktivierung erwarten. action folgt diesem Vertrag. action normal endet beim normalen Abschluss; eine explizite Verlängerung kann nach Finish bestehen. Ein Impuls erfolgt einmal je Ausführung, sein Ablauf zählt zur Abschlussqualifikation. Latch bleibt bis zu autorisierter Freigabe oder Sperre.
Diese Politiken ändern nicht die physische Kanalbedeutung. Bei einer Zuordnung kann false ein gültiger aktiver Befehl sein. EIN/AUS beschreibt Aktivierungsabsicht, keine allgemeine elektrische Polarität. Freigabewert und Verhalten bei Freigabeverlust dokumentieren. Freigabewiederkehr allein berechtigt nicht zum Wiederstart einer sicherheitsgesperrten gespeicherten Aktivierung.
| Benötigtes Verhalten | Zu prüfende Politik | Getrenntes Ereignis |
|---|---|---|
| Bis Normalabschluss treiben | action normal | Eingangsqualifikation |
| T nach Finish halten | action normal T | Verlängerungsablauf nach Abschluss |
| Ein Aktivierungsimpuls | action pulse [T] | Impulsablauf und Ergebnis |
| Aktivierung speichern | action latch | Autorisierte Freigabe und Abschaltung |
Ist der Ausgang bei Finish immer inaktiv?
action und Freigaberegeln lesen. Verlängerung oder Latch können über den logischen Abschluss hinaus bestehen, ein Impuls schon während der Ergebniswartezeit enden. Work-Zustand, Ausgangsabsicht, gesendeten Wert und physische Beobachtung getrennt vergleichen.
Festlegen, wann eine Beobachtung als Abschlussnachweis gilt
Erscheint ein erwarteter Eingang kurz und ändert sich dann, verlangt sensing normal T kontinuierlich gültige passende Werte für T, beginnend bei null. sensing latch T merkt eine gültige Erfassung der aktuellen Ausführung und prüft danach die Stabilität seit letzter Rohwertänderung oder Gültigkeitswiederkehr. Dieselbe Wellenform kann verschieden qualifiziert werden.
Erwartete Gerätezeit, Ausgangszeit und Erfassungsqualifikationszeit getrennt halten. Eine virtuelle Modellverzögerung ist ein ausdrücklich deklarierter Sensorersatz, keine Sensormessung. Nach der Auswahl stabile und kurze Übereinstimmung, ungültige Werte und eine zweite Anforderung testen. Tatsächliche Zeiten und Ausführungskennungen festhalten.
| Frage | Politik | Benötigter Nachweis |
|---|---|---|
| Passt der Eingang jetzt gültig? | sensing normal | Gültige passende Beobachtung |
| Passt er durchgehend T lang? | sensing normal T | Kontinuierliche gültige Übereinstimmung |
| Erfassung gemerkt und Stabilität erfüllt? | sensing latch T | Aktuelle Erfassung und definierte Stabilität |
| Gilt eine Modellverzögerung? | sensing virtual [T] | Deklarierte Zeit, als virtuell gekennzeichnet |
Kann dieselbe Beobachtung ohne Befehl gelesen werden?
Eine observe-basierte Bedingung prüft eine Freigabe, ohne das Gerät zu befehligen. Tassenanwesenheit prüfen unterscheidet sich vom Platzierungsaufruf mit Ergebniswartezeit. Beobachtung zu teilen heißt nicht Ausgangshoheit zu teilen. Lesepfad und Operationsanforderung im Modell ausdrücklich halten.
Vor der Ausführung prüfen
Für jeden Call Anlageninstanz, Start-Work, beobachteten Work und Ergebnis der aktuellen Ausführung bestimmen. Bei physischem I/O zusätzlich Adresszuständigkeit, Typ und Polarität prüfen. Vor Aussagen zum Wiederholbetrieb den Wiederbereitschaftspfad klären.
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