FB_DALIV2StoreXyCoordinatePrimaryN

FB_DALIV2StoreXyCoordinatePrimaryN 1:

Kopiert den Wert aus den Variablen TEMPORARY x-COORDINATE und TEMPORARY y-COORDINATE in die Variablen x-COORDINATE PRIMARY N und y-COORDINATE PRIMARY N.

Der Parameter nPrimaryColour gibt die Primärfarbe an und muss im Bereich von 0 bis 5 liegen, abhängig von der verfügbaren Anzahl von Primärfarben. Für jeden anderen Wert wird der Befehl ignoriert.

Dieser Befehl ist dazu vorgesehen, die zur Primärfarbe dazugehörigen aktuellen xy-Koordinaten zu speichern. xy-Koordinaten außerhalb des Farbenraum-Chromatizitäts-Diagramms sind nicht sinnvoll und sollten deshalb vermieden werden.

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

Der Funktionsbaustein unterstützt die Farbdarstellungen:

FB_DALIV2StoreXyCoordinatePrimaryN 2:

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.

FB_DALIV2StoreXyCoordinatePrimaryN 3: Eingänge

VAR_INPUT
  bStart           : BOOL;
  nAddr            : BYTE;
  eAddrType        : E_DALIV2AddrType := eDALIV2AddrTypeShort;
  eCommandPriority : E_DALIV2CommandPriority := eDALIV2CommandPriorityMiddle;
  nPrimaryColour   : 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.

nPrimaryColour

BYTE

Primärfarbe (0 - 5)

FB_DALIV2StoreXyCoordinatePrimaryN 4: 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).

FB_DALIV2StoreXyCoordinatePrimaryN 5: Ausgänge

VAR_OUTPUT
  bBusy    : BOOL;
  bError   : BOOL;
  nErrorId : UDINT;
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).

Voraussetzungen

Entwicklungsumgebung

Einzubindende SPS-Bibliothek

TwinCAT ab v3.1.4020.14

Tc2_DALI ab v3.4.3.0