MicrowaveOvenControl Cluster

Cluster ID: 0x005F  |  Endpoint: Microwave Oven Endpoint

MicrowaveOvenControl is the core control Cluster for microwave ovens in Matter kitchen appliances, managing cooking time, power level, and wattage settings. It does not handle starting/stopping cooking (handled by the OperationalState Cluster) or mode selection (handled by MicrowaveOvenMode), focusing solely on cooking parameters.

Commands

The MicrowaveOvenControl Cluster has only one command -- SetCookingParameters. It is the sole entry point for setting cooking parameters; all parameters (time, power, wattage) are set through this single command. Note: this command only sets parameters and does not start cooking. Starting the cooking requires calling the OperationalState Cluster's Start command.

SetCookingParameters (0x00)

Sets the microwave cooking parameters. All parameters are optional — only pass the fields that need changing; unspecified parameters retain their current values. Parameters can be set when the device is not running; some devices also allow changes while running (implementation-dependent).

Usage Example: Set by Power Percentage (PWRNUM)

{
  "CookTime": 180,          // Cook for 3 minutes
  "PowerSetting": 70        // Power 70%
}

Usage Example: Set by Wattage Level (WATTS)

{
  "CookTime": 300,          // Cook for 5 minutes
  "WattSettingIndex": 3     // Select the wattage at SupportedWatts[3]
}

↑ Back to Commands

Attributes

MicrowaveOvenControl attributes are organized into three groups: cooking time, power level, and wattage level. The latter two are gated by the PWRNUM and WATTS Features respectively. Click an attribute ID below to jump to its detailed description.

Cooking Time (0x0000, 0x0001)

Cooking time is a basic attribute supported by all microwave ovens; no special Feature is required.

↑ Back to Attributes

Power Level (0x0002-0x0005)

A group of attributes representing power level as a numeric value. These require the PWRNUM feature. Without PWRNUM, PowerSetting still exists but defaults to 100 (full power) and cannot be modified.

↑ Back to Attributes

Wattage Level (0x0006-0x0008)

A group of attributes representing power as actual wattage. These require the WATTS feature. Unlike PWRNUM's percentage approach, WATTS uses a discrete wattage list for user selection.

↑ Back to Attributes

Feature Bitmap

MicrowaveOvenControl Cluster declares supported power control methods through FeatureMap (0xFFFC):

Example Data

Attribute read result from a microwave oven supporting both PWRNUM and WATTS (in practice, a device only supports one power method; both shown here for completeness):

{
  // --- Cooking Time ---
  "0x0000": 120,            // CookTime = 120 sec (currently set to cook 2 minutes)
  "0x0001": 5400,           // MaxCookTime = 5400 sec (max 90 minutes)

  // --- Power Setting (PWRNUM Feature) ---
  "0x0002": 80,             // PowerSetting = 80 (current power 80%)
  "0x0003": 10,             // MinPower = 10 (minimum 10%)
  "0x0004": 100,            // MaxPower = 100 (maximum 100%)
  "0x0005": 10,             // PowerStep = 10 (step size 10%)

  // --- Wattage Setting (WATTS Feature) ---
  "0x0006": [100, 300, 500, 700, 900, 1100],  // SupportedWatts (supported wattage list)
  "0x0007": 4,              // SelectedWattIndex = 4 → corresponds to 900W
  "0x0008": 900             // WattRating = 900 (current rated wattage)
}

Common Scenarios