FB_BA_AnlgLgtActr
Funktionsbaustein zum Ansteuern eines analogen Lichtaktors, beispielsweise über eine KL2751
Funktionsbeschreibung
Der Baustein empfängt seine Kommandos über das Befehlstelegramm stLgtCmd.
Als konventioneller Analog-Ansteuerungsbaustein besitzt er Lichtwert-Ausgänge als LREAL-Wert [0..100%], als INT-Wert [0..32767] und als booleschen Wert (EIN/AUS), der bei bestimmten Lampenarten das Schalten eines AUS-Relais ermöglicht.
Dieser Baustein muss in jedem SPS-Zyklus aufgerufen werden, da die SPS-Zykluszeit in die Berechnung der Dimmrampe mit einfließt. |
Ein-/Ausgänge
VAR_INPUT
lrSttupCtrlVal : LREAL;
lrMinCtrlVal : LREAL;
lrMaxCtrlVal : LREAL;
lrLgtOffset : LREAL;
udiDimTi : UDINT;
uiBlinkTi : UINT;
uiOffDly : UINT;
stLgtCmd : ST_BA_LgtCmd;
lrSttupCtrlVal : Lichtwert nach Neustart. [lrMinCtrlVal..lrMaxCtrlVal]. Eingabe als Prozentwert (0%..100%). Dieser Wert wird nur im ersten Aufruf-Zyklus übernommen. Fehlerhafte Einträge kleiner lrMinCtrlVal oder größer lrMaxCtrlVal werden automatisch begrenzt.
lrMinCtrlVal: Minimaler Lichtausgabewert. [1..lrMaxCtrlVal]. Eingabe als Prozentwert (1%..100%). Eine Änderung dieses Wertes wirkt unmittelbar. Fehlerhafte Einträge kleiner 1.0 oder größer 100.0 werden automatisch begrenzt.
Zur Kontrolle wird der resultierende Wert am Ausgang lrActlMinCtrlVal ausgegeben, wobei zu beachten ist, dass auch Wertänderungen über das Befehlstelegramm stLgtCmd angenommen werden. Die letzte Änderung ist jeweils gültig.
lrMaxCtrlVal: Maximaler Lichtausgabewert. [lrMinCtrlVal..100%]. Eingabe als Prozentwert (1%..100%). Eine Änderung dieses Wertes wirkt unmittelbar. Fehlerhafte Einträge kleiner lrMinCtrlVal oder größer 100.0 werden automatisch begrenzt.
Zur Kontrolle wird der resultierende Wert am Ausgang lrActlMaxCtrlVal ausgegeben, wobei zu beachten ist, dass auch Wertänderungen über das Befehlstelegramm stLgtCmd angenommen werden. Die letzte Änderung ist jeweils gültig.
lrLgtOffset: Möglichkeit den Helligkeitswert zu erhöhen oder zu erniedrigen. Dieser Effekt ist nur in Verbindung mit dem Befehl bSetCtrlValDct der Kommandostruktur stLgtCmd wirksam. In diesem Fall wird der Lichtaktor auf den Wert lrSetCtrlValDct+lrLgtOffset gesetzt. Derr Wert kann dabei nicht den eingestellten Maximalwert überschreiten bzw. den Minimalwert unterschreiten. Ein Abschalten jedoch ist möglich, wenn lrSetCtrlValDct+lrLgtOffset kleiner oder gleich Null ist.
uiDimTi: Dimmrampe [ms]: Zeit in der von 0 auf 100% gedimmt wird.
uiBlinkTi / udiOffDly: Mit diesen beiden Zeiten [s] lässt sich eine Ausschaltwarnung, beispielsweise für eine Treppenhausbeleuchtung erzielen. Zu dem Zeitpunkt, an dem die Leuchte normalerweise abschaltet, kommen diese beiden Intervalle zusätzlich zum Tragen: für die Zeit uiBlinkTi [s] wird das Licht ausgeschaltet und danach für die Zeit uiOffDly [s] noch einmal eingeschaltet.
stLgtCmd: Befehlstelegramm vom Typ ST_BA_LgtCmd
VAR_OUTPUT
lrActlLgtLvl : LREAL;
iActlLgtLvl : INT;
bLgt : BOOL;
lrActlMinCtrlVal: LREAL;
bMinCtrlValRchd : BOOL;
lrActlMaxCtrlVal: LREAL;
bMaxCtrlValRchd : BOOL;
lrRstVal : LREAL;
bErr : BOOL;
udiErrId : UDINT;
udiErrArg : UDINT;
lrActlLgtLvl: Aktuelle Stellgröße [0..100%]. Berechnung siehe unten.
iActlLgtLvl: Aktuelle Stellgröße [0..32767]
bLgt: Aktuelle Stellgröße (EIN / AUS)
lrActlMinCtrlVal: Aktueller Min-Wert (über Eingang oder Kommandostruktur beschrieben)
bMinCtrlValRchd: Der Aktor hat seinen Minimalwert erreicht.
lrActlMaxCtrlVal: Aktueller Max-Wert (über Eingang oder Kommandostruktur beschrieben)
bMaxCtrlValRchd: Der Aktor hat seinen Maximalwert erreicht.
lrRstVal: Letzter Wert vor Aus als Wiedereinschaltwert, d.h. vor dem Ausschalten wird der aktuelle Stellwert hier gespeichert.
bErr: Lichtbaustein im Fehlerzustand
udiErrId / udiErrArg: Fehlernummer und -argument zur Bestimmung der Ursache, siehe Fehlercodes.
Voraussetzungen
Die Warnmeldungen zur Autokorrektur der Minimal- und Maximalwerte liegen nur für einen SPS-Zyklus an, da die Korrektur den Fehler selbst behebt. |
Entwicklungsumgebung | Zielsystem | erforderliche Bibliothek | erforderliches Supplement |
---|---|---|---|
TwinCAT 2.11 R3/x64 | PC/CX | TcBA-Bibliothek ab V1.0.0 | TS8040 | TwinCAT Building Automation ab V1.0.0 |