FB_DALI209SetColourTemperatureTc

Der Baustein speichert den Wert nColourTemperatureTc in die Variable colourTemperatureTc des DALI-Vorschaltgerätes und veranlasst durch das Ausführen des Befehls ACTIVATE die Übernahme der eingestellten Farbtemperatur an der Lampe.

Der Wert kann mit dem Funktionsbaustein FB_DALI209QueryColourValue ausgelesen werden.

Der Wert wird in Einheiten von 1 Mirek ausgedrückt. Ein Wert von 0 wird ignoriert und deshalb nicht gespeichert. Die Farbtemperatur Tc kann von 1 Mirek (1000000 K) bis 65534 Mirek (15,26 K) variieren.

Für die Umrechnung von oder nach Kelvin stehen die Funktionen KELVIN_TO_MIREK und MIREK_TO_KELVIN zur Verfügung.

	Der Baustein versendet vor dem DALI-Befehl SET TEMPORARY COLOUR TEMPERATURE Tc den DALI-Befehl ENABLE DEVICE TYPE 8, so wie es für anwendungsbezogene Erweiterungsbefehle notwendig ist (siehe FB_DALI102EnableDeviceType). Zur Aktivierung der Farbtemperatur versendet der Baustein den Befehl ACTIVATE (siehe FB_DALI209Activate).

	Der Baustein verändert das DTR0 und DTR1 aller angeschlossenen DALI-Vorschaltgeräte.

Eingänge

VAR_INPUT
  bStart               : BOOL;
  nAddress             : BYTE;
  eAddressType         : E_DALIAddressType := E_DALIAddressType.Short;
  eCommandPriority     : E_DALICommandPriority := E_DALICommandPriority.MiddleLow;
  nColourTemperatureTc : UINT;
END_VAR

Name	Typ	Beschreibung
bStart	BOOL	Über eine positive Flanke an diesem Eingang wird die Ausführung der DALI-Befehle gestartet.
nAddress	BYTE	Adresse eines DALI-Vorschaltgerätes oder einer DALI-Gruppe.
eAddressType	E_DALIAddressType	Definiert, ob der Eingang nAddress eine Kurzadresse (0…63) oder eine Gruppenadresse (0…15) enthält. Der Eingang nAddress hat keine Bedeutung, wenn ein Sammelruf (Broadcast) oder ein Sammelruf an nicht adressierte Geräte (BroadcastUnaddr) ausgewählt wurde.
eCommandPriority	E_DALICommandPriority	Priorität (low, middle low, middle, middle high, high), mit der die DALI-Befehle versendet werden.

	eCommandPriority hat bei der KL6811 keine Verwendung. Die Prioritäten für die DALI-Befehle werden von der KL6821 ab dem Firmwarestand BD unterstützt.

Name	Typ	Beschreibung
nColourTemperatureTc	UINT	Der Wert, der in die Variable ColourTemperatureTc geschrieben und direkt zum Ausgangswert übertragen wird (0…65534 Mirek, 65535).

Ausgänge

VAR_OUTPUT
  bError                  : BOOL;
  ipResultMessage         : I_TcMessage;
  bBusy                   : BOOL;
END_VAR

Name	Typ	Beschreibung
bError	BOOL	Der Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung ein Fehler aufgetreten ist. Weitere Informationen zu dem Fehler können über die Variable ipResultMessage abgefragt werden. Der Ausgang wird wieder auf FALSE gesetzt, sobald bBusy auf TRUE geht.
ipResultMessage	I_TcMessage	Interface-Pointer (siehe Fehlerauswertung) mit dem detaillierte Informationen über die Abarbeitung des Bausteins abgefragt werden können (siehe Laufzeitmeldungen). Der Interface-Pointer ist gültig, nachdem bBusy von TRUE auf FALSE gewechselt hat.
bBusy	BOOL	Der Ausgang wird gesetzt, sobald die Ausführung der DALI-Befehle gestartet wurde und bleibt so lange aktiv, bis alle DALI-Befehle abgearbeitet wurden.

Eigenschaften

Name	Typ	Zugriff	Initialwert	Beschreibung
ipDALICommunication	I_DALICommunication	Get,Set	0	Interface-Pointer auf den Kommunikationsbaustein (siehe Übergabe der Referenz auf den Kommunikationsbaustein).

Voraussetzungen

Entwicklungsumgebung	Erforderliche SPS-Bibliothek
TwinCAT ab v3.1.4024.12	Tc3_DALI ab v3.5.0.0