The Level Control cluster (0x0008) is a Matter cluster that Controls the level or intensity of a device, such as brightness for lights or speed for fans. Supports smooth transitions.. It defines 9 commands and 14 attributes and is mandatory for 18 device types.
Level Control 0x0008
Controls the level or intensity of a device, such as brightness for lights or speed for fans. Supports smooth transitions.
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 14
Commands 9
Features 3
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
CurrentLevel
nullable
|
int8u | |
| 0x0001 | RemainingTime | int16u | Optional |
| 0x0002 |
MinLevel
max 254 · default 1
|
int8u | Optional |
| 0x0003 |
MaxLevel
max 254 · default 0xFE
|
int8u | Optional |
| 0x0004 | CurrentFrequency | int16u | Optional |
| 0x0005 | MinFrequency | int16u | Optional |
| 0x0006 | MaxFrequency | int16u | Optional |
| 0x000F |
Options
max 0x03
|
OptionsBitmap | Writable |
| 0x0010 |
OnOffTransitionTime
default 0x0000
|
int16u | Writable Optional |
| 0x0011 |
OnLevel
nullable
|
int8u | Writable |
| 0x0012 |
OnTransitionTime
nullable
|
int16u | Writable Optional |
| 0x0013 |
OffTransitionTime
nullable
|
int16u | Writable Optional |
| 0x0014 |
DefaultMoveRate
0x01..254 · nullable
|
int8u | Writable Optional |
| 0x4000 |
StartUpCurrentLevel
nullable
|
int8u | Writable Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
MoveToLevel
This command will move the device to the specified level.
|
client→server |
Level: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x01 |
Move
This command will move the device using the specified values.
|
client→server |
MoveMode: MoveModeEnum, Rate: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x02 |
Step
This command will do a relative step change of the device using the specified values.
|
client→server |
StepMode: StepModeEnum, StepSize: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x03 |
Stop
This command will stop the actions of various other commands that are still in progress.
|
client→server |
OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x04 |
MoveToLevelWithOnOff
Command description for MoveToLevelWithOnOff
|
client→server |
Level: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x05 |
MoveWithOnOff
Command description for MoveWithOnOff
|
client→server |
MoveMode: MoveModeEnum, Rate: int8u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x06 |
StepWithOnOff
Command description for StepWithOnOff
|
client→server |
StepMode: StepModeEnum, StepSize: int8u, TransitionTime: int16u, OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x07 |
StopWithOnOff
Command description for StopWithOnOff
|
client→server |
OptionsMask: OptionsBitmap, OptionsOverride: OptionsBitmap |
| 0x08 |
MoveToClosestFrequency
Optional This command will cause the device to change the current frequency to the requested value.
|
client→server |
Frequency: int16u |
OnOff
(OO)
bit 0
Dependency with the On/Off cluster
Lighting
(LT)
bit 1
Behavior that supports lighting applications
Frequency
(FQ)
bit 2
Supports frequency attributes and behavior.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
📱
📱
💡
🌉
💡
🔌
📱
📱
🌡
📱
🔘
💡
🔌
🔘
📱
📱
🔊
📱
Casting Video Client
Optional Client
Color Dimmer Switch
Mandatory Client
Color Temperature Light
Mandatory Server
Control Bridge
Mandatory Client
Dimmable Light
Mandatory Server
Dimmable Plug-In Unit
Mandatory Server
Dimmer Switch
Mandatory Client
Extended Color Light
Mandatory Server
Heating/Cooling Unit
Mandatory Server
Mounted Dimmable Load Control
Mandatory Server
Mounted On/Off Control
Optional Server
On/Off Light
Optional Server
On/Off Plug-in Unit
Optional Server
On/Off Sensor
Optional Client
Pump
Optional Server
Pump Controller
Optional Client
Speaker
Mandatory Server
Video Remote Control
Optional Client
Devices Implementing This Cluster
334 devices in the survey implement this cluster
Essentials Holiday String Lights
Nanoleaf
Haiku H/I Series
Big Ass Fans
WiZ G95 Filament
Signify Netherlands B.V.
Govee Outdoor Wall Light
Shenzhen Qianyan Technology
WiZ A.E27
Signify Netherlands B.V.
Power Plug H2 EU（RGB）
Aqara
Decora Smart Wi-Fi Scene Controller Switch
Leviton
H61B8
Shenzhen Qianyan Technology
H61B9
Shenzhen Qianyan Technology
Smart Rainbow LED
Momax
Govee Smart AI Sync Box
Shenzhen Qianyan Technology
matter
Tuya
WiZ A67.E27
Signify Netherlands B.V.
SmartCeilingFan
Eran
Matter Light Switch
ESPHome
Govee Ceiling Light
Shenzhen Qianyan Technology
Philips Candle
Signify Netherlands B.V.
Philips GU10
Signify Netherlands B.V.
Govee Uplighter Floor Lamp
Shenzhen Qianyan Technology
WiZ G25 Filament
Signify Netherlands B.V.
Smart Bulb
NOUS TECHNOLOGY
Govee Strip Light 2 Pro
Shenzhen Qianyan Technology
Govee Square Ceiling Light
Shenzhen Qianyan Technology
Govee Outdoor Pathway Lights 2
Shenzhen Qianyan Technology