[CALC_AGL] Calculate slat angle from solar position

Function block CALC_AGL determines the slat angle for shading from the engineered solar angle of entry.

CALC_AGL determines the slat angle for shading from the engineered solar angle of entry. The result is outputted as a slat angle and the blind position number.

Functioning

CALC_AGL uses only 4 different solar positions [SolAglSet] to calculate the required slat angle. As a result, the changing the slat angle is limited to a maximum of 8 actions per day.
A slat angle [SlatsAglSet] is parameterized for each of the solar positions.
CALC_AGL determines, based on the projected solar angle of entry [PrjAgl] one of the 4 solar positions [SolAglSet] using the corresponding parameterized slat angle [SlatsAglSet] and the associated blinds position number [BlsPosNr].

Solar positions	[SlatsAgl]	[BlsPosNr]
-180° < PrjAgl < SolAglSet1	AglPosNr1	1
SolAglSet1 < PrjAgl < SolAglSet2	AglPosNr1	1
SolAglSet2 < PrjAgl < SolAglSet3	AglPosNr2	2
SolAglSet3 < PrjAgl < SolAglSet4	AglPosNr3	3
SolAglSet4 < PrjAgl < 180°	AglPosNr4	4

CALC_AGL supplies the required slat angle [SlatsAgl] in % and as predefined blinds position number [BlsPosNr] (corresponding to the blinds motor used).
The calculation is immediate and without hysteresis.

Pins

Input	Description	Data type	Default value Value range
PrjAgl	Projected solar incidence angle	Real	0.0 0…100
SlatsPosOpn	Slat position value for open	Real	20.0 [%] 0…100
SlatsPosClsd	Slat position value for closed	Real	100.0 [%] 0…100
SolAglSet	Settings for solar angle	Structure	---
SolAglSet > AglPosNr1	Angle for position number 1	Real	0.0 [%] 0…100 [%]
SolAglSet > AglPosNr2	Angle for position number 2	Real	10.0 [%] 0…100 [%]
SolAglSet > AglPosNr3	Angle for position number 3	Real	25.0 [%] 0…100 [%]
SolAglSet > AglPosNr4	Angle for position number 4	Real	40.0 [%] 0…100 [%]
SlatsAglSet	Settings for slat angle	Structure	---
SlatsAglSet > AglPosNr1	Angle for position number 1	Real	60.0 [%] 0…100 [%]
SlatsAglSet > AglPosNr2	Angle for position number 2	Real	45.0 [%] 0…100 [%]
SlatsAglSet > AglPosNr3	Angle for position number 3	Real	25.0 [%] 0…100 [%]
SlatsAglSet > AglPosNr4	Angle for position number 4	Real	0.0 [%] 0…100 [%]

Output	Description	Data type	Default value Value range
SlatsAgl	Slat angle Angle of louvers or slats	Real	0.0 [%] 0...100 [%]
BlsPosNr	Blinds position number	Integer	0 0...4 (BA Predefined blinds position)

Output

Description

Data type

Default value
Value range

SlatsAgl

Slat angle

Angle of louvers or slats

Real

0.0 [%]

0...100 [%]

BlsPosNr

Blinds position number

Integer

0...4 (BA Predefined blinds position)

Application

Centralized shading (with tracking of the position of the sun)

Troubleshooting

Standard troubleshooting:

Numerical errors are handled in dependence of the respective context:

Tool

Offline

Error message.

Shows a non-conformant value.

Online

Error message.

The non-conformant value is displayed in red in the Parameter Editor.

Function block code

No troubleshooting.