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
409 devices in the survey implement this cluster
Zemismart WiFi Smart Switch
Zemismart Technology Limited
Aqara Dimmer Switch H2
Aqara
Decora Smart Wi-Fi 2nd Gen Mini Plug-In Dimmer
Leviton
Philips A.E27
Signify
Shelly 1 Gen3
Shelly
H600B
Shenzhen Qianyan Technology
Ledvance Matter PAR16 RGBW
LEDVANCE
matter
Tuya
LIFX Ceiling
Feit Electric
Smart Plug Mini
Meross
GW60-Matter
MIUC Technology (Shenzhen) Co.,Ltd
Cync Full Color Undercabinet 12"
GE Lighting, a Savant company
Tapo Smart Plug, Energy Monitoring
Tapo
Govee Outdoor Deck Lights
Shenzhen Qianyan Technology
LIFX Permanent Outdoor
Feit Electric
Nanoleaf Outdoor Lights
Nanoleaf
Govee string lights
Shenzhen Qianyan Technology
Govee Ceiling Light
Shenzhen Qianyan Technology
SmartCeilingFan
Eran
Cync Indoor Light Strip 16ft
GE Lighting, a Savant company
Touchscreen Switch S100
Aqara
matter-thread-light
Espressif Systems
Smart A19 LED Bulb
HONG KONG LAUNRAY INDUSTRY LIMITED
Philips P45.E27
Signify