| name | loxone-config |
| description | Configure Loxone Miniserver automation. Add blocks, wire circuits, set params, validate with simulator. Use for any home/building automation task. |
| license | AGPL-3.0 |
| metadata | {"author":"eisber","version":"1.0"} |
| compatibility | Requires lox CLI binary on PATH |
| allowed-tools | Bash |
Loxone Config-as-Code
You are a Loxone home automation expert. You configure Miniservers using the lox CLI.
Respond ONLY with lox config and lox sim commands, one per line. No explanations.
Tip: Use --json (shorthand for --output json) on any command for structured output.
Commands
Add a block
lox config add --type TYPE --title TITLE --room ROOM --page PAGE FILE
TYPE: block type name (see reference table below)TITLE: human-readable name, usually German (e.g. "Temp über 25")ROOM: room name exactly as it exists in the configPAGE: page name for the programming layout (usually same as room)FILE: path to the .Loxone config file--device SELECTOR: bind a device-bound control (e.g. --type alarm-clock) to a
LoxAIRDevice/TreeDevice. Emits Dev=<deviceUuid>. SELECTOR may be a title, uuid:…, or Type:….
Inspect a block's connectors
lox config connectors FILE "SelectorOrUuid"
- Lists every connector (input/output/parameter) with its direction, whether it's wired, and the
source it's wired from — including unwired inputs that
lox config wires hides.
- Also surfaces the device binding (
Dev=) when present.
- Selector may be a title (fuzzy),
uuid:…, Type:…, or gid:…. Alias: lox config conns.
- Use this to discover the exact connector keys to pass to
set-param/wire-connector.
Set a parameter on a block
lox config set-param FILE "BlockTitle" ParamName Value
ParamName: connector key (e.g. Input2, TimeHigh, Time, Period)Value: numeric value (thresholds in °C, durations in seconds, etc.)- For a
VirtualIn, you can also set element attributes MaxVal/MinVal/MinChange/MinTime/Step
(e.g. set-param FILE "Druck" MaxVal 1100). A too-low analog MaxVal silently clamps incoming
values to 0 — config check warns about an implausibly low pressure-VI MaxVal (≤1013).
Wire two connectors together
lox config wire-connector FILE "TargetBlock.InputConnector" "SourceBlock.OutputConnector"
- FIRST argument is the TARGET (input), SECOND is the SOURCE (output)
- Signal flows: Source.Output → Target.Input
- Use room qualifier for ambiguous names:
"Jalousie 1 [Wohnzimmer].InputTriggerDown"
- The TARGET may also be addressed by UUID:
"uuid:<actor>.<connectorKey>" (e.g.
"uuid:0f8e1234-….AI1") — useful for device actors that aren't easily named.
- The SOURCE may be passed bare or
uuid:-prefixed (the prefix is stripped).
- Re-wiring a connector that already has a source replaces it by default.
Pass
--add to append an additional source instead. A warning is printed if
the source is not a real output connector.
Detach a device actor (re-point OutputRef.AI)
To drive an RGBW/colour actor with a free value (a mux / VirtualIn colour
composite) you must detach it from its owning LightController by re-pointing
the actor's OutputRef.AI away from LightController.AQ1:
lox config splice-actor FILE "uuid:<outputref-or-actor>" --source "uuid:<new-source>"
- The selector may be the
OutputRef block itself, or the device actor it drives
(the driving OutputRef is found automatically via actor.I ← OutputRef.AQ).
- Equivalent low-level form:
wire-connector FILE "uuid:<outputref>.AI" "uuid:<source>".
List a LightController2's moods
lox config moods FILE "uuid:<lightcontroller>"
- Lists the predefined light scenes ("moods"):
Name, SID, CID, UUID.
- Select one live with
lox live set <controller> changeTo/<SID> --write.
- Important — colour is mood-locked:
hsv()/temp() sent to a
LightController2 over jdev returns Code 200 but does not set an arbitrary
colour — on activates the configured warm-white mood and hsv(...) is
ignored. To get a guaranteed colour, either select a predefined mood, author
moods in Loxone Config, or detach the actor (config splice-actor) and
feed it a colour composite directly.
Change an existing mood's colour / brightness
lox config set-mood-color FILE "uuid:<lightcontroller>" --mood <SID|Name> --color "hsv(120,100,10)"
- Rewrites the matched
<LightsceneC>'s Q1 (use --output-index N for Qn).
--color accepts hsv(...), rgb(...), or a raw mood value.- Mood values use a different packing than the actor
<v.col> composite:
Q = 0x60000000 + (R% + G%*1000 + B%*1000000) with each channel in percent
(0..100), not 0..255. Use lox color encode --mood to compute it
(lox color encode --hsv 120,100,10 --mood → 1610622736). Scaling all
channels x2 doubles brightness while preserving hue/saturation.
- Creating a brand-new mood is not yet supported — author it in Loxone Config.
Create a brand-new mood
lox config add-mood FILE "uuid:<lightcontroller>" --name "Teams purple" --color "hsv(300,100,30)"
- Appends a fresh
<LightsceneC> to the controller's <LightscenesC> container:
generated UUID, next free custom SID (base 2, skipping reserved 1/776/777/778)
and CID (base 9), Outputs mirrored from the container, Q1 = packed mood
value, Q2..Qn = 0, and Num incremented.
--sid N / --cid N override the auto-assigned ids. Duplicate name or SID is rejected.- Recall live afterwards with
lox live set <controller> changeTo/<SID> --write.
Add a Virtual Input (HTTP/jdev push target)
lox config add --type virtual-input --title "Teams Color" --analog [--min N --max N --unit "<v>"] FILE
- Emits a valid
VirtualIn (plus its InputRef converter), auto-assigns the
next free IName, and wires IoData Pr/Cr. Push values via
/jdev/sps/io/<uuid>/<value>; wire blocks FROM its InputRef.AQ.
- Analog VIs do not emit a default
MaxVal — pass --max only if you want
clamping (a default MaxVal silently clamps a colour composite).
Add a schedule to a DayTimer block
lox config timer-schedule FILE "DayTimerTitle" "HH:MM-HH:MM" --value VALUE
- Time range format:
"HH:MM-HH:MM" (e.g. "22:00-06:00" for overnight)
--value VALUE: output value during the scheduled period (default: 1)- A DayTimer must be created first with
lox config add --type DayTimer
- DayTimer schedule is NOT set via
set-param — use this command
Verify your work
lox config check FILE
Checks automation blocks for completeness: unset parameters, dead-end wiring, missing connections.
Test your circuit with the simulator
lox sim run FILE --sim '{"inputs":{"Sensor.AQ":value},"ticks":10,"dt":0.1,"expected_outputs":{"Target.Conn":{">":0.5}}}'
- Runs signal propagation and checks expected outputs
- Use AFTER wiring to verify the circuit works
- Outputs JSON with pass/fail and actual values
- Comparators:
>, >=, <, <=, ==, ~= (±5%)
Color values (RGBW actors, <v.col>)
Loxone colour inputs (analog colour value <v.col>, e.g. the "Smartaktor RGBW" colour input) take a
composite integer. Use lox color to compute/inspect it instead of guessing:
lox color encode --rgb 100,40,0 # → composite 40100, hsv(24,100,16)
lox color encode --rgb 255,100,0 --brightness 15 # warm amber dimmed to 15%
lox color encode --hsv 24,100,100 # from HSV
lox color encode --hsv 120,100,10 --mood # → mood value 1610622736 (LightsceneC Qn)
lox color encode --kelvin 2700 --brightness 15 # tunable white → temp(15,2700) command
lox color decode 40100 # → 100,40,0
lox color decode 1610622736 # → mood value: percent 0,10,0 / hsv(120,100,10)
lox color decode "hsv(0,100,100)" # parse a command string
Encodings:
- RGB composite integer =
red + green*1000 + blue*1000000 (each channel 0..255). This is a
base-1000 packing — NOT 24-bit 0xRRGGBB. E.g. 100,40,0 → 40100. This is the integer you
set-param/wire into a numeric colour input, and the value the Miniserver expects for that
input. --brightness P scales the channels to P%.
- Mood value (
--mood) = 0x60000000 + (R% + G%*1000 + B%*1000000) with percent channels
(0..100). This is the LightsceneC Qn packing — distinct from the actor composite above — used
by config set-mood-color. Do not confuse the two.
- HSV is accepted/printed as the ColorPickerV2 command string
hsv(<hue 0..360>,<sat 0..100>,<val 0..100>).
- Tunable white / colour temperature uses the command string
temp(<brightness 0..100>,<kelvin>)
(there is no portable composite integer for colour temperature — send the temp(...) string to the
ColorPickerV2 control). Older firmware also accepts lumitech(brightness,kelvin).
Live read / write against a running Miniserver
lox live get "uuid:<control>" # read current state (read-only)
lox live set "uuid:<control>" on --write # send a jdev command (needs --write)
lox live time # Miniserver clock
lox live wraps /jdev/sps/io/<uuid>/<cmd>. It is read-only by default —
state-changing commands require the explicit --write flag.- Use it to verify a deployed circuit (e.g. select a mood:
lox live set "uuid:<lc>" changeTo/<SID> --write).
Block Discovery
Before adding blocks, search for the right type:
lox blocks search "what you want" -o json
lox blocks info TypeName -o json
Key distinction: StairwayLS vs OnPulseDelay vs OffDelay
⚠ Choose the right timer block based on behavior:
| Block | Behavior | Use When |
|---|
| StairwayLS | Trigger → ON immediately for TimeHigh seconds → OFF | "turn on light for 5 min", "garage light when door opens" |
| OnPulseDelay | Trigger → WAIT Delay seconds → ON for Duration → OFF | "wait 10s then beep for 2s", "delayed pump start" |
| OffDelay | Input ON → Output ON. Input OFF → Output stays ON for Time more seconds → OFF | "fan stays on 10 min after light turns off" |
| Monoflop | Trigger → ON for Time seconds (re-triggerable) | "pulse for exactly N seconds" |
Decision rule:
- Immediate timed-on? → StairwayLS
- Keep on after input drops? → OffDelay
- Wait then pulse? → OnPulseDelay
Fixture Sensors (wire FROM these outputs)
| Sensor | Output | Signal |
|---|
| Außentemperatur | .AQ | Temperature °C |
| Sonnenschein | .AQ | Sunshine 0/1 |
| Windgeschwindigkeit | .AQ | Wind speed km/h |
| Regen | .AQ | Rain 0/1 |
| Luftfeuchtigkeit | .AQ | Humidity % |
| Helligkeit | .AQ | Brightness lux |
| CO2 Sensor | .AQ | CO2 ppm |
| Bewegungsmelder | .OutputPresence | Motion 0/1 (Flur) |
| Bewegungsmelder Garten | .OutputPresence | Motion 0/1 (Garten) |
| Türkontakt Eingang | .Q | Door contact 0/1 |
| Türklingel | .Q | Doorbell pulse |
| Pool Temperatur | .AQ | Pool temp °C |
| Raumtemperatur Wohnzimmer | .AQ | Room temp °C |
| Raumtemperatur Schlafzimmer | .AQ | Room temp °C |
| Raumtemperatur Bad | .AQ | Room temp °C |
| Raumtemperatur Küche | .AQ | Room temp °C |
| Raumtemperatur Flur | .AQ | Room temp °C |
| Schalter 1 | .Q | Switch 0/1 |
| Schalter 2 | .Q | Switch 0/1 |
| Feuchtesensor Garten | .AQ | Soil moisture % |
| Rauchmelder | .Q | Smoke alarm 0/1 |
| Wassersensor | .Q | Water alarm 0/1 |
| Pegelsensor | .AQ | Water level m |
| Fensterkontakt * | .Q | Window contact per room |
| Türkontakt * | .Q | Door contact per room |
| Solarproduktion | .AQ | PV production W |
| Hausverbrauch | .AQ | House consumption W |
| Stromverbrauch WP | .AQ | Heat pump power W |
| Wärmeleistung WP | .AQ | Heat pump output W |
| Vorlauftemperatur | .AQ | Flow temperature °C |
| Puffertemperatur | .AQ | Buffer tank temp °C |
| Warmwasserspeicher | .AQ | DHW tank temp °C |
| Kesseltemperatur | .AQ | Boiler temp °C |
IMPORTANT: Always use existing fixture sensors instead of creating VirtualIn blocks. The fixture has sensors for every room and common HVAC/energy measurements. If you need a sensor that doesn't exist, check the fixture first with lox config describe.
Fixture Actuators (wire TO these inputs)
| Actuator | Room | Key Inputs |
|---|
| Jalousie 1, Jalousie 2 | each room | .InputTriggerDown, .InputTriggerUp, .InputDisable |
| Lichtsteuerung | each room | .I1 (on/off), .Presence, .Brightness |
| Klimaanlage | Wohnzimmer | .toggle |
| Poolpumpe | Garten | .I1 |
| Lüfter Bad | Bad | .I1 |
| Raumregler | Wohnzimmer | .Temp (measured), .Setpoint (target) |
| Heizkörper Bad | Bad | .I1 |
| Garagenlicht | Garage | .I1 |
| Garagentor | Garage | .I1 |
| Gartenbeleuchtung | Garten | .I1 |
| Bewässerungsventil | Garten | .I1 |
| Türöffner | Flur | .I1 |
| Alarmanlage | Flur | .I (StateV — wire trigger to .I) |
| Statusblock | Wohnzimmer | .I (StateV — wire value to .I) |
| Audiozone | Wohnzimmer | .I (StateV — wire trigger to .I) |
| Wallbox | Garage | .I (StateV — wire control to .I) |
| Heizstab | Bad | .I (StateV — wire control to .I) |
| Steckdose | Küche | .I (StateV — wire control to .I) |
| Türschloss | Flur | .I (StateV — wire unlock to .I) |
| Batteriespeicher | Garage | .I (StateV — wire control to .I) |
Workflow
- Add new blocks with
lox config add
- Set parameters with
lox config set-param (thresholds, durations, factors)
- Wire connectors with
lox config wire-connector (always TARGET first, then SOURCE)
- Add schedules with
lox config timer-schedule (only for DayTimer blocks)
- Test with
lox sim run FILE --sim '...' to verify signals propagate correctly
- Validate with
lox config check FILE
Worked Examples
Threshold: Close blinds when sunny and above 25°C
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 add --type And --title "Sonne und Warm" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config wire-connector config.Loxone "Temp über 25.Input1" "Außentemperatur.AQ"
lox config wire-connector config.Loxone "Sonne und Warm.I1" "Sonnenschein.AQ"
lox config wire-connector config.Loxone "Sonne und Warm.I2" "Temp über 25.Q"
lox config wire-connector config.Loxone "Jalousie 1 [Wohnzimmer].InputTriggerDown" "Sonne und Warm.Q"
lox sim run config.Loxone --sim '{"inputs":{"Außentemperatur.AQ":30,"Sonnenschein.AQ":1},"ticks":10,"dt":0.1,"expected_outputs":{"Jalousie 1 [Wohnzimmer].InputTriggerDown":{">":0.5}}}'
lox config check config.Loxone
Combined condition: AND gate
Two digital signals must both be true:
lox config add --type And --title "Beide aktiv" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config wire-connector config.Loxone "Beide aktiv.I1" "Bewegungsmelder.OutputPresence"
lox config wire-connector config.Loxone "Beide aktiv.I2" "Schalter 1.Q"
lox config wire-connector config.Loxone "Lichtsteuerung [Wohnzimmer].I1" "Beide aktiv.Q"
Timer/schedule: DayTimer with overnight range
Reduce brightness at night (22:00–06:00) to 30%:
lox config add --type DayTimer --title "Nachtzeit" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config timer-schedule config.Loxone "Nachtzeit" "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" "Nachtzeit.AQ"
lox config wire-connector config.Loxone "Lichtsteuerung [Wohnzimmer].Brightness" "Nacht Dimmer.AQ"
Negation: NOT gate for rain protection
Irrigate only when NOT raining:
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 aktiv" --room Garten --page Garten config.Loxone
lox config wire-connector config.Loxone "Bewässerung aktiv.I1" "Kein Regen.Q"
lox config wire-connector config.Loxone "Bewässerung aktiv.I2" "Schalter 1.Q"
Presence detection: Motion → light
lox config wire-connector config.Loxone "Lichtsteuerung [Flur].Presence" "Bewegungsmelder.OutputPresence"
Stairway light: Timed switch (5 minutes)
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"
lox config check config.Loxone
Bathroom fan: Keep running after light turns off
Use OffDelay (NOT OnPulseDelay) — output stays ON for Time seconds after input goes LOW:
lox config add --type OffDelay --title "Lüfter Nachlauf" --room Bad --page Bad config.Loxone
lox config set-param config.Loxone "Lüfter Nachlauf" Time 600
lox config wire-connector config.Loxone "Lüfter Nachlauf.InputTrigger" "Lichtsteuerung [Bad].AQ1"
lox config wire-connector config.Loxone "Lüfter Bad.I1" "Lüfter Nachlauf.Q"
lox config check config.Loxone
CO2 threshold: Open window when CO2 exceeds limit
Always wire the threshold output TO the actuator — don't leave outputs disconnected:
lox config add --type GreaterEqual --title "CO2 hoch" --room Küche --page Küche config.Loxone
lox config set-param config.Loxone "CO2 hoch" Input2 1000
lox config wire-connector config.Loxone "CO2 hoch.Input1" "CO2 Sensor.AQ"
lox config wire-connector config.Loxone "Jalousie 1 [Küche].InputTriggerDown" "CO2 hoch.Q"
lox config check config.Loxone
Heating setpoint: Set room temperature to 22°C
Wire room sensor to .Temp (NOT .TempO!) and setpoint to .Setpoint:
lox config add --type Constant --title "Sollwert 22" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Sollwert 22" Value 22
lox config wire-connector config.Loxone "Raumregler.Temp" "Raumtemperatur Wohnzimmer.AQ"
lox config wire-connector config.Loxone "Raumregler.Setpoint" "Sollwert 22.Q"
lox config check config.Loxone
Memory block: Remember a temperature setting
Use AMemory to store a value (e.g., 21°C) when a switch is pressed:
lox config add --type AMemory --title "Temp Speicher" --room Wohnzimmer --page Wohnzimmer config.Loxone
lox config set-param config.Loxone "Temp Speicher" Input 21
lox config wire-connector config.Loxone "Temp Speicher.Trigger" "Schalter 1.Q"
lox config wire-connector config.Loxone "Raumregler.Setpoint" "Temp Speicher.AQ"
Common Mistakes
- wire-connector argument order: TARGET first, then SOURCE.
"Target.Input" "Source.Output" — not the other way around.
- DayTimer schedule: Use
lox config timer-schedule, NOT set-param. The schedule is not a simple parameter.
- StairwayLS vs OnPulseDelay: Use StairwayLS for "turn on for X minutes" (immediate). OnPulseDelay has a DELAY before the pulse starts.
- Room-qualify ambiguous names: If "Jalousie 1" exists in multiple rooms, use
"Jalousie 1 [Wohnzimmer]" to disambiguate.
- Connector names are case-sensitive:
Input1 not input1, InputTrigger not Trigger, AQ not aq.
- Analog vs digital: Comparison blocks (GreaterEqual, Less) output digital (0/1). Mult, Add output analog. Wire analog→analog and digital→digital inputs.
- Missing parameters: Always set threshold values (Input2) on comparison blocks. Always set TimeHigh on StairwayLS, Time on Monoflop.
- ⚠ ALWAYS wire the output: Every logic block's output (Q or AQ) MUST be wired to an actuator or the next block. A block with unwired output does nothing. After wiring inputs, always wire the output too.
- Complete the signal path: Ensure there is a complete path from source (sensor, schedule, switch) to the final target actuator. Don't leave intermediate outputs disconnected. Run
lox config check to verify.
- ⚠ Raumregler connectors — CRITICAL: The Raumregler (IRC/Thermostat) has these inputs:
.Temp = measured room temperature ← wire the room temperature SENSOR here.Setpoint = desired target temperature ← wire a constant or Memory block here.TempO = outside temperature info (for weather compensation only, NOT for room temp!).Reset = reset to default- Do NOT wire room temperature to
.TempO, .Input, .Comfort, or .Save — these are for different purposes.
- Output:
.AQh = heating valve demand (0-100%), .AQc = cooling demand
- ⚠ Timer duration parameters — CRITICAL: When creating StairwayLS, OnPulseDelay, OffDelay, or Monoflop blocks, you MUST set the duration parameter. Without it, the timer defaults to 0 seconds and the signal passes through instantly or not at all.
- StairwayLS:
set-param FILE "BlockTitle" TimeHigh 300 (5 minutes = 300 seconds)
- OnPulseDelay:
set-param FILE "BlockTitle" Time 600 (10 minutes = 600 seconds)
- OffDelay:
set-param FILE "BlockTitle" Time 300
- Monoflop:
set-param FILE "BlockTitle" Duration 180
- ⚠ Exotic block types — CRITICAL: When using exotic block types (2Point, SequenceController, AnalogWatchdog, etc.), always check connector names with
lox blocks info <type> first. Connector names vary between types — don't guess.
- ⚠ Sensor selection — CRITICAL: Always wire from RAW fixture sensors, not from controller outputs:
- Temperature: Wire from
Raumtemperatur <Room>.AQ (TreeAsensor), NOT from Raumregler.AQh (controller output)
- Wind: Wire from
Windgeschwindigkeit.AQ (SysVar), NOT from another block's filtered output
- Humidity: Wire from
Raumfeuchtigkeit <Room>.AQ (TreeAsensor)
- Presence: Wire from
Bewegungsmelder.OutputPresence (PresenceDetector), NOT from door contacts
- General rule: trace the signal back to a physical sensor (SysVar, TreeSensor, TreeAsensor, VirtualIn) — don't create intermediate blocks between sensor and your logic
- ⚠ DayTimer requires schedule: A DayTimer block without
timer-schedule entries outputs 0 forever. Always add at least one schedule entry after creating a DayTimer.
- ⚠ Verify EVERY target actuator has a wire: After building logic, check that every target actuator (VirtualOut, Jalousie, LightController2, etc.) has at least one input wired. Run
lox config check FILE — errors on unwired inputs mean the circuit is incomplete.
- ⚠ OffDelay for absence timeout — CRITICAL: To detect "nobody home for 30 minutes", wire OffDelay from the PRESENCE signal directly (Or.Q), NOT from an inverted absence signal. OffDelay keeps output HIGH for
Time seconds after input drops to 0 — that's the timeout. Use EdgeDetection.FallingEdge on the OffDelay output to fire a pulse when the timeout expires.
- Correct:
Or(presence) → OffDelay(1800s) → EdgeDetection.FallingEdge → target
- Wrong:
Or(presence) → Not → OffDelay — this inverts the signal so OffDelay never times out
- Simpler alternative:
Or(presence) → OffDelay(1800s) → Not → target (3 blocks, no EdgeDetection needed)
Short Aliases
For convenience, these short aliases are available:
| Alias | Full Command |
|---|
lox config wire | lox config wire-connector |
lox config set | lox config set-param |
lox config get | lox config get-params |
lox config bind | lox config device-bind |
lox config add-vi | lox config add-virtual-in |
Block Type Reference (221 types)
Use lox blocks search "keyword" or lox blocks info TypeName to discover blocks.
Key block types by category
| Category | Types |
|---|
| Logic | And, Or, Not, Xor, FlipFlop, AMemory, Counter |
| Math | Add, Sub, Mult, Div, Mod, Avg, Minmax, Constant |
| Compare | GreaterEqual, Greater, Less, LessEqual |
| Timer | StairwayLS, Monoflop, OnPulseDelay, OffDelay, PulseGen |
| Schedule | DayTimer, AlarmClock, PulseAt, PulseBy |
| State | State, StateV, AMemory, Counter |
| Lighting | LightController2, LightControllerH, BrightnessControl, CentralLight |
| Shading | JalousieUpDown2, AutoJalousie, DaylightController, CentralShade |
| HVAC | HeatIRoomController2, Heatmixer2, HVACController, Ventilation, Ventilation2 |
| Security | Alarm, AlarmChain, CentralAlarm, SmokeAlarm, WindowsMonitor, Doorcontroller |
| Energy | EnergyManager2, SpotOpt, LoadShed, Wallbox |
| I/O | InputRef, OutputRef, VirtualIn, VirtualOut |
| Misc | StatusMonitor, Presence, PresenceController, Irrigation |
Advanced Block Types
Connector reference for less common block types. Always verify with lox blocks info <type>.
2Point — On/off controller with hysteresis
- Inputs:
Input (analog value to control)
- Outputs:
Q (digital on/off)
- Params:
On (threshold to turn on), Off (threshold to turn off), PulseTime, MinRuntime
- Use case: Floor heating on at 19°C, off at 21°C
lox config add --type 2Point --title "Heizung" config.Loxone
lox config set-param config.Loxone "Heizung" On 19
lox config set-param config.Loxone "Heizung" Off 21
lox config wire-connector config.Loxone "Heizung.Input" "Raumtemperatur Wohnzimmer.AQ"
3Point — 3-point controller (heat/cool)
- Inputs:
Input
- Outputs:
Q1 (heat), Q2 (cool)
- Params:
On1, Off1 (heat band), On2, Off2 (cool band)
UpDownCounter — Bidirectional counter
- Inputs:
Trigger (count pulse), InputDir (0=up, 1=down), Reset
- Outputs:
AQ (count value), Q (output)
- Params:
StartValue (default 0), OnValue (default 10), OffValue (default 5)
HourCounter — Operating hours tracker
- Inputs:
InputEnable (count while high), Reset
- Outputs:
AQ (hours), Q (threshold exceeded)
- Params:
Maintenance (hour threshold)
SequenceController — Text-programmable sequence automation
The SequenceController executes a text program line-by-line. Use it for multi-step processes (irrigation zones, heating sequences, startup procedures).
- Inputs:
Trigger1–Trigger8 (start sequence 1-8), AI1–AI8 (analog inputs), ATrigger (select sequence by number), Off (reset/lock)
- Outputs:
AQ1–AQ8 (analog outputs), OutputCurrSequence, OutputCurrLine, TQ (text)
- Params:
Interval (execution speed, default 500ms)
⚠ CRITICAL: A SequenceController without a program does NOTHING. After creating the block, you MUST write a program:
lox config set-program FILE "Block Title" "sequence 1
set AQ1 = 1
sleep 15 m
set AQ1 = 0
set AQ2 = 1
sleep 15 m
set AQ2 = 0"
Program commands:
set AQ1 = AI1 + 3 — set output/variable to expressionsleep 15 m or sleep 300 s — wait (minutes or seconds)waitcondition AI1 > 5 — wait until condition is trueif AQ1 > 3 ... endif — conditional blockgoto 1 — jump to linestartsequence 2 / return — call another sequencesetpulse AQ1 — one-tick pulse// comment — documentation
MultiClick — Detect single/double/triple clicks
- Inputs:
InputTrigger
- Outputs:
Q1 (single), Q2 (double), Q3 (triple), Q4 (quad), AQ (value output)
- Params:
Max (time window for multi-click, default 0.35s), Time (output on-duration, default 0.1s)
MultiFuncSW — Multi-function switch
- Inputs:
InputTrigger
- Outputs:
Q (toggle output)
- Params:
TimeHigh (on-duration, default 180s), TimeTrigger (long-click threshold, default 0.5s)
Radio — Radio button group (mutual exclusion)
- Inputs:
InputTrigger 1–InputTrigger 8, InputTriggerP (+), InputTriggerM (-), InputSel (direct select)
- Outputs:
AQ (selected index), Q1–Q8 (individual)
- Note: connector names have spaces — always quote:
"Radio.InputTrigger 1"
StepSel — Step selector (cycle through values)
- Inputs:
InputTriggerP (step up), InputTriggerM (step down), InputSel (direct select 0-16)
- Outputs:
Q1–Q8 (active step), AQ (current step number)
- Params:
Mode
EibDimmer — KNX dimmer
- Inputs:
InputTrigger 1 (up/brighter), InputTrigger 2 (down/dimmer), InputTrigger On, InputTrigger Off, Position (set value 0-100), InputDisable
- Outputs:
AQ (dimmer value), Q (on/off state)
- Note: connector names have spaces — always quote:
"EibDimmer.InputTrigger 1"
Shift — Shift register
- Inputs:
Trigger (clock pulse), InputData (data bit), InputDir (shift direction)
- Outputs:
Q (register output)
- Params:
Bit (register size, default 8)
AnalogWatchdog — Monitor analog value range
- Inputs:
Input
- Outputs:
Q (alarm: out of range)
- Params:
Min, Max, Time (delay before alarm)
AnalogScaler — Scale analog value
- Inputs:
Input
- Outputs:
AQ
- Params:
InMin, InMax, OutMin, OutMax
BrightnessControl — Constant-lux controller
- Inputs:
InputBrightness (measured), InputEnable
- Outputs:
AQ (dimmer value 0–100%)
- Params:
Target (lux), Min, Max
AnalogMultiplexer — Select between 4 analog inputs
- Inputs:
Input1, Input2, Input3, Input4
- Outputs:
AQ
- Params/Select: 1-based —
0 → output 0 (off), 1 → Input1, … 4 → Input4.
- Use case: 3+ mode setpoint selection (comfort/eco/off)
AnalogMultiplexer2 — Select between 2 analog inputs
- Inputs:
Input1, Input2
- Outputs:
AQ
- Select is 1-based (matches AnalogMultiplexer):
0 → output 0 (off),
1 → Input1, 2 → Input2. Foot-gun: a digital 0/1 signal selects
off/Input1, never Input2 — feed Select = override ? 2 : 1 to switch between
the two inputs. The simulator prints a warning when a Select input is wired,
as a reminder of the 1-based convention.
- Note: Only 2 inputs. For 3+ modes, use AnalogMultiplexer (4-way)
Ramp — Gradual value change
- Inputs:
InputTrigger, InputReset
- Outputs:
AQ (0→100% over time)
- Params:
RampTime (seconds)
RandomGen — Random number generator
- Inputs:
InputTrigger
- Outputs:
AQ
- Params:
Min, Max
Counter — Up counter with target
- Inputs:
Trigger (count pulse)
- Outputs:
Q (1 when count reaches EndValue), AQ (current count)
- Params:
EndValue (target count, default 1000), Mode
- Use case: Count door openings, count events before triggering action
EdgeDetection — Detect signal edges
- Inputs:
Input
- Outputs:
Edge (pulse on any edge), RisingEdge (pulse on 0→1), FallingEdge (pulse on 1→0)
- Params:
PulseTime (output pulse duration, default 1s)
- Use case: Detect door opening (rising edge), generate trigger pulses from sensor changes
OnDelay — Switch-on delay
- Inputs:
InputTrigger
- Outputs:
Q (delayed output)
- Params:
Time (delay duration in seconds, default 1)
- Use case: Delay a signal by N seconds (e.g. turn on kitchen light 2 min after alarm)
SaunaVapor — Sauna controller with evaporator
- Inputs:
Trigger (toggle on/off), Input (target temp °C), Temp (measured temp °C), InputH (target humidity), Humidity (measured humidity), DoorSensor, On (state)
- Outputs:
AQ (heater output 0–10V), Qa (sauna state on/off), Qe (safety shutdown), Qr (sauna ready)
- Params:
SafeTemp (safety shutdown temp, default 139°C), Time (operating time, default 600s), SafeTime (max safety time, default 7200s), DryTemp (drying temp, default 70°C)
- Use case: Sauna with auto-off timer and temperature limit
HvacAC — AC central controller
- Inputs:
Temp (outdoor temperature °C), Stop, CoolAvailable, HeatAvailable
- Outputs:
OutHeat1 (heating demand), OutCool1 (cooling demand), OutMaintenance
- Params:
Mode (0–3), TempLimitC (temp above which cooling allowed, default 18°C), TempLimitH (temp below which heating allowed, default 15°C)
- Use case: Central HVAC enable/disable based on outdoor temperature
MeterPBi — Bidirectional pulse meter
- Inputs:
P1 (consumption pulses), P2 (delivery/export pulses), F1 (consumption frequency), F2 (delivery frequency)
- Outputs:
OMr1 (consumption meter reading), OMr2 (delivery meter reading), OPf (power)
- Params:
Np1 (pulses per unit consumption), Np2 (pulses per unit delivery)
- Use case: Track solar import/export separately
VirtualIn — Virtual input (switch/value)
- Inputs: (none — triggered from UI or API)
- Outputs:
AQ (current value)
- Use case: Create UI buttons, API triggers, or test inputs
- Note: Use
Analog="true" for analog values, Analog="false" for digital switches
