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.

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:
2. INIT mit Makro-Objekt-ID (8-bit kompatibel)

3. INITO bestätigt Betriebsbereitschaft

4. Makroausführung:

5. REQ ohne zusätzliche Parameter
6. Führt gespeicherte Makrosequenz aus

7. CNF liefert Ergebnisstatus

8. Fehlerbehandlung:

9. ISO-standardisierte Fehlercodes
10. 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