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 Baustein 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. |
VAR_INPUT
bStart : BOOL;
nAddr : BYTE;eAddrType : E_DALIV2AddrType := eDALIV2AddrTypeShort;
nParameter : BYTE;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
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).
nParameter: Farbwert, der ausgelesen werden soll (siehe Tabelle oben).
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrorId : UDINT;
nValue : UINT;
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)
nValue: Enthält den ausgelesenen Wert.
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 |