Q_ExecuteMacro

Q_ExecuteMacro

Einleitung

Der Q_ExecuteMacro ist ein standardkonformer Funktionsbaustein zur Ausführung von Makros in Virtual Terminals, entwickelt unter EPL-2.0 Lizenz. Die Version 1.0 implementiert die ISO 11783-6 (Teil 6 - F.48) Spezifikation für VT ab Version 4.

Q_ExecuteMacro

Schnittstellenstruktur

Ereignis-Eingänge

  • INIT: Initialisierungsanforderung (mit Makro-ID)

  • REQ: Makroausführungs-Anforderung

Ereignis-Ausgänge

  • INITO: Initialisierungsbestätigung

  • CNF: Ausführungsbestätigung (mit Status)

Daten-Eingänge

  • u16ObjId (UINT): Makro-Objekt-ID (max. Wert 255)

Daten-Ausgänge

  • STATUS (STRING): Betriebsstatusmeldung

  • s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

  1. Initialisierung:

    • INIT mit Makro-Objekt-ID (8-bit kompatibel)

    • INITO bestätigt Betriebsbereitschaft

  2. Makroausführung:

    • REQ ohne zusätzliche Parameter

    • Führt gespeicherte Makrosequenz aus

    • CNF liefert Ergebnisstatus

  3. Fehlerbehandlung:

    • ISO-standardisierte Fehlercodes

    • Detaillierte Statusmeldungen

Technische Besonderheiten

✔ ISO 11783-6 konform (F.48) ✔ Kompatibel mit VT Version 4+ ✔ 8-bit Makro-IDs (0-255) ✔ Atomare Ausführung (Transaktionssicher)

Makro-Eigenschaften

Feature

Beschreibung

Speicherort

Im VT dauerhaft gespeichert

Größe

Bis zu 255 Befehle

Inhalt

VT-Kommandosequenzen

ID-Bereich

0x01 - 0xFF (8-bit)

Rückgabecodes (s16result)

Code

Konstante

Bedeutung

0

VT_E_NO_ERR

Erfolgreiche Ausführung

-6

VT_E_OVERFLOW

Makro zu komplex

-8

VT_E_NOACT

VT nicht bereit

-129

VT_E_ISO_INSTANCE_INVALID

Ungültige VT-Instanz

Anwendungsszenarien

  • Standardabläufe: Häufig genutzte Befehlsketten

  • Systemstart: Basisinitialisierungen

  • Bediensequenzen: Automatisierte Menünavigation

  • Diagnose: Vordefinierte Testroutinen

⚖️ Vergleich mit ähnlichen Bausteinen

Feature

Q_ExecuteMacro

Q_ExecuteExtendedMacro

VtMacroRunner

ISO-Standard

✔

✔

✖

VT-Version

4+

5+

Alle

ID-Typ

8-bit

16-bit

8-bit

Fazit

Der Q_ExecuteMacro-Baustein bietet die Standardimplementierung für Basis-Makros:

  • Einfach: Kompakte 8-bit Adressierung

  • Kompatibel: Funktioniert mit VT Generation 4+

  • Zuverlässig: Bewährte Technik in Seriengeräten

Idealer Einsatz bei:

  • Standard-Automatisierungen

  • Kompatibilitätskritischen Systemen

  • Einfachen Makroanwendungen