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.
Add it on the Flows page from the Lighting group. Wire the buttons into the inputs on the left and the lights into the outputs on the right, then press Deploy.

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.

PinSummaryDescriptionRange
Lc1–LcnLight circuitPulse 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 moodPulse selects the next mood in the list, wrapping around at the end.0/1
M−Previous moodPulse selects the previous mood.0/1
MoodSelect mood by IDActivates the mood with this ID directly. 0 switches everything off; 98 and 99 are the reserved moods below.0…99
OffOff — dominatingWhile 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
OnAll onPulse activates mood 99. If no mood 99 is configured, every circuit goes to MaxAbr. Starts Met.0/1
PPresenceLevel input. While 1 the presence mood stays on. When it falls to 0 the lights switch off after Pto.0/1
MoMotionRising edge activates the presence mood. When it falls to 0 the lights switch off after Moet.0/1
DisPDisable presence / motionWhile 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
DisPcDisable buttonsWhile 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
AlarmAlarmWhile 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
BuzzerAlarm clockPulse 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
BrCurrent brightnessA 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.

PinSummaryDescriptionRange
Lc1–LcnLight circuitA 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.—
MCurrent mood0 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 / 3CDouble / triple clickA 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
Wire the 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.

ParameterSummaryDescriptionRangeDefault
RemRemanenceWhen on, the block comes back after a reboot exactly as it was. When off it starts with the lights off.0/10
CircuitsNumber of light circuitsHow 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…184
MaxAbrMaximum / alarm brightnessThe brightness used when a circuit is toggled on, when On fires without a mood 99, and for the alarm flash.10…100 %50
MetManual extend timeLights switched on by hand — a circuit, a mood, On or Buzzer — switch off after this time. 0 disables the automatic switch-off.s3600
MoetMotion extend timeHow long the lights stay on after motion ends. 0 disables the automatic switch-off.s900
PtoPresence timeoutHow long the lights stay on after presence ends.s300
PmPresence moodThe mood ID that presence and motion activate. 0 means the first mood in the list.0…990
AfiAlarm flashing intervalOne full flash cycle — 4 s means two seconds lit and two seconds dark.s4
BrtBrightness thresholdAbove this reading on Br, presence and motion do not switch the room on. 0 disables the daylight lock.lux30
TdcDouble-click timeHow close two presses must be to count as a double click. 0 disables click detection, so every press is a plain mood step.s0.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.

  1. Off — dominating. While it is high, nothing else runs at all.
  2. Alarm — while flashing, every other input is ignored.
  3. Buzzer — the alarm-clock mood.
  4. On — all on.
  5. Mood — a mood selected by ID.
  6. M+ / M− — stepping through the moods.
  7. Lc1–Lc4 — toggling one circuit, unless DisPc is on.
  8. Presence and motion — unless DisP or DisPc is on.
Manual operation always wins over the automatic: touching a button makes the room manual, and the lights then follow 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 actionCircuit behaves asWhat the output sends
Boolean propertySwitchOn or off. Any mood value above 0 counts as on.
Numeric propertyDimmer0–100 %. A mood holding a level sends that level; a circuit toggled on by its Lc input sends MaxAbr.
Colour propertyRGB / RGBWThe mood's colour as #RRGGBB or #RRGGBBWW. A circuit with no colour stored sends full white when on and black when off.
Wire the outputs before configuring moods. Once a circuit knows it drives a colour fixture, the mood editor offers a colour picker for it instead of a level.

7.Moods

A mood is one saved value per circuit — the whole point of the block.

IDMeaningNotes
0OffEvery circuit off. Always available.
1–97Your moodsCreated in the block. These are what M+ and M− step through, in ID order.
98Alarm clockUsed by the Buzzer input. Falls back to 99 if you have not made one.
99All onUsed by the On input. Without it, every circuit goes to MaxAbr.
−1User definedNot 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

  1. Open the block and press the add button in the Moods section.
  2. Give it an ID and a name the customer will understand — "Dinner", "TV", "Cleaning".
  3. Set what each circuit should do: a level for dimmers, a colour for RGB circuits, on or off for switched ones.
  4. Deploy, then step through with M+ to check the order feels right.
Keep it to three or four moods per room. The customer presses one button repeatedly — a list of ten means they overshoot and give up.

8.Automatic on presence / motion

Both inputs activate the same mood; the difference is what happens when they go quiet.

P — presenceMo — motion
ActivatesThe mood in Pm, or the first mood if Pm is 0.The same.
While highStays on for as long as the input stays high.Stays on.
When it clearsLights switch off after Pto (default 5 minutes).Lights switch off after Moet (default 15 minutes).
Use it forA 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 Met takes over. The automatic does not override a person.
  • DisP suspends the automatic — useful during a film, or wired to a "guests" switch.
Keep a presence detector away from the lights it controls where you can. If it also senses heat or light from the fixture, the room will hold itself on — which looks exactly like a configuration fault and is not one.

9.Lighting Controller Central

One block that commands several Lighting Controllers — the hall button that switches the whole floor off.

  1. Add a Lighting Controller Central block.
  2. Open it and tick every room controller it should command.
  3. 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.

  1. Add the block and set Circuits to 4. Wire the outputs: Lc1 to the ceiling dimmer, Lc2 to the spotlights relay, Lc3 to the LED strip (a colour action), Lc4 to the floor lamp.
  2. Create three moods — Bright (everything high), Dinner (ceiling 40 %, strip warm, spots off) and TV (ceiling off, strip dim blue).
  3. Wire the room button through a Device trigger set to changed into M+, so each press steps to the next mood.
  4. Wire the presence detector into P and set Pm to the Dinner mood's ID, with Pto at 300.
  5. Set Met to 0 — a living room should not switch itself off while people are sitting in it.
  6. Add a Lighting Controller Central, link this room and the others, and wire the hall button to its Off.
  7. 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 Lc inputs 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.
If one of these is blocking a project, tell us which — they are small, well-understood additions and we schedule them by what installers actually hit.
See it in context in the examples library, or go back to all function blocks.