So arbeitet die Automation
Das Ziel: Du betrittst die Treppe von unten oder von oben, das Licht geht sofort an. Nachts leuchtet es nur gedimmt. Hat keiner der beiden Melder mehr Bewegung gemeldet und ist eine einstellbare Nachlaufzeit vorbei, geht es aus. Kommt in der Zwischenzeit jemand, bleibt es an.
Vorbild für den Ablauf ist der offizielle Blueprint „Motion-activated Light“ aus dem Quellcode von Home Assistant (Apache-Lizenz 2.0): Licht an bei Bewegung, warten bis keine Bewegung mehr gemeldet wird, Wartezeit, Licht aus. Er nimmt allerdings nur einen Melder und kennt keinen Nachtmodus. Die Konfiguration unten ist deshalb selbst geschrieben und erweitert den Ablauf um drei Bausteine:
- Eine Gruppe aus beiden Meldern. Sie meldet Bewegung, solange mindestens einer der beiden Melder Bewegung sieht.
- Einen Timer-Helfer für die Nachlaufzeit. Er startet, wenn die Gruppe frei meldet, und behält seine Restzeit auch über einen Neustart.
- Eine Automation mit drei Auslösern. Bewegung, frei und Timer abgelaufen steuern je einen eigenen Zweig.
Das brauchst du
- Home Assistant, das dauerhaft auf einem Gerät im Haus läuft.
- Zwei Bewegungsmelder, einer am Fuß und einer am Kopf der Treppe. Welche Funktechnik sie nutzen, ist egal, solange Home Assistant sie als Binärsensor mit der Geräteklasse „motion“ (Bewegung) einbindet. Für Zigbee-Melder brauchst du ein Zigbee-Gateway oder einen Funkstick.
- Ein dimmbares Licht an der Treppe, das Home Assistant als Licht-Entität kennt: ein LED-Streifen mit Smart-Controller, eine smarte Leuchte, eine Leuchtengruppe oder ein WLED-Controller.
- Zugang zur Datei configuration.yaml, falls du die Helfer per YAML statt in der Oberfläche anlegen willst.
Wo die Melder sitzen, entscheidet über den Erfolg: Sie sollen dich erfassen, bevor du die erste Stufe betrittst.
Mehr zu Montagehöhe, Erfassungswinkel und Fehlauslösungen steht auf der Seite Treppenbeleuchtung mit Bewegungsmelder.
Schritt 1: Melder und Licht einbinden
Binde beide Melder und das Licht wie gewohnt über ihre Integration ein. Notiere dir danach die Entitäts-IDs, du findest sie unter Einstellungen, Geräte & Dienste, Entitäten. In dieser Anleitung heißen sie:
- binary_sensor.treppe_bewegung_unten und binary_sensor.treppe_bewegung_oben für die Melder
- light.treppe für das Licht
Nutzt du WLED, legt die WLED-Integration laut Doku ein Hauptlicht für den ganzen Streifen an und bei zwei oder mehr Segmenten zusätzlich je Segment eine eigene Licht-Entität. Für diese Automation nimmst du das Hauptlicht.
Schritt 2: Melder zu einer Gruppe zusammenfassen
Lege unter Einstellungen, Geräte & Dienste, Helfer einen neuen Helfer vom Typ Gruppe an, wähle Binärsensor-Gruppe und füge beide Melder hinzu. Die Option „Alle Entitäten“ bleibt aus. Nur dann ist die Gruppe laut Doku eingeschaltet, sobald mindestens ein Mitglied Bewegung meldet.
Wer lieber mit YAML arbeitet, trägt die Gruppe und den Timer aus Schritt 3 in die configuration.yaml ein. Gibt es dort schon einen Abschnitt binary_sensor oder timer, ergänzt du die Einträge dort, statt einen zweiten Abschnitt anzulegen.
# configuration.yaml: Gruppe aus beiden Meldern und Timer für die Nachlaufzeit
binary_sensor:
- platform: group
name: "Treppe Bewegung"
unique_id: treppe_bewegung_gruppe
device_class: motion
entities:
- binary_sensor.treppe_bewegung_unten
- binary_sensor.treppe_bewegung_oben
timer:
treppe_nachlauf:
name: "Treppe Nachlauf"
duration: "00:01:30"
restore: true
Die Gruppe erscheint danach als binary_sensor.treppe_bewegung, der Timer als timer.treppe_nachlauf. Prüfe die IDs nach dem Neustart in der Entitätenliste.
Schritt 3: Timer für die Nachlaufzeit anlegen
Legst du den Timer in der Oberfläche an, wählst du unter Helfer den Typ Timer, gibst ihm den Namen „Treppe Nachlauf“, stellst die Dauer auf 1 Minute 30 Sekunden und schaltest die Option zum Wiederherstellen nach einem Neustart ein. In YAML entspricht das dem Eintrag restore: true aus dem Block oben.
Warum ein Timer? Die Doku zu den Automationsmodi sagt es deutlich: Startet Home Assistant neu, etwa für ein Update, enden alle laufenden Durchläufe, und eine Wartezeit, die gerade lief, ist verloren. Ein Timer-Helfer behält dagegen seine Restzeit. Die Dauer von 90 Sekunden ist ein Startwert, keine Empfehlung aus einer Norm. Pass sie an, wenn die Treppe lang ist oder jemand regelmäßig etwas trägt.
Schritt 4: Die Automation einfügen
Lege unter Einstellungen, Automationen & Szenen eine neue Automation an, öffne oben rechts das Menü und wähle „In YAML bearbeiten“. Ersetze den Inhalt durch den folgenden Block und speichere.
alias: "Treppenlicht mit Nachtmodus"
description: "Bewegung oben oder unten schaltet das Licht ein, nachts gedimmt. Der Timer schaltet es wieder aus."
mode: queued
triggers:
- trigger: state
entity_id: binary_sensor.treppe_bewegung
from: "off"
to: "on"
id: bewegung
- trigger: state
entity_id: binary_sensor.treppe_bewegung
from: "on"
to: "off"
id: frei
- trigger: timer.finished
target:
entity_id: timer.treppe_nachlauf
id: nachlauf_abgelaufen
actions:
- choose:
- conditions:
- condition: trigger
id: bewegung
sequence:
- action: timer.cancel
target:
entity_id: timer.treppe_nachlauf
- choose:
- conditions:
- condition: time
after: "22:00:00"
before: "06:00:00"
sequence:
- action: light.turn_on
target:
entity_id: light.treppe
data:
brightness_pct: 15
transition: 1
default:
- action: light.turn_on
target:
entity_id: light.treppe
data:
brightness_pct: 80
transition: 1
- conditions:
- condition: trigger
id: frei
sequence:
- action: timer.start
target:
entity_id: timer.treppe_nachlauf
- conditions:
- condition: trigger
id: nachlauf_abgelaufen
- condition: state
entity_id: binary_sensor.treppe_bewegung
state: "off"
sequence:
- action: light.turn_off
target:
entity_id: light.treppe
data:
transition: 2
So liest sich der Block:
- Drei Auslöser mit eigener ID: Die Gruppe wechselt auf Bewegung (bewegung), die Gruppe wird frei (frei), der Timer ist abgelaufen (nachlauf_abgelaufen). Die Bedingung „Triggered by“ (in YAML condition: trigger) wählt den passenden Zweig.
- Bewegung: Ein laufender Timer wird abgebrochen. Laut Doku feuert ein abgebrochener Timer kein „finished“, das Licht bleibt also an. Danach geht das Licht an, zwischen 22 und 6 Uhr mit 15 Prozent, sonst mit 80 Prozent.
- Frei: Der Timer startet. Läuft er schon, beginnt er laut Doku von vorn.
- Timer abgelaufen: Zur Sicherheit prüft die Automation noch einmal, ob die Gruppe frei ist, und dimmt das Licht in zwei Sekunden aus.
- Modus queued: Kommen Ereignisse kurz hintereinander, arbeitet die Automation sie der Reihe nach ab, statt eines zu verwerfen.
Willst du die Automation direkt in die Datei automations.yaml schreiben, braucht sie dort laut Doku eine eigene id und steht als Listeneintrag mit einem Strich davor. Über die Oberfläche erledigt Home Assistant das selbst.
Nachtmodus: Uhrzeit oder Sonnenstand
Im Beispiel gilt der Nachtmodus von 22 bis 6 Uhr. Die Zeitbedingung darf laut Doku über Mitternacht reichen: Ist „before“ früher als „after“, gilt das Fenster für die Nacht. Uhrzeiten und Helligkeiten änderst du direkt in den Zeilen after, before und brightness_pct.
Soll sich der Nachtmodus nach dem Tageslicht richten, ersetzt du die Bedingung condition: time samt den Zeilen after und before durch diese eine Zeile:
- condition: sun.is_set
Sie ist laut Doku erfüllt, solange die Sonne unter dem Horizont steht, also von Sonnenuntergang bis Sonnenaufgang. Dann leuchtet die Treppe auch am frühen Abend gedimmt. Wer abends volles und erst spät gedimmtes Licht möchte, bleibt bei der Uhrzeit.
Testen und anpassen
- Geh einmal von unten nach oben und einmal von oben nach unten. Das Licht muss beim ersten Schritt brennen.
- Bleib oben stehen, bis der untere Melder frei meldet. Das Licht muss anbleiben, solange der obere dich sieht.
- Schau dir in der Automation die Ablaufverfolgung (Trace) an. Dort siehst du, welcher Auslöser welchen Zweig gestartet hat.
- Stell die Nachlaufzeit am Timer-Helfer ein, bis sie passt. Die Automation musst du dafür nicht ändern.
Brauchst du die Zeit kürzer oder länger nur für einzelne Fälle, kann timer.start laut Doku auch eine eigene Dauer mitbringen. Für die meisten Treppen reicht ein fester Wert.
Häufige Fehler
- Zwei Automationen, je eine pro Melder. Sie schalten gegeneinander. Die Gruppe löst das.
- Gruppe mit „Alle Entitäten“. Dann meldet sie nur Bewegung, wenn beide Melder gleichzeitig etwas sehen, also fast nie.
- Platzhalter nicht ersetzt. Stimmen die Entitäts-IDs nicht, zeigt der Editor einen Fehler oder die Automation tut nichts.
- Alte und neue Schlüssel gemischt. Ältere Beispiele schreiben trigger, condition und action auf oberster Ebene, heute heißen sie triggers, conditions und actions. Laut Doku darf eine Automation nicht beide Formen an derselben Stelle haben.
- Haltezeit des Melders übersehen. Viele Melder melden „keine Bewegung“ erst nach einer eigenen Haltezeit. Die Nachlaufzeit des Timers kommt dazu. Wirkt das Licht zu lange an, prüfe zuerst die Einstellung am Melder.
- Leuchte nicht dimmbar. Dann entfallen brightness_pct und transition; ein Nachtmodus mit wenig Licht braucht eine dimmbare Leuchte.
- Timer läuft ab, während Home Assistant aus ist. Laut Doku feuert „Timer finished“ nach dem Start dann nicht nachträglich. Das Licht bleibt an, bis die nächste Bewegung den Ablauf neu startet.
Welche anderen Wege es für smarte Treppenbeleuchtung gibt, zeigt die Übersicht Smart Home an der Treppe. Ein Lauflicht, das im Controller selbst läuft und sich trotzdem in Home Assistant einbinden lässt, beschreibt die Anleitung Lauflicht mit WLED und ESP32. Was zu deiner Treppe passt, ermittelt der Treppenlicht-Planer.
Häufige Fragen
- Warum eine Gruppe statt zwei Automationen, je eine pro Melder?
- Zwei getrennte Automationen arbeiten gegeneinander: Meldet der untere Melder frei, während der obere dich noch sieht, schaltet die eine Automation das Licht aus. Eine Binärsensor-Gruppe ist laut Home-Assistant-Doku eingeschaltet, solange mindestens ein Mitglied eingeschaltet ist. So gilt die Treppe erst als frei, wenn beide Melder frei sind.
- Warum ein Timer-Helfer statt einer Wartezeit in der Automation?
- Startet Home Assistant neu, gehen laut Doku alle laufenden Wartezeiten einer Automation verloren, das Licht bliebe an. Ein Timer mit der Option zum Wiederherstellen behält seine Restzeit über den Neustart. Außerdem kannst du die Nachlaufzeit am Helfer ändern, ohne die Automation anzufassen.
- Kann ich den fertigen Blueprint Motion-activated Light nehmen?
- Für eine Treppe nur mit Umweg: Der offizielle Blueprint nimmt genau einen Bewegungsmelder. Wählst du dort die Gruppe aus beiden Meldern aus, klappt das Ein- und Ausschalten. Einen Nachtmodus mit gedimmter Helligkeit hat der Blueprint nicht, dafür ist die Automation auf dieser Seite gedacht.
- Funktioniert das mit jeder Leuchte?
- Einschalten und Ausschalten ja, sobald die Leuchte in Home Assistant als Licht-Entität erscheint. Für den Nachtmodus mit gedimmter Helligkeit muss sie dimmbar sein. Eine Leuchte, die nur an und aus kann, schaltest du ohne die Zeilen mit brightness_pct.
- Lässt sich damit auch ein Lauflicht Stufe für Stufe bauen?
- Nur, wenn jede Stufe ein eigenes Licht ist, zum Beispiel ein WLED-Segment, und eine Automation die Stufen nacheinander schaltet. Einfacher ist ein Lauflicht, das im Controller selbst läuft, etwa WLED mit dem Usermod Animated Staircase.