FB_BA_InRngAzm
This function block checks whether the current azimuth angle (horizontal position of the sun) lies within the limits entered. As can be seen in the overview, the function block provides an additionally evaluation as to whether the sun shading of a window group should be activated. Therefore the observations in the remainder of the text always apply to one window group.
Functional description
The sun incidence azimuth angle on a smooth facade will always be facade orientation-90°... facade orientation+90°.
If the facade has lateral projections, however, this range is limited. This limitation can be checked with the help of this function block. However, the position of the window group on the facade also plays a role. If it lies centrally, this gives rise to the following situation (the values are only examples):
The values change for a group at the edge:
The beginning of the range lrSttRng may thereby be larger than the end lrEndRng; it is then regarded beyond 0°:
lrAzm | 10.0° |
lrSttRng | 280.0° |
lrEndRng | 20.0° |
bOut | TRUE |
However, the range regarded may not be greater than 180° or equal to 0° – this would be unrealistic. Such entries result in an error on the output bErr – the test output bOut is then additionally set to FALSE.
Inputs/outputs
VAR_INPUT
lrAzm : LREAL;
lrSttRng : LREAL;
lrEndRng : LREAL;
lrAzm: current azimuth angle
lrSttRng: start of range [°]
lrEndRng: end of range [°]
VAR_OUTPUT
bOut : BOOL;
bErr : BOOL;
udiErrId : UDINT;
udiErrArg : UDINT;
bOut: The facade element is in the sun if the output is TRUE.
bErr: This output is switched to TRUE if the parameters entered are erroneous.
udiErrId / udiErrArg: Contains the error number and the error argument. See Error codes.
Requirements
Development environment | Target system | required library | required supplement |
|---|---|---|---|
TwinCAT 2.11 R3/x64 | PC/CX | TcBA library from V1.0.0 | TS8040 | TwinCAT Building Automation from V1.0.0 |