Automatic Shading

The Automatic Shading function block is used to control shading devices such as blinds, roller shutters, curtains or awnings.
In addition to manual operation, shading can be automated, based on sunlight and room temperature, in combination with Intelligent Room Controller.
The goal is to avoid overheating of a room due to solar radiation.

Table of Contents


Inputs

Abbreviation Summary Description Unit Value Range
Tg Toggle Toggles between open, stop, close.
For single button control.
- 0/1
Po Partial open with push & hold - 0/1
Pc Partial close with push & hold - 0/1
Co Complete open If in motion, stops. - 0/1
Cc Complete close If in motion, stops. - 0/1
So Slightly open Venetian blinds close completely and move slats in horizontal position according to parameter (Rd).
Roller blinds, curtains and awnings move into position according to parameter (Rd).
- 0/1
Sps Sun position automatic start Activates the sun position automatic when On at the beginning of the shading period, or also with a pulse during the shading period.
The sun position automatic is deactivated for the rest of the day, if block is operated manually. Pulse on (Spr) followed by a rising edge on (Sps) or pulse on (Spr) while (Sps) is active, restarts the sun position automatic.
- 0/1
DisSp Disable sun position automatic Disables the sun position automatic when On. - 0/1
Spr Sun position automatic restart Pulse followed by a rising edge at input (Sps) or pulse while input (Sps) is active, restarts the sun position automatic. - 0/1
Wa Wind alarm Moves shading to the wind alarm position set in parameter (Wap) and locks the block. Used for storm protection. Wind alarm is not a manual operation.
The name of the connected sensor is used in the user interface.
- 0/1
Dwc Door/window contact Opens shading completely and locks the block when On.
Manual operation via App is still possible.
(0 = closed, 1 = open).
- 0/1
Off Off Pulse stops movement. On locks the block.
Dominating input.
The name of the connected sensor is used in the user interface.
- 0/1
Pos Position of shading Move the shading to the specified position. % 0...100
Slat Position of slats Move the slats to the specified position.
This input is only visible in certain configurations.
% 0...100
T5 T5 control Button 1: Complete open
Button 4: Complete close
-
DisPc Disable periphery control Disables inputs Tg, Po, Pc, Co, Cc, So, T5 when On. (e.g Child lock, cleaning)
Control via user interface is still possible.
- 0/1




Outputs

Abbreviation Summary Description Unit Value Range
Op Open
This output is only visible in certain configurations.
- 0/1
Cl Close
This output is only visible in certain configurations.
- 0/1
Pos Position of shading Position of the shading (0.0 = open, 1.0 = closed) - 0...1
Slat Position of slats Position of the slats (0.0 = horizontal, 1.0 = vertical)
This output is only visible in certain configurations.
- 0...1
Sp Sun position automatic On, if input (Sps) = 1 and input (DisSp) = 0 ...and if the setting “Use sunshine variable” is checked and the sun is shining,
or if the Automation based on sun position is switched on in the App.
- 0/1
Wds Wind, door/window contact state Active when input (Wa) or input (Dwc) is 1. - 0/1
Off Off Active when input (Off) is 1. - 0/1
AQpp Command output Used with specific devices.
Command * 1000000 + Blind position in % * 1000 + Slat position in °.
Command 0 = Stop, 1 = Blind position + Slat position, 2 = Only blind position, 3 = Only slat position.
This output is only visible in certain configurations.
- 0/1
TPos Target position Target position of the shading. Can for example be used for Hunter Douglas shades. % 0...100
AC API Connector Intelligent API based connector.
API Commands
- -




Parameters

Abbreviation Summary Description Unit Value Range Default Value
Type Shading type Type of shading device
0 = Venetian blinds
1 = Roller blinds
2 = Curtains opening to both sides
3 = Schlotterer Retrolux
4 = Curtain left
5 = Curtain right
6 = Awning
- 0...6 0
Wap Wind alarm position 0 = Completely open
1 = Completely closed
- 0/1 0
Spe Sun position automatic end action 0 = No action
1 = Complete open
2 = Complete close
3 = Set slats horizontal
- 0...3 1
Tlc Time long-click Long-click duration on inputs (Po), (Pc) for complete open / close.
If you prefer a double-click, then set the value > (Opd) or (Cld).
0 = Always start complete travel.
s 0...∞ 3
Opd Opening duration s 0...∞ 75
Cld Closing duration s 0...∞ 70
Mld Motor lock duration Duration of motor lock between direction changes. s 0...∞ 0,5
Tdc Time double-click Double click duration on inputs (Po), (Pc) for complete open / close.
0 = Not used
s 0...∞ 0,3
Rd Return duration Return duration for horizontal alignment of slats.
Slightly open position for roller blinds, curtains and awnings.
s 0.1...∞ 0,8
Bldo Backlash duration opposite Backlash duration when moving in opposite direction.
This parameter is only visible in certain configurations.
s 0...∞ 0,15
Bld Backlash duration Backlash duration when moving in same direction.
This parameter is only visible in certain configurations.
s 0...∞ 0
minTd Minimum travel duration Minimum travel time at pulse on input (Po) or (Pc). s 0...∞ 0,4
Dir Compass direction Compass direction of the window:
0 = north
90 = east
180 = south
270 = west
-1 = not configured
° -1...360 -1
Dts Direction tolerance start Direction tolerance for the sun position automatic when the sun enters the shading area. ° 0...90 85
Dte Direction tolerance end Direction tolerance for the sun position automatic when the sun exits the shading area. ° 0...90 85
Sw Slat width Width of the slats.
This parameter is only visible in certain configurations.
mm 0...∞ 70
Sd Slat distance Distance between two horizontal slats.
This parameter is only visible in certain configurations.
mm 0...∞ 60
Spm Sun position automatic mode 0 = Optimal brightness - no direct sunlight, with as much light as possible.
Automatic remains off with closed shading. If the input (Sps) is active, a pulse on (Spr) restarts the sun position automatic.

1 = Optimal cooling - blocks even more solar radiation, but also results in lower brightness.
Automatic remains off with closed shading. If the input (Sps) is active, a pulse on (Spr) restarts the sun position automatic.

2 = Optimal brightness - no direct sunlight, with as much light as possible.
Automatic is activated even when the shading is closed.

3 = Optimal cooling - blocks even more solar radiation, but also results in lower brightness.
Automatic is activated even when the shading is closed.

This parameter is only visible in certain configurations.
- 0...3 1
Spi Sun position automatic interval Specifies how often the slats may adjust during sun position automatic control.
This parameter is only visible in certain configurations.
min 1...180 120
Spos Sun position automatic start offset Start offset of the sun position automatic relative to Sunrise. min -90...90 30
Spoe Sun position automatic end offset End offset of the sun position automatic relative to Sunset. min -90...90 -30
Rdd Reference Drive Down When ON, every close command triggers a full drive down, ensuring the blinds move for the entire configured closing duration. Even if the blinds are already closed, the system will reactivate the relays to ensure the shades align with their hardware-defined end position. The shading controller doesn’t define the lower limit—this is determined by your blinds’ setup.
This parameter is only visible in certain configurations.
- 0/1 0




Properties

Summary Description Value Range Default Value
History Entries Number of entries in the control history.
0: History is disabled
Control history tracks relevant changes since program start.
0...100 20
Use sunshine variable Sun position automatic is only activated if the system variable Sunshine and the input Sps are active. - -




Type of shading device

The function block and the user interface adapt based on the following types:

0: Venetian blinds and external blinds

1: Roller shutters and roller blinds

2:Curtains on both sides

3: Schlotterer Retrolux (special slats prevent direct sunlight, which makes readjusting the slats unnecessary)

4: Curtain one-sided left

5: Curtain one-sided right

6: Awning


Programming example

A Loxone Touch is connected to the T5 input, to operate the function block according to the Loxone switch standard.
The outputs (Op) and (Cl) are connected to the outputs that control the shading device.
The parameters (Opd) and (Cld) specify the run times.
The parameter (Type) defines the type of shading device.

In addition, the compass direction is specified in parameter (Dir), to ensure that the sun position automatic is only activated when the sun is actually shining on the window. On demand, the Intelligent Room Controller requests shading via the output (Shd) to the input (Sps) of the Automatic Shading block.

When using venetian blinds, the parameters Rd, Bld, Bldo, Sw, Sd must also be set for them to be controlled correctly.


Functional Description

When configured with the recommended settings, the sun position automatic is activated when the room controller enables it via input (Sps). If however, the sun position automatic is activated manually, e.g. via App, the signal from the room controller is not required.

The sun position automatic begins when the sun reaches the shading area and ends when it passes.

During this time, the slats are adjusted according to the angle of the sun. At the end, the blinds move to the position specified with parameter (Spe).

Manual shading, independent of the sun's position, can be triggered via input (So) or in the App with "Slightly open". The slats are then adjusted horizontally.

The sun position automatic can be deactivated via input (DisSp).

If the blinds are operated manually during shading period (e.g. using an app), then the sun position automatic is deactivated for that shading period. To reactivate the automatic control, a pulse on input (Spr) or activation via App is necessary.

When the sun position automatic is activated, the blinds may not adjust immediately. Shading only starts based on the position of the sun and the related parameters.

Output (Sp) indicates whether the sun position automatic is active.

To control multiple blinds simultaneously, the corresponding central function block is used.

Additional inputs, outputs and parameters may be required if standard push buttons are used or additional logic is programmed.


Direction parameters

Dir: Compass direction of the shading device relative to the geographical north. (0 = North, 90 = east, 180 = south, 270 = West)

Dts: Direction tolerance when the sun enters the shading device. The directional tolerance is relative to the perpendicular angle of the shading device. Consider, for example, building protrusions. If your shading device is not affected, you can leave this at its default value of 85º.

Dte: Direction tolerance when the sun exits the shading device. The directional tolerance is relative to the perpendicular angle of the shading device. Consider, for example, building protrusions. If your shading device is not affected, you can leave this at its default value of 85º.


Start / End offsets

With parameter (Spos), the sun position automatic will be delayed by this number of minutes after sunrise.
This is relevant for windows that may not get the sun directly after sunrise.

With parameter (Spoe), the sun position automatic will be brought forward by this number of minutes before sunset.
This is relevant for windows that may be affected by the sun prior to sunset.

There are two possible applications for the two parameters:

Often the sun is obscured by other buildings, structures or trees after sunrise and before sunset. Here, the start or end time of the sun position automatic can be adapted to accommodate for these.

Another possibility is to shift the times so that sunrise or sunset can be seen with the shading open.


Backlash duration

The parameter (Bld) is added to the required percentage of (Rd) when adjusting the slats, if the preceding run was in the same direction. The parameter only affects slat adjustment, as a change of direction is always necessary when the sun position automatic is activated. If the slat position is correct at the start of sun position automatic, but becomes inaccurate over the course of the day, this parameter must be adjusted.

The parameter (Bldo) is added to the required percentage of (Rd) when adjusting the slats, if the preceding run was in the opposite direction. If the slat position is already incorrect at the start of sun position automatic, the sum of (Rd + Bldo) is either too high (sun shines in between the slats) or too low (blind closed too far)

For windows facing east, there is only one change of direction, as the slats are opened more and more during the course of the day; for windows facing west, the blind changes direction when adjusting for the first time.


Slat adjustment

When the sun position automatic is active, the blind slats are adjusted based on the sun's position.
The slats are tilted to an angle that prevents any direct sunlight from entering in between them.

Generally, the adjustment is carried out at the intervals set with parameter (Spi), but only at 15° increments, and only if necessary.
If, for example, the sun's path is at a relatively constant angle, its elevation will hardly change. For this reason, an adjustment is not necessarily carried out at every interval.

When the sun is rising, the value required at each interval is calculated and the slats are adjusted if necessary.
When the sun is setting, the value required for the following interval is calculated at each interval and the slats are adjusted if necessary.


Complete movement, end positions and remanence

When fully opening the blinds (via Co, central function block or the App), they are always activated for the entire UP duration, regardless of the current position. This ensures that the blinds move into the defined end position. This is equivalent to a reference run.

However, for safety reasons, when fully closing the blinds, they are only activated for the determined remaining run time.

The actual position of the blinds is stored in the Miniserver using the block's remanence function.

If e.g. the blinds are moving up and a power failure occurs immediately thereafter, the new position can not be registered by the Miniserver. When power returns, the system will remember the previous position of the blinds, although they are actually raised.

If a downwards movement is then triggered, it will not be executed at all or not far enough, because the previous position is still stored. Also the status displayed in the App will not match the actual position.

In such and similar cases, a complete open movement must first be executed, then the shading will again operate as expected.


Function for setting the end limits

Since Loxone Config version 12.1, shading technology specialists have had a function available in the visualisation of the block for setting the end positions of the shading.
This function is comparable to commercially available setting cables, and requires precise knowledge and observance of the operating instructions of the respective motor.

In the open visualisation of the block, the function can be called up in the menu. For users with full access, the function is then accessible after entering the password:


Enable Sun Position Automatic via User Interface

The sun position automatic can be started manually via the user interface, thereby blinds are lowered when the sun is at the window. Whether the sun is shining, it is cloudy, or the Sps input of the block is active or not is not taken into account.


Timing Diagram


History

In the user interface, the history of the function block can be displayed.
A maximum of 100 entries are shown.
When you restart or save to the Miniserver, the history is cleared.