微波炉模式 Cluster（MicrowaveOvenMode）

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

MicrowaveOvenMode 是 Matter 中用于微波炉模式选择的 Cluster，派生自 ModeBase Cluster。 它允许用户在微波炉支持的多种加热模式之间切换，例如常规加热和解冻。 每种模式通过语义标签（ModeTag）描述其用途，使不同厂商的微波炉能以统一方式被控制。

命令（Commands）

旧版本的 MicrowaveOvenMode Cluster 有一个命令 ChangeToMode，用于切换加热模式， 命令执行后设备返回 ChangeToModeResponse，告知切换是否成功。新版本已移除这两个命令，模式只能在微波炉本机上切换。

ChangeToMode -- 切换模式（0x00） 新版已移除

请求微波炉切换到指定的加热模式。NewMode 的值必须是 SupportedModes 列表中某个 ModeOptionStruct 的 Mode 字段。 设备收到后返回 ChangeToModeResponse。

请求参数

响应字段（ChangeToModeResponse）

↑ 返回命令列表

属性详解

MicrowaveOvenMode Cluster 继承 ModeBase 的 4 个属性。

SupportedModes -- 支持的模式列表（0x0000）

设备支持的全部加热模式，每个元素是一个 ModeOptionStruct：

↑ 返回属性列表

CurrentMode -- 当前模式（0x0001）

当前选中的加热模式编号。值必须是 SupportedModes 中某个 ModeOptionStruct 的 Mode 字段。 通过 ChangeToMode 命令修改。可订阅此属性获取模式变更通知。

↑ 返回属性列表

StartUpMode -- 启动模式（0x0002） 新版已移除

设备上电或重启后的初始模式。Nullable -- 值为 null 时表示保持上次断电前的模式。 设置具体值时，该值必须存在于 SupportedModes 列表中。

↑ 返回属性列表

OnMode -- 开机模式（0x0003） 新版已移除

当设备从 Off 切换到 On 时自动应用的模式。Nullable -- 值为 null 时不覆盖，保持 CurrentMode 不变。 如果 OnMode 有值，每次开机都会将 CurrentMode 强制设为该值，忽略 StartUpMode 的设置。

↑ 返回属性列表

ModeTag 语义标签

MicrowaveOvenMode 定义了 2 个专属 ModeTag 值，用于标准化描述微波炉加热模式的类型。 App 应根据这些标签识别模式用途，而不是依赖厂商自定义的 Label 文字。

状态码（StatusCode）

ChangeToModeResponse 中 Status 字段的可能取值：

示例数据

一台支持常规加热和解冻两种模式、当前处于常规加热的微波炉的 MicrowaveOvenMode Cluster 读取结果：

{
  // --- 支持的模式列表 ---
  "0x0000": [                    // SupportedModes
    {
      "Label": "Normal",
      "Mode": 0,
      "ModeTags": [{ "Value": 16384 }]   // 0x4000 = Normal
    },
    {
      "Label": "Defrost",
      "Mode": 1,
      "ModeTags": [{ "Value": 16385 }]   // 0x4001 = Defrost
    }
  ],

  // --- 当前模式 ---
  "0x0001": 0                    // CurrentMode = 0（Normal）

  // --- 启动与开机模式 ---
}

常见场景