Variablen

actualLevel

Die Variable beinhaltet den aktuellen Ausgangswert vom DALI-Vorschaltgerät.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryActualLevel ausgelesen werden.

powerOnLevel

Beim Anlegen der Versorgungsspannung an das DALI-Vorschaltgerät, wird die Lampe mit dem Ausgangswert, der in der Variable powerOnLevel gespeichert ist, angesteuert. Voraussetzung ist, dass der DALI-Bus mit Spannung versorgt und der Ruhepegel eingehalten wird. Wird powerOnLevel auf 255 (MASK) gesetzt, so wird nach dem Anlegen der Versorgungsspannung der Ausgangswert auf den letzten aktiven Ausgangswert (minLevel...maxLevel) vor dem Abschalten der Versorgungsspannung gesetzt. Soll nach dem Anlegen der Versorgungsspannung der Ausgangswert auf 0 gesetzt werden, so muss powerOnLevel ebenfalls 0 sein. Ist powerOnLevel größer 0 und kleiner 255, so wird der Ausgangswert nach dem Anlegen der Versorgungsspannung immer durch die Variablen minLevel und maxLevel begrenzt.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryPowerOnLevel abgefragt und mit dem Baustein FB_DALI102SetPowerOnLevel verändert werden.

systemFailureLevel

Tritt ein Fehler am DALI-Bus auf (Ruhespannung länger als 500 ms unterhalb des zulässigen Pegelbereichs), so wird das DALI-Vorschaltgerät mit dem Ausgangswert aus der Variablen systemFailureLevel angesteuert. Steht 255 (MASK) in der Variablen, so ändert sich der Ausgangswert nicht. Begrenzt wird der Wertebereich durch die Variablen minLevel und maxLevel.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QuerySystemFailureLevel abgefragt und mit dem Baustein FB_DALI102SetSystemFailureLevel verändert werden.

minLevel / maxLevel

Der Ausgangswert wird innerhalb des DALI-Vorschaltgeräts durch die Variablen minLevel und maxLevel begrenzt. Ausnahmen sind die Ausgangswerte 0 (AUS) und 255 (MASK).

Der Wert der jeweiligen Variablen kann mit den Bausteinen FB_DALI102QueryMinLevel / FB_DALI102QueryMaxLevel ausgelesen und mit den Bausteinen FB_DALI102SetMinLevel / FB_DALI102SetMaxLevel verändert werden.

fadeRate

Die fadeRate (Stufengeschwindigkeit) legt die Veränderungsgeschwindigkeit (in Stufen pro Sekunde) für die Änderung des Ausgangswerts fest. Die Variable hat Auswirkung auf die DALI-Befehle FB_DALI102Up und FB_DALI102Down.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryFadeTimeFadeRate ausgelesen und mit dem Baustein FB_DALI102SetFadeRate verändert werden.

Folgende Werte können über E_DALIFadeRate vorgegeben werden:

fadeTime

Die fadeTime (Stufenzeit) legt die Zeit des aktuellen Ausgangswerts zum Erreichen des geforderten Wert fest. Falls die Lampe eingeschaltet wird, sind die Vorheiz- und Zündzeit nicht in der Stufenzeit enthalten. Die Variable hat Auswirkung auf die Befehle FB_DALI102DirectArcPowerControl, FB_DALI102GoToScene und FB_DALI102GoToLastActiveLevel.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryFadeTimeFadeRate ausgelesen und mit dem Baustein FB_DALI102SetFadeTime verändert werden.

Folgende Werte können über E_DALIFadeTime vorgegeben werden:

extendedFadeTimeBase

Diese Variable ist der Basiswert zur Berechnung der Extended Fade Time (0 ms bis 16 min). Die Extended Fade Time wird eingesetzt, wenn fadeTime auf E_DALIFadeTime.Disabled gesetzt wurde und, falls vorhanden, fastFadeTime gleich E_DALIFastFadeTime.Disabled ist.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryExtendedFadeTime ausgelesen und mit dem Baustein FB_DALI102SetExtendedFadeTime verändert werden.

Die Extended Fade Time errechnet sich folgendermaßen:

Extended Fade Time = extendedFadeTimeBase x extendedFadeTimeMultiplier

Folgende Basiswerte stehen zur Verfügung:

extendedFadeTimeMultiplier

Diese Variable ist der Multiplikator zur Berechnung der Extended Fade Time (0 ms bis 16 min). Die Extended Fade Time wird eingesetzt, wenn fadeTime auf E_DALIFadeTime.Disabled gesetzt wurde und, falls vorhanden, fastFadeTime gleich E_DALIFastFadeTime.Disabled ist.

Nimmt extendedFadeTimeMultiplier den Wert E_DALIExtendeFadeTimeMultiplier.Disabled an, so wird die gewünschte Beleuchtungsstärke so schnell wie möglich erreicht.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryExtendedFadeTime ausgelesen und mit dem Baustein FB_DALI102SetExtendedFadeTime verändert werden.

Die Extended Fade Time errechnet sich folgendermaßen:

Extended Fade Time = extendedFadeTimeBase x extendedFadeTimeMultiplier

Folgende Multiplikationswerte stehen zur Verfügung:

shortAddress

In dieser Variable ist die Kurzadresse abgelegt. Eine gültige Kurzadresse liegt im Wertebereich von 0 bis 63. Mit einem Wert von 255 (MASK) gilt die Kurzadresse als gelöscht.

Die Kurzadresse wird mit dem Baustein FB_DALI102SetShortAddress eingestellt.

searchAddress

Die Suchadresse wird nur bei der Vergabe der Kurzadressen benötigt.

Der Wert der Variablen kann mit dem Baustein FB_DALI102SetSearchAddress verändert werden.

randomAddress

Die Zufallsadresse, auch als Langadresse bezeichnet, wird nur bei der Vergabe der Kurzadressen benötigt.

Mit Hilfe des Bausteins FB_DALI102QueryRandomAddress kann die 3 Byte lange Zufallsadresse ausgelesen werden.

controlGearFailure

Die Variable gibt an, ob das DALI-Vorschaltgerät seiner Funktion entsprechend arbeitet.

Im Falle eines Fehlers wird das Bit spätestens nach 30 s auf TRUE gesetzt.

Wenn das Gerät wieder ordnungsgemäß funktioniert, wird das Bit zurückgesetzt.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

lampFailure

Die Variable gibt an, ob die Lampe korrekt funktioniert.

Im Falle eines Fehlers wird das Bit spätestens nach 30 s auf TRUE gesetzt.

Der Fehler kann bedeuten, dass ein fehlerhafter Anschluss vorliegt, oder die Lampe defekt ist.

Der Fehlerzustand kann nur dann erkannt werden, wenn die Lampe eingeschaltet ist.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

lampOn

Die Variable gibt an, ob die Lampe eingeschaltet ist.

Wenn die Lampe ausgeschaltet ist, in der Aufstartphase und im Falle eines totalen Lampenausfalls ist dieses Bit auf FALSE gesetzt.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

limitError

Die Variable gibt an, ob der gewünschte Ausgangswert (targetLevel) innerhalb der Grenzen von minLevel und maxLevel liegt, oder ob der targetLevel durch die Werte minLevel oder maxLevel verändert wurde.

Wenn einer der beschriebenen Fälle auftritt, wird das Bit auf TRUE gesetzt.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

fadeRunning

Die Variable gibt an, ob das Dimmen aktiv ist.

Das Bit ist TRUE, wenn das Dimmen startet (nach der Startphase der Leuchte) bis zum Ablauf der fadeTime.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

resetState

Die Variable gibt an, ob alle Geräte- und Instanz-Variablen auf ihren Rücksetzwert (siehe Tabelle oben) gesetzt wurden.

In diesem Fall ist das Bit TRUE.

Variablen, die in der Spalte Rücksetzwert den Vermerk keine Änderung besitzen, werden nicht berücksichtigt.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

powerCycleSeen

Die Variable gibt an, ob das DALI-Vorschaltgerät mit Spannung versorgt wurde, ohne das bisher ein Befehl ausgeführt wurde, der den Ausgangswert verändert.

In diesem Fall ist das Bit TRUE.

Mit Hilfe des Bausteins FB_DALI102QueryStatus kann die Variable ausgelesen werden.

gearGroups

Die Variable gibt an, ob ein bestimmtes DALI-Vorschaltgerät den Gruppen 0 bis 15 zugeordnet ist. Ist das Bit gesetzt, so gehört das Vorschaltgerät der entsprechenden Gruppe an.

Der Wert der Variablen kann mit dem Baustein FB_DALI102QueryGroups ausgelesen und mit den Bausteinen FB_DALI102AddToGroup und FB_DALI102RemoveFromGroup verändert werden.

scene0…scene15

Jedes DALI-Vorschaltgerät kann Ausgangswerte für 16 verschiedene Szenen abspeichern. Pro Szene gilt ein Ausgangswert. Wird der Befehl zum Aufruf einer Szene FB_DALI102GoToScene an einem Teilnehmer, eine Gruppe oder an alle (Sammelruf) aufgerufen, so wird jeweils der Ausgangswert der entsprechenden DALI-Vorschaltgeräte auf den abgespeicherten Wert gesetzt. Begrenzt wird die Ausgabe durch maxLevel, minLevel und physicalMinLevel.

Der Wert der Variablen kann dem Baustein FB_DALI102QuerySceneLevel ausgelesen und mit den Bausteinen FB_DALI102SetScene und FB_DALI102RemoveFromScene verändert werden.

DTR0…DTR2

Die Data Transfer Register (DTR) 0 bis 2 dienen als Zwischenspeicher für die Ausführung verschiedener DALI-Befehle.

Die DTR werden von verschiedenen Bausteinen genutzt. In der jeweiligen Beschreibung eines Bausteins ist angegeben welche DTRs verwendet werden.

Die Werte der DTR können mit den Bausteinen FB_DALI102QueryContentDTRx ausgelesen und mit den Bausteinen FB_DALI102SetDTRx verändert werden.

physicalMinLevel

Der physikalisch kleinstmögliche Ausgangswert wird vom Hersteller in der Variablen physicalMinLevel abgelegt.

Der Wert kann mit dem Baustein FB_DALI102QueryPhysicalMinimum ausgelesen werden.

deviceTypes

Die Variable beinhaltet die jeweiligen Geräte-Typen eines DALI-Vorschaltgerätes.

Mit dem Baustein FB_DALI102QueryDeviceTypes können die Gerätetypen (siehe E_DALIDeviceType) eines DALI-Vorschaltgerätes ausgelesen werden.