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
Yeelight Smart Lamp
Yeelight
Sengled Multicolor A19 Bulb
Sengled
Govee AI Sync Box Kit 2
Shenzhen Qianyan Technology
Govee string lights
Shenzhen Qianyan Technology
electronic ballast for matter
dresden elektronik
Govee Tree Floor Lamp
Shenzhen Qianyan Technology
Govee Outdoor Flood Light 2
Shenzhen Qianyan Technology
Govee Strip Light with Tower Kit
Shenzhen Qianyan Technology
Govee Star Light Projector
Shenzhen Qianyan Technology
WiZ Linear
Signify
LIFX Spot
Feit Electric
Govee TV Backlight 3 Lite
Shenzhen Qianyan Technology
LIFX A21
Feit Electric
Govee Net lights
Shenzhen Qianyan Technology
Govee Strip Light 2 Pro
Shenzhen Qianyan Technology
Govee RGBIC Pro LED Strip Lights
Shenzhen Qianyan Technology
WiZ G125 Filament
Signify
WiZ G95 Filament
Signify
Brighter Floor Lamp
Brighter Lighting
Ledvance Matter Filament RGBW
LEDVANCE
Ledvance Matter Filament RGBW
LEDVANCE