This function block allows you to control multiple types of lights (switched, dimmed and RGB) using lighting scenes.


In this video we show you how to use the lighting controller function block to control multiple circuits of lighting with just one switch, which is our advised method!


The lighting controller at its most basic is essentially 12 push button blocks combined. With each click of a retractive switch connected to one of the inputs I1-I12 you can toggle their respective output AQ1-AQ12 on and off just like a push button does.

A double click on any one of the inputs I1-I12 or S1-S8 turns all of the outputs on the lighting controller off. So for example if you leave a room you can turn off all the lights with a double click.

Using the parameter input M, the maximum time interval between two clicks can be adjusted, so if you click slower this can be allowed for, see the Overview section for more information.

A triple click on any one of the inputs I1-I12 or S1-S8 turns all of the outputs on the lighting controller off like a double click. Furthermore, the output RaQ will pulse on quickly which means that if the output RaQ is connected to other lighting controllers through using a memory flag, you can trigger a central function such as all lights off.

A long press on one of the inputs I1-I12 will dim the output up and down if it is connected to a dimmed output. See the Functions section for more information.

The lighting controller supports switched outputs, 0-10V outputs, 0-100%, RGB, Lumitech or RGBW, these types can be changed by double clicking on the lighting controller and going to the Outputs tab, see Basic Setup for more information.


The lighting controller can be used in the same was as a push button block to control simple light circuits. In this example we have a single switched light circuit and one retractive switch on the wall. In this case it is uneccessary to use scenes with the lighting controller.

The first thing to do is to make sure you have labelled your output correctly. You can give the output a name and a description. When you connect the output to one of the lighting controller outputs the name, or description if there is one, will be copied across and this will show on the user interface.

Therefore it is important that if you have used a technical reference for the output that you put a description for the circuit the user would want to see. In this case our output name is “C1 Toilet GND” and the description is “Ceiling”.

Next connect the input for the switch to I1 and the output to AQ1.


Finally double click on the lighting controller and click on the Scenes tab. You can see there are default scenes 1-3 and a scene called Motion. In this case we aren’t using scenes so we don’t want them to show on the user interface. Replace the names with a hyphen “-” so that no scenes show.



The lighting controller has 8 lighting scenes which can be toggled on and off with the inputs S1-S8. In this example we have a lounge that has 4 circuits. Two of the circuits are dimmed and two are switched.

Our recommendation is to have one retractive switch in each room to control lighting only, no matter how many circuits there are. This is because you can use scenes to control different circuits and then use the retractive switch to scroll through the scenes with each click.


The first step is to connect your outputs to AQ1-AQ4. Then connect the retractive switch to the + input on the lighting controller. This will scroll through scenes 0 (all off), 1-4 and then 9 (all on).



Now if you double click on the lighting controller it will bring up an edit box that allows you to see the outputs and scenes.

The outputs tab will include the description of the output (or the name if there is no description entered for the output). The lighting controller will only copy the description across once, if you change the output name or description it won’t be updated in the lighting controller a second time so be aware of this!

The lighting controller will automatically detect the output type, in this case 2 Switch circuits and 2 Dimmer 0-100%.



Now you have connected all your inputs and outputs the next thing to do is to click on the Scenes tab and label up your scenes.

By default there are four scenes, Scene 1-3 and a scene called Motion. These are blank defaults with no outputs selected. The motion scene is the one that is chosen to be brought on by a motion sensor if connected.

In our lounge, we have four scenes too. To change the name click on the name in the box and type in a new name. We have everyday, reading, movie and evening. Tick or choose the dim levels or colours (for RGB) that you want to have each scene. This can also be done by the customer in the user interface (app or webinterface).

You can exclude the all off and all on scenes from the scroll by double clicking on the lighting controller and going to the Scenes tab and ticking the boxes there:



A scene can also be assigned to a motion detector. This is done by selecting the desired lighting scene and clicking the box ‘Connect this lighting scene with motion detectors’:


The motion detector should be connected to the input Mv. The motion detector is enabled by default. If motion is detected, then the scene that has been ticked in the lighting controller editor is activated.

You can prevent the scene from being activated by using the DisM input. So in our case we don’t want the scene to be triggered in the daytime so we use the time Daytime to disable the motion sensor. If someone then walks in to the room at night, the evening scene (low level single colour white LED tape) is brought on.

The parameter TH defines how long the scene remains active. The timer starts with the last trigger of the motion sensor.

You can also use the parameter MS to decide which scene is triggered rather than using the tick box in the editor. Have a look at the patio page in the Outdoor Lighting example file!



The dimming function is activated by a long press of a retractive switch connected to one of the inputs I1-I12. The way the dimming behaves depends on the values of the parameters SI, ST, Min, Max, W and L:
The percentage increment is set by the parameter SI and the time step (in seconds) between increments by the parameter ST.

The parameter Min sets the minimum value the dimming can take in the range 0-50%, and the parameter Max sets its maximum value in the range 50-100%.

If the parameter W is on, when the dimming reaches its maximum value it will change direction and start to dim towards the minimum. Similarly, when it reaches its minimum value, it will change direction and return towards the maximum. If the parameter W is off, the dimmer will simply stop when it reaches the minimum or maximum value.

If the parameter L is off, a single click of the retractive switch connected to I1-I12 applies the last value of the dimming. If on, the dimming toggles between 0% and 100%.


A short press at an input I1-I12 causes the corresponding RGB output to be toggled on and off. A long click will cycle through the colour spectrum. When Ra is on a short click with cycle through the primary colours and a long click will change the brightness.




I1-I12Trigger inputsDirectly trigger outputs AQ1-AQ12
+Select next sceneCycle forward through the scenes 0-9
Select previous sceneCycle backward through the scenes 0-9
AlsChoose lighting scene (0-9)
RResetSet all the outputs to 0
S1-S8Lighting scene trigger inputsTriggers the scene (1-8)
DisMLock motion sensorsMotion sensors will not trigger if they detect movement
MvMotion detector inputStarts the motion detected scene
OAll onSelect scene 9 (every output on full or on)
GNo functionReserved for future extensions.
AAlarm inputIf this input is on all the outputs will flash (how fast can be adjusted using the Ta parameter).
DisDisableChild lock will lock all the inputs (but not the user interface)


AQ1-AQ12Output for lighting controlControlled by the inputs 11-112
AQsCurrent lighting scene (0-9)-1 = undefined, 0 = everything off, 9 = all on
RQReset outputSends out a pulse if reset or a double click is detected
RAQReset output from a triple clickSends out a pulse if a triple click is detected


RemanenceSets the function block to be remanent, e.g. return to the last known scene after a power cut
MMaximum pulse seperation (s)Maximum time span between two pulses (s)
SIDimmer step increment
STDimmer step time 
MinDimmer minimum value0-50%
MaxDimmer maximum value50-100%
WDimmer Up/Down mode (Off = Stop at max/min)
LDo not set last value (Off = short click sets last value of dimmer)
THSets how long the lights will stay on if a motion sensor (Mv input) is used with the lighting controller.This parameter is in seconds.
LTLearn timeLength of time a switch must be held down to learn in a new scene
MSMotion sensor sceneSets which scene will be actived if the motion sensor (Mv input) is triggered
MTMotion sensor timeoutAll the lights will be switched off if after MT seconds there has been no motion in the room (detected with Mv input). This happens regardless of whether the lights were turned on by a switch on the wall or the motion sensor, if there is no motion the lights will be turned off.
RaRGB modeIf set to 1, a short press on a switch cycles though colours, and a long press dims the lights
TaFlashing intervalIf input A is on then the outputs all flash. The Ta parameter is the total of the on time and the off time.


Here is an example of what the Lighting controller block looks like on the apps.