Appliances95 — Microwave Oven Control

Matter Cluster 95 — Microwave Oven Control

Matter Cluster 95 (0x005F) Microwave Oven Control: attributes, commands, events, data types, shadow paths and bridge payload examples.

Matter Cluster 95 — Microwave Oven Control Cluster

Matter Cluster 95, also written as 0x005F, is the Microwave Oven Control Cluster. This cluster defines the requirements for the Microwave Oven Control cluster. This cluster has dependencies with the Operational State and Microwave Oven Mode clusters. The Operational State cluster and the Microwave Oven Mode clusters, or derivatives of those clusters must appear on the same endpoint as this cluster.

Cluster Identity

FieldValue
Cluster ID decimal95
Cluster ID hex0x005F
Cluster nameMicrowave Oven Control
Cluster revision (Matter 1.6.1)1
Roleapplication
ScopeEndpoint
PICS codeMWOCTRL
Typical endpoint1

Revision history

RevisionChange
1Initial revision

Shadow Path Format

Cluster 95 values in the device shadow use this format:

endpoint_id / 95 / attribute_id

Example:

{
  "1/95/0": 0
}
PartMeaning
1Endpoint ID
95Microwave Oven Control cluster
0CookTime attribute

Cluster 95 Features

The FeatureMap attribute (1/95/65532) is a bitmap. Each bit set means the device implements that feature and the attributes and commands that depend on it.

BitCodeFeatureConformanceMeaning
0PWRNUMPowerAsNumberOPower is specified as a unitless number or a percentage
1WATTSPowerInWattsP, OPower is specified in Watts
2PWRLMTSPowerNumberLimits[PWRNUM]Supports the limit attributes used with the PWRNUM feature

Example: FeatureMap = 0 means no optional feature is enabled; 7 means every feature listed above is enabled.


Cluster 95 Attributes

Cluster 95 defines 9 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
00x0000CookTimeelapsed-sMR (read: view)——
10x0001MaxCookTimeelapsed-sMR (read: view)——
20x0002PowerSettinguint8PWRNUMR (read: view)——
30x0003MinPoweruint8PWRLMTSR (read: view)——
40x0004MaxPoweruint8PWRLMTSR (read: view)——
50x0005PowerStepuint8PWRLMTSR (read: view)——
60x0006SupportedWattslist of uint16P, WATTSR (read: view)——
70x0007SelectedWattIndexuint8P, WATTSR (read: view)——
80x0008WattRatinguint16OR (read: view)—MS

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; 1 for a Matter 1.6.1 device.

Attribute Details

Attribute 0 / 0x0000 — CookTime

Path example:

1/95/0

Indicates the total cook time associated with the operation of the device. This attribute must remain unchanged during the operation of the oven unless the value is changed via a command or out-of-band action.

PropertyValue
Typeelapsed-s
ConformanceM
AccessR (read: view)
Constraint1 to MaxCookTime

Example:

{
  "1/95/0": 0
}

Attribute 1 / 0x0001 — MaxCookTime

Path example:

1/95/1

Indicates the maximum value to which the CookTime attribute can be set.

PropertyValue
Typeelapsed-s
ConformanceM
AccessR (read: view)
Constraint1 to 86400

Example:

{
  "1/95/1": 0
}

Attribute 2 / 0x0002 — PowerSetting

Path example:

1/95/2

Indicates the power level associated with the operation of the device. If the MinPower, MaxPower, and PowerStep attributes are not supported: - The minimum value of this attribute is 10, - The maximum value of this attribute is 100, - The value is in even multiples of 10, - The default value is 100. If the MinPower, MaxPower, and PowerStep attributes are supported: - The value of this attribute is between MinPower and MaxPower inclusive. - The value of this attribute is such that (PowerSetting - MinPower) % PowerStep == 0

PropertyValue
Typeuint8
ConformancePWRNUM
AccessR (read: view)
Constraintdesc

Example:

{
  "1/95/2": 1
}

Attribute 3 / 0x0003 — MinPower

Path example:

1/95/3

Indicates the minimum value to which the PowerSetting attribute that can be set on the server.

PropertyValue
Typeuint8
ConformancePWRLMTS
AccessR (read: view)
Constraint1 to 99

Example:

{
  "1/95/3": 1
}

Attribute 4 / 0x0004 — MaxPower

Path example:

1/95/4

Indicates the maximum value to which the PowerSetting attribute that can be set on the server.

PropertyValue
Typeuint8
ConformancePWRLMTS
AccessR (read: view)
Constraintcompute to 100

Example:

{
  "1/95/4": 1
}

Attribute 5 / 0x0005 — PowerStep

Path example:

1/95/5

Indicates the increment of power that can be set on the server. The value of this attribute is between 1 and MaxPower inclusive. The value of this attribute is such that (MaxPower - MinPower) % PowerStep == 0 For example, if MinPower is 1, MaxPower is 10, and PowerSetting can be set to any integer between MinPower and MaxPower, PowerStep would be set to 1.

PropertyValue
Typeuint8
ConformancePWRLMTS
AccessR (read: view)
Constraintdesc

Example:

{
  "1/95/5": 1
}

Attribute 6 / 0x0006 — SupportedWatts

Path example:

1/95/6

Indicates the list of power levels (in W) supported by the server.

PropertyValue
Typelist of uint16
ConformanceP, WATTS
AccessR (read: view)
Constraint1 to 10 entries

Example:

{
  "1/95/6": []
}

Attribute 7 / 0x0007 — SelectedWattIndex

Path example:

1/95/7

Indicates the index into the list of SupportedWatts of the currently selected power setting. The index is a valid index into the SupportedWatts list.

PropertyValue
Typeuint8
ConformanceP, WATTS
AccessR (read: view)
Constraintdesc

Example:

{
  "1/95/7": 1
}

Attribute 8 / 0x0008 — WattRating

Path example:

1/95/8

Indicates the rating, in Watts, of the microwave power of the oven. Supporting this attribute can assist clients in suggesting cooking settings for various foods and beverages.

PropertyValue
Typeuint16
ConformanceO
AccessR (read: view)
DefaultMS

Example:

{
  "1/95/8": 1
}

Cluster 95 Commands

Cluster 95 has 2 client-to-server commands and 0 responses.

IDHexCommandDirectionConformanceResponseDescription
00x00SetCookingParametersclient → serverMstatusThis command is used to set the cooking parameters associated with the operation of the device.
10x01AddMoreTimeclient → serverOstatusThis command is used to add more time to the CookTime attribute of the server.

AcceptedCommandList

The AcceptedCommandList attribute lists the command IDs the endpoint actually implements:

endpoint_id / 95 / 65529
{
  "1/95/65529": [
    0,
    1
  ]
}

Before sending a Cluster 95 command, check that the command ID exists in endpoint/95/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": 95,
    "command_name": "SetCookingParameters",
    "payload": {},
    "timed_request_timeout_ms": 1000
  }
}

For Cluster 95, always use "cluster_id": 95. 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: SetCookingParameters

Purpose

This command is used to set the cooking parameters associated with the operation of the device. This command supports the following fields:

Command Identity

FieldValue
Command ID0
Command hex0x00
Command nameSetCookingParameters
Directionclient → server
ConformanceM
Responsestatus
Access(invoke: operate)

Payload Fields

IDFieldPayload keyTypeConformanceConstraintMeaning
0CookModecookModeuint8OdescIndicates the value to which the CurrentMode attribute of the Microwave Oven Mode cluster should be set. The value of this field is one from the list of SupportedModes from the Microwave Oven Mode cluster.
1CookTimecookTimeelapsed-sO1 to MaxCookTimeIndicates the CookTime associated with the operation of the device. The value of this field is subject to the constraints of the CookTime attribute of this cluster.
2PowerSettingpowerSettinguint8[PWRNUM]MinPower to MaxPowerIndicates the PowerSetting associated with the operation of the device. The value of this field is subject to the constraints of the PowerSetting attribute of this cluster.
3WattSettingIndexwattSettingIndexuint8[WATTS]descIndicates the value to which the SelectedWattIndex attribute is set.
4StartAfterSettingstartAfterSettingboolO—Indicates whether or not oven operation is started when the command is received.

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 95,
    "command_name": "SetCookingParameters",
    "payload": {
      "cookMode": 1,
      "cookTime": 0
    }
  }
}

Command: AddMoreTime

Purpose

This command is used to add more time to the CookTime attribute of the server. This command supports these fields:

Command Identity

FieldValue
Command ID1
Command hex0x01
Command nameAddMoreTime
Directionclient → server
ConformanceO
Responsestatus
Access(invoke: operate)

Payload Fields

IDFieldPayload keyTypeConformanceConstraintMeaning
0TimeToAddtimeToAddelapsed-sM1 to MaxCookTimeIndicates the number of seconds to be added to the CookTime attribute.

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 95,
    "command_name": "AddMoreTime",
    "payload": {
      "timeToAdd": 0
    }
  }
}

Cluster 95 Events

Cluster 95 defines no events.


SmartphoneKey Notes

  • Cluster 95 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/95/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.