The Group Key Management cluster (0x003F) is a Matter cluster that Manages cryptographic keys used for secure group communication.. It defines 6 commands and 4 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 4
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 |
| 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
770 devices in the survey implement this cluster
SwitchBot Air Purifier
SwitchBot
Eve Energy
Eve Systems
Govee Smart Bulb
Shenzhen Qianyan Technology
Eve Energy
Eve Systems
SMART MAT PAR16 RGBW GU10
LEDVANCE
SH Matter Bridge
BOSCH
Dreame X50 Ultra
Dreame
Home Relay 16A Thread
WAGO GmbH & Co. KG
Smart Window Shade Tubular Motor
JLM
Level Bolt (Matter)
Level Home
FocusPro S200 Smart Thermostat
Resideo
Govee Smart Bulb
Shenzhen Qianyan Technology
Nuki Smart Lock
Nuki
Sengled Wi-Fi Plug
Sengled
Tapo Smart Wi-Fi Light Switch
Tapo
Aqara Light Switch H2
Aqara
Aqara Camera Hub G350
Aqara
SwitchBot AI Hub
SwitchBot
Cync Full Color Deco Candle Base
GE Lighting, a Savant company
Smart RGBTW Bulb
Leedarson
Govee Smart Bulb
Shenzhen Qianyan Technology
UA-SmartPlug-M028-US102
Uascent
Robot Vacuum Cleaner
Tapo
Cync Full Color Undercabinet 12"
GE Lighting, a Savant company