FB_BA_Facade

This template compiles the sun protection telegrams that are valid for an entire facade.

The telegrams are largely formed in sub-templates in the main part, then passed to a telegram selector FB_BA_SunBldTgmSel8 and supplemented by the resulting alarm telegram from the building data (fire, burglary or icing).

The passed telegram from the selector is placed on the output structure stFacade together with the enables from the thermal and twilight automatic and the current sun protection data - the priority of the telegram is displayed in the sub-template FacadeInformation.

Telegrams

The following telegrams are available at the telegram selector SunBldTgmResult, sorted by input:

Protection telegram communication error (CommError)
The global variable list Site also contains the error states of the subscribers, which can only change to TRUE if the corresponding subscriber is actually used. In the event of a subscriber failure or a weather station malfunction, the blinds are raised as a precaution.
Protection telegram Storm (WindProtection)
Positioning telegram Maintenance (Maintenance)
Positioning telegram for facade thermal automatic (ThermoAutomatic)
Positioning telegram for twilight automatic (TwilightAutomatic)
Positioning telegram park position (ParkPosition)
Alarm telegram fire/burglary/icing
This telegram (Site.stBuildingSunBlind.stSunBld) is usually created on the building controller in the template FB_BA_BuildingSunprotection and placed on the Site variable list. It contains the building-wide telegrams for icing, burglary and fire.

Sun protection calculation

Sun protection is calculated separately for each facade. This is done in the sub-template SunProtection. The calculated values are placed on the output structure stFacade together with the enables from the thermal and twilight automatic.

	The initialization of the template takes place within the method FB_Init.

Syntax

FUNCTION_BLOCK FB_BA_Facade EXTENDS FB_BA_View
VAR_INPUT
  fRefRmT                  : REAL;
  fRefRmTCol               : REAL;
  fRefRmTHtg               : REAL;
END_VAR
VAR_OUTPUT
  stFacade                 : ST_BA_Facade;
END_VAR
VAR_INPUT CONSTANT PERSISTENT
  fFcdOrtn                 : REAL;
  fFcdAngl                 : REAL;
  fLamWdth                 : REAL;
  fLamDstc                 : REAL;
  fAzmSttRng               : REAL;
  fAzmEndRng               : REAL;
  fElvLoLmt                : REAL;
  fElvHiLmt                : REAL;
END_VAR
VAR_INPUT CONSTANT
  CommError                : FB_BA_SunBldEvt :=(ePrio:=E_BA_SunBldPrio.eCommError);
  WindProtection           : FB_BA_Facade_WindProtection;
  Maintenance              : FB_BA_Facade_Maintenance;
  ThermoAutomatic          : FB_BA_Facade_ThermoAutomatic;
  TwilightAutomatic        : FB_BA_Facade_TwilightAutomatic;
  ParkPosition             : FB_BA_Facade_ParkPosition;
 SunProtection             : FB_BA_Facade_SunProtection;
 FacadeInformation         : FB_BA_Facade_Information;
END_VAR
VAR
  InRngAzm                 : FB_BA_InRngAzm;
  InRngElv                 : FB_BA_InRngElv;
  bFcdInSun                : BOOL;
  SunBldTgmResult          : FB_BA_SunBldTgmSel8;
END_VAR

Inputs

Name	Type	Description
fRefRmT	REAL	Room temperature of the reference room for the facade-wide thermal automatic.
fRefRmTCol	REAL	Room temperature setpoint cooling of the reference room for the facade-wide thermal automatic.
fRefRmTHtg	REAL	Room temperature setpoint heating of the reference room for the facade-wide thermal automatic.

Outputs

Name	Type	Description
stFacade	ST_BA_Facade	Output structure of the collected facade data.

Inputs CONSTANT PERSISTENT

Name	Type	Description
fFcdOrtn	REAL	Facade orientation northern hemisphere: north=0°, east=90°, south=180°, west=270°, in the southern hemisphere applies: south=0°, east=90°, north=180°, west=270°.
fFcdAngl	REAL	Inclination of the facade [°]. Inclined downwards, the angle is smaller, upwards it is greater than zero.
fLamWdth	REAL	Lamella width [mm].
fLamDstc	REAL	Lamella spacing [mm].
fAzmSttRng / fAzmEndRng	REAL	The facade is considered to be illuminated by the sun when the position of the sun is +/-90° of the facade orientation. With fAzmSttRng / fAzmEndRng the range can be restricted.
fElvLoLmt / fElvHiLmt	REAL	The facade is considered to be illuminated by the sun when the sun elevation is between 0 and 90°. With fElvLoLmt / fElvHiLmt the range can be restricted.

Inputs CONSTANT

Name	Type	Description
CommError	FB_BA_SunBldEvt	Telegram block for the communication error
WindProtection	FB_BA_Facade_WindProtection	Sub-template storm protection
Maintenance	FB_BA_Facade_Maintenance	Sub-template maintenance
ThermoAutomatic	FB_BA_Facade_ThermoAutomatic	Sub-template thermal automatic
TwilightAutomatic	FB_BA_Facade_TwilightAutomatic	Sub-template twilight automatic
ParkPosition	FB_BA_Facade_ParkPosition	Sub-template park position
SunProtection	FB_BA_Facade_SunProtection	Sub-template sun protection
FacadeInformation	FB_BA_Facade_Information	Sub-template facade information

Variables

Name	Type	Description
InRngAzm	FB_BA_InRngAzm	Sun direction within the defined limits
InRngElv	FB_BA_InRngElv	Sun elevation within the defined limits
bFcdInSun	BOOL	Facade in the position of the sun
SunBldTgmResult	FB_BA_SunBldTgmSel8	Telegram selection block for the resulting blind telegram of the facade

Requirements

Development environment	Necessary function
TwinCAT from v3.1.4024.35	TF8040 \| TwinCAT Building Automation from V5.0.0.0