温控器界面配置 Cluster（Thermostat User Interface Configuration）

Cluster ID: 0x0204  |  所在 Endpoint: 与 Thermostat（0x0201）同一 Endpoint，通常在 Endpoint 1

ThermostatUserInterfaceConfiguration 用于配置温控器物理面板的显示和操作行为 —— 面板上温度用摄氏还是华氏显示、按键是否锁定、日程编排功能是否可见。 这是一个纯配置型 Cluster，只有 3 个属性、没有命令，全部通过 Write 操作完成配置。

属性详解

ThermostatUserInterfaceConfiguration 共有 3 个属性，全部可读写。 点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

TemperatureDisplayMode（温度显示模式）

控制温控器物理面板上温度的显示单位。写入后，面板上的温度数字会立即按新单位显示。 这个属性不影响 Thermostat Cluster 通过 Matter 协议上报的温度值 —— 协议传输的温度始终以 0.01°C 为单位。

TemperatureDisplayModeEnum 枚举值

↑ 返回属性列表

KeypadLockout（按键锁定）

控制温控器面板上的按键锁定级别。锁定后，用户无法通过物理按键修改特定的设置项， 只能通过 Matter 协议（App / 自动化）远程修改。这在商业和公共场所非常有用 —— 防止人为随意调温。

KeypadLockoutEnum 枚举值

↑ 返回属性列表

ScheduleProgrammingVisibility（日程编排可见性）

控制温控器面板上是否显示日程编排（Schedule Programming）功能入口。 隐藏后，用户在面板上看不到日程相关的菜单或按钮，只能通过 App 管理日程。

ScheduleProgrammingVisibilityEnum 枚举值

↑ 返回属性列表

命令（Commands）

ThermostatUserInterfaceConfiguration 没有定义任何命令。 所有配置通过直接 Write 属性完成。这在 Matter 中是常见的模式 —— 对于纯配置类的 Cluster，直接读写属性比定义专用命令更简洁。

Write 请求示例 —— 切换到华氏度显示：

{
  "writeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x0204",
      "attributeId": "0x00"           // TemperatureDisplayMode
    },
    "attributeValue": 1               // Fahrenheit（华氏度）
  }]
}

Write 请求示例 —— 设置按键一级锁定：

{
  "writeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x0204",
      "attributeId": "0x01"           // KeypadLockout
    },
    "attributeValue": 1               // LockoutLevel1（锁定一级）
  }]
}

示例数据

读取一台温控器 Endpoint 1 上的 ThermostatUserInterfaceConfiguration 属性：

{
  // --- 显示配置 ---
  "0x00": 0,             // TemperatureDisplayMode = Celsius（摄氏度显示）
  "0x01": 0,             // KeypadLockout = NoLockout（按键无锁定）
  "0x02": 0              // ScheduleProgrammingVisibility = ScheduleProgrammingPermitted（日程可见）
}

实际场景

场景一：酒店客房温控器 —— 锁定面板防止乱调

场景二：出口到不同地区 —— 配网时自动设置显示单位