FB_DALIV2QueryColourValue

FB_DALIV2QueryColourValue 1:

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;
eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
nParameter       : BYTE;

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