The Group Key Management cluster (0x003F) is a Matter cluster that Manages cryptographic keys used for secure group communication.. It defines 6 commands and 5 attributes and is mandatory for 1 device type.
Group Key Management 0x003F
Manages cryptographic keys used for secure group communication.
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 5
Commands 6
Features 2
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 | GroupKeyMap | array | Writable write: manage |
| 0x0001 | GroupTable | array | |
| 0x0002 |
MaxGroupsPerFabric
default 0
|
int16u | |
| 0x0003 |
MaxGroupKeysPerFabric
min 1 · default 1
|
int16u | |
| 0x0004 | GroupcastAdoption | array | Writable Optional read: administer write: administer |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
KeySetWrite
invoke: administer
This command is used by Administrators to set the state of a given Group Key Set, including atomically updating the state of all epoch keys.
|
client→server |
GroupKeySet: GroupKeySetStruct |
| 0x01 |
KeySetRead
invoke: administer
This command is used by Administrators to read the state of a given Group Key Set.
|
client→server |
GroupKeySetID: int16u |
| 0x02 |
KeySetReadResponse
This command SHALL be generated in response to the KeySetRead command, if a valid Group Key Set was found.
|
server→client |
GroupKeySet: GroupKeySetStruct |
| 0x03 |
KeySetRemove
invoke: administer
This command is used by Administrators to remove all state of a given Group Key Set.
|
client→server |
GroupKeySetID: int16u |
| 0x04 |
KeySetReadAllIndices
invoke: administer
This command is used by Administrators to query a list of all Group Key Sets associated with the accessing fabric.
|
client→server | None |
| 0x05 |
KeySetReadAllIndicesResponse
This command SHALL be generated in response to KeySetReadAllIndices and it SHALL contain the list of _GroupKeySetID_ for all Group Key Sets associated with the scoped Fabric.
|
server→client |
GroupKeySetIDs: int16u |
CacheAndSync
(CS)
bit 0
The ability to support CacheAndSync security policy and MCSP.
Groupcast
(GCAST)
bit 1
The device supports groups using the Groupcast cluster.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
548 devices in the survey implement this cluster
Govee Gaming Light Bars Pro
Shenzhen Qianyan Technology
Govee Glide Wall Light
Shenzhen Qianyan Technology
Govee LED Strip Light M1
Shenzhen Qianyan Technology
Smart Tower Fan 2 Max (42 Inch)
Shenzhen Qianyan Technology
Essentials Lightstrip
Nanoleaf
SwitchBot Relay Switch 1
SwitchBot
Sengled Wi-Fi Plug
Sengled
Heiman smart CO sensor
HEIMAN
Door Sensor
NEO
UA-SmartPlug-M028-US102
Uascent
MT-CCT
Sunricher
Aqara Smart Lock U400
Aqara
Shelly 1 Gen4
Shelly
Tapo Smart Power Strip
Tapo
Smart Night Light-W
ThirdReality
Govee Ceiling Light Pro
Shenzhen Qianyan Technology
Kasa Smart Wi-Fi Dimmer Switch
Kasa
Aqara Smart Lock U300
Aqara
SAWF-07P
SONOFF
Decora Smart Wi-Fi 2nd Gen Outlet
Leviton
SONOFF SwitchMan Smart Wall Switch
SONOFF
Smart RGBTW Bulb
Leedarson
Zemismart Light Strip Driver
Zemismart Technology Limited
Govee RGBICWW Floor Lamp Pro
Shenzhen Qianyan Technology