Lighting Controller

The Lighting Controller is the main function block for lighting in any room. It allows you to configure multiple light circuits all together in one place and create moods from these various lights. These moods can then be associated with operating modes in order for the scene brought on with motion to be varied depending on which mode the house is currently in.


Whether you are looking to use an output as dimming, switched (on/off) or RGBW (colour) the lighting controller can manage this. The following are the supported types of lighting with the Lighting Controller.

  • Switch
  • Dimmer 0-100%
  • Dimmer 0-10V
  • Dimmer 1-10V
  • RGB
  • Lumitech
  • Smart actuator

New functions in addition to those available with the original Lighting Controller Verison 1 function block:

  • Dynamic fade time for supported outputs (Smart Actuators)
  • Mix moods together
  • Colour sequencing mode (colour changing)
  • Unlimited number of moods
  • Mood “Bright” (previously All On) now configurable
  • Master brightness control in the app
  • Master colour control in the app
  • Support of operating modes
  • Favourites are valid globally, not just for each block
  • Alarm clock mood with for use with alarm clock fading time

An existing lighting controller can be easily converted to a Lighting Controller V2 with the button “Convert Block”.

This function replaces the existing block, scenes, Input & Output connections and parameters are copied.

Please note that this feature will also convert applicable outputs to Smart Actuators as such it is strongly recommended that you review the naming of the outputs as they may no longer be correct. If a 230V Dimmer extension is being used for the outputs will need to have the “Dimming Type” set again in the properties of the Dimmer output.


The majority of the configuration of the Lighting Controller can be done by Auto Config. Here is an example of the Lighting Controller that has been configured by Auto Config.

As you can see the lighting controller is automatically connected with the Motion Sensor (Mv) input, the Touch switch (T5), Brightness Sensor (AIb) and the associated outputs. There are also memory flags connection the lighting controller for other functions such as Leaving Room and Good Night. For more information on the features Auto Config creates see the Auto Config documentation page.


Double-clicking on the lighting controller can be further configured by double-clicking on it. This will bring up a window giving the option to edit and change Lighting Circuits, Moods and Automatic functionality.


The Light Circuits tab allows you to rename and change the type of the light circuit confifured. The lighting controller will automatically pick up on both the name and the type of lighting circuit when it is connected to the bock either manually or through auto config. When the last free output is renamed (text not empty), the next free output is automatically added until the maximum number of 18 outputs is reached.


In the block, any number of moods can be stored, which can also be changed via the visualization. The inputs T5 / 1 – T5 / 8 can be used to directly control moods by a single pulse. You can scroll through the defined moods by using the + and – inputs.

If an analogue value is sent into input AIs, the desired mood can be selected directly. If the value 7 is set here, mood 7 will be activated.


To define moods, double-click on the block. Alternatively, you can add light scenes by clicking on the “Click here” field in the Properties window. A window appears in which you can set the eight light scenes to the desired type for outputs AQ1-AQ12.

This gives you the opportunity to set up all the moods through Loxone Config, the following describes the various options.

  •  Mood
    • Name of the mood to be displayed in the UI
  • Input
    • Which input on the Lighting Controller the mood is tied to (O/R/T51-8). This when using T5 inputs this will prioritise this mood with that switch. i.e. the mood scroll will go to the prioritised mood first
  • Number (for AIs/AQs)
    • Mood number for use with AIs. All numbers greater than 8 have no input and can only be used via app/AIs/MS.
  • +
    • If a mood is deselected, this is then not included in the scene scroll, but can still be used via AIs/logic or the app.
  • Mix
    • This will change the behaviour of the associated input, such as T5/1, to be a mix/unmix function. Thus pressing this button will initially mix in the mood and then unmix when this button is pressed again.

The buttons below the Mood creator are for the following:

+: A new mood will be added to the  list
Eraser: Delete selected mood
Up / Down: change the position of the mood; this corresponds to the mood order in the app.
All Off / All On: All visible outputs of the mood are set to maximum for All On and 0 All Off.

It is possible to adjust the “Bight” (All On) mood (default: all channels to maximum). “Unimportant” lights like a reading lamp here are not included.


When setting a mood with a RGBW Smart Actuator or RGB Ouput the options to change the colour for that mood is presented as a colour picker. The Colour Picker gives three tabs, Colour, Warm White and Colour Sequence (only for Smart Actuators)


Any colour can be chosen the circuit in the Colour Picker’s “Colour” tab. In the left-hand side list, all saved (favourite) colours are displayed. When clicking on the favourite colours, this is selected directly in the colour picker either through the app or the config. The + button adds the current colour to the favourites, button delete; removes the selected saved colour.


The “Warm White” tab works identically to the “Colour” tab.


With the “Colour Sequence” tab you can set a sequence of colours to be scrolled through over time by the RGBW light. Clicking on the + icon (1) will add new points to the colour picker. You can add up to 6 colour points to cycle through. By clicking on the colour (2) the respective step can be configured or re-configured. The currently selected colour is indicated by a large cross in the colour picker window, all other colours are small crosses.
The “Colour change interval” (3) determines the time to change from one to the next.

In this example screenshot above, it would take 15 minutes before the first colour is selected again (3 colours x 2 minutes 30 seconds). On the left, the current sequence can be saved as a favourite or removed from the favourites.


The mix mood function means that a secondary mood can be added to the already active moods.

For example, if you were to walk into a room with the spots coming on full brightness as brought on by the mood associated with the motion sensor. Now, if you sit down to read a book, by using the app or a dedicated T5 switch the ‘Reading’ mood can be brought on which will turn add the side lamp to the current mood. This is referred to generally as “Task Lighting”.

The ‘Reading’ mood can be a mood that isn’t used in a general mood scroll.


If one output is used in more than one mood and two (or more) of these are being mixed together. In this case, the light will only be mixed in if it’s brightness level is higher in the mood being mixed in than the current level.

For example, Output 1 is a dimmer that is currently on 30%, if the mood that is being mixed in has this output set with a brightness of >30% it will be changed to this value. If the brightness is <30% no change will be made.


The T5 buttons work as before to switch on and scroll through the moods. In addition, however, the “First Mood” is determined is prioritised when turning on or pressing the button for the first time.
T5/1: Moods 1, 2, 3, All On, All Off
T5/3: Moods 3, 1, 2, All On, All Off

Long-clicks on T5/x Inputs are done of time period equal to or longer than the time defined in parameter Tm (Mixing Period) is carried out, the mood associated with this T5 input is then mixed in rather than changed to. For example, if mode 1 is active, a long-click on T5/2 mixes mood 2.


The Automatic tab allows me to automate the bringing on of lights when the motion sensor is triggered based on active operating modes.

There are 4 columns in this screen, here is a description of what each one does.

  • Priority
    • This column indicates the priority of the line, if more than one operating ode is active from this list then the one at the top of then list is prioritised.
  • Active operating mode
    • The operating mode that must be active in order for the automatic functionality for this line to take action.
  • Mood selected on motion
    • What mood from the list of created moods should be tied to the mode and the motion sensor.
  • Action
    • On activating the associated mode what action to take. There are three options.
      • Only use if previously “All Off” – this will only bring the associated mood on with the moition sensor if the lights were previously All Off.
      • Always change – this will change the mood to the selected one for this line when the motion sensor is triggered if this mode is on or turned on.
      • Mix with current mood – the selected mode will be mixed with the current mood when the motion sensor is triggered.


For Loxone Air and Tree lighting products, the actuator type “Smart Actuator” has been inserted as a property option and will be used as default. This type of actuator supports variable fading times as opposed to the fixed increase of previous actuators. This can be set in the properties of the respective device under “Actuator type”.

Fading behaviour (only for Smart Actuators)
– Switching on or off: fading time defined in Lighting Controller Parameter Tf
– Colour sequence: fading time = time interval set within sequencer
– Change via app: directly jumps to new value


A short pulse at an input I1-I4 is used to switch the associated output ON/OFF. With long-clicks (press and hold), dim up/dim down functionality can be achieved. The dimming behaviour depends on the settings of the parameters SI, ST, Min, Max, W and L. These are described in the tables at the bottom of this page

The parameter SI, sets the step width in % and St is the time between steps in seconds. The limits of dimming are set via the parameters Min and Max. If the parameter W is deactivated, the dimmer is stopped when the limit values are reached rather than looping back around (up-down mode). With the parameter L the last dimming value is set if a single short click on the switch is detected, otherwise, the dimming starts at the minimum value.


If a double-click is detected on one of the inputs I1-I4 or T5 / 1-T5 / 8, all outputs of the Lighting Controller will be set to 0. Also, the output RQ will provide a single pulse, this is exceptionally useful for functions such as “leaving room”.

Application example: When a room is excited and you double click the switch, all lights and music are turned off and shading and heating go back into automatic mode.


If a triple click is detected at one of the inputs I1-I4 or T5 / 1-T5 / 8, all outputs of the light control are reset. FAlso, the output RaQ will provide a single pulse, this is exceptionally useful for functions such as “leaving house”/”All Out”.


The user interface for the lighting controller provides an easy way to select between, edit and mix moods. Here are some of the functions the App/Web Interface of the lighting controller can give.


This function at the top of the lighting controller’s edit screen sets the brightness of all outputs proportionally to the respective current brightness.

When using this function here are how respective output circuits behave:
– Switch: switches on when brightness is greater than 0
– Dimmer: sets the desired brightness
– RGB, Lumitech: colour is retained, brightness is adjusted

If the master brightness is 100% and the brightness of an output is only 50%, if the master brightness is reduced by 50% from 100 to 50 (= 50% reduction), this means the output is also reduced by 50% of current value. i.e. 25%.


This works the same as master brightness, except for colour. The temperature, brightness, and colour change for all supported output types; RGB, Lumitech & Composite can be changed all at once.

Dimmers and switches are not changed here.



The selected colour can be added to the favourites with a click on the star and is then available in every Lighting Controller. Clicking on the star again deletes it from the list.


Click and drag in the colour circle to jump directly to your chosen colour, while releasing is then faded to the next colour. If you configure colour 1 and colour 2 only, for colour 3 the next step will be faded back to colour 1.

Adjustment at runtime: If one fades in the above example between 1 (blue) and 2 (green) one would have an aqua hue at halfway between the two colours in time.


To mix moods in the app simply press the plus button next to the mood in the mood list. To unmix the moods simply click on the minus sign next to the now mixed mood.



Input Name Description
I1-I4 Trigger inputs Refers directly to the output (for example I1 to AQ1)
+ Next  mood Input for next mood
Previous mood Input for previous mood
As Selection of mood (0-9) Selects mood
R Reset Sets all outputs to 0
T5 / 1-T5 / 8 Input for T5 switch with a priority for an individual mood The corresponding mood is started by pulse
DisMv Lock motion detector Prevents lighting controller from bringing the lights on during motion
Mv Motion detector Starts the motion detector scene
O All On (All outputs to maximum) Scene 99 (Bright) is started
 A Alarm If on, all outputs flash (on-off duration can be set via parameter Ta)
 Bu Alarm clock input Assigned alarm clock tuning with fade time Tb
AIb Brightness Valu for current brightness
 Dis Disable Child protection – blocks all inputs, but not the app.


Output Name Description
AQ1 – AQ18 Output for light control
AQs Active light scene (-1-9) -1 or -3 = undefined, 0 = all off, 9 = all on
RQ Reset output Outputs a pulse with reset or a double click
RAQ Reset by triple click Outputs a pulse on a triple click


Parameter Name Description
R Resets the block
M Max. Time interval Max. Time interval between two pulses so that a double-click is detected
SI Step dimmer Indicates the percentage steps
ST Step dimmer Indicates the time the step is over
Min Minimum value of the dimmer Lower limit
Max Maximum value of the dimmer Upper limit
W Mode Up / Down Dimmer (1 = Up / Down)  Enables up down mod. If disabled dimmer will halt at 100%  when rising, if enabled it will go to 100% then back down again if the switch is held
L Do not set last value  When a dimmer switch is pressed this can enable/disable “using last value” when coming on.
TH Switch-on duration Motion detector  Duration after last motion the lights are turned off if there has been no manual interaction.
Ti Temporal lock for motion detectors Disables the motion sensor after switching off for the set number seconds. If this value is 0, the state of DisMv applies
MS Motion scene Select which scene is connected to motion detector (legacy from V1)
MT Motion detector timeout Scene is switched off after “MT” seconds without movement if there has been a manual interaction.
Ra RGB mode If 1, the base colours are switched through with a short keypress, with long press dimming
Ta Blinking period alarm If input A = 1, all outputs flash. The time Ta = ON Duration + OFF Duration
Tb Fading alarm clock Fade time when activating the alarm clock
T Maximum brightness If the current brightness exceeds this value, the motion detector scene is not activated during movement
tm Add the mood Duration of a long click required to Mix a mood.
tf Fading time moods When changing moods