# ButtonActivationCode_S

```{index} single: ButtonActivationCode_S
```

* * * * * * * * * *
## Einleitung
Der Datentyp `ButtonActivationCode_S` ist eine strukturierte Datenstruktur (Struct), die zur Konfiguration der Aktivierung eines Tasters (Buttons) in einem Steuerungssystem verwendet wird. Er definiert einen Aktivierungscode und ein Steuerungsflag für die Wiederholungslogik. Dieser Datentyp ist Teil des Pakets `isobus::UT::io::Button`.

## Schnittstellenstruktur
Da es sich um einen Datentyp und nicht um einen Funktionsblock handelt, gibt es keine Ereignis- oder Adapterschnittstellen. Die Struktur besteht ausschließlich aus Datenfeldern.

### **Daten-Eingänge**
*(Nicht anwendbar - Dies ist ein Datentyp, kein Funktionsblock)*

### **Daten-Ausgänge**
*(Nicht anwendbar - Dies ist ein Datentyp, kein Funktionsblock)*

### **Strukturierte Datenfelder**
Die folgenden Felder bilden die interne Struktur des Datentyps `ButtonActivationCode_S`:

| Name     | Datentyp | Initialwert | Kommentar |
| :------- | :------- | :---------- | :-------- |
| `code`   | `USINT`  | 255         | Definiert den spezifischen Aktivierungscode für den Taster. |
| `bCyclic`| `BOOL`   | TRUE        | Steuert das zyklische Verhalten. Wenn auf `FALSE` gesetzt, wird die Aktivierung nicht alle 200 ms wiederholt. |

## Funktionsweise
Die Struktur `ButtonActivationCode_S` dient als Container für Konfigurationsdaten.
*   Das Feld `code` identifiziert den Taster eindeutig innerhalb des Systems. Der Standardwert 255 kann als inaktiver oder undefinierter Zustand interpretiert werden.
*   Das Feld `bCyclic` bestimmt das Zeitverhalten bei einer dauerhaften Betätigung des Tasters. Bei `TRUE` (Standard) wird das zugehörige Ereignis in einem festen Intervall (z.B. alle 200 ms) wiederholt ausgelöst. Bei `FALSE` wird das Ereignis nur einmalig beim Drücken (und ggf. beim Loslassen) ausgelöst, auch wenn der Taster gedrückt gehalten wird.

## Technische Besonderheiten
*   **Initialwerte:** Beide Felder der Struktur haben vordefinierte Initialwerte, was eine sichere Initialisierung gewährleistet.
*   **Kommentar:** Das Feld `bCyclic` enthält einen hilfreichen Kommentar, der die konkrete Auswirkung (`do not repeat every 200ms`) direkt in der Deklaration erklärt.
*   **Typ-Hash:** Der Datentyp enthält ein Attribut (`eclipse4diac::core::TypeHash`), das für die Typprüfung und Versionierung innerhalb der 4diac-Umgebung genutzt wird.

## Zustandsübersicht
*(Nicht anwendbar - Dies ist ein statischer Datentyp ohne Zustandsautomaten.)*

## Anwendungsszenarien
Dieser Struct wird typischerweise als Eingangs- oder Konfigurationsparameter für Funktionsblöcke verwendet, die Tastereingänge verarbeiten, z.B.:
*   In einer Bedienoberfläche (HMI) zur Konfiguration von Softkeys.
*   In Maschinensteuerungen zur Parametrierung von physischen Steuertastern.
*   Überall dort, wo zwischen einmaliger und wiederholter Aktion bei Tastendruck unterschieden werden muss.

## ⚖️ Vergleich mit ähnlichen Bausteinen
Als reiner Datentyp ist `ButtonActivationCode_S` mit anderen strukturierten Datentypen (STRUCTs) in 4diac vergleichbar, wie z.B. `DATE_AND_TIME`. Sein spezifischer Zweck ist die Bündelung der für die Tastersteuerung relevanten Parameter (`code` für Identifikation, `bCyclic` für Zeitverhalten) in einer einzigen, wiederverwendbaren Einheit.

## Fazit
Der Datentyp `ButtonActivationCode_S` ist eine einfache, aber wesentliche Struktur zur standardisierten Konfiguration von Tasterverhalten in 4diac-basierten Steuerungsapplikationen. Durch die Kapselung des Codes und des Wiederholungsflags fördert er die Wiederverwendbarkeit und Lesbarkeit von Code. Die integrierten Initialwerte und der klare Kommentar tragen zur Robustheit und einfachen Handhabung bei.