微波炉控制 Cluster（MicrowaveOvenControl）

Cluster ID: 0x005F  |  所在 Endpoint: 微波炉功能端点（Microwave Oven Endpoint）

MicrowaveOvenControl 是 Matter 厨电设备中微波炉的核心控制 Cluster，负责管理烹饪时间、功率等级和瓦数设定。 它不负责启动/停止烹饪（由 OperationalState Cluster 处理），也不负责模式选择（由 MicrowaveOvenMode Cluster 处理）， 专注于「烹饪参数」这一件事。

命令（Commands）

MicrowaveOvenControl Cluster 只有一个命令 —— SetCookingParameters。 它是设置烹饪参数的唯一入口，所有参数（时间、功率、瓦数）都通过这一个命令设置。 注意：这个命令只设置参数，不会启动烹饪。启动烹饪需要调用 OperationalState Cluster 的 Start 命令。

SetCookingParameters —— 设置烹饪参数（0x00）

设置微波炉的烹饪参数。所有参数都是可选的 —— 只传需要修改的字段即可，未传的参数保持当前值不变。 设备处于非运行状态时可以设置参数；某些设备也允许在运行中修改（取决于具体实现）。

使用示例：按功率百分比设置（PWRNUM）

{
  "CookTime": 180,          // 烹饪 3 分钟
  "PowerSetting": 70        // 功率 70%
}

使用示例：按瓦数等级设置（WATTS）

{
  "CookTime": 300,          // 烹饪 5 分钟
  "WattSettingIndex": 3     // 选择 SupportedWatts[3] 对应的瓦数
}

↑ 返回命令列表

属性详解

MicrowaveOvenControl 的属性按功能分为三组：烹饪时间、功率数值、瓦数等级。 后两组分别由 PWRNUM 和 WATTS Feature 门控。 点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

烹饪时间（0x0000, 0x0001）

烹饪时间是所有微波炉都支持的基础属性，不需要特殊 Feature 门控。

↑ 返回属性列表

功率数值（0x0002 ~ 0x0005）

用数值表示功率等级的一组属性。这组属性需要 PWRNUM 特性支持。 无 PWRNUM 特性时，PowerSetting 仍然存在但默认值固定为 100（满功率），不可修改。

↑ 返回属性列表

瓦数等级（0x0006 ~ 0x0008）

用实际瓦数表示功率的一组属性。这组属性需要 WATTS 特性支持。 与 PWRNUM 的百分比方式不同，WATTS 用离散的瓦数列表让用户选择。

↑ 返回属性列表

Feature 位图

MicrowaveOvenControl Cluster 通过 FeatureMap（0xFFFC）声明设备支持哪些功率控制方式：

示例数据

一个同时支持 PWRNUM 和 WATTS 特性的微波炉设备的属性读取结果（实际设备只会支持其中一种功率方式，此处为展示完整属性）：

{
  // --- 烹饪时间 ---
  "0x0000": 120,            // CookTime = 120 秒（当前设定烹饪 2 分钟）
  "0x0001": 5400,           // MaxCookTime = 5400 秒（最大可设 90 分钟）

  // --- 功率设置（PWRNUM 特性）---
  "0x0002": 80,             // PowerSetting = 80（当前功率 80%）
  "0x0003": 10,             // MinPower = 10（最低功率 10%）
  "0x0004": 100,            // MaxPower = 100（最高功率 100%）
  "0x0005": 10,             // PowerStep = 10（功率调节步长 10%）

  // --- 瓦数设置（WATTS 特性）---
  "0x0006": [100, 300, 500, 700, 900, 1100],  // SupportedWatts（支持的瓦数列表）
  "0x0007": 4,              // SelectedWattIndex = 4 → 对应 900W
  "0x0008": 900             // WattRating = 900（当前瓦数额定值）
}

常见场景