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
Decora Smart Wi-Fi 2nd Gen Outlet
Leviton
SONOFF SwitchMan Smart Wall Switch
SONOFF
Smart RGBTW Bulb
Leedarson
Govee RGBICWW Floor Lamp Pro
Shenzhen Qianyan Technology
Zemismart Light Strip Driver
Zemismart Technology Limited
SmartWings Levitate with DUCTECH
DUCTECH
Eve Energy
Eve Systems
Shelly 1PM Gen4
Shelly
Smart Plug
Realwe Innovation
Tapo Smart Wi-Fi Lamp Dimmer Kit
TP-Link
Aqara Smart Light
Aqara
Kasa Smart Outdoor Plug
Kasa
KAJPLATS E26 WS globe 1600lm
IKEA of Sweden
KAJPLATS E12 CWS globe 800lm
IKEA of Sweden
KAJPLATS E26 WS globe 1100lm
IKEA of Sweden
Smart Plug Mini
Meross
Shelly Outdoor Plug S Gen3
Shelly
Eve Dimmer Switch
Eve Systems
Cync Indoor Plug
GE Lighting, a Savant company
SONOFF SwitchMan Smart Wall Switch
SONOFF
Govee RGBWW Smart LED Bulb
Shenzhen Qianyan Technology
Eve Energy
Eve Systems
WiZ A19
Signify
SONOFF MINI-D Wi-Fi Smart Switch
SONOFF