---
title: "Device Type 8 (DT8) group"
canonical: "https://docs.cuesystem.com/space/CVCHELP/551911445/Device%20Type%208%20(DT8)%20group"
format: markdown
---
> Macro (toc)
---
# Introduction
The Device Type 8 is to operate with a lighting control gear (ballast) providing Color control, which means the control gear that can change its light color according to IEC-62386.
The DT8 is recognizing four mechanisms how to set appropriate color, and these mechanisms define four different Color Types:
- **XY-Coordinate**
- The output color must correspond as closely as possible to the point in the color space diagram IEC1931
- **Tc-Color Temperature**
- Temperature of Planckian black body radiator whose perceived color most closely resembles that of given stimulus at the same brightness and under specified viewing conditions
- **PrimaryN**
- This color type gives direct control of the light intensity of each available primary output channel - each representing a single output channel of the light. Up to 6 Primary channels are supported.
- **RGBWAF**
- Color type, in which the output channels of the control gear can be associated with Red(R), Green(G), Blue(B), White(W), Amber(A) and Freecolor(F)
Each DT8 control gear must support at least one of the color types mentioned above.
All the commands for Device Type 8 are starting with: ”DT8_”.
These commands have effect only on the ballasts or control gears in the DALI group whose Device Types are Device Type 8.
The “DT8_” starting commands for DALI group do not have any effect on all ballasts or control gears in the DALI group whose Device Types are different than Device Type 8.
Note that all following DALI Channel commands are automatically sending through DALI bus the message to Enable DT8 which must be issued prior any executive command for DT8.
# DT8_Activate
This function provides activation of predefined Color preset by commands SetCollorXXXX with parameter activatenow := FALSE
#### Syntax
```visualbasic
Function DT8_Activate ()
```
#### Example
```visualbasic
DALI_Group1.DT8_Activate() // Activate all DT8 ballast in DALI_Group1
```
# DT8_SetColorPrimaryNBin
The function sets the dimming level for one PrimaryN channel
This command can have effect only if the control gear on the specified address supports the PrimaryN color type.
Execution time: approx. **360ms**.
#### Syntax
```visualbasic
Function DT8_SetColorPrimaryNBin(
dimmlevelBin As Long,
primaryNo /*0-5*/ As Byte,
Optional activatenow As Boolean :=True)
```
#### Parameters
dimmlevelBin
[Long](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Long) dimming level in range 0 – 65534, value 65535 means no change
primaryNo
[Byte](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Byte) primary channel number 0 – 5 (Max 6 primary channels are supported)
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 0)
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 1)
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 2)
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 3)
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 4)
DALI_Group1.DT8_SetColorPrimaryNBin(65534, 5)
//set PrimaryN 1-6 to max levels on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorRGB
The function sets the levels for RGB lighting channels
This command can have effect only if the control gear on the specified address supports the RGBWAF color type.
Execution time: approx. **360ms**.
#### Syntax
```visualbasic
Function DT8_SetColorRGB(
red As Byte,
green As Byte,
blue As Byte,
Optional activatenow As Boolean :=True)
```
#### Parameters
red, green, blue
[Byte](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Byte) level in range 0 – 254, value 255 means no change
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorRGB(254,254,254)
//set R,G,B max levels on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorRGBWAF
The function sets the levels for RGBWAF lighting channels
This command can have effect only if the control gear on the specified address supports the RGBWAF color type.
Execution time: approx. **640ms**.
#### Syntax
```visualbasic
Function DT8_SetColorRGWAFB(
red As Byte,
green As Byte,
blue As Byte,
white As Byte,
amber As Byte,
free As Byte,
Optional activatenow As Boolean :=True)
```
#### Parameters
red, green, blue, white, amber, free
[Byte](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Byte) level in range 0 – 254, value 255 means no change
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorRGBWAF(254,254,254,255,255,255)
//set R,G,B max levels, W,A,F no change on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorTemperatureTc
The function sets Color Temperature Tc to temperature in Kelvin
This command can have effect only if the control gear on the specified address supports the Tc-Color Temperature color type.
Execution time: approx. **320ms**.
#### Syntax
```visualbasic
Function DT8_SetColorTemperatureTc(
kelvin As Double,
Optional activatenow As Boolean :=True)
```
#### Parameters
kelvin
[Double](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Double) temperature in Kelvin in range 15.4 – 1000000
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorTemperatureTc(5000)
// set color temperature Tc to 5000K on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorTemperatureTcMirek
The function sets Color Temperature Tc to temperature specified in Mirek
Mirek = 1000000/Tc where Tc is temperature in Kelvin
This command can have effect only if the control gear on the specified address supports the Tc-Color Temperature color type.
Execution time: approx. **320ms**.
#### Syntax
```visualbasic
Function DT8_SetColorTemperatureTcMirek(
mirek As Long,
Optional activatenow As Boolean :=True)
```
#### Parameters
mirek
[Long](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Long) temperature in Mirek in range 1 – 1000000
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorTemperatureTcMirek(200)
//set color temperature Tc to 200Mirek on all DT8 ballasts in DALI_Group1
// 5000Kelvin = 200Mirek
```
# DT8_SetColorWAF
The function sets the levels for WAF lighting channels
This command can have effect only if the control gear on the specified address supports the RGBWAF color type.
Execution time: approx. **360ms**.
#### Syntax
```visualbasic
Function DT8_SetColorWAF(
white As Byte,
amber As Byte,
free As Byte,
Optional activatenow As Boolean :=True)
```
#### Parameters
white, amber, free
[Byte](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Byte) level in range 0 – 254, value 255 means no change
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorWAF(254,254,254)
//set W,A,F max levels on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorXY
The function sets Color to color of the point in color space according to CIE1931.
This command can have effect only if the control gear on the specified address supports the XY-Coordinate color type.
Execution time: approx. **540ms**.
#### Syntax
```visualbasic
Function DT8_SetColorXY(
Xvalue0to1 As Double,
Yvalue0to1 As Double,
Optional activatenow As Boolean :=True)
```
#### Parameters
Xvalue0to1, Yvalue0to1
[Double](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Double) X,Y coordinates in range : 0 - 0.99997 ,value 1 means no change
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorXY( 0.6203, 0.270 )
//set shade of red color on all DT8 ballasts in DALI_Group1
```
# DT8_SetColorXYBin
The function sets light color to color of the point in color space according to CIE1931.
This command can have effect only if the control gear on the specified address supports the XY-Coordinate color type.
Execution time: approx. **540ms**.
#### Syntax
```visualbasic
Function DT8_SetColorXYBin(
Xbin As Long,
Ybin As Long,
Optional activatenow As Boolean :=True)
```
#### Parameters
Xbin,Ybin
[Long](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Long) Coordinates in range in range 0 – 65534, value 655335 means no change
For point in colorspace with coordinates x,y (both x,y are in range 0-0.99997)
The Xbin value is calculated as 65535*x
The Ybin value is calculated as 65535*y
activatenow
[Boolean](/wiki/spaces/CVCHELP/pages/495058958/Data+types#Boolean) Optional, default **True**. **True** means that the color change will have immediate effect on output light. **False** means that output light will be changed to new specified color value by nearest activate.
#### Example
```visualbasic
DALI_Group1.DT8_SetColorXYBin(40551,17694 )
//set shade of red color on all DT8 ballasts in DALI_Group1
```