Appliances85 — RVC Clean Mode

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

FieldValue
Cluster ID decimal85
Cluster ID hex0x0055
Cluster nameRVC Clean Mode
Cluster revision (Matter 1.6.1)5
Roleapplication
ScopeEndpoint
PICS codeRVCCLEANM
Typical endpoint1

Revision history

RevisionChange
1Initial revision
2Add 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.
3Remove 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.
4Add Vacuum then Mop cleaning mode
5DirectModeChange 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
}
PartMeaning
1Endpoint ID
85RVC Clean Mode cluster
0SupportedModes 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.

BitCodeFeatureConformanceMeaning
0DEPONOFFOnOffXDependency with the OnOff cluster
20DIRECTMODECHDirectModeChangeOCluster 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

ValueNameConformanceMeaning
0Auto—The device decides the best mode automatically.
1Quick—Faster than normal, usually at the cost of quality or energy.
2Quiet—Minimises noise.
3LowNoise—Reduced noise compared with normal operation.
4LowEnergy—Reduced energy consumption.
5Vacation—Long-absence mode (reduced activity or safe state).
6Min—Lowest setting of the controlled quantity.
7Max—Highest setting of the controlled quantity.
8Night—Night-time operation.
9Day—Day-time operation.
16384DeepClean——
16385Vacuum—The device's vacuuming feature is enabled in this mode.
16386Mop—The device's mopping feature is enabled in this mode.
16387Vacuum then Mop——

StatusCodeEnum

ValueNameConformanceMeaning
64CleaningInProgressM—

ModeOptionStruct (struct)

This is a struct representing a possible mode of the server.

FieldNameTypeConformanceConstraintMeaning
0LabelstringMmax length 64Indicates readable text that describes the mode option, so that a client can provide it to the user to indicate what this option means.
1Modeuint8M—This field is used to identify the mode option.
2ModeTagslist of ModeTagStructM1 to 8This 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.

FieldNameTypeConformanceConstraintMeaning
0MfgCodevendor-idOdescIf the MfgCode field exists, the Value field is in the manufacturer-specific value range.
1Valueenum16M—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 …".

IDHexAttributeTypeConformanceAccessQualitiesDefault
00x0000SupportedModes————
10x0001CurrentMode————
20x0002StartUpModeX———
30x0003OnModeX———

Global attributes

IDHexAttributeMeaning
655280xFFF8GeneratedCommandListResponse command IDs this server generates.
655290xFFF9AcceptedCommandListCommand IDs this server accepts.
655310xFFFBAttributeListAttribute IDs implemented.
655320xFFFCFeatureMapImplemented optional features (see above).
655330xFFFDClusterRevisionCluster 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.

PropertyValue
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.

PropertyValue
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.

PropertyValue
Type
ConformanceX
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.

PropertyValue
Type
ConformanceX
Access—

Example:

{
  "1/85/3": 0
}

Cluster 85 Commands

Cluster 85 has 1 client-to-server command and 1 response.

IDHexCommandDirectionConformanceResponseDescription
00x00ChangeToModeclient → serverMChangeToModeResponseThis command is used to change device modes.
10x01ChangeToModeResponseserver → clientM—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

FieldValue
Command ID0
Command hex0x00
Command nameChangeToMode
Directionclient → server
ConformanceM
ResponseChangeToModeResponse
Access(invoke: operate)

Payload Fields

IDFieldPayload keyTypeConformanceConstraintMeaning
0NewModenewModeuint8MdescIf 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

FieldValue
Command ID1
Command hex0x01
Command nameChangeToModeResponse
Directionserver → client (response)
ConformanceM

Response Fields

IDFieldPayload keyTypeConformanceConstraintMeaning
0Statusstatusenum8Mdesc—
1StatusTextstatusTextstring[Status = status], Mmax 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 as n/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.