Lighting Controller
Controls the lighting of one room or area: several circuits, saved moods, and automatic switching from presence or motion detectors. Switched, dimmed and colour circuits can be mixed in the same block.
1.What it does
The block holds the state of a room's lighting. Buttons, a presence detector and the app all feed into it, and it decides what every circuit should be doing. The circuits are wired to device actions on the outputs, so one block drives a whole room regardless of whether those lights are KNX relays, dimmers or colour fixtures.
- Up to eighteen light circuits, each switched, dimmed or coloured.
- Saved moods the customer steps through with one button.
- Automatic lighting from presence or motion, with separate timeouts.
- An alarm flash and an alarm-clock mood for use by other blocks.
2.Inputs
Pulse inputs act on the rising edge — wire a button through a Device trigger set to 'changed'. Level inputs are read as a state that stays.
| Pin | Summary | Description | Range |
|---|---|---|---|
| Lc1–Lcn | Light circuit | Pulse toggles that one circuit between off and the brightness in MaxAbr. The mood becomes "user defined" and the manual extend timer Met starts. Pressed twice quickly it switches the whole room off and pulses 2C; three times pulses 3C as well. Ignored while DisPc is on. | 0/1 |
| M+ | Next mood | Pulse selects the next mood in the list, wrapping around at the end. | 0/1 |
| M− | Previous mood | Pulse selects the previous mood. | 0/1 |
| Mood | Select mood by ID | Activates the mood with this ID directly. 0 switches everything off; 98 and 99 are the reserved moods below. | 0…99 |
| Off | Off — dominating | While 1, every circuit is off, all timers are cleared and every other input is ignored, including the alarm. This is the highest priority in the block. | 0/1 |
| On | All on | Pulse activates mood 99. If no mood 99 is configured, every circuit goes to MaxAbr. Starts Met. | 0/1 |
| P | Presence | Level input. While 1 the presence mood stays on. When it falls to 0 the lights switch off after Pto. | 0/1 |
| Mo | Motion | Rising edge activates the presence mood. When it falls to 0 the lights switch off after Moet. | 0/1 |
| DisP | Disable presence / motion | While 1, P and Mo are ignored and anything they lit switches off immediately. When it returns to 0, lighting resumes at once if presence or motion is still present. | 0/1 |
| DisPc | Disable buttons | While 1, the Lc inputs and presence / motion are ignored — for a child lock or during cleaning. Moods, On and Off still work, and so does the app. | 0/1 |
| Alarm | Alarm | While 1, every circuit flashes between 0 and MaxAbr at the interval in Afi, and all other inputs are ignored so nothing interrupts the flashing. Clearing it switches the lights off. | 0/1 |
| Buzzer | Alarm clock | Pulse activates mood 98. If there is no mood 98 it uses mood 99, and failing that every circuit at MaxAbr. Switches off after Met. | 0/1 |
| Br | Current brightness | A lux reading. While it is above Brt and the room is still dark of its own lights, presence and motion are ignored — the daylight lock. Leave it unwired and nothing is suppressed. | lux |
3.Outputs
Each circuit output adapts to whatever device action you wire to it — you do not convert anything by hand.
| Pin | Summary | Description | Range |
|---|---|---|---|
| Lc1–Lcn | Light circuit | A boolean for a switched light, 0–100 for a dimmer, or a hex colour for an RGB / RGBW action. A circuit that is on but has no colour of its own sends full white to a colour fixture, and MaxAbr to a dimmer. | — |
| M | Current mood | 0 off · 98 alarm clock · 99 all on · −1 user defined (after a single circuit was toggled) · otherwise the active mood's ID. | −1…99 |
| 2C / 3C | Double / triple click | A short pulse when a circuit button (Lc1–Lcn) or M+ / M− is pressed twice (2C) or three times (3C) within Tdc. The repeat also switches the room off. Clicks are counted per button, so pressing two different ones in quick succession stays two single presses. | 0/1 |
M output to a Notification block while commissioning and you can watch exactly which mood the room thinks it is in as you press buttons.4.Parameters
Set on the block itself in the Flows editor.
| Parameter | Summary | Description | Range | Default |
|---|---|---|---|---|
| Rem | Remanence | When on, the block comes back after a reboot exactly as it was. When off it starts with the lights off. | 0/1 | 0 |
| Circuits | Number of light circuits | How many circuits the room has. The block draws one input and one output pin per circuit, so every one of them can be wired. | 1…18 | 4 |
| MaxAbr | Maximum / alarm brightness | The brightness used when a circuit is toggled on, when On fires without a mood 99, and for the alarm flash. | 10…100 % | 50 |
| Met | Manual extend time | Lights switched on by hand — a circuit, a mood, On or Buzzer — switch off after this time. 0 disables the automatic switch-off. | s | 3600 |
| Moet | Motion extend time | How long the lights stay on after motion ends. 0 disables the automatic switch-off. | s | 900 |
| Pto | Presence timeout | How long the lights stay on after presence ends. | s | 300 |
| Pm | Presence mood | The mood ID that presence and motion activate. 0 means the first mood in the list. | 0…99 | 0 |
| Afi | Alarm flashing interval | One full flash cycle — 4 s means two seconds lit and two seconds dark. | s | 4 |
| Brt | Brightness threshold | Above this reading on Br, presence and motion do not switch the room on. 0 disables the daylight lock. | lux | 30 |
| Tdc | Double-click time | How close two presses must be to count as a double click. 0 disables click detection, so every press is a plain mood step. | s | 0.35 |
Met is an automatic switch-off, not a comfort feature. On its default of one hour, a living room lit by hand will go dark after an hour with nobody touching anything. Set it to 0 where that would be wrong, and keep it short in corridors.5.Input priority
When several things happen at once, the block works down this list and stops at the first one that applies. This order explains nearly every 'why did the light do that' question.
- Off — dominating. While it is high, nothing else runs at all.
- Alarm — while flashing, every other input is ignored.
- Buzzer — the alarm-clock mood.
- On — all on.
- Mood — a mood selected by ID.
- M+ / M− — stepping through the moods.
- Lc1–Lc4 — toggling one circuit, unless
DisPcis on. - Presence and motion — unless
DisPorDisPcis on.
Met rather than the presence timers.6.Light circuits
A circuit is one light or one group of lights that behave as one.
You do not tell the block what kind of light a circuit drives — it works that out from the device action you wire to the output:
| Wired device action | Circuit behaves as | What the output sends |
|---|---|---|
| Boolean property | Switch | On or off. Any mood value above 0 counts as on. |
| Numeric property | Dimmer | 0–100 %. A mood holding a level sends that level; a circuit toggled on by its Lc input sends MaxAbr. |
| Colour property | RGB / RGBW | The mood's colour as #RRGGBB or #RRGGBBWW. A circuit with no colour stored sends full white when on and black when off. |
7.Moods
A mood is one saved value per circuit — the whole point of the block.
| ID | Meaning | Notes |
|---|---|---|
| 0 | Off | Every circuit off. Always available. |
| 1–97 | Your moods | Created in the block. These are what M+ and M− step through, in ID order. |
| 98 | Alarm clock | Used by the Buzzer input. Falls back to 99 if you have not made one. |
| 99 | All on | Used by the On input. Without it, every circuit goes to MaxAbr. |
| −1 | User defined | Not a mood you create — what the M output reports after a single circuit has been toggled, so the room no longer matches any saved mood. |
Creating one
- Open the block and press the add button in the Moods section.
- Give it an ID and a name the customer will understand — "Dinner", "TV", "Cleaning".
- Set what each circuit should do: a level for dimmers, a colour for RGB circuits, on or off for switched ones.
- Deploy, then step through with
M+to check the order feels right.
8.Automatic on presence / motion
Both inputs activate the same mood; the difference is what happens when they go quiet.
| P — presence | Mo — motion | |
|---|---|---|
| Activates | The mood in Pm, or the first mood if Pm is 0. | The same. |
| While high | Stays on for as long as the input stays high. | Stays on. |
| When it clears | Lights switch off after Pto (default 5 minutes). | Lights switch off after Moet (default 15 minutes). |
| Use it for | A presence detector that holds its output while the room is occupied. | A PIR that pulses and then goes quiet. |
- If somebody then operates a button, the room becomes manual: the presence timers are dropped and
Mettakes over. The automatic does not override a person. DisPsuspends the automatic — useful during a film, or wired to a "guests" switch.
9.Lighting Controller Central
One block that commands several Lighting Controllers — the hall button that switches the whole floor off.
- Add a Lighting Controller Central block.
- Open it and tick every room controller it should command.
- Wire your central button into its input — usually
Off.
It has the same inputs as the room block — Lc1–Lc4, M+, M−, Mood, Off, On, DisP, DisPc, Alarm, Buzzer — and forwards whatever it receives to every linked block at once. Rtd is the recovery pin: a pulse releases the latched Off, switches every linked room off once, and hands them back to their own automation. It works even while Off is held.
Off on the central block latches. While it is held high, the linked rooms ignore everything else — that is what makes "everything off while we are away" reliable. Release it before expecting the rooms to respond again, and wire it from a button that pulses rather than a switch that stays closed.10.Programming example
A living room with four circuits, three moods, a presence detector and a central off.
- Add the block and set Circuits to 4. Wire the outputs:
Lc1to the ceiling dimmer,Lc2to the spotlights relay,Lc3to the LED strip (a colour action),Lc4to the floor lamp. - Create three moods — Bright (everything high), Dinner (ceiling 40 %, strip warm, spots off) and TV (ceiling off, strip dim blue).
- Wire the room button through a Device trigger set to changed into
M+, so each press steps to the next mood. - Wire the presence detector into
Pand setPmto the Dinner mood's ID, withPtoat 300. - Set
Metto 0 — a living room should not switch itself off while people are sitting in it. - Add a Lighting Controller Central, link this room and the others, and wire the hall button to its
Off. - Turn Rem on if the room should come back as it was after a power cut, then Deploy.
11.Not available in this version
Stated plainly so nothing is wired in expectation of it. Several of these exist on other systems' equivalents of this block.
- Dimming by holding a button. The
Lcinputs toggle only. There is no long-press dimming and no minimum or maximum dimming limit — set levels through moods instead. - Mood mixing, fading times, daylight (circadian) colour control, presence simulation and a master-brightness input. None of these are in the block.