The Color Control cluster (0x0300) is a Matter cluster that Controls the color output of a light, supporting hue/saturation, XY color space, and color temperature modes.. It defines 19 commands and 52 attributes and is mandatory for 5 device types.
Color Control 0x0300
Controls the color output of a light, supporting hue/saturation, XY color space, and color temperature modes.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 52
Commands 19
Features 5
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
CurrentHue
max 0xFE
|
int8u | Optional |
| 0x0001 |
CurrentSaturation
max 0xFE
|
int8u | Optional |
| 0x0002 |
RemainingTime
max 0xFFFE · default 0x0000
|
int16u | Optional |
| 0x0003 |
CurrentX
max 0xFEFF
|
int16u | Optional |
| 0x0004 |
CurrentY
max 0xFEFF
|
int16u | Optional |
| 0x0005 |
DriftCompensation
max 0x04
|
DriftCompensationEnum | Optional |
| 0x0006 | CompensationText | char_string | Optional |
| 0x0007 |
ColorTemperatureMireds
max 0xFEFF
|
int16u | Optional |
| 0x0008 |
ColorMode
max 0x02
|
ColorModeEnum | |
| 0x000F |
Options
max 0x01
|
OptionsBitmap | Writable |
| 0x0010 |
NumberOfPrimaries
max 0x06 · nullable
|
int8u | |
| 0x0011 |
Primary1X
max 0xFEFF
|
int16u | Optional |
| 0x0012 |
Primary1Y
max 0xFEFF
|
int16u | Optional |
| 0x0013 |
Primary1Intensity
nullable
|
int8u | Optional |
| 0x0015 |
Primary2X
max 0xFEFF
|
int16u | Optional |
| 0x0016 |
Primary2Y
max 0xFEFF
|
int16u | Optional |
| 0x0017 |
Primary2Intensity
nullable
|
int8u | Optional |
| 0x0019 |
Primary3X
max 0xFEFF
|
int16u | Optional |
| 0x001A |
Primary3Y
max 0xFEFF
|
int16u | Optional |
| 0x001B |
Primary3Intensity
nullable
|
int8u | Optional |
| 0x0020 |
Primary4X
max 0xFEFF
|
int16u | Optional |
| 0x0021 |
Primary4Y
max 0xFEFF
|
int16u | Optional |
| 0x0022 |
Primary4Intensity
nullable
|
int8u | Optional |
| 0x0024 |
Primary5X
max 0xFEFF
|
int16u | Optional |
| 0x0025 |
Primary5Y
max 0xFEFF
|
int16u | Optional |
| 0x0026 |
Primary5Intensity
nullable
|
int8u | Optional |
| 0x0028 |
Primary6X
max 0xFEFF
|
int16u | Optional |
| 0x0029 |
Primary6Y
max 0xFEFF
|
int16u | Optional |
| 0x002A |
Primary6Intensity
nullable
|
int8u | Optional |
| 0x0030 |
WhitePointX
max 0xFEFF
|
int16u | Optional |
| 0x0031 |
WhitePointY
max 0xFEFF
|
int16u | Optional |
| 0x0032 |
ColorPointRX
max 0xFEFF
|
int16u | Optional |
| 0x0033 |
ColorPointRY
max 0xFEFF
|
int16u | Optional |
| 0x0034 |
ColorPointRIntensity
nullable
|
int8u | Optional |
| 0x0036 |
ColorPointGX
max 0xFEFF
|
int16u | Optional |
| 0x0037 |
ColorPointGY
max 0xFEFF
|
int16u | Optional |
| 0x0038 |
ColorPointGIntensity
nullable
|
int8u | Optional |
| 0x003A |
ColorPointBX
max 0xFEFF
|
int16u | Optional |
| 0x003B |
ColorPointBY
max 0xFEFF
|
int16u | Optional |
| 0x003C |
ColorPointBIntensity
nullable
|
int8u | Optional |
| 0x4000 | EnhancedCurrentHue | int16u | Optional |
| 0x4001 |
EnhancedColorMode
max 0x03
|
EnhancedColorModeEnum | |
| 0x4002 |
ColorLoopActive
max 1
|
int8u | Optional |
| 0x4003 | ColorLoopDirection | int8u | Optional |
| 0x4004 | ColorLoopTime | int16u | Optional |
| 0x4005 | ColorLoopStartEnhancedHue | int16u | Optional |
| 0x4006 | ColorLoopStoredEnhancedHue | int16u | Optional |
| 0x400A |
ColorCapabilities
max 0x001F
|
ColorCapabilitiesBitmap | |
| 0x400B |
ColorTempPhysicalMinMireds
1..65279
|
int16u | Optional |
| 0x400C |
ColorTempPhysicalMaxMireds
max 65279
|
int16u | Optional |
| 0x400D |
CoupleColorTempToLevelMinMireds
1..65279
|
int16u | Optional |
| 0x4010 |
StartUpColorTemperatureMireds
1..0xFEFF · nullable
|
int16u | Writable Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
MoveToHue
Optional This command will move the device to the requested hue using a transition.
|
client→server |
Hue: int8u, Direction: DirectionEnum, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x01 |
MoveHue
Optional This command will change the hue of the device with a requested rate.
|
client→server |
MoveMode: MoveModeEnum, Rate: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x02 |
StepHue
Optional This command will change the hue of the device using a step and transition.
|
client→server |
StepMode: StepModeEnum, StepSize: int8u, TransitionTime: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x03 |
MoveToSaturation
Optional This command will move the device to the requested saturation using a transition.
|
client→server |
Saturation: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x04 |
MoveSaturation
Optional This command will change the saturation of the device with a requested rate.
|
client→server |
MoveMode: MoveModeEnum, Rate: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x05 |
StepSaturation
Optional This command will change the saturation of the device using a step and transition.
|
client→server |
StepMode: StepModeEnum, StepSize: int8u, TransitionTime: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x06 |
MoveToHueAndSaturation
Optional This command will move the device to the requested hue and saturation using a transition.
|
client→server |
Hue: int8u, Saturation: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x07 |
MoveToColor
Optional This command will move the device to the requested color using a transition.
|
client→server |
ColorX: int16u, ColorY: int16u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x08 |
MoveColor
Optional This command will change the color of the device with a requested rate.
|
client→server |
RateX: int16s, RateY: int16s, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x09 |
StepColor
Optional This command will change the color of the device using a step and transition.
|
client→server |
StepX: int16s, StepY: int16s, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x0A |
MoveToColorTemperature
Optional This command will move the device to the requested color temperate using a transition.
|
client→server |
ColorTemperatureMireds: int16u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x40 |
EnhancedMoveToHue
Optional This command allows the light to be moved in a smooth continuous transition from their current hue to a target hue.
|
client→server |
EnhancedHue: int16u, Direction: DirectionEnum, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x41 |
EnhancedMoveHue
Optional This command allows the light to start a continuous transition starting from their current hue.
|
client→server |
MoveMode: MoveModeEnum, Rate: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x42 |
EnhancedStepHue
Optional This command allows the device to be moved in a stepped transition from their current hue.
|
client→server |
StepMode: StepModeEnum, StepSize: int16u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x43 |
EnhancedMoveToHueAndSaturation
Optional This command allows the light to be moved in a smooth continuous transition from their current hue to a target hue and from their current saturation to a target saturation.
|
client→server |
EnhancedHue: int16u, Saturation: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x44 |
ColorLoopSet
Optional This command allows a color loop to be activated such that the color light cycles through its range of hues.
|
client→server |
UpdateFlags: UpdateFlagsBitmap, Action: ColorLoopActionEnum, Direction: ColorLoopDirectionEnum, Time: int16u, StartHue: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x47 |
StopMoveStep
Optional This command is provided to allow MoveTo and Step commands to be stopped.
|
client→server |
OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x4B |
MoveColorTemperature
Optional This command allows the color temperature of the light to be moved at a specified rate.
|
client→server |
MoveMode: MoveModeEnum, Rate: int16u, ColorTemperatureMinimumMireds: int16u, ColorTemperatureMaximumMireds: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x4C |
StepColorTemperature
Optional This command allows the color temperature of the light to be stepped with a specified step size.
|
client→server |
StepMode: StepModeEnum, StepSize: int16u, TransitionTime: int16u, ColorTemperatureMinimumMireds: int16u, ColorTemperatureMaximumMireds: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
Hue And Saturation
(HS)
bit 0
Supports color specification via hue/saturation.
EnhancedHue
(EHUE)
bit 1
Enhanced hue is supported.
ColorLoop
(CL)
bit 2
Color loop is supported.
XY
(XY)
bit 3
Supports color specification via XY.
ColorTemperature
(CT)
bit 4
Supports specification of color temperature.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
213 devices in the survey implement this cluster
Zemismart Light Strip Driver
Zemismart Technology Limited
Smart RGBTW Bulb
Leedarson
Aqara Smart Light
Aqara
KAJPLATS E26 WS globe 1600lm
IKEA of Sweden
KAJPLATS E12 CWS globe 800lm
IKEA of Sweden
KAJPLATS E26 WS globe 1100lm
IKEA of Sweden
Govee RGBWW Smart LED Bulb
Shenzhen Qianyan Technology
Smart Bulb Filament
Hama GmbH
WiZ A19
Signify
Essentials Holiday String Lights
Nanoleaf
Sengled Smart Matter A60 bulb
Sengled
Govee AI Sync Box 2
Shenzhen Qianyan Technology
H600C
Shenzhen Qianyan Technology
KAJPLATS E12 WS globe 800lm
IKEA of Sweden
Govee Recessed Downlight 2
Shenzhen Qianyan Technology
Govee Table Lamp Classic
Shenzhen Qianyan Technology
Sailsco Smart Bulb RGB+CCT
Saishigao
Smart Night Light Thread
ThirdReality
MT-RGBCCT
Sunricher
Nanoleaf Indoor Lights
Nanoleaf
Govee Neon Light
Shenzhen Qianyan Technology
Govee Floor Lamp 3
Shenzhen Qianyan Technology
EGLO-MAT-TW
EGLO
Govee Neon Rope Light 2
Shenzhen Qianyan Technology