FB_DALI103QueryInputValue

The function block queries the input value (see inputValue) of the selected instance of the DALI control device.

The parameter nResolution specifies how high the resolution (in bits) of the input value is. The function block FB_DALI103QueryResolution can be used to read the resolution.

All bytes of the input value are read and subsequently decoded.

Make sure that the parameter nResolution corresponds to the actual resolution of the device, otherwise errors may occur during decoding.

The possible input values for the respective instance types can be found here:

Part 301 (push buttons) – Introduction

Part 302 (absolute input devices) - Introduction

Part 303 (occupancy sensors) - Introduction

Part 304 (light sensors) - Introduction

The DALI commands QUERY INPUT VALUE and QUERY INPUT VALUE LATCH are called internally.

The output nInputValue contains a valid value only if the function block was executed without errors (bError = FALSE).

	The function block cannot be used when using the KL6811.

Inputs

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	Type	Description
bStart	BOOL	Execution of the DALI commands is triggered via a positive edge at this input.
nAddress	BYTE	Address of a DALI control gear or a DALI group.
eAddressType	E_DALIAddressType	Defines whether the input nAddress contains a short address (0…63) or a group address (0…31). The input nAddress has no meaning if a broadcast or a broadcast to unaddressed devices (BroadcastUnaddr) has been selected.
nInstanceAddress	BYTE	Instance number within a DALI control device. A DALI control device can support multiple instance numbers.
eInstanceAddressType	E_DALIInstanceAddressType	Defines the access mode to the desired instance within the DALI control device.
eCommandPriority	E_DALICommandPriority	Priority (low, middle low, middle, middle high, high) with which the DALI commands are sent.

	The command priorities are supported by the KL6821 from the firmware version BD.

Name	Type	Description
nResolution	BYTE	Resolution of the input value in bits (1...64).

Outputs

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

Name	Type	Description
bError	BOOL	This output is switched to TRUE if an error occurs during the execution. Further information about the error can be queried via the variable ipResultMessage. The output is set to FALSE again as soon as bBusy switches to TRUE.
ipResultMessage	I_TcMessage	Interface pointer (see error evaluation) that can be used to obtain detailed information about the processing of the function block (see runtime messages). The interface pointer is valid after bBusy has changed from TRUE to FALSE.
bBusy	BOOL	The output is set as soon as execution of the DALI commands has commenced. It remains active until all DALI commands have been processed.
nInputValue	LWORD	The input value of the selected instance of the DALI control device.

Properties

Name	Type	Access	Initial value	Description
ipDALICommunication	I_DALICommunication	Get,Set	0	Interface Pointer to the communication block (see Transfer of the reference to the communication block).

Requirements

Development environment	required PLC library
TwinCAT from v3.1.4022.29	Tc3_DALI from v3.1.4.0