FB_DALIV2QueryColourValue

Die vorgegebene Variable (Farbwert) wird aus dem DALI-Vorschaltgerät ausgelesen. Der auszulesende Wert wird durch nParamter definiert (siehe Tabelle unten).

Bestimmte Variablen können direkt über DALI-Befehle ausgelesen werden (z. B. FB_QueryColourStatus oder FB_QueryRGBWAFControl). Weitere Einzelheiten zu den Variablen finden Sie im Abschnitt Variablen.

Wert	Beschreibung
0	x-COORDINATE
1	y-COORDINATE
2	COLOUR TEMPERATURE Tc
3	PRIMARY N DIMLEVEL 0
4	PRIMARY N DIMLEVEL 1
5	PRIMARY N DIMLEVEL 2
6	PRIMARY N DIMLEVEL 3
7	PRIMARY N DIMLEVEL 4
8	PRIMARY N DIMLEVEL 5
9	RED DIMLEVEL
10	GREEN DIMLEVEL
11	BLUE DIMLEVEL
12	WHITE DIMLEVEL
13	AMBER DIMLEVEL
14	FREECOLOUR DIMLEVEL
15	RGBWAF CONTROL
64	x-COORDINATE PRIMARY N 0
65	y-COORDINATE PRIMARY N 0
66	TY PRIMARY N 0
67	x-COORDINATE PRIMARY N 1
68	y-COORDINATE PRIMARY N 1
69	TY PRIMARY N 1
70	x-COORDINATE PRIMARY N 2
71	y-COORDINATE PRIMARY N 2
72	TY PRIMARY N 2
73	x-COORDINATE PRIMARY N 3
74	y-COORDINATE PRIMARY N 3
75	TY PRIMARY N 3
76	x-COORDINATE PRIMARY N 4
77	y-COORDINATE PRIMARY N 4
78	TY PRIMARY N 4
79	x-COORDINATE PRIMARY N 5
80	y-COORDINATE PRIMARY N 5
81	TY PRIMARY N 5
82	NUMBER OF PRIMARIES
128	COLOUR TEMPERATURE Tc COOLEST
129	COLOUR TEMPERATURE Tc PHYSICAL COOLEST
130	COLOUR TEMPERATURE Tc WARMEST
131	COLOUR TEMPERATURE Tc PHYSICAL WARMEST
192	TEMPORARY x-COORDINATE
193	TEMPORARY y-COORDINATE
194	TEMPORARY COLOUR TEMPERATURE Tc
195	TEMPORARY PRIMARY N DIMLEVEL 0
196	TEMPORARY PRIMARY N DIMLEVEL 1
197	TEMPORARY PRIMARY N DIMLEVEL 2
198	TEMPORARY PRIMARY N DIMLEVEL 3
199	TEMPORARY PRIMARY N DIMLEVEL 4
200	TEMPORARY PRIMARY N DIMLEVEL 5
201	TEMPORARY RED DIMLEVEL
202	TEMPORARY GREEN DIMLEVEL
203	TEMPORARY BLUE DIMLEVEL
204	TEMPORARY WHITE DIMLEVEL
205	TEMPORARY AMBER DIMLEVEL
206	TEMPORARY FREECOLOUR DIMLEVEL
207	TEMPORARY RGBWAF CONTROL
208	TEMPORARY COLOUR TYPE
224	REPORT x-COORDINATE
225	REPORT y-COORDINATE
226	REPORT COLOUR TEMPERATURE Tc
227	REPORT PRIMARY N DIMLEVEL 0
228	REPORT PRIMARY N DIMLEVEL 1
229	REPORT PRIMARY N DIMLEVEL 2
230	REPORT PRIMARY N DIMLEVEL 3
231	REPORT PRIMARY N DIMLEVEL 4
232	REPORT PRIMARY N DIMLEVEL 5
233	REPORT RED DIMLEVEL
234	REPORT GREEN DIMLEVEL
235	REPORT BLUE DIMLEVEL
236	REPORT WHITE DIMLEVEL
237	REPORT AMBER DIMLEVEL
238	REPORT FREECOLOUR DIMLEVEL
239	REPORT RGBWAF CONTROL
240	REPORT COLOUR TYPE

Antworten, die eine aktive Farbdarstellung betreffen, sind nur gültig, wenn die Farbdarstellung des angeforderten Farbwertes aktiv ist (siehe FB_DALIV2QueryColourStatus) oder das Vorschaltgerät in der Lage ist, eine Neuberechnung des geforderten Farbwertes von der aktiven Farbdarstellung in einen Farbwert einer anderen Farbdarstellung durchzuführen.

Falls das Vorschaltgerät die Koordinaten nicht kennt oder die Primärfarbe nicht vorliegt, muss die Antwort 255 (MASK) sein.

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

Der Funktionsbaustein unterstützt die Farbdarstellungen:

xy-Koordinaten
Farbtemperatur Tc
Primär(farbe) N
RGBWAF

	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.

Eingänge

VAR_INPUT
  bStart           : BOOL;
  nAddr            : BYTE;
  eAddrType        : E_DALIV2AddrType := eDALIV2AddrTypeShort;
  eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
  nParameter       : BYTE;
END_VAR

Name	Typ	Beschreibung
bStart	BOOL	Über eine positive Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.
nAddr	BYTE	Adresse eines Teilnehmers oder einer Gruppe
eAddrType	E_DALIV2AddrType	Kurzadresse, Gruppenadresse oder Sammelruf (Broadcast)
eCommandPriority	E_DALIV2CommandPriority	Priorität (hoch, mittel oder niedrig), mit der der Befehl von der Library abgearbeitet wird.
nParameter	BYTE	Farbwert, der ausgelesen werden soll (siehe Tabelle oben).

Ein-/Ausgänge

VAR_IN_OUT
  stCommandBuffer : ST_DALIV2CommandBuffer;
END_VAR

Name	Typ	Beschreibung
stCommandBuffer	ST_DALIV2CommandBuffer	Verweis auf die interne Struktur zur Kommunikation mit FB_KL6811Communication (KL6811) oder FB_KL6821Communication (KL6821).

Ausgänge

VAR_OUTPUT
  bBusy    : BOOL;
  bError   : BOOL;
  nErrorId : UDINT;
  nValue   : UINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Funktionsbausteins wird der Ausgang gesetzt und bleibt so lange aktiv, bis der Befehl abgearbeitet wurde.
bError	BOOL	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	UDINT	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).
nValue	UINT	Enthält den ausgelesenen Wert.

Voraussetzungen

Entwicklungsumgebung	Einzubindende SPS-Bibliothek
TwinCAT ab v3.1.4020.14	Tc2_DALI ab v3.4.3.0