# Blueprint Entwicklungshilfe

### Ereignisse auslesen

[![Open your Home Assistant instance and show your event developer tools.](https://my.home-assistant.io/badges/developer_events.svg)](https://my.home-assistant.io/redirect/developer_events/)

Die Entwicklungstools von Home Assistant sind euer Freund.  
Der Punkt "Ereignisse Abonnieren" zeigt euch an, welche Tastendruck-Aktionen welche Ereignisse auslösen auf die euer Blueprint gebunden werden muss.

Weil hier Zigbee läuft müssen wir die ZHA\_Events abonnieren

Im Falle von IKEA SYMFONISK sieht das dann in etwa so aus.

```yaml
event_type: zha_event
data:
  device_ieee: xx:xx:xx:xx:xx:xx:xx:00
  device_id: xxxxx0000xx0xx00x0xxx0000000x000
  unique_id: xx:xx:xx:xx:xx:xx:xx:xx:x:0x0000
  endpoint_id: 1
  cluster_id: 6
  command: "on"
  args: []
  params: {}
origin: LOCAL
time_fired: "2025-11-09T10:26:43.663802+00:00"
context:
  id: 00X0X0XXXXXXXX0X0X000X0XXX
  parent_id: null
  user_id: null

```

In der YAML Notation sind die Zeileneinrückungen am Anfang ziemlich wichtig. Nicht so kritisch wie bei FORTRAN, aber die geben statt den {} Klammern aus jeder anderen Sprache an, was zu welchem Element gehört.

Hier ist der Anschalter gedrückt worden, der meldet ein "on" command, auf das wir im Blueprint Aktionen eintragen können.

```yaml
event_type: zha_event
data:
  device_ieee: xx:xx:xx:xx:xx:xx:xx:00
  device_id: xxxxx0000xx0xx00x0xxx0000000x000
  unique_id: xx:xx:xx:xx:xx:xx:xx:xx:x:0x0000
  endpoint_id: 1
  cluster_id: 5
  command: press
  args:
    - 256
    - 13
    - 0
  params:
    param1: 256
    param2: 13
    param3: 0
origin: LOCAL
time_fired: "2025-11-09T10:27:18.174521+00:00"
context:
  id: 00X0X0XXXXXXXX0X0X000X0XXX
  parent_id: null
  user_id: null
```

Das hier ist jetzt keine Standardtaste mehr, sondern eine Funktionstaste der STYRBAR Fernbedienung. command:press bedeutet schlicht dass sie gedrückt wurde, und der args: Abschnitt sagt uns welche Taste das eigentlich war.

Jetzt kann die Taste aber auch lange gedrückt werden, was zwei Events erzeugt:

```yaml
  endpoint_id: 1
  cluster_id: 6
  command: "on"
  args: []
  params: {}
origin: LOCAL
```

```yaml
  endpoint_id: 1
  cluster_id: 5
  command: release
  args:
    - 0
  params:
    param1: 0
origin: LOCAL
```

Das ist mit allen Zigbee Geräten so, die irgendwelche Tasten haben, die irgendwelche Zustände an den Coordinator melden müssen

### Zustände

[![Open your Home Assistant instance and show your state developer tools.](https://my.home-assistant.io/badges/developer_states.svg)](https://my.home-assistant.io/redirect/developer_states/)

Zustände sind aktuelle Eigenschaften von Zigbee-Geräten. Dinge wie ob eine Glühbirne gerade leuchtet, welche Helligkeit sie hat, oder Lichttemperatur, Lichtfarbe und so weiter.

Hier braucht ihr eure Entitäts-ID, die findet ihr wenn ihr im Home Assistant auf euer Gerät geht und im Abschnitt "Steuerelemente" aufs Gerät und dann das Zahnrad klickt.

Nehmen wir jetzt mal Beispielhaft eine IKEA TRADFRI E14 Glühbirne:

```yaml
min_color_temp_kelvin: 2202
max_color_temp_kelvin: 4000
min_mireds: 250
max_mireds: 454
effect_list: off, colorloop
supported_color_modes: color_temp, xy
effect: null
color_mode: null
brightness: null
color_temp_kelvin: null
color_temp: null
hs_color: null
rgb_color: null
xy_color: null
off_with_transition: false
off_brightness: 254
friendly_name: ******
supported_features: 44
```

Das ist eine ganze Menge: Sie ist gerade ausgeschaltet, weil wir keine Brightness haben und auch keine anderen Werte die ein Licht beschreiben würden.

Sie kann Lichttemperatur (color\_temp), und Farblicht (sieht man am xy, das ist ein anderes Farbsystem, scheinbar passender für LED als RGB)...

WEITERER ARTIKEL IN ARBEIT