| name | loxone-patterns |
| description | Reference patterns for Loxone automation. Threshold, AND/OR logic, timers, schedules, presence, irrigation, blinds, HVAC. Use as recipe book. |
| license | AGPL-3.0 |
| metadata | {"author":"eisber","version":"1.0"} |
| user-invocable | false |
Loxone Automation Patterns
Recipe book of common automation patterns. Each pattern includes when to use it, which blocks are needed, copy-paste CLI commands, and a simulator test spec.
Replace config.Loxone with your actual config file path.
1. Threshold
When: Trigger an action when a sensor value crosses a limit (temperature, humidity, brightness, wind speed, CO2, etc.)
Blocks: GreaterEqual (≥) or Less (<) or Greater (>)
Circuit: Sensor.AQ → Comparison.Input1 | set Input2=threshold | Comparison.Q → Actuator
lox config add --type GreaterEqual --title "Temp über 25" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Temp über 25" Input2 25
lox config wire-connector config.Loxone "Temp über 25.Input1" "Außentemperatur.AQ"
lox config wire-connector config.Loxone "Jalousie 1 [Wohnzimmer].InputTriggerDown" "Temp über 25.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"above threshold","inputs":{"Außentemperatur.AQ":30},"ticks":10,"dt":0.1,"expected_outputs":{"Temp über 25.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"below threshold","inputs":{"Außentemperatur.AQ":20},"ticks":10,"dt":0.1,"expected_outputs":{"Temp über 25.Q":{"==":0}}}'
2. Combined Condition (AND/OR)
When: Multiple conditions must be true simultaneously (AND) or any one suffices (OR).
Blocks: And or Or + comparison blocks as needed
Circuit: ConditionA.Q → And.I1, ConditionB.Q → And.I2, And.Q → Actuator
lox config add --type GreaterEqual --title "Temp über 20" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Temp über 20" Input2 20
lox config wire-connector config.Loxone "Temp über 20.Input1" "Außentemperatur.AQ"
lox config add --type And --title "Sonne und Warm" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config wire-connector config.Loxone "Sonne und Warm.I1" "Sonnenschein.AQ"
lox config wire-connector config.Loxone "Sonne und Warm.I2" "Temp über 20.Q"
lox config wire-connector config.Loxone "Jalousie 1 [Wohnzimmer].InputTriggerDown" "Sonne und Warm.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"both true","inputs":{"Außentemperatur.AQ":25,"Sonnenschein.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Sonne und Warm.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"only one true","inputs":{"Außentemperatur.AQ":15,"Sonnenschein.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Sonne und Warm.Q":{"==":0}}}'
3. Timed Switch (Stairway Light)
When: Turn something on for a fixed duration after a trigger pulse (light on for 5 minutes after motion).
Blocks: StairwayLS
Key param: TimeHigh = duration in seconds
Circuit: Trigger.Q → StairwayLS.InputTrigger | set TimeHigh=seconds | StairwayLS.Q → Actuator
lox config add --type StairwayLS --title "Treppenlicht" --room Flur --page Flur config.Loxone
lox config set-param config.Loxone "Treppenlicht" TimeHigh 300
lox config wire-connector config.Loxone "Treppenlicht.InputTrigger" "Bewegungsmelder.OutputPresence"
lox config wire-connector config.Loxone "Lichtsteuerung [Flur].I1" "Treppenlicht.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"motion triggers","inputs":{"Bewegungsmelder.OutputPresence":1},"ticks":10,"dt":0.1,"expected_outputs":{"Treppenlicht.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"no motion","inputs":{"Bewegungsmelder.OutputPresence":0},"ticks":10,"dt":0.1,"expected_outputs":{"Treppenlicht.Q":{"==":0}}}'
⚠️ Do NOT use OnPulseDelay for this: OnPulseDelay has a delay before the pulse starts. StairwayLS turns on immediately.
4. Delayed Action
When: Wait before activating something, then run for a duration (e.g. wait 10s, then pump for 30s).
Blocks: OnPulseDelay
Key params: Delay = wait time in seconds, Duration = pulse length in seconds
Circuit: Trigger.Q → OnPulseDelay.InputTrigger | set Delay + Duration | OnPulseDelay.Q → Actuator
lox config add --type OnPulseDelay --title "Verzögerte Pumpe" --room Garten --page Garten config.Loxone
lox config set-param config.Loxone "Verzögerte Pumpe" Delay 10
lox config set-param config.Loxone "Verzögerte Pumpe" Duration 30
lox config wire-connector config.Loxone "Verzögerte Pumpe.InputTrigger" "Schalter 1.Q"
lox config wire-connector config.Loxone "Poolpumpe.I1" "Verzögerte Pumpe.Q"
5. Schedule (DayTimer)
When: Time-based automation — activate during specific hours (night dimming, irrigation windows, quiet hours).
Blocks: DayTimer + optionally Mult for value scaling
Circuit: DayTimer.AQ → Mult.Input1 | set Mult.Input2=factor | Mult.AQ → Actuator
lox config add --type DayTimer --title "Nachtmodus" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config timer-schedule config.Loxone "Nachtmodus" "22:00-06:00" --value 30
lox config add --type Mult --title "Nacht Dimmer" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config wire-connector config.Loxone "Nacht Dimmer.Input1" "Nachtmodus.AQ"
lox config wire-connector config.Loxone "Lichtsteuerung [Wohnzimmer].Brightness" "Nacht Dimmer.AQ"
Note: Overnight ranges like "22:00-06:00" are handled correctly — they wrap across midnight.
6. Negation (NOT gate)
When: Invert a condition — do something when a sensor is NOT active (irrigate when NOT raining, open blinds when NOT sunny).
Blocks: Not, often combined with And
Circuit: Sensor.Q → Not.I | Not.Q → And.I1 (combine with other conditions)
lox config add --type Not --title "Kein Regen" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Kein Regen.I" "Regen.AQ"
Sim test:
lox sim run config.Loxone --sim '{"name":"raining","inputs":{"Regen.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Kein Regen.Q":{"==":0}}}'
lox sim run config.Loxone --sim '{"name":"dry","inputs":{"Regen.AQ":0},"ticks":10,"dt":0.1,"expected_outputs":{"Kein Regen.Q":{">":0.5}}}'
7. Memory / Latch
When: Remember a state — set with one button, reset with another (alarm armed/disarmed, mode toggle, irrigation started/stopped).
Blocks: Memory
Key inputs: S (set → Q=1), R (reset → Q=0)
Circuit: SetTrigger → Memory.S, ResetTrigger → Memory.R, Memory.Q → Actuator
lox config add --type Memory --title "Bewässerung Merker" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Bewässerung Merker.S" "Schalter 1.Q"
lox config wire-connector config.Loxone "Bewässerung Merker.R" "Regen.AQ"
Sim test:
lox sim run config.Loxone --sim '{"name":"set","inputs":{"Schalter 1.Q":1,"Regen.AQ":0},"ticks":10,"dt":0.1,"expected_outputs":{"Bewässerung Merker.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"reset by rain","inputs":{"Schalter 1.Q":0,"Regen.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Bewässerung Merker.Q":{"==":0}}}'
8. Frost Protection
When: Protect blinds/shutters from freezing by raising them when temperature drops below 0°C.
Blocks: Less
Circuit: Außentemperatur.AQ → Less.Input1 | set Input2=0 | Less.Q → Jalousie.InputTriggerUp
lox config add --type Less --title "Frostschutz" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Frostschutz" Input2 0
lox config wire-connector config.Loxone "Frostschutz.Input1" "Außentemperatur.AQ"
lox config wire-connector config.Loxone "Jalousie 1 [Wohnzimmer].InputTriggerUp" "Frostschutz.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"freezing","inputs":{"Außentemperatur.AQ":-5},"ticks":10,"dt":0.1,"expected_outputs":{"Frostschutz.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"warm","inputs":{"Außentemperatur.AQ":10},"ticks":10,"dt":0.1,"expected_outputs":{"Frostschutz.Q":{"==":0}}}'
9. Wind Protection
When: Retract all blinds when wind exceeds a safety threshold (e.g. 40 km/h).
Blocks: GreaterEqual
Circuit: Windgeschwindigkeit.AQ → GreaterEqual.Input1 | set Input2=40 | Q → Jalousie.InputTriggerUp
lox config add --type GreaterEqual --title "Windschutz" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Windschutz" Input2 40
lox config wire-connector config.Loxone "Windschutz.Input1" "Windgeschwindigkeit.AQ"
lox config wire-connector config.Loxone "Jalousie 1 [Wohnzimmer].InputTriggerUp" "Windschutz.Q"
lox config wire-connector config.Loxone "Jalousie 2 [Wohnzimmer].InputTriggerUp" "Windschutz.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"strong wind","inputs":{"Windgeschwindigkeit.AQ":50},"ticks":10,"dt":0.1,"expected_outputs":{"Windschutz.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"calm","inputs":{"Windgeschwindigkeit.AQ":10},"ticks":10,"dt":0.1,"expected_outputs":{"Windschutz.Q":{"==":0}}}'
10. Irrigation (Moisture + Rain Guard)
When: Water plants when soil moisture is low AND it's not raining.
Blocks: Less + Not + And
Circuit: Moisture → Less (< threshold) → And.I1, Rain → Not → And.I2, And.Q → Valve
lox config add --type Less --title "Boden trocken" --room Garten --page Garten config.Loxone
lox config set-param config.Loxone "Boden trocken" Input2 30
lox config wire-connector config.Loxone "Boden trocken.Input1" "Bodenfeuchtigkeit.AQ"
lox config add --type Not --title "Kein Regen" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Kein Regen.I" "Regen.AQ"
lox config add --type And --title "Bewässerung nötig" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Bewässerung nötig.I1" "Boden trocken.Q"
lox config wire-connector config.Loxone "Bewässerung nötig.I2" "Kein Regen.Q"
lox config wire-connector config.Loxone "Bewässerungsventil.I1" "Bewässerung nötig.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"dry no rain","inputs":{"Bodenfeuchtigkeit.AQ":20,"Regen.AQ":0},"ticks":10,"dt":0.1,"expected_outputs":{"Bewässerung nötig.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"dry but raining","inputs":{"Bodenfeuchtigkeit.AQ":20,"Regen.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Bewässerung nötig.Q":{"==":0}}}'
lox sim run config.Loxone --sim '{"name":"moist","inputs":{"Bodenfeuchtigkeit.AQ":50,"Regen.AQ":0},"ticks":10,"dt":0.1,"expected_outputs":{"Bewässerung nötig.Q":{"==":0}}}'
11. CO2 Ventilation
When: Activate ventilation when CO2 exceeds a healthy level (e.g. 1000 ppm).
Blocks: GreaterEqual
Circuit: CO2.AQ → GreaterEqual.Input1 | set Input2=1000 | Q → Fan.I1
lox config add --type GreaterEqual --title "CO2 zu hoch" --room Bad --page Bad config.Loxone
lox config set-param config.Loxone "CO2 zu hoch" Input2 1000
lox config wire-connector config.Loxone "CO2 zu hoch.Input1" "CO2 Sensor.AQ"
lox config wire-connector config.Loxone "Lüfter Bad.I1" "CO2 zu hoch.Q"
Sim test:
lox sim run config.Loxone --sim '{"name":"high co2","inputs":{"CO2 Sensor.AQ":1200},"ticks":10,"dt":0.1,"expected_outputs":{"CO2 zu hoch.Q":{">":0.5}}}'
lox sim run config.Loxone --sim '{"name":"normal co2","inputs":{"CO2 Sensor.AQ":600},"ticks":10,"dt":0.1,"expected_outputs":{"CO2 zu hoch.Q":{"==":0}}}'
12. Humidity-Based Ventilation
When: Activate bathroom fan when humidity exceeds 65%.
Blocks: GreaterEqual + optionally StairwayLS for minimum run time
Circuit: Humidity → GreaterEqual.Input1 | set Input2=65 | Q → StairwayLS (optional) → Fan
lox config add --type GreaterEqual --title "Hohe Feuchte" --room Bad --page Bad config.Loxone
lox config set-param config.Loxone "Hohe Feuchte" Input2 65
lox config wire-connector config.Loxone "Hohe Feuchte.Input1" "Luftfeuchtigkeit.AQ"
lox config add --type StairwayLS --title "Lüfter Nachlauf" --room Bad --page Bad config.Loxone
lox config set-param config.Loxone "Lüfter Nachlauf" TimeHigh 600
lox config wire-connector config.Loxone "Lüfter Nachlauf.InputTrigger" "Hohe Feuchte.Q"
lox config wire-connector config.Loxone "Lüfter Bad.I1" "Lüfter Nachlauf.Q"
13. Pool Temperature Guard
When: Run pool pump only when water temperature is within a safe/desired range.
Blocks: GreaterEqual + Less + And
Circuit: Temp ≥ min AND Temp < max → Pump
lox config add --type GreaterEqual --title "Pool warm genug" --room Garten --page Garten config.Loxone
lox config set-param config.Loxone "Pool warm genug" Input2 18
lox config wire-connector config.Loxone "Pool warm genug.Input1" "Pool Temperatur.AQ"
lox config add --type Less --title "Pool nicht zu heiß" --room Garten --page Garten config.Loxone
lox config set-param config.Loxone "Pool nicht zu heiß" Input2 32
lox config wire-connector config.Loxone "Pool nicht zu heiß.Input1" "Pool Temperatur.AQ"
lox config add --type And --title "Pool Temp OK" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Pool Temp OK.I1" "Pool warm genug.Q"
lox config wire-connector config.Loxone "Pool Temp OK.I2" "Pool nicht zu heiß.Q"
lox config wire-connector config.Loxone "Poolpumpe.I1" "Pool Temp OK.Q"
14. Touch Nightlight Air — dim/off at night
When: Bring a newly-added Touch Nightlight Air (device-bound AlarmClock) in line with its
siblings — the display nightlight should dim (or go off) during night hours and return to normal
during the day. This mirrors the factory wiring of the existing devices.
Blocks: device-bound AlarmClock + the day-gating chain Time → GreaterEqual/Less → And → Mult
Circuit: a time-of-day source gates a day window (≥ start AND < end); the AND result scales a
brightness via Mult, whose output drives the AlarmClock's BrightInact (display brightness while
inactive). Bind the AlarmClock to the physical device with --device so it emits Dev=.
lox config add --type alarm-clock --title "DG Nachtlicht" --device "Touch Nightlight Air" config.Loxone
lox config add --type Hour --title "Stunde" --page NachtPage config.Loxone
lox config add --type GreaterEqual --title "Ab 7 Uhr" --page NachtPage config.Loxone
lox config set-param config.Loxone "Ab 7 Uhr" Input2 7
lox config wire-connector config.Loxone "Ab 7 Uhr.Input1" "Stunde.AQ"
lox config add --type Less --title "Vor 22 Uhr" --page NachtPage config.Loxone
lox config set-param config.Loxone "Vor 22 Uhr" Input2 22
lox config wire-connector config.Loxone "Vor 22 Uhr.Input1" "Stunde.AQ"
lox config add --type And --title "Tagfenster" --page NachtPage config.Loxone
lox config wire-connector config.Loxone "Tagfenster.I1" "Ab 7 Uhr.Q"
lox config wire-connector config.Loxone "Tagfenster.I2" "Vor 22 Uhr.Q"
lox config add --type Mult --title "Display Helligkeit" --page NachtPage config.Loxone
lox config set-param config.Loxone "Display Helligkeit" Input2 50
lox config wire-connector config.Loxone "Display Helligkeit.Input1" "Tagfenster.Q"
lox config wire-connector config.Loxone "DG Nachtlicht.BrightInact" "Display Helligkeit.AQ"
Sim test (the simulator advances a virtual clock — see the loxone-sim skill):
lox sim run config.Loxone --sim '{"name":"day","clock":{"time":"12:00"},"ticks":5,"dt":1,"expected_outputs":{"Display Helligkeit.AQ":{"==":50}}}'
lox sim run config.Loxone --sim '{"name":"night","clock":{"time":"23:00"},"ticks":5,"dt":1,"expected_outputs":{"Display Helligkeit.AQ":{"==":0}}}'
Note: --device accepts any selector (title, uuid:…, Type:…). It writes Dev=<deviceUuid>
on the new block, which is what binds the AlarmClock to a specific LoxAIRDevice/TreeDevice.
Pattern Selection Guide
| I want to... | Use pattern |
|---|
| React to a sensor threshold | #1 Threshold |
| Combine two conditions | #2 Combined (AND/OR) |
| Turn on for X minutes | #3 Timed Switch (StairwayLS) |
| Wait then pulse | #4 Delayed Action (OnPulseDelay) |
| Activate during hours | #5 Schedule (DayTimer) |
| Do the opposite | #6 Negation (NOT) |
| Remember on/off state | #7 Memory/Latch |
| Protect from frost | #8 Frost Protection |
| Protect from wind | #9 Wind Protection |
| Smart irrigation | #10 Irrigation |
| Air quality control | #11 CO2 Ventilation |
| Humidity management | #12 Humidity Ventilation |
| Range-based control | #13 Pool Temperature |
| Device-bound night dimming | #14 Touch Nightlight Air |
