# HANDLE

```{index} single: HANDLE
```

* * * * * * * * * *
## Einleitung
Die `HANDLE`-Konstante ist eine globale Konstantendefinition für die 4diac-IDE, die im Kontext der ISOBUS-Protokoll- und Parameter-Gruppen-Nummer (PGN) Verarbeitung verwendet wird. Sie definiert spezielle Werte zur Kennzeichnung ungültiger oder globaler Adressierungsziele innerhalb eines ISOBUS-Netzwerks. Diese Konstanten dienen als zentrale Referenzwerte für Funktionsblöcke, die mit Handle-basierter Kommunikation arbeiten.

## Schnittstellenstruktur
Dies ist eine globale Konstantendefinition und besitzt daher keine Ereignis- oder Datenschnittstellen im herkömmlichen Sinne eines Funktionsblocks. Stattdessen stellt sie benannte Konstanten zur Verfügung, die in anderen Blöcken verwendet werden können.

### **Ereignis-Eingänge**
*Nicht vorhanden.* Diese Definition enthält keine Ereignisseingänge.

### **Ereignis-Ausgänge**
*Nicht vorhanden.* Diese Definition enthält keine Ereignisausgänge.

### **Daten-Eingänge**
*Nicht vorhanden.* Diese Definition enthält keine Dateneingänge.

### **Daten-Ausgänge**
*Nicht vorhanden.* Diese Definition enthält keine Datenausgänge.

### **Adapter**
*Nicht vorhanden.* Diese Definition enthält keine Adapterschnittstellen.

## Funktionsweise
Die `HANDLE`-Konstante definiert zwei symbolische Namen für spezielle Integer-Werte:
1.  `UNVALID`: Repräsentiert einen ungültigen oder nicht genutzten Handle mit dem Wert `-1` (dezimal) bzw. `0xFFFF` (hexadezimal). Dieser Wert kann verwendet werden, um anzuzeigen, dass ein Handle nicht initialisiert ist, eine Operation fehlgeschlagen ist oder eine Ressource nicht verfügbar ist.
2.  `GLOBAL`: Repräsentiert einen Pseudo-Handle mit dem Wert `32767` (dezimal) bzw. `0x7FFF` (hexadezimal). Dieser Wert dient dazu, eine globale Zieladresse (Broadcast) innerhalb des ISOBUS-Netzwerks anzusprechen, anstatt ein spezifisches Einzelgerät.

Diese Konstanten werden typischerweise in den Datenverbindungen oder internen Logiken anderer Funktionsblöcke (z.B. für ISOBUS-Kommunikation) verwendet, um die Code-Lesbarkeit und Wartbarkeit zu verbessern, anstatt magische Zahlen direkt im Code zu verwenden.

## Technische Besonderheiten
*   **Paketzuordnung:** Die Konstanten sind dem Paket `isobus::pgn` zugeordnet, was ihren Einsatzbereich in der ISOBUS-PGN-Kommunikation klar definiert.
*   **Typisierung:** Beide Konstanten sind vom Typ `INT` (Integer).
*   **Initialisierung:** Die Werte werden direkt bei der Deklaration zugewiesen (`InitialValue`).
*   **Sichtbarkeit:** Als globale Konstanten (`GLOBALCONSTANTS`) sind sie innerhalb des definierten Pakets (`isobus::pgn`) für alle darin enthaltenen Funktionsblöcke sichtbar und verwendbar.

## Zustandsübersicht
Da es sich um eine statische Konstantendefinition handelt, gibt es keine Zustandsmaschine oder veränderlichen Zustände.

## Anwendungsszenarien
*   **Initialisierung von Handles:** Beim Start eines Systems können Kommunikationshandles mit dem Wert `UNVALID` initialisiert werden, um ihren "leeren" Zustand zu kennzeichnen.
*   **Fehlerbehandlung:** Funktionsblöcke, die Handles zurückgeben (z.B. nach dem Öffnen einer Verbindung), können `UNVALID` zurückgeben, um einen Fehler anzuzeigen.
*   **Broadcast-Kommunikation:** Ein Senderblock kann den `GLOBAL`-Handle verwenden, um eine Nachricht an alle Teilnehmer im ISOBUS-Netzwerk zu adressieren, anstatt an einen spezifischen Empfänger.
*   **Vergleiche:** Die Lesbarkeit von Bedingungen wie `IF currentHandle = UNVALID THEN ...` oder `IF targetHandle = GLOBAL THEN ...` wird deutlich verbessert.

## ⚖️ Vergleich mit ähnlichen Bausteinen
*   **`CONSTANT`-Funktionsblock:** Ein generischer `CONSTANT`-Block kann einen festen Wert ausgeben, ist aber eine Instanz innerhalb eines Funktionsblocknetzwerks. Die `HANDLE`-Globalkonstante ist eine zentrale, paketweite Definition, die nicht instanziiert werden muss und direkt über ihren Namen referenziert wird.
*   **Direkte Werteingabe:** Anstatt `UNVALID` oder `GLOBAL` zu verwenden, könnten die numerischen Werte (`-1`, `32767`) direkt in die Blöcke eingegeben werden. Die Verwendung der Konstanten ist jedoch die deutlich bessere Praxis, da sie den Code selbsterklärender und änderungsresistenter macht (Änderungen nur an einer Stelle).

## Fazit
Die `HANDLE`-Globalkonstante ist ein einfaches aber wesentliches Hilfselement für die Entwicklung von ISOBUS-konformen Applikationen in 4diac. Sie erhöht die Codequalität, indem sie zwei häufig benötigte, spezielle Handle-Werte mit aussagekräftigen Namen versieht. Ihre Verwendung fördert lesbaren, wartbaren und fehlerrobusten Code in Funktionsblöcken, die mit ISOBUS-PGN-Adressierung arbeiten.