FB_DALI209QueryColourValue

The function block reads the specified variable (color value) from the DALI control gear. The value to be read is defined by eColourValue.
Certain variables can be read directly by DALI commands (e.g. FB_DALI209QueryColourStatus). Further details on the variables can be found in section Variables.
The response must be 255 (MASK) if the DALI control gear does not know the coordinates or if the primary color is not present.
![]() | Prior to the DALI command QUERY COLOUR VALUE, the function block sends the DALI command ENABLE DEVICE TYPE 8, as is necessary for application extended commands (see also FB_DALI102EnableDeviceType). |
![]() | The function block changes the DTR0 of all connected DALI control gears. |
The output nColourValue contains a valid value only if the function block was executed without errors (bError = FALSE).
Inputs
VAR_INPUT
bStart : BOOL;
nAddress : BYTE;
eAddressType : E_DALIAddressType := E_DALIAddressType.Short;
eCommandPriority : E_DALICommandPriority := E_DALICommandPriority.MiddleLow;
eColourValue : E_DALIColourValue;
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 | Defines whether the input nAddress contains a short address (0…63) or a group address (0…15). The input nAddress has no meaning if a broadcast or a broadcast to unaddressed devices (BroadcastUnaddr) has been selected. | |
eCommandPriority | Priority (low, middle low, middle, middle high, high) with which the DALI commands are sent. |
![]() | eCommandPriority has no function with the KL6811. The DALI command priorities are supported by the KL6821 from the firmware version BD. |
Name | Type | Description |
---|---|---|
eColourValue | Variable to be read from the DALI control gear. |
Outputs
VAR_OUTPUT
bError : BOOL;
ipResultMessage : I_TcMessage;
bBusy : BOOL;
nColourValue : UINT;
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. |
nColourValue | UINT | Contains the value of the read variable. |
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.4024.10 | Tc3_DALI from v3.4.0.0 |