← All guides

Smart home / demonstration

Building directional staircase lighting with WLED

A demonstration design note for modelling direction, timing and safe fallback behaviour.

Demonstration guide — commands and outcomes are illustrative. Review before use.

Model the behaviour first

Directional lighting needs more than two motion triggers. Define how the system handles simultaneous detection, retriggering, occupancy timeout, controller unavailability and manual control.

idle -> entry detected -> directional effect -> occupied -> clear delay -> off

Note: This is a presentation example, not configuration copied from a live home. Pin mappings, addresses and entity identifiers are intentionally absent.

Keep responsibilities clear

Let sensors report observations, the automation own state transitions, and WLED render the requested effect. Avoid splitting timing decisions across all three layers.

Failure handling

Expected output: Walking in either direction produces the matching effect, while two near-simultaneous triggers resolve predictably and the lights still clear.

Publish safely

Use abstract diagrams and rewritten examples. Review all screenshots, traces and snippets for private entity names, network details and location information.