Matter Cluster 85 — RVC Clean Mode
Matter Cluster 85 (0x0055) RVC Clean Mode: attributes, commands, events, data types, shadow paths and bridge payload examples.
Matter Cluster 85 — RVC Clean Mode Cluster
Matter Cluster 85, also written as 0x0055, is the RVC Clean Mode Cluster.
This cluster is derived from the Mode Base cluster and defines additional mode tags and namespaced enumerated values for the cleaning type of robotic vacuum cleaner devices.
This cluster is derived from the Mode Base cluster: it inherits the base attributes, commands and data types listed below and adds the cluster-specific values. Where the base definition applies, the base text is used.
Cluster Identity
| Field | Value |
|---|---|
| Cluster ID decimal | 85 |
| Cluster ID hex | 0x0055 |
| Cluster name | RVC Clean Mode |
| Cluster revision (Matter 1.6.1) | 5 |
| Role | application |
| Scope | Endpoint |
| PICS code | RVCCLEANM |
| Typical endpoint | 1 |
Revision history
| Revision | Change |
|---|---|
| 1 | Initial revision |
| 2 | Add constraint about changing cleaning modes while the RVC Run Mode cluster is in a non-Idle mode. ChangeToModeResponse command: StatusText must be provided for InvalidInMode status. Deprecate the OnMode attribute and the related feature map bit. |
| 3 | Remove constraint on changing cleaning modes while the RVC Run Mode cluster is in a non-Idle mode. Continue to allow InvalidInMode response for devices that do not support such mode changes. |
| 4 | Add Vacuum then Mop cleaning mode |
| 5 | DirectModeChange made non-provisional |
Shadow Path Format
Cluster 85 values in the device shadow use this format:
endpoint_id / 85 / attribute_id
Example:
{
"1/85/0": 0
}
| Part | Meaning |
|---|---|
1 | Endpoint ID |
85 | RVC Clean Mode cluster |
0 | SupportedModes attribute |
Cluster 85 Features
The FeatureMap attribute (1/85/65532) is a bitmap. Each bit set means the device implements that feature and the attributes and commands that depend on it.
| Bit | Code | Feature | Conformance | Meaning |
|---|---|---|---|---|
| 0 | DEPONOFF | OnOff | X | Dependency with the OnOff cluster |
| 20 | DIRECTMODECH | DirectModeChange | O | Cluster supports changing clean modes from non-Idle states |
Example: FeatureMap = 0 means no optional feature is enabled; 1048577 means every feature listed above is enabled.
Data Types
ModeTag
| Value | Name | Conformance | Meaning |
|---|---|---|---|
| 0 | Auto | — | The device decides the best mode automatically. |
| 1 | Quick | — | Faster than normal, usually at the cost of quality or energy. |
| 2 | Quiet | — | Minimises noise. |
| 3 | LowNoise | — | Reduced noise compared with normal operation. |
| 4 | LowEnergy | — | Reduced energy consumption. |
| 5 | Vacation | — | Long-absence mode (reduced activity or safe state). |
| 6 | Min | — | Lowest setting of the controlled quantity. |
| 7 | Max | — | Highest setting of the controlled quantity. |
| 8 | Night | — | Night-time operation. |
| 9 | Day | — | Day-time operation. |
| 16384 | DeepClean | — | — |
| 16385 | Vacuum | — | The device's vacuuming feature is enabled in this mode. |
| 16386 | Mop | — | The device's mopping feature is enabled in this mode. |
| 16387 | Vacuum then Mop | — | — |
StatusCodeEnum
| Value | Name | Conformance | Meaning |
|---|---|---|---|
| 64 | CleaningInProgress | M | — |
ModeOptionStruct (struct)
This is a struct representing a possible mode of the server.
| Field | Name | Type | Conformance | Constraint | Meaning |
|---|---|---|---|---|---|
| 0 | Label | string | M | max length 64 | Indicates readable text that describes the mode option, so that a client can provide it to the user to indicate what this option means. |
| 1 | Mode | uint8 | M | — | This field is used to identify the mode option. |
| 2 | ModeTags | list of ModeTagStruct | M | 1 to 8 | This field contains a list of tags that are associated with the mode option. |
ModeTagStruct (struct)
A Mode Tag is meant to be interpreted by the client for the purpose the cluster serves.
| Field | Name | Type | Conformance | Constraint | Meaning |
|---|---|---|---|---|---|
| 0 | MfgCode | vendor-id | O | desc | If the MfgCode field exists, the Value field is in the manufacturer-specific value range. |
| 1 | Value | enum16 | M | — | Indicates the mode tag within a mode tag namespace which is either manufacturer specific or standard. |
Cluster 85 Attributes
Cluster 85 defines 4 attributes plus the global attributes. Conformance: M mandatory, O optional, a feature code means "mandatory when that feature is present", square brackets mean "optional when …".
| ID | Hex | Attribute | Type | Conformance | Access | Qualities | Default |
|---|---|---|---|---|---|---|---|
| 0 | 0x0000 | SupportedModes | — | — | — | — | |
| 1 | 0x0001 | CurrentMode | — | — | — | — | |
| 2 | 0x0002 | StartUpMode | X | — | — | — | |
| 3 | 0x0003 | OnMode | X | — | — | — |
Global attributes
| ID | Hex | Attribute | Meaning |
|---|---|---|---|
| 65528 | 0xFFF8 | GeneratedCommandList | Response command IDs this server generates. |
| 65529 | 0xFFF9 | AcceptedCommandList | Command IDs this server accepts. |
| 65531 | 0xFFFB | AttributeList | Attribute IDs implemented. |
| 65532 | 0xFFFC | FeatureMap | Implemented optional features (see above). |
| 65533 | 0xFFFD | ClusterRevision | Cluster revision implemented; 5 for a Matter 1.6.1 device. |
Attribute Details
Attribute 0 / 0x0000 — SupportedModes
Path example:
1/85/0
At least one entry in the SupportedModes attribute includes the Vacuum and/or the Mop mode tag in the ModeTags field list.
| Property | Value |
|---|---|
| Type | |
| Conformance | — |
| Access | — |
Example:
{
"1/85/0": 0
}
Attribute 1 / 0x0001 — CurrentMode
Path example:
1/85/1
No condensed specification text is available for CurrentMode; use the type, conformance and constraint below together with the cluster description above.
| Property | Value |
|---|---|
| Type | |
| Conformance | — |
| Access | — |
Example:
{
"1/85/1": 0
}
Attribute 2 / 0x0002 — StartUpMode
Path example:
1/85/2
No condensed specification text is available for StartUpMode; use the type, conformance and constraint below together with the cluster description above.
| Property | Value |
|---|---|
| Type | |
| Conformance | X |
| Access | — |
Example:
{
"1/85/2": 0
}
Attribute 3 / 0x0003 — OnMode
Path example:
1/85/3
No condensed specification text is available for OnMode; use the type, conformance and constraint below together with the cluster description above.
| Property | Value |
|---|---|
| Type | |
| Conformance | X |
| Access | — |
Example:
{
"1/85/3": 0
}
Cluster 85 Commands
Cluster 85 has 1 client-to-server command and 1 response.
| ID | Hex | Command | Direction | Conformance | Response | Description |
|---|---|---|---|---|---|---|
| 0 | 0x00 | ChangeToMode | client → server | M | ChangeToModeResponse | This command is used to change device modes. |
| 1 | 0x01 | ChangeToModeResponse | server → client | M | — | This command is sent by the device on receipt of the ChangeToMode command. |
AcceptedCommandList
The AcceptedCommandList attribute lists the command IDs the endpoint actually implements:
endpoint_id / 85 / 65529
{
"1/85/65529": [
0
]
}
Before sending a Cluster 85 command, check that the command ID exists in endpoint/85/65529. Optional commands are only present when the matching feature is set in FeatureMap.
Bridge Command Payload Format
The bridge accepts Matter commands in this structure:
{
"message_id": "1",
"command": "device_command",
"args": {
"endpoint_id": 1,
"cluster_id": 85,
"command_name": "ChangeToMode",
"payload": {},
"timed_request_timeout_ms": 1000
}
}
For Cluster 85, always use "cluster_id": 85. Payload keys are the command field names in lowerCamelCase. Octet-string fields are base64-encoded. timed_request_timeout_ms is required for timed commands and ignored otherwise.
Command: ChangeToMode
Purpose
This command is used to change device modes. On receipt of this command the device must respond with a ChangeToModeResponse command.
Command Identity
| Field | Value |
|---|---|
| Command ID | 0 |
| Command hex | 0x00 |
| Command name | ChangeToMode |
| Direction | client → server |
| Conformance | M |
| Response | ChangeToModeResponse |
| Access | (invoke: operate) |
Payload Fields
| ID | Field | Payload key | Type | Conformance | Constraint | Meaning |
|---|---|---|---|---|---|---|
| 0 | NewMode | newMode | uint8 | M | desc | If the NewMode field doesn't match the Mode field of any entry of the SupportedModes list, the ChangeToModeResponse command's Status field indicates UnsupportedMode and the StatusText field is included and may be used to indicate the issue, with a human … |
Bridge Command Example
{
"message_id": "1",
"command": "device_command",
"args": {
"endpoint_id": 1,
"cluster_id": 85,
"command_name": "ChangeToMode",
"payload": {
"newMode": 1
}
}
}
The device answers with ChangeToModeResponse (see below).
Command: ChangeToModeResponse
Purpose
This command is sent by the device on receipt of the ChangeToMode command.
Command Identity
| Field | Value |
|---|---|
| Command ID | 1 |
| Command hex | 0x01 |
| Command name | ChangeToModeResponse |
| Direction | server → client (response) |
| Conformance | M |
Response Fields
| ID | Field | Payload key | Type | Conformance | Constraint | Meaning |
|---|---|---|---|---|---|---|
| 0 | Status | status | enum8 | M | desc | — |
| 1 | StatusText | statusText | string | [Status = status], M | max length 64 | — |
Cluster 85 Events
Cluster 85 defines no events.
SmartphoneKey Notes
- Cluster 85 is not currently exposed by SmartphoneKey devices. This page documents the Matter 1.6.1 specification so that future devices can be interpreted without changes to the backend.
- Shadow paths follow
endpoint/85/attribute; attribute values that the device reports as unreadable are written asn/a. - Attribute IDs, command IDs and enum values on this page come from the CSA Matter 1.6.1 data model; descriptions are condensed from the specification text.