Martin Weissenböck

Home Assistant: YAML, Automationen und Skripte

Was erwartet Sie in diesem Beitrag?

Was geschieht bei einem Clubabend, beim Forum Smart Home | IoT? Dieser Beitrag behandelt den Clubabend vom 28. Mai 2025 als Nachlese. Die Grundlagen wurden bereits in den PCNEWS 184 vorgestellt und beim Clubtreffen noch einmal im Detail geübt. Alles ist Schritt-für-Schritt in den Download-Ordnern zu finden, auch eine weitere Einführung zu Home Assistant-Themen. Ferner sind alle Schritte mit Screenshots unterlegt.

Die Themen waren…

• … ein Überblick über YAML

• … das Erstellen von Automationen und die verwendeten Editoren

• … Einträge in der Datei configuration.yaml

• ... der Einsatz von ChatGPT

• … Skripte und Bausteine

In der Langversion steht anstelle von ☝ viel mehr Text.

YAML

YAML ist die Beschreibungssprache, in der im Home Assistant (HA) Konfigurationen und Anweisungen formuliert werden (können), aber auch veröffentlicht werden. Wer mit HA arbeitet, sollte die Grundlagen von YAML kennen. Der Vergleich mit Konstrukten in JavaScript oder JSON kann manchen Lesern helfen.

YAML ist also keine Programmiersprache, sondern eine für Menschen gut lesbare Form zur seriellen Darstellung von Daten, verwendbar in beliebigen Programmiersprachen.

YAML ist ein rekursives Akronym und steht für „YAML Ain’t Markup Language“: "YAML ist keine Auszeichnungssprache", "YAML ist keine Markup-Sprache", ursprünglich „Yet Another Markup Language“.

Die Grundlagen von YAML

Jede YAML-Darstellung besteht ausschließlich nur aus:

• Einzelwerten (in JavaScript: Literale)

• Listen (list, in JavaScript, Python: Listen, etwas ungenau: Array)

• Assoziativen Listen (map, in JavaScript: Objekte, in C/C++: struct)

Listen und Maps können selbst wieder alle Datenarten enthalten, also auch weitere Listen oder Maps.

Einzelwerte

• Zeichenketten

• Zahlen

• false, true, No, Yes

Datenstrukturen

• Listen

• Maps (assoziative Listen)

• Zusammensetzungen wie Listen von Maps, Maps von Maps usw.

Listen

In anderen Programmiersprachen werden Daten durch Klammern (oder Schlüsselworte) organisiert. In YAML werden Einrückungen verwendet – sie sind streng zu beachten! Zwei Leerstellen sind üblich, Tabulatoren statt Leerstellen werden meist als Fehler gekennzeichnet.

Beispiele aus der Wikipedia

Ich habe die englischen Ausdrücke übernommen.

In YAML ist jede Zeile ein eigener Listeneintrag, der Zeilenwechsel ist daher wesentlich. Das "–"-Zeichen kann weggelassen werden,

xxxxxxxxxx
4
1
- Berüchtigt (Notorious)
2
- Casablanca
3
- Ich kämpfe um dich (Spellbound)
4
- Solange ein Herz schlägt (Mildred Pierce)

oder (gleichwertig)

xxxxxxxxxx
4
1
Berüchtigt (Notorious)
2
Casablanca
3
Ich kämpfe um dich (Spellbound)
4
Solange ein Herz schlägt (Mildred Pierce)

Listen können auch in einer Zeile in eckigen Klammern geschrieben werden. Zeichenketten müssen nicht in Hochkommata eingeschlossen werden.

xxxxxxxxxx
1
1
[Haferflocken, Bananen, Nüsse]

Wer JSON kennt, kann zum besseren Verständnis ein Umwandlungsprogramm verwenden.

JSON (zum Vergleich):

Ein Zeilenwechsel ist in YAML ein (wichtiges) Sprachelement, in JSON dient er nur der besseren Lesbarkeit.

xxxxxxxxxx
4
1
[ "Berüchtigt (Notorious)", 
2
  "Casablanca", 
3
  "Ich kämpfe um dich (Spellbound)", 
4
  "Solange ein Herz schlägt (Mildred Pierce)"]

Auch einzeilig möglich:

xxxxxxxxxx
1
1
["Haferflocken", "Bananen", "Nüsse"]

Map (Assoziative Liste):

Da in den Home Assistant–Unterlagen meistens von maps und nicht von assoziativen Listen gesprochen wird, verwende ich die englische Bezeichnung.

Beispiele aus der Wikipedia

• Jeder Eintrag besteht aus einem Schlüssel (key) und einem Wert (value).

• Dazwischen steht ein Doppelpunkt. Der Doppelpunkt ist das charakteristische Merkmal einer Map.

• Jeder Schlüssel darf pro Map nur einmal vorkommen.

• Werte können wieder alle besprochenen Datentypen sein, also auch Listen und Maps. Maps von Maps oder Listen kommen häufig vor.

• --- leitet einen neuen Abschnitt ein.

• Mit # beginnt ein Kommentar und endet in derselben Zeile.

xxxxxxxxxx
3
1
--- # Block
2
name: John Smith
3
age: 33

name und age sind Schlüssel (keys), John Smith und 33 sind Werte (values).

Gleichwertige Schreibweise, bei großen Maps aber unübersichtlich:

xxxxxxxxxx
2
1
--- # Inline
2
{name: John Smith, age: 33}

JSON (zum Vergleich):

xxxxxxxxxx
1
1
{ "name": "John Smith", "age": 33 }

oder

xxxxxxxxxx
3
1
{ "name": "John Smith", 
2
  "age": 33
3
}

Der Zeilenwechsel ist in JSON nicht vorgeschrieben. Wenn aber zusammengehörige Klammern genau untereinander stehen, werden Datenstrukturen und Programme leichter lesbar.

JavaScript (zum Vergleich):

Die Keys müssen nicht zwischen Apostrophen stehen.

xxxxxxxxxx
1
1
{ name: "John Smith", age: 33 }

Block-Ausdrücke

Ein senkrechter Strich bewirkt, dass Zeilenumbrüche beibehalten werden:

xxxxxxxxxx
6
1
--- |
2
  There was a young lady of Wright
3
  Who travelled much faster than light.
4
      She departed one day
5
      In a relative way
6
  And returned in the previous night.

Listen von Maps

Beispiele aus der Wikipedia

• Das "–" leitet ein neues Listenelement ein.

• Untereinander stehende, gleich eingerückte Listenelemente bilden gemeinsam eine assoziative Liste.

xxxxxxxxxx
3
1
- {name: John Smith, age: 33}
2
- name: Mary Smith
3
  age: 27

Entspricht in JSON:

xxxxxxxxxx
3
1
[ {"name": "John Smith", "age": 33}, 
2
  {"name": "Mary Smith", "age": 27}
3
]

oder

xxxxxxxxxx
7
1
[ { "name": "John Smith", 
2
     "age": 33
3
  }, 
4
  { "name": "Mary Smith", 
5
    "age": 27
6
  }
7
]

Map von Listen

Beispiel aus der Wikipedia

xxxxxxxxxx
4
1
men: [John Smith, Bill Jones]
2
women:
3
  - Mary Smith
4
  - Susan Williams

Entspricht in JSON:

xxxxxxxxxx
7
1
{ "men":   [ "John Smith", 
2
             "Bill Jones"
3
           ],  
4
  "women": [ "Mary Smith", 
5
             "Susan Williams"
6
           ] 
7
}

Oder:

xxxxxxxxxx
3
1
{ "men":   [ "John Smith", "Bill Jones" ],  
2
  "women": [ "Mary Smith", "Susan Williams" ] 
3
}

Mehr zu YAML

Weiterentwicklungen von YAML erlauben, den YAML-Code selbst durch Anweisungen zu verändern. Dadurch können beispielsweise YAML-Codestücke mehrfach verwendet werden, vergleichbar mit Makros einer Programmiersprache.

Siehe Advanced YAML syntax cheatsheet.

Automationen

Sie sind das zentrale Steuerelement in Home Assistant. Zum Erstellen einer Automation in der Menüleiste links Einstellungen und dann Automationen & Szenen wählen.

Eine neue Automation wird mit dem Button rechts unten erstellt:

Weiter bei

Automationen können im visuellen Editor oder mit YAML bearbeitet werden.

Visueller Editor

Beim Entwickeln von Programmen sind oft drei Abschnitt zu erkennen: Eingabe der Daten — Verarbeitung — Ausgabe.

Eine Automation besteht im einfachen Fall ebenso aus drei Blöcken:

• Die Eingabe der Daten entspricht im HA dem Auslöser der Automation. Stichworte: trigger oder Sobald

• In der Verarbeitung werden Bedingungen geprüft. Stichworte: conditions oder Und wenn

• Die Ausgabe wird mit actions oder Dann eingeleitet

Im Visuellen Editor sieht das so aus:

YAML-Editor

Zwischen dem visuellen Editor und dem YAML–Editor kann jederzeit umgeschaltet werden. Dazu wird rechts oben das Drei-Punkt-Menü ⋮ aufgerufen.

In den Zeilen 3 bis 5 sind wieder die drei Blöcke zu finden. In Zeile 1 kann eine Beschreibung eingetragen werden. single in Zeile 2 bedeutet, dass das neuerliche Aufrufen einer gerade laufenden Automation ignoriert wird.

Wie sind diese fünf Zeilen syntaktisch aufgebaut? Sie bilden eine Liste von Maps. Die jeweiligen Keys stehen vor den Doppelpunkten und sind in oranger Schrift hervorgehoben.

Vergleiche

Zeile 1 und 2 haben als Wert je eine Zeichenkette, Zeilen 3 bis 5 je eine leere Liste.

• Zeile 1: Description = Beschreibung

• Zeile 2: Die Automation wird (zu einem Zeitpunkt) nur einfach ausgeführt.

xxxxxxxxxx
2
1
description: "Erster YAML-Versuch"`
2
mode: "single"

File editor

HA hat einen eigenen File editor, also ein Programm, mit dem einzelne Dateien ausgesucht und angesehen oder verändert werden können. Der File editor ist ein Zusatzprogramm (Add on). und wird so installiert:

Über Einstellungen und Add-ons (rechts unten) zum

gehen,

suchen und zum Installieren anklicken. Alle angebotenen Optionen sind nützlich:

STARTEN nicht vergessen.

HA arbeitet sehr viel mit Konfigurationsdateien, in denen Geräte, Abläufe, Systemeinstellungen und mehr beschrieben und gespeichert werden. Die Beschreibungssprache ist YAML. Die Mutter aller Konfigurationen ist die Datei configuration.yaml. Wenn wir eine einzige neue Automation erstellen (was in der Praxis kaum vorkommen), könnten wir diese dort unter automation eintragen:

xxxxxxxxxx
4
1
automation:
2
  triggers: []
3
  conditions: []
4
  actions: []

Diese Automation (beginnend mit Zeile 1) ist eine Map mit dem Schlüssel automation, deren Wert wieder eine Map mit drei Einträgen (Zeilen 2 bis 4) ist. Die Werte der drei Einträge sind selbst leere Listen.

Wir hätten auch diesen Eintrag auch als Map mit einer Liste von Maps schreiben können:

xxxxxxxxxx
4
1
automation:
2
  - triggers: []
3
    conditions: []
4
    actions: []

• Hier beginnt in Zeile 1 wieder eine Map mit dem Schlüssel automation.

• Der zugehörige Wert ist eine Liste mit einem Element.

• Dieses Element ist eine Map mit drei Einträgen.

• Die Werte der drei Einträge sind leere Listen.

Die zweite Schreibweise erlaubt es, eine HA-Steuerung mit mehr als einer Automation zu schreiben — was ja wohl die Regel ist! Mehrere Automationen werden in die Map automation: als Liste von Maps eingetragen und üblicherweise durch id-Einträge von einander unterschieden:

xxxxxxxxxx
9
1
automation:
2
  - id: 1
3
    triggers: []
4
    conditions: []
5
    actions: []
6
  - id: 2
7
    triggers: []
8
    conditions: []
9
    actions: []

Die ids stehen hier als Beispiele. Noch einmal zum Verständnis:

• Zeile 1 bis 9 ist eine Map mit dem Schlüssel automation und dem Wert in den Zeilen 2 bis 9

• Die Zeilen 2 bis 9 sind eine Liste mit zwei Einträgen, nämlich Zeilen 2 bis 5 und Zeilen 6 bis 9.

• Die Zeilen 2 bis 5 enthalten eine Map mit vier Einträgen, ebenso die Zeilen 6 bis 9.

Allerdings würde bei vielen Automationen die configuration.yaml–Datei rasch unübersichtlich werden. Daher verwendet HA die Möglichkeit, eine YAML-Datei auf mehrere Dateien aufzuteilen und diese Teile mit !include in die gemeinsame Datei (hier: configuration.yaml) zusammenzuführen.

Die Datei configuration.yaml zeigt, wie das gelöst wird. Über File editor in der linken Seitenleiste und dann über das Verzeichnis-Symbol links oben

kommen wir zu einer Liste der Verzeichnisse und Dateien. Dort ist die zentrale Konfigurationsdatei configuration.yaml zu finden.

Anklicken zeigt im Editor eine große Datei. Das sind die ersten 10 Zeilen, die auch nicht verändert werden dürfen:

​x
1
# Loads default set of integrations. Do not remove.
2
default_config:
3

4
# Load frontend themes from the themes folder
5
frontend:
6
  themes: !include_dir_merge_named themes
7

8
automation: !include automations.yaml
9
script: !include scripts.yaml
10
scene: !include scenes.yaml

Alle Automationen werden hier in eine eigene Datei, automations.yaml, ausgelagert:

xxxxxxxxxx
1
1
automation: !include automations.yaml

Das vorherige Beispiel sieht nun in automations.yaml so aus:

xxxxxxxxxx
8
1
- id: 1
2
  triggers: []
3
  conditions: []
4
  actions: []
5
- id: 2
6
  triggers: []
7
  conditions: []
8
  actions: []

Was hat sich geändert?

• Der Schlüssel automation: fällt weg, da die Datei automations.yaml ja selbst nach automation: mit !include in die Datei configurations.yaml eingefügt wird.

• Alle Einträge in automations.yaml sind Listen von Maps und beginnen in Spalte 1.

xxxxxxxxxx
3
1
automation:
2
  - id: 1
3
    ...

xxxxxxxxxx
2
1
- id: 1
2
  ...

Der visuelle Editor und YAML

Wir erzeugen eine einfache Automation und schauen, wie dieselbe in YAML dargestellt wird.

Die Aufgabe:

• T1 ist ein Taster, L1 ist eine Lampe.

• T1 und L1 sind bereits angelernt.

• Wenn der Taster T1 einmal gedrückt wird, wird die Lampe L1 umgeschaltet.

Erstellen der Automation:

Einstellungen → Automationen & Szenen →  + AUTOMATION ERSTELLEN → Neue Automation erstellen →  +AUSLÖSER HINZUFÜGEN

Gerät und Auslöser auswählen:

• Obwohl Gerät erst an zweiter Stelle steht, zuerst Gerät auswählen: In unserem Fall T1.

• Dann erst Auslöser suchen. Wir wählen "single" action. Gemeint ist, dass die Taste nur einmal gedrückt wird.

  xxxxxxxxxx
  1
  1
  
  

Bei Und wenn wird keine Bedingung eingetragen, weiter bei Dann:

+ AKTION HINZUFÜGEN und alles so einstellen:

• Wieder wird zuerst das Gerät gewählt: L1

• Dann erst über Aktion auf Schalte L1 um einstellen.

Nicht vergessen: alles speichern (rechts unten, blau).

SPEICHERN

Die neue Automation bekommt beim Speichern einen Namen und eine Beschreibung:

Noch einmal SPEICHERN und dann ausprobieren: jedes Mal, wenn der Taster T1 gedrückt wird, schaltet die Lampe L1 um.

Außerdem erscheint im Visuellen Editor das Wort AUSGELÖST:

Die YAML-Version

Über das 3-Punkte-Menü ⋮ der neuen Automation (rechts neben L1 umschalten) den Eintrag In YAML bearbeiten wählen:

Automation zum Umschalten einer Lampe in YAML:

xxxxxxxxxx
15
1
alias: L1 umschalten
2
description: Bsp. 1, Version 1
3
triggers:
4
  - domain: mqtt
5
    device_id: 2a73abd2b10d069a70ddeb7b4e000a23
6
    type: action
7
    subtype: single
8
    trigger: device
9
conditions: []
10
actions:
11
  - type: toggle
12
    device_id: a1213e273962d1700c88b6c989213151
13
    entity_id: 73a8e2da66a719a3560fac4186c87958
14
    domain: light
15
mode: single

Erklärung

• Zeile 1: Der gewähle Name der Automation erscheint unter Alias. Die Automation hat intern eine (lange) Nummer bekommen, aber für den menschlichen Leser Namen besser. Ein Alias kann immer eingesetzt werden, wenn ein kürzerer oder treffenderer Name gewünscht wird.

• Zeile 2: Die Beschreibung landet unter – Überraschung! – description

• Dann kommen die drei Teile

  • triggers: Plural – es können ja auch mehrere sein, Zeile 3 bis 8

  • conditions: Zeile 9, eine leere Liste

  • actions: was zu tun ist, Zeile 10 bis 14.

• mode: das Verhalten beim mehrfachen Start der Automation.

triggers: Die Zeilen 3 bis 8 können so gelesen werden: Über die Komponente mqtt wird das Gerät mit der internen Nummer 2a73abd2b10d069a70ddeb7b4e000a23 abgefragt. Wird auf diesem Gerät die Aktion "Taste einmal drücken" ausgeführt, löst das die Automation aus.

actions: Die Zeilen 11 bis 15 bedeuten: das Gerät mit der internen Nummer a1213e273962d1700c88b6c989213151 ist eine Lampe (light) und hat eine Schaltfunktion mit der internen Nummer 73a8e2da66a719a3560fac4186c87958, mit der das Gerät umgeschaltet wird.

Wo sind die Bezeichnungen T1 und L1 hingekommen? Die YAML-Darstellung ist sehr nahe an den internen Steuerbefehlen und die arbeiten nun einmal mit Nummern.

ChatGPT

Es gibt viele Varianten, wie ein Problem gelöst werden kann. Kann ChatGPT einen Vorschlag machen?

Ich habe eine Lichtsteuerung (siehe YAML) mit Home Assistant erstellt und möchte sie so umstellen, dass beim Drücken des Tasters T1 das Licht in 2 Sekunden die volle Helligkeit erreicht und beim zweiten Tastendruck die Lampe L1 nach 6 Sekunden dunkel wird. Ohne Verwendung einer Hilfsvariablen.

Die Antwort von ChatGPT

Danke! Du hast eine einfache Toggle-Automation erstellt, die beim Drücken des Tasters T1 das Licht L1 umschaltet. Jetzt möchtest du sie erweitern:

🧭 Ziel

Beim Tastendruck:

• Wenn L1 aus → Licht in 2 Sekunden hochdimmen.

• Wenn L1 an → Licht in 6 Sekunden runterdimmen und dann ausschalten.

Ohne Hilfsvariable wie input_boolean.

✅ Angepasste Version deiner Automation

Hier ist dein YAML, erweitert um die gewünschte Logik:

xxxxxxxxxx
36
1
alias: L1 umschalten mit sanfter Dimmung
2
description: Schaltet Licht L1 mit sanftem An- und Ausschalten
3
trigger:
4
  - platform: device
5
    device_id: 2a73abd2b10d069a70ddeb7b4e000a23
6
    domain: mqtt
7
    type: action
8
    subtype: single
9
condition: []
10
action:
11
  - choose:
12
      - conditions:
13
          - condition: state
14
            entity_id: light.licht_l1
15
            state: 'off'
16
        sequence:
17
          - service: light.turn_on
18
            data:
19
              entity_id: light.licht_l1
20
              brightness: 255
21
              transition: 2
22
      - conditions:
23
          - condition: state
24
            entity_id: light.licht_l1
25
            state: 'on'
26
        sequence:
27
          - service: light.turn_on
28
            data:
29
              entity_id: light.licht_l1
30
              brightness: 1
31
              transition: 6
32
          - delay: "00:00:06"
33
          - service: light.turn_off
34
            data:
35
              entity_id: light.licht_l1
36
mode: single

🛠️ Was du ggf. anpassen musst:

Falls du dir unsicher bist, wie deine Entity-ID heißt: → Home Assistant UI → Einstellungen > Geräte & Dienste > Entitäten → suche nach L1.

Wenn du möchtest, kann ich auch die automations.yaml direkt umschreiben, wenn du mir die Originaldatei oder deinen Editor-Kontext schickst.

Den Vorschlag umsetzen

• Eine neue Automation erstellen:

• Auf den YAML-Editor umschalten

• Mit dem von ChatGPT gelieferten Code alles überschreiben

Ich habe dann noch die Zeile 1 und 2 geändert:

xxxxxxxxxx
2
1
alias: L1 dimmen
2
description: Bsp. 2 mit Dimmen

Die erste Lösung (Bsp. 1 - L1 umschalten) ausschalten:

Ausprobieren – und es funktioniert nicht.

ChatGPT hat darauf hingewiesen, dass die Entitäten der Lampe zu überprüfen sind. Entitäten sind hexadezimale eindeutige Nummern für jede Funktion jedes einzelnen Geräts (und auch von Programmen).

Den nächsten Hinweis hat ChatGPT auch gegeben. Unter Einstellungen → Geräte & Dienste sind Integrationen, Geräte, Entitäten und Helfer zu finden.

Und dann unter L1

und unter dem Zahnradsymbol die gesuchte Entität:

Jeder Eintrag light.licht_l1 ist durch light.l1 zu ersetzen. Jetzt klappt es!

Das ist die endgültige Automation:

xxxxxxxxxx
37
1
alias: L1 dimmen
2
description: Bsp. 2 mit Dimmen
3
triggers:
4
  - device_id: 2a73abd2b10d069a70ddeb7b4e000a23
5
    domain: mqtt
6
    type: action
7
    subtype: single
8
    trigger: device
9
conditions: []
10
actions:
11
  - choose:
12
      - conditions:
13
          - condition: state
14
            entity_id: light.l1
15
            state: "off"
16
        sequence:
17
          - data:
18
              entity_id: light.l1
19
              brightness: 255
20
              transition: 2
21
            action: light.turn_on
22
      - conditions:
23
          - condition: state
24
            entity_id: light.l1
25
            state: "on"
26
        sequence:
27
          - data:
28
              entity_id: light.l1
29
              brightness: 1
30
              transition: 6
31
            action: light.turn_on
32
          - delay: "00:00:06"
33
          - data:
34
              entity_id: light.l1
35
            action: light.turn_off
36
mode: single
37

Ergebnis

ChatGPT liefert dazu ein YAML-Programm, das alle gewünschten Funktionen erfüllt. Diese Anfrage an ChatGPT war recht erfolgreich, obwohl noch kleine Änderungen notwendig waren! Allerdings gibt es noch andere Aufgaben, in denen ChatGPT total versagt, zum Beispiel beim Erstellen eines ziemlich einfachen Schaltplans. Aber ChatGPT ist ja noch nicht einmal 3 Jahre alt – das kommt schon noch!

Skripte

Ein Skript kann mit einer Funktion – einem Unterprogramm – in einer höheren Programmiersprache verglichen werden.

Wir haben vorhin eine Automation erstellt, die eine bestimmte Lampe dimmt. Wäre doch nett, diese Idee auf verschiedene Lampen anwenden zu können, ohne jedes Mal eine komplette Automation schreiben zu müssen. Das kann mit einem Skript erreicht werden.

Probieren wir es gemeinsam aus.

Das letzte Beispiel weiter verwenden

Zuerst holen wir den YAML-Code des letzten Beispiels in die Zwischenablage:

Einstellungen → Automationen & Szenen → L1 dimmen

In der Überschriftszeile Lampe L1 ganz rechts das Drei-Punkt-Menü ⁝ aufrufen. Dann  In YAML bearbeiten .

Das komplette Programm erscheint im YAML-Editor. Links unten steht IN DIE ZWISCHENABLAGE KOPIEREN. Anklicken, fertig!

Erstellen des ersten Skripts

Zum Erstellen beginnen wir wieder mit dem Menüpunkt Einstellungen in der linken Seitenleiste. Dann kommtAutomation & Szenen und dann in der Kopfzeile auf Skripte umschalten:

Dann rechts unten + SKRIPT ERSTELLEN wählen.

Bei der Auswahl

auf Neues Skript erstellen klicken. Es erscheint:

Wir starten wieder über das Drei-Punkt-Menü und In YAML bearbeiten. Das neue Skript ist noch recht kurz und erwartet eine sequence.

Wir überschreiben alles ab Zeile 1 mit dem Code aus der Zwischenablage. Die triggers-Liste und die conditions-Liste werden entfernt. alias und description kommen in die Zeilen 1 und 2 und werden geändert.

Nun sieht das Skript so aus:

xxxxxxxxxx
30
1
alias: dimmen
2
description: Bsp. 3 Dimmen mit Skript
3
sequence: 
4
  - choose:
5
      - conditions:
6
          - condition: state
7
            entity_id: light.l1
8
            state: "off"
9
        sequence:
10
          - data:
11
              entity_id: light.l1
12
              brightness: 255
13
              transition: 2
14
            action: light.turn_on
15
      - conditions:
16
          - condition: state
17
            entity_id: light.l1
18
            state: "on"
19
        sequence:
20
          - data:
21
              entity_id: light.l1
22
              brightness: 1
23
              transition: 6
24
            action: light.turn_on
25
          - delay: "00:00:06"
26
          - data:
27
              entity_id: light.l1
28
            action: light.turn_off
29
mode: single
30

SKRIPT SPEICHERN . Name und Beschreibung stimmen schon:

!

Trotzdem auf UMBENENNEN klicken.

Um das Skript gleich zu erproben, wählen wir im rechten Seitenmenu aus dem Drei-Punkt-Menü Skript ausführen. Probieren wir es ein paar Mal hintereinander: die Lampe wird langsam hell und noch langsamer dunkel.

Das war ja recht erfolgreich, aber wie verwenden wir ein Skript in einer Automation? Dazu erzeugen wir eine Kopie von unserer ersten Automation und bauen dort das Skript ein:

Einstellungen → Automationen & Szenen

Lampe L1 umschalten suchen und im Drei-Punkt-Menü auf Duplizieren klicken,.

Rechts neben Neue Automation über das Drei-Punkt-Menü den YAML-Editor öffnen und die Automation bearbeiten.

Das YAML-Programm wird angepasst:

• triggers bleibt unverändert.

• conditions wird gelöscht.

• actions wird geändert auf action: script.dimmen.

SPEICHERN. Neuen Namen vergeben: L1 dimmen mit Skript

Nicht vergessen: die anderen Automationen abschalten!

Ein Skript für mehrere Lampen

Gelingt es nun, die Bezeichnung der Lampe zu ändern, dass ein Skript mehrere Lampen steuern kann? Ja – sonst wäre ein Skript kaum nützlich.

In höheren Programmiersprachen heißen diese Elemente Parameter, hier Variablen.

Allerdings sind größere Umbauten notwendig. Das Skript wird dupliziert und geändert:

xxxxxxxxxx
36
1
alias: dimmen2
2
description: Dimmen von mehreren Lampen
3

4
fields:
5
  lampe:
6
    description: Die zu steuernde Lampe
7
    example: light.l1
8
sequence:
9
  - choose:
10
      - conditions:
11
          - condition: template
12
            value_template: "{{ is_state(lampe, 'off') }}"
13
        sequence:
14
          - target:
15
              entity_id: "{{ lampe }}"
16
            data:
17
              brightness: 255
18
              transition: 2
19
            action: light.turn_on
20
      - conditions:
21
          - condition: template
22
            value_template: "{{ is_state(lampe, 'on') }}"
23
        sequence:
24
          - target:
25
              entity_id: "{{ lampe }}"
26
            data:
27
              brightness: 1
28
              transition: 6
29
            action: light.turn_on
30
          - delay: "00:00:06"
31
          - target:
32
              entity_id: "{{ lampe }}"
33
            action: light.turn_off
34
            data: {}
35
mode: single
36

Zu den Änderungen im Einzelnen:

Zeilen 1 und 2: Der Name des neuen Skripts und eine neue Beschreibung

Zeilen 4: Beginn der Vereinbarungen der Variablen (in höheren Programmiersprachen eine Liste der formalen Parameter)

Zeile 5: lampe – der Name des ersten (und hier auch einzigen) Parameters.

Zeilen 6 und 7: Eine optionale Beschreibung von lampe und ein möglicher Wert für lampe. Diese Erklärung wird beim Schreiben der Automation, die das Skript verwendet, eingeblendet.

Hier verwenden wir die lesbare Darstellung der entity_id: keine lange Folge von Hexadezimalziffern, sondern eine Entität aus der Gruppe der Lampen (light), und zwar die Lampe l1. Entitäten verwenden nur Kleinbuchstaben, Ziffern und das Unterstreichungszeichen.

Zeilen 9 bis 19: Große Änderungen!

• Zuerst wird in den Zeilen 10 bis 12 festgestellt, ob die Lampe abgedreht ist. Nur dann soll die sequence in den Zeilen 13 bis 19 ausgeführt werden.

• In der condition (Zeile 11) wird der Zustand der Lampe über ein template bestimmt. Die Zeile 12 zeigt, wie der Wert des Templates (value_template) ermittelt wird.

• Noch einmal im Detail: Zuerst wird festgestellt, dass die condition über ein template ausgewertet wird:

  • condition: template

  • Dann kommt die Formel, wie der Wert ausgerechnet wird:

  • value_template: "{{ is_state(lampe, 'off') }}".

  • is_state(lampe, 'off') bedeutet: ist der Zustand der Lampe gleich off, also ausgeschaltet, ist die Bedingung wahr (true).

  Es ist eine Bedingung: die Sequenz wird nur abgearbeitet, wenn die Bedingung wahr ist, also wenn die Lampe ausgeschaltet ist.

  Zeile 15 zeigt das schon besprochene Template "{{ lampe }}".

Die restlichen Zeilen von 13 bis 19 sind im Vergleich dazu harmlos.

• Eine Befehlsfolge (sequence) wird nun abgearbeitet (Beginn ist Zeile 13).

• Zeilen 14 und 15: Worauf wird die Befehlsfolge angewendet? Das Ziel (target) wird bestimmt. Da es erst zur Laufzeit bekannt ist, wird ein Template verwendet.

• Zeilen 17 und 18: Welche Zusatzinformationen bekommt das Ziel? Das Umschalten von dunkel auf hell soll 2 Sekunden dauern, transition: 2

• Zeile 19: Was soll geschehen? Das ist der eigentliche Befehl zum Aufdrehen der Lampe.

Die Zeilen 20 bis 29 beschreiben den Vorgang, wenn die Lampe bereits aufgedreht ist und abgedreht werden soll und entsprechen den Zeilen 10 bis 19. Warum steht hier light.turn_on? Als Ziel ist die Helligkeit 1 (brightness: 1) angegeben.

Damit die Lampe aber auf jeden Fall abgedreht ist, wird in den Zeilen 31 bis 34 nach 6 Sekunden die Lampe komplett abgeschaltet.

SKRIPT SPEICHERN, wenn erforderlich umbenennen:

Die zugehörige Automation

Wir duplizieren L1 Dimmen mit Skript und ändern die actions–Zeilen, der Rest bleibt unverändert.

xxxxxxxxxx
7
1
actions:
2
  - data:
3
      lampe: light.l1
4
    action: script.dimmen2
5
  - data:
6
      lampe: light.l2
7
    action: script.dimmen2

Na gut, die Zeilennummern (die automatisch erzeugt werden) beginnen wieder mit 1, aber es geht wirklich um die actions–Zeilen:

• Zeile 4: So sieht der Aufruf eines Skripts aus.

• Zeilen 2 und 3: so wird der aktuelle Parameter (auch Argument genannt) an das Skript übergeben.

• Zeile 1: Ja, das ist die Aktion, die abläuft, wenn die Automation gestartet wird.

• Zeile 5 bis 7: hier kommt eine zweite Lampe dazu.

• Ausschaltender anderen Automationen nicht vergessen.

• Ausprobieren!

Allerdings wird hier zuerst die Lampe L1 gedimmt und dann erst die Lampe L2. Das kann so gewünscht sein. Wenn nicht, ist eine weitere Änderung notwendig.

Paralleles Dimmen

ChatGPT hat mir ein neues Skript vorgeschlagen, das beliebig vielen Lampen parallel steuert:

xxxxxxxxxx
37
1
script:
2
  dim_lights_smooth:
3
    alias: Sanftes Licht An/Aus
4
    description: Dimmt übergebene Lampen sanft hoch oder runter, je nach aktuellem Zustand
5
    fields:
6
      lights:
7
        description: Liste der Licht-Entity-IDs
8
        example: ["light.l1", "light.l2", "light.l3"]
9
        required: true
10
    mode: parallel
11
    sequence:
12
      - choose:
13
          - conditions:
14
              - condition: state
15
                entity_id: "{{ lights[0] }}"
16
                state: 'off'
17
            sequence:
18
              - service: light.turn_on
19
                data:
20
                  entity_id: "{{ lights }}"
21
                  brightness: 255
22
                  transition: 2
23
          - conditions:
24
              - condition: state
25
                entity_id: "{{ lights[0] }}"
26
                state: 'on'
27
            sequence:
28
              - service: light.turn_on
29
                data:
30
                  entity_id: "{{ lights }}"
31
                  brightness: 1
32
                  transition: 6
33
              - delay: "00:00:06"
34
              - service: light.turn_off
35
                data:
36
                  entity_id: "{{ lights }}"
37

Wir erzeugen ein neues Skript, schalten auf die YAMP-Bearbeitung um und fügen den ChatGPT-Vorschlag ein.

Es ist doch schon bekannt, wie das geht? Bitte selbstständig probieren.

Probleme? Hier noch einmal der Ablauf:

Einstellungen → Automationen & Szenen → Reiter Skripte → + SKRIPT ERSTELLEN → Neues Skript erstellen → ⁝ → In YAML bearbeiten

Die Zeilen 1 und 2 lassen wir weg, weil die Datei ja schon als Skript angelegt worden ist.

Wir könnten auch lights durch lampen ersetzen, aber lassen wir es einmal so stehen.

ChatGPT ist nicht unfehlbar. Es waren noch ein paar Änderungen notwendig, die sich aber im Dialog geklärt haben. Das ist das endgültige Skript:

xxxxxxxxxx
33
1
alias: dimmen3
2
description: Dimmt übergebene Lampen sanft hoch oder runter, je nach aktuellem Zustand
3
fields:
4
  lights:
5
    description: Liste der Licht-Entity-IDs
6
    example: "[light.l1, light.l2, light.l3]"
7
    required: true
8
mode: parallel
9
sequence:
10
  - choose:
11
      - conditions:
12
          - condition: template
13
            value_template: "{{ states(lights[0]) == 'off' }}"
14
        sequence:
15
          - data:
16
              entity_id: "{{ lights }}"
17
              brightness: 255
18
              transition: 10
19
            action: light.turn_on
20
      - conditions:
21
          - condition: template
22
            value_template: "{{ states(lights[0]) == 'on' }}"
23
        sequence:
24
          - data:
25
              entity_id: "{{ lights }}"
26
              brightness: 1
27
              transition: 6
28
            action: light.turn_on
29
          - delay: "00:00:06"
30
          - data:
31
              entity_id: "{{ lights }}"
32
            action: light.turn_off
33

Wie wird das neue Skript verwendet? Wir duplizieren die Automation Mehrere Lampen nacheinander dimmen:

Einstellungen → Automation & Szenen → Mehrere Lampen nacheinander dimmen →Drei-Punkte-Menü ⁝ → Duplizieren →  ⁝ → In YAML bearbeiten

Wir ändern die Zeile 2 auf description: Bsp. 5, mehrerer Lampen nacheinander dimmen description

Die actions (Zeilen 10 bis 16) werden zu:

xxxxxxxxxx
6
1
actions:
2
  - action: script.dimmen3
3
    data:
4
      lights:
5
        - light.l1
6
        - light.l2

Bitte die Zeilennummern wieder ignorieren.

Als Bsp 5, paralleles Dimmen mehrerer Lampen speichern.

SPEICHERN

Zusammenfassung

Das war eine sehr detaillierte Erklärung, wie ein Skript entsteht und wie es verwendet wird.

Z2H und ZHA

ZigBee-Netzwerke sind in der Home Automation sehr verbreitet. Mit Zigbee2MQTT (Z2M) oder Zigbee Home Automation (ZHA) kann ZigBee im Home Assistant verwendet werden.

Z2M ist ein externes Programm, das in mehreren Schritten installiert werden muss. ZHA ist ein Add-On zu Home Assistant und wird über einen Link installiert.

Bei ZHA wird unter Sobald statt single press der Auslöser Erste Taste kurz drücken gewählt.

In ZHA sieht die YAML-Konfiguration des vorherigen Beispiels so aus:

xxxxxxxxxx
15
1
alias: Lampe L1 umschalten
2
description: Erstes Beispiel zur Lampensteuerung
3
triggers:
4
  - device_id: 297b39892ff9a6bcd27cfdb5f46d69f5
5
    domain: zha
6
    type: remote_button_short_press
7
    subtype: button_1
8
    trigger: device
9
conditions: []
10
actions:
11
  - type: toggle
12
    device_id: 7c96f1e7727aa6c4be2d76c0269feb6b
13
    entity_id: 70ab137e9e0cda64b00f8cb8231f094c
14
    domain: light
15
mode: single

Bausteine

HA bietet nach Einstellungen → Automation & Szenen → Skripte → + SKRIPT ERSTELLEN → Neues Skript erstellen auch an, Bausteine hinzuzufügen. Aber was sind Bausteine? Probieren wir es aus:

+ BAUSTEIN HINZUFÜGEN

Home Assistant bietet viele Bausteine an. Durch scrollen werden noch mehr sichtbar:

Einige dieser Bausteine sind schon von den Automationen bekannt:

• Auf einen Auslöser warten entspricht dem Sobald-Schritt in Automationen.

• Bedingung funktioniert wie bei den Automationen: wird sie nicht erfüllt, endet der Ablauf.

Weitere Bausteine:

Eine Zeit warten (Verzögerung) erklärt sich wohl selbst. Zeiten können in Stunden, Minuten, Sekunden und Millisekunden angegeben werden.

Ein interessantes Thema! Aber das passt besser in einen kommenden Clubabend oder Beitrag.

Das alles wurde beim Clubabend am 25. Mai 2025 besprochen und geübt – wer will, kann gerne bei den nächsten Terminen auch dazu kommen. Dieser Text geht aber bei ein paar Punkten noch mehr ins Detail.

Zu den Downloads und zur Langversion

Alle Zusatzinformationen (anklickbare Links, Downloads us.) sind in der Langversion zu finden.

Link und QR-Code: https://pcnews.at/markdown/index.html

Erstellt mit QR Code Generator – kostenfrei, ohne Login, ohne Konto: https://goqr.me/. Short URL erstellt mit https://t.ly/.

Copyright