Q_BackgroundColourAux_AUS¶
Einleitung¶
Dieser Funktionsblock implementiert das Kommando zum Ändern der Hintergrundfarbe eines Objekts gemäß ISO 11783-6, Teil F.20.
Er ermöglicht die Interaktion mit dem Virtuellen Terminal (VT) und übernimmt die Übermittlung der neuen Farbe sowie die Rückmeldung des Ergebnisses.
Schnittstellenstruktur¶
Ereignis-Eingänge¶
| Ereignis | Typ | Mit Parameter | Beschreibung |
|---|---|---|---|
| INIT | EInit | u16ObjId | Service Initialisierung |
Ereignis-Ausgänge¶
| Ereignis | Typ | Mit Parameter | Beschreibung |
|---|---|---|---|
| INITO | EInit | – | Initialisierung bestätigt |
| CNF | Event | STATUS, s16result | Bestätigung des angeforderten Dienstes |
Daten-Eingänge¶
| Name | Typ | Initialwert | Beschreibung |
|---|---|---|---|
| u16ObjId | UINT | ID_NULL | Objekt-ID des betroffenen Objekts |
Daten-Ausgänge¶
| Name | Typ | Beschreibung |
|---|---|---|
| STATUS | STRING | Dienststatus (z. B. Fehlertext) |
| s16result | INT | Rückgabewert (siehe unten) |
Adapter¶
| Richtung | Name | Typ | Beschreibung |
|---|---|---|---|
| Socket | u8Colour | AUS | Neue Hintergrundfarbe (gemäß ISO 11783-6 A.3) |
| Plug | u8OldColour | AUS | Alte Hintergrundfarbe (wird vom VT zurückgemeldet) |
Funktionsweise¶
Der Baustein erwartet zuerst eine Initialisierung mit der Objekt-ID (INIT mit u16ObjId).
Sobald am Socket-Adapter u8Colour ein neuer Farbwert anliegt (ausgelöst durch das Ereignis E1 des Adapters), wird intern ein REQ-Event an den verkapselten Funktionsblock Q_BackgroundColourAux gesendet.
Dieser führt das VT-Kommando aus und liefert über den Ausgang CNF den Status (STATUS) und das Ergebnis (s16result) zurück.
Die alte Farbe wird über den Plug-Adapter u8OldColour ausgegeben.
Die gesamte Logik ist in einem untergeordneten FB der gleichen Familie gekapselt, sodass dieser Baustein nur als äußere Hülle für die Adapterkopplung dient.
Technische Besonderheiten¶
- Der Initialwert für
u16ObjIdistID_NULL, d. h. der FB muss vor der Nutzung mit einer gültigen Objekt-ID initialisiert werden. - Die Farbwerte werden als 8‑Bit-Werte über den AUS‑Adapter transportiert. Die gültigen Farben sind in der VT‑Standard‑Farbpalette (ISO 11783‑6 Anhang A.3) definiert.
- Mögliche Rückgabewerte (
s16result): VT_E_NO_ERR(0): ErfolgVT_E_OVERFLOW(-6): PufferüberlaufVT_E_NOACT(-8): Kommando im aktuellen Zustand nicht möglichVT_E_NO_INSTANCE(-21): Kein VT‑Client verfügbarVT_E_ISO_INSTANCE_INVALID(-129): Ungültige VerbindungskennungVT_E_NOT_ALIVE(-130): VT‑Instanz gültig, aber VT nicht erreichbar
Zustandsübersicht¶
Der FB besitzt keine expliziten Zustandsautomaten im XML. Die Ereignissteuerung erfolgt rein über die Ereignisverbindungen:
- INIT → Initialisierung des Dienstes.
- Externes Ereignis über Socket‑Adapter → Start des Farbänderungs‑Requests.
- CNF → Abschluss der Operation mit Status und Rückgabewert.
Anwendungsszenarien¶
- Dynamische Anpassung der Hintergrundfarbe eines ISOBUS‑VT‑Objekts (z. B. Button, Textfeld) in Abhängigkeit von Betriebszuständen oder Benutzereingaben.
- Umsetzung von Farbwechseln in landwirtschaftlichen Steuerungs‑ und Visualisierungssystemen.
Vergleich mit ähnlichen Bausteinen¶
Es existieren analoge Funktionsblöcke für andere visuelle Eigenschaften (z. B. Q_TextColourAux_AUS, Q_VisibilityAux_AUS).
Gemeinsam ist allen das schema-basierte Adapter-Pattern, das die Signalisierung von Wertänderungen über AUS‑Adapter realisiert.
Dieser Baustein spezialisiert sich auf die Hintergrundfarbe und verwendet die gleichen Fehler- und Rückgabewerte.
Fazit¶
Der Funktionsblock Q_BackgroundColourAux_AUS kapselt einen ISOBUS‑VT‑Dienst zur Hintergrundfarbänderung kompakt und bietet durch die Adapterschnittstellen eine einfache Integration in übergeordnete Steuerungen.
Er ist zuverlässig, standardkonform und erlaubt durch die Rückmeldung des Status eine robuste Fehlerbehandlung.