Matter Cluster 73 — Oven Mode
Matter Cluster 73 (0x0049) Oven Mode: attributes, commands, events, data types, shadow paths and bridge payload examples.
Matter Cluster 73 — Oven Mode Cluster
Matter Cluster 73, also written as 0x0049, is the Oven Mode Cluster.
This cluster is derived from the Mode Base cluster and defines additional mode tags and namespaced enumerated values for oven 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 | 73 |
| Cluster ID hex | 0x0049 |
| Cluster name | Oven Mode |
| Cluster revision (Matter 1.6.1) | 2 |
| Role | application |
| Scope | Endpoint |
| PICS code | OTCCM |
| Typical endpoint | 1 |
Revision history
| Revision | Change |
|---|---|
| 1 | Initial revision |
| 2 | Set OnOff feature, StartUpMode, and OnMode as disallowed (previously a Device Type override) |
Shadow Path Format
Cluster 73 values in the device shadow use this format:
endpoint_id / 73 / attribute_id
Example:
{
"1/73/0": 0
}
| Part | Meaning |
|---|---|
1 | Endpoint ID |
73 | Oven Mode cluster |
0 | SupportedModes attribute |
Cluster 73 Features
The FeatureMap attribute (1/73/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 |
Example: FeatureMap = 0 means no optional feature is enabled; 1 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 | Bake | — | This mode sets the device into baking mode for baking food items. |
| 16385 | Convection | — | This mode sets the device into convection mode which creates an airflow within the device during the cooking duration. |
| 16386 | Grill | — | This mode sets the device into grill mode for grilling food items. |
| 16387 | Roast | — | This mode sets the device into roast mode for roasting food items. |
| 16388 | Clean | — | This mode sets the device into cleaning mode to clean the internal components of the appliance. |
| 16389 | Convection Bake | — | — |
| 16390 | Convection Roast | — | — |
| 16391 | Warming | — | This mode sets the device into a warming mode which begins warming the cavity. |
| 16392 | Proofing | — | This mode sets the device into proofing mode which creates an environment ready for proofing. |
| 16393 | Steam | — | — |
| 16394 | Air Fry | — | — |
| 16395 | Air Sous Vide | — | — |
| 16396 | Frozen Food | — | — |
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 73 Attributes
Cluster 73 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; 2 for a Matter 1.6.1 device. |
Attribute Details
Attribute 0 / 0x0000 — SupportedModes
Path example:
1/73/0
At least one entry in the SupportedModes attribute includes the Bake mode tag in the ModeTags field list.
| Property | Value |
|---|---|
| Type | |
| Conformance | — |
| Access | — |
Example:
{
"1/73/0": 0
}
Attribute 1 / 0x0001 — CurrentMode
Path example:
1/73/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/73/1": 0
}
Attribute 2 / 0x0002 — StartUpMode
Path example:
1/73/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/73/2": 0
}
Attribute 3 / 0x0003 — OnMode
Path example:
1/73/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/73/3": 0
}
Cluster 73 Commands
Cluster 73 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 / 73 / 65529
{
"1/73/65529": [
0
]
}
Before sending a Cluster 73 command, check that the command ID exists in endpoint/73/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": 73,
"command_name": "ChangeToMode",
"payload": {},
"timed_request_timeout_ms": 1000
}
}
For Cluster 73, always use "cluster_id": 73. 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": 73,
"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 73 Events
Cluster 73 defines no events.
SmartphoneKey Notes
- Cluster 73 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/73/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.