FB_DALI103QueryInputValue

Der Baustein fragt den Eingangswert (siehe inputValue) der ausgewählten Instanz des DALI-Steuergeräts ab.

Der Parameter nResolution gibt vor, wie hoch die Auflösung (in Bits) vom Eingangswert ist. Die Auflösung kann mit dem Baustein FB_DALI103QueryResolution ausgelesen werden.

Es werden alle Bytes des Eingangswertes ausgelesen und anschließend decodiert. Hierzu werden intern die DALI-Befehle QUERY INPUT VALUE und QUERY INPUT VALUE LATCH aufgerufen

Es darauf zu achten, dass der Parameter nResolution der tatsächlichen Auflösung des Gerätes entspricht, da es sonst zu Fehlern bei der Decodierung kommen kann.

Die möglichen Eingangswerte für die jeweiligen Instanztypen finden Sie hier:

Part 301 (Taster) – Einleitung

Part 302 (Absolutwertgeber) - Einleitung

Part 303 (Präsenzmelder) - Einleitung

Part 304 (Helligkeitssensoren) - Einleitung

Der Ausgang nInputValue und die Eigenschaft nRawInputValue enthalten nur dann einen gültigen Wert, wenn der Baustein fehlerfrei ausgeführt wurde (bError = FALSE).

	Bei Einsatz der KL6811 kann der Baustein nicht verwendet werden.

Eingänge

VAR_INPUT
  bStart               : BOOL;
  nAddress             : BYTE;
  eAddressType         : E_DALIAddressType := E_DALIAddressType.Short;
  nInstanceAddress     : BYTE := 0;
  eInstanceAddressType : E_DALIInstanceAddressType := E_DALIInstanceAddressType.InstanceNumber;
  eCommandPriority     : E_DALICommandPriority := E_DALICommandPriority.MiddleLow;
  nResolution          : BYTE := 8;
END_VAR

Name	Typ	Beschreibung
bStart	BOOL	Über eine positive Flanke an diesem Eingang wird die Ausführung der DALI-Befehle gestartet.
nAddress	BYTE	Adresse eines DALI-Vorschaltgerätes oder einer DALI-Gruppe.
eAddressType	E_DALIAddressType	Definiert, ob der Eingang nAddress eine Kurzadresse (0…63) oder eine Gruppenadresse (0…31) enthält. Der Eingang nAddress hat keine Bedeutung, wenn ein Sammelruf (Broadcast) oder ein Sammelruf an nicht adressierte Geräte (BroadcastUnaddr) ausgewählt wurde.
nInstanceAddress	BYTE	Instanznummer innerhalb eines DALI-Steuergerätes. Ein DALI-Steuergerät kann mehrere Instanznummern unterstützen.
eInstanceAddressType	E_DALIInstanceAddressType	Definiert die Zugriffsart auf die gewünschte Instanz innerhalb des DALI-Steuergeräts.
eCommandPriority	E_DALICommandPriority	Priorität (low, middle low, middle, middle high, high), mit der die DALI-Befehle versendet werden.

	Die Command Prioritäten werden von der KL6821 ab dem Firmwarestand BD unterstützt.

Name	Typ	Beschreibung
nResolution	BYTE	Auflösung des Eingangswerts in Bits (1…64).

Ausgänge

VAR_OUTPUT
  bError                  : BOOL;
  ipResultMessage         : I_TcMessage;
  bBusy                   : BOOL;
  nInputValue             : LWORD;
END_VAR

Name	Typ	Beschreibung
bError	BOOL	Der Ausgang wird auf TRUE geschaltet, wenn bei der Ausführung ein Fehler aufgetreten ist. Weitere Informationen zu dem Fehler können über die Variable ipResultMessage abgefragt werden. Der Ausgang wird wieder auf FALSE gesetzt, sobald bBusy auf TRUE geht.
ipResultMessage	I_TcMessage	Interface-Pointer (siehe Fehlerauswertung) mit dem detaillierte Informationen über die Abarbeitung des Bausteins abgefragt werden können (siehe Laufzeitmeldungen). Der Interface-Pointer ist gültig, nachdem bBusy von TRUE auf FALSE gewechselt hat.
bBusy	BOOL	Der Ausgang wird gesetzt, sobald die Ausführung der DALI-Befehle gestartet wurde und bleibt so lange aktiv, bis alle DALI-Befehle abgearbeitet wurden.
nInputValue	LWORD	Der Eingangswert der ausgewählten Instanz des DALI-Steuergeräts.

Eigenschaften

Name	Typ	Zugriff	Initialwert	Beschreibung
ipDALICommunication	I_DALICommunication	Get,Set	0	Interface-Pointer auf den Kommunikationsbaustein (siehe Übergabe der Referenz auf den Kommunikationsbaustein).
nRawInputValue	LWORD	Get	-	Der uncodierte Eingangswert der ausgewählten Instanz des DALI-Steuergerätes.

Voraussetzungen

Entwicklungsumgebung	erforderliche SPS-Bibliothek
TwinCAT ab v3.1.4022.29	Tc3_DALI ab v3.1.4.0