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
401 devices in the survey implement this cluster
Eve Energy Outdoor
Eve Systems
SwitchBot Floor Lamp
SwitchBot
Zemismart M6 Hub
Zemismart Technology Limited
Govee Floor Lamp
Shenzhen Qianyan Technology
Essentials Wifi Smart Light
Nanoleaf
Essentials Holiday String Lights
Nanoleaf
H6076A
Shenzhen Qianyan Technology
MS1
Sensereo Limited
Shelly 1 Mini Gen3
Shelly
Smart Wi-Fi Thermostat
Meross
Zemismart MT25B Roller Motor
Zemismart Technology Limited
Smart RGBTW Bulb
Leedarson
LIFX Luna
Feit Electric
Dimmable Light
EcoDim
Smart Plug Mini
Meross
Govee Cutain Lights
Shenzhen Qianyan Technology
A19 Smart Bulb
Energetic
Smart Wi-Fi Switch
Meross
Comet Matter
Eurotronic Technology GmbH
UA-SmartPlug-M023-US102
Uascent
Smart Bulb
L-TRADE
Smart Hub
Meross
WiZ A.E27
Signify
SONOFF SwitchMan Smart Wall Switch
SONOFF