冰箱模式 Cluster（RefrigeratorAndTemperatureControlledCabinetMode）

Cluster ID: 0x0052  |  所在 Endpoint: 冷藏室 / 冷冻室功能端点（可能有多个）

RefrigeratorAndTemperatureControlledCabinetMode 是 Matter 中用于冰箱模式控制的 Cluster，派生自 ModeBase Cluster。 它允许用户切换冰箱各温区的工作模式，例如启用急速制冷（RapidCool）或急速冷冻（RapidFreeze）。 每种模式通过语义标签（ModeTag）描述其用途，使不同厂商的冰箱能以统一方式被控制。

命令（Commands）

RefrigeratorAndTemperatureControlledCabinetMode Cluster 只有一个命令 ChangeToMode，用于切换冰箱模式。 命令执行后设备返回 ChangeToModeResponse，告知切换是否成功。

ChangeToMode -- 切换模式（0x00）

请求设备切换到指定的冰箱模式。NewMode 的值必须是 SupportedModes 列表中某个 ModeOptionStruct 的 Mode 字段。 设备收到后返回 ChangeToModeResponse。注意需要向正确的 Endpoint 发送命令 -- 冷藏室和冷冻室是独立的。

请求参数

响应字段（ChangeToModeResponse）

↑ 返回命令列表

属性详解

RefrigeratorAndTemperatureControlledCabinetMode Cluster 继承 ModeBase 的 4 个属性。每个 Endpoint 各自维护一份。

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

该 Endpoint（温区）支持的全部工作模式，每个元素是一个 ModeOptionStruct：

↑ 返回属性列表

CurrentMode -- 当前模式（0x0001）

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

↑ 返回属性列表

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

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

↑ 返回属性列表

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

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

↑ 返回属性列表

ModeTag 语义标签

RefrigeratorAndTemperatureControlledCabinetMode 定义了 2 个专属 ModeTag 值，用于标准化描述冰箱工作模式。 App 应根据这些标签识别模式用途，而不是依赖厂商自定义的 Label 文字。

状态码（StatusCode）

ChangeToModeResponse 中 Status 字段的可能取值：

Feature 位图

RefrigeratorAndTemperatureControlledCabinetMode Cluster 通过 FeatureMap（0xFFFC）声明设备支持的特性：

示例数据

一台双温区冰箱的两个 Endpoint 分别读取到的 Cluster 数据：

冷藏室 Endpoint

{
  // --- 冷藏室 Endpoint 的模式列表 ---
  "0x0000": [                    // SupportedModes
    {
      "Label": "Normal",
      "Mode": 0,
      "ModeTags": []              // 普通模式，无特殊标签
    },
    {
      "Label": "Rapid Cool",
      "Mode": 1,
      "ModeTags": [{ "Value": 16384 }]   // 0x4000 = RapidCool
    }
  ],

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

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

冷冻室 Endpoint

{
  // --- 冷冻室 Endpoint 的模式列表 ---
  "0x0000": [                    // SupportedModes
    {
      "Label": "Normal",
      "Mode": 0,
      "ModeTags": []
    },
    {
      "Label": "Rapid Freeze",
      "Mode": 1,
      "ModeTags": [{ "Value": 16385 }]   // 0x4001 = RapidFreeze
    }
  ],

  // --- 当前模式 ---
  "0x0001": 1                    // CurrentMode = 1（Rapid Freeze 急冻中）

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

常见场景

场景 1：大量食材入库后启用急速制冷

场景 2：多温区独立控制