FB_DALIV2SetTemporaryPrimaryNDimlevel

FB_DALIV2SetTemporaryPrimaryNDimlevel 1:

Speichert den Wert in die Variable TEMPORARY PRIMARY N DIMLEVEL des Vorschaltgerätes. Der Wert kann mit dem Funktionsbaustein FB_DALIV2QueryColourValue() ausgelesen werden.

Der Wert wird in Einheiten von 1 / 65536 ausgedrückt. Der Höchstwert des PRIMARY N DIMLEVEL ist 0,99997 und wird auf einem linearen Maßstab interpretiert.

Durch den Funktionsbaustein werden bei allen DALI-Vorschaltgeräten der DALI-Linie die DTR (Data Transfer Register), DTR1 und DTR2 verändert.

Der Baustein unterstützt die Farbdarstellungen:

  • Primär(farbe) N

Dieser Befehl gehört zu den anwendungsbezogenen Erweiterungsbefehlen für Lampen zur Farb-/Farbtemperatursteuerung mit DALI-Schnittstelle. Diese funktionieren nur dann, wenn ihnen der Befehl Enable Device Type 8 vorangeht, welcher mit dem Funktionsbaustein FB_DALIV2EnableDeviceType() gesendet werden kann. Der Befehl Enable Device Type 8 wird bereits allen anwendungsbezogenen Erweiterungsbefehlen für Lampen zur Farb-/Farbtemperatursteuerung mit DALI-Schnittstelle intern automatisch vorangestellt.

VAR_INPUT

bStart           : BOOL;
nAddr            : BYTE;
eAddrType        : E_DALIV2AddrType := eDALIV2AddrTypeShort;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
nPrimaryColour   : BYTE;
nValue           : UINT;

bStart: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

nAddr: Adresse eines Teilnehmers oder einer Gruppe.

eAddrType: Kurzadresse, Gruppenadresse oder Sammelruf (Broadcast) (siehe E_DALIV2AddrType).

eCommandPriority: Priorität (hoch, mittel oder niedrig), mit der der Befehl von der Library abgearbeitet wird (siehe E_DALIV2CommandPriority).

nPrimaryColour: Primärfarbe (0 - 5).

nValue: Der Wert, der in die Variable TEMPORARY PRIMARY N DIMLEVEL geschrieben wird.

VAR_OUTPUT

bBusy    : BOOL;
bError   : BOOL;
nErrorId : UDINT;

bBusy: Bei der Aktivierung des Bausteins wird der Ausgang gesetzt und bleibt so lange aktiv, bis der Befehl abgearbeitet wurde.

bError: Dieser Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung eines Befehls ein Fehler aufgetreten ist. Der befehlsspezifische Fehlercode ist in nErrorId enthalten. Wird durch das Ausführen eines Befehls an den Eingängen auf FALSE zurückgesetzt.

nErrorId: Enthält den befehlsspezifischen Fehlercode des zuletzt ausgeführten Befehls. Wird durch das Ausführen eines Befehls an den Eingängen auf 0 zurückgesetzt. (Siehe Fehlercodes)

VAR_IN_OUT

stCommandBuffer : ST_DALIV2CommandBuffer;

stCommandBuffer: Verweis auf die interne Struktur zur Kommunikation mit den Bausteinen FB_KL6811Communication() (KL6811) oder FB_KL6821Communication() (KL6821).

Voraussetzungen

Entwicklungsumgebung

erforderliche SPS-Bibliothek

TwinCAT ab v3.1.4020.14

Tc2_DALI ab v3.4.3.0