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
Govee Ceiling Light
Shenzhen Qianyan Technology
Smart Wall Switch
TEST_VENDOR
Ledvance Matter Classic B P RGBW
LEDVANCE
Smart Lights Smart Plug
Legrand Group
Cync Full Color Undercabinet 24"
GE Lighting, a Savant company
KAJPLATS GU10 WS 575lm
IKEA of Sweden
Govee Neon Rope Light 2
Shenzhen Qianyan Technology
LED Driver
MEAN WELL
WiZ PAR38
Signify
LIFX Switch
LIFX
WiZ A.E27
Signify
Decora Smart Wi-Fi Fan Speed Controller
Leviton
H6013
Shenzhen Qianyan Technology
Smart Wall Switch
TEST_VENDOR
Cync Full Color Undercabinet 18"
GE Lighting, a Savant company
Lennox L40 Smart Thermostat
Lennox
Govee Holiday Projector Lights
Shenzhen Qianyan Technology
Govee Smart TV Backlight 3S
Shenzhen Qianyan Technology
Smart Rainbow LED
Momax
Smart Bulb
Leedarson
Decora Smart Wi-Fi Scene Controller Switch
Leviton
WiZ A67.E27
Signify
WiZ A19
Signify
TNKGU1241
tink GmbH