The Groups cluster (0x0004) is a Matter cluster that Enables devices to be organized into groups for coordinated control, allowing a single command to affect multiple devices simultaneously.. It defines 10 commands and 1 attribute and is mandatory for 25 device types.
Groups 0x0004
Enables devices to be organized into groups for coordinated control, allowing a single command to affect multiple devices simultaneously.
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 1
Commands 10
Features 1
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
NameSupport
max 0x80
|
NameSupportBitmap |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
AddGroup
The AddGroup command allows a client to add group membership in a particular group for the server endpoint.
|
client→server |
GroupID: group_id, GroupName: char_string |
| 0x00 |
AddGroupResponse
The AddGroupResponse is sent by the Groups cluster server in response to an AddGroup command.
|
server→client |
Status: enum8, GroupID: group_id |
| 0x01 |
ViewGroup
The ViewGroup command allows a client to request that the server responds with a ViewGroupResponse command containing the name string for a particular group.
|
client→server |
GroupID: group_id |
| 0x01 |
ViewGroupResponse
The ViewGroupResponse command is sent by the Groups cluster server in response to a ViewGroup command.
|
server→client |
Status: enum8, GroupID: group_id, GroupName: char_string |
| 0x02 |
GetGroupMembership
The GetGroupMembership command allows a client to inquire about the group membership of the server endpoint, in a number of ways.
|
client→server |
GroupList: group_id |
| 0x02 |
GetGroupMembershipResponse
The GetGroupMembershipResponse command is sent by the Groups cluster server in response to a GetGroupMembership command.
|
server→client |
Capacity: int8u, GroupList: group_id |
| 0x03 |
RemoveGroup
The RemoveGroup command allows a client to request that the server removes the membership for the server endpoint, if any, in a particular group.
|
client→server |
GroupID: group_id |
| 0x03 |
RemoveGroupResponse
The RemoveGroupResponse command is generated by the server in response to the receipt of a RemoveGroup command.
|
server→client |
Status: enum8, GroupID: group_id |
| 0x04 |
RemoveAllGroups
The RemoveAllGroups command allows a client to direct the server to remove all group associations for the server endpoint.
|
client→server | None |
| 0x05 |
AddGroupIfIdentifying
The AddGroupIfIdentifying command allows a client to add group membership in a particular group for the server endpoint, on condition that the endpoint is identifying itself.
|
client→server |
GroupID: group_id, GroupName: char_string |
GroupNames
(GN)
bit 0
The ability to store a name for a group.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
📱
📱
💡
🌉
💡
🔌
📱
🔒
🔒
📱
💨
🌡
📱
🔘
💡
🔘
🔌
🔘
📱
📱
📱
📱
🌡
🪟
🪟
Air Purifier
Optional Server
Color Dimmer Switch
Optional Client
Color Temperature Light
Mandatory Server
Control Bridge
Mandatory Client
Dimmable Light
Mandatory Server
Dimmable Plug-In Unit
Mandatory Server
Dimmer Switch
Optional Client
Door Lock
Optional Server
Door Lock Controller
Optional Client
Extended Color Light
Mandatory Server
Fan
Mandatory Server
Heating/Cooling Unit
Optional Server
Mounted Dimmable Load Control
Mandatory Server
Mounted On/Off Control
Mandatory Server
On/Off Light
Mandatory Server
On/Off Light Switch
Optional Client
On/Off Plug-in Unit
Mandatory Server
On/Off Sensor
Optional Client
Pump
Optional Server
Pump Controller
Optional Client
Room Air Conditioner
Optional Server
Smoke CO Alarm
Optional Server
Thermostat
Optional Server
Window Covering
Optional Server
Window Covering Controller
Optional Client
Devices Implementing This Cluster
398 devices in the survey implement this cluster
Matter Thread Dimmer Switch VTM31-SN
Inovelli
Eve Energy
Eve Systems
Aqara Smart Light
Aqara
GRILLPLATS plug
IKEA of Sweden
Essentials A19-A60
Nanoleaf
Onvis Smart Plug S4
Onvis
Matter Thread On/Off Switch VTM30-SN
Inovelli
Essentials Downlight
Nanoleaf
Tapo Mini Plug
TP-Link
Smart Multicolor Bulb
Tapo
KAJPLATS E27 WS globe 1521lm
IKEA of Sweden
KAJPLATS GU10 WS 575lm
IKEA of Sweden
Eve Energy
Eve Systems
KAJPLATS GU10 CWS 575lm
IKEA of Sweden
Matter Thread Fan and Light Module VTM36
Inovelli
Tapo Smart Wi-Fi Light Switch
TP-Link
YS1606-UC
Homebridge
KAJPLATS E27 CWS globe 1055lm
IKEA of Sweden
Matter Thread Fan Switch VTM35-SN
Inovelli
SmartPlug
Espressif Systems
Aqara Climate Sensor W100
Aqara
Smart Plug-in Unit
SONOFF
KAJPLATS E27 WS G95 clear 806lm
IKEA of Sweden
KAJPLATS E14 CWS globe 806lm
IKEA of Sweden