loxone-config

Category: Tools & Productivity | Uploader: eisber | Downloads: 0 | Version: v1.0（Latest）
Configure Loxone Miniserver automation. Add blocks, wire circuits, set params, validate with simulator. Use for any home/building automation task.
Changelog: Source: GitHub https://github.com/eisber/lox-cli
Directory Structure

Current level: tree/main/.github/skills/loxone-config/
📄 SKILL.md 18.8 KB
SKILL.md

---
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 config
- `PAGE`: page name for the programming layout (usually same as room)
- `FILE`: path to the `.Loxone` config file

### 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.)

### 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"`

### 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%)

## Block Discovery

Before adding blocks, search for the right type:

```bash
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

1. **Add** new blocks with `lox config add`
2. **Set parameters** with `lox config set-param` (thresholds, durations, factors)
3. **Wire connectors** with `lox config wire-connector` (always TARGET first, then SOURCE)
4. **Add schedules** with `lox config timer-schedule` (only for DayTimer blocks)
5. **Test** with `lox sim run FILE --sim '...'` to verify signals propagate correctly
6. **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

1. **wire-connector argument order**: TARGET first, then SOURCE. `"Target.Input" "Source.Output"` — not the other way around.
2. **DayTimer schedule**: Use `lox config timer-schedule`, NOT `set-param`. The schedule is not a simple parameter.
3. **StairwayLS vs OnPulseDelay**: Use StairwayLS for "turn on for X minutes" (immediate). OnPulseDelay has a DELAY before the pulse starts.
4. **Room-qualify ambiguous names**: If "Jalousie 1" exists in multiple rooms, use `"Jalousie 1 [Wohnzimmer]"` to disambiguate.
5. **Connector names are case-sensitive**: `Input1` not `input1`, `InputTrigger` not `Trigger`, `AQ` not `aq`.
6. **Analog vs digital**: Comparison blocks (GreaterEqual, Less) output digital (0/1). Mult, Add output analog. Wire analog→analog and digital→digital inputs.
7. **Missing parameters**: Always set threshold values (Input2) on comparison blocks. Always set TimeHigh on StairwayLS, Time on Monoflop.
8. **⚠ 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.
9. **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.
10. **⚠ 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
11. **⚠ 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`
12. **⚠ 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.

## 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:** `InputUp`, `InputDown`, `Reset`
- **Outputs:** `AQ` (count), `Q` (at max)
- **Params:** `Max`, `Min`

#### HourCounter — Operating hours tracker

- **Inputs:** `Input` (digital: count while high), `Reset`
- **Outputs:** `AQ` (hours), `Q` (threshold exceeded)
- **Params:** `Threshold`

#### SequenceController — Step through outputs in sequence

- **Inputs:** `InputTrigger` (advance), `InputReset`
- **Outputs:** `Q1`–`Q8` (one active at a time), `AQ` (current step)
- **Params:** `Steps`, `Time` (per step)

#### MultiClick — Detect single/double/triple clicks

- **Inputs:** `InputTrigger`
- **Outputs:** `Q` (single), `QDouble`, `QTriple`
- **Params:** `Timeout` (ms between clicks)

#### MultiFuncSW — Multi-function switch

- **Inputs:** `InputTrigger`
- **Outputs:** `Qshort`, `Qlong`, `Qdouble`
- **Params:** `LongTime` (ms threshold for long press)

#### Radio — Radio button group (mutual exclusion)

- **Inputs:** `I1`–`I8`, `Reset`
- **Outputs:** `AQ` (selected index), `Q1`–`Q8` (individual)

#### StepSel — Step selector (cycle through values)

- **Inputs:** `Input` (trigger), `Reset`
- **Outputs:** `AQ` (current value)
- **Params:** `Steps`, `Min`, `Max`

#### 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 / AnalogMultiplexer2 — Select between analog inputs

- **Inputs:** `Input1`, `Input2`, `Input3`, `Input4`
- **Outputs:** `AQ`
- **Params:** `Select` (which input to pass through)

#### 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`
Comments 0
Latest | Hot
Please login before commenting.
Loading comments...
loxone-config

Directory Structure

SKILL.md

Report

Notice
