单位本地化 Cluster（Unit Localization）

Cluster ID: 0x002D  |  所在 Endpoint: Endpoint 0（Root Node）

Unit Localization 用于存储用户的温度单位显示偏好。设备收到这个设置后，在本地屏幕、面板等界面上按用户偏好的单位展示温度。 这是 Matter 中最简单的 Cluster 之一 —— 只有 1 个属性，没有命令，通过 Write 操作直接配置。

Feature Map

Unit Localization 定义了一个 Feature —— TEMP。设备声明支持该 Feature 后，才会暴露 TemperatureUnit 属性。

属性总览

Unit Localization 只有一个属性，依赖 TEMP Feature。

TemperatureUnit（温度显示单位）

用户偏好的温度显示单位。写入该属性后，设备在本地界面（屏幕、面板、LED 等）上按指定单位显示温度值。 这个属性不影响设备通过 Matter 协议上报的温度数据 —— 协议传输的温度始终以 0.01°C 为单位。

TempUnitEnum 枚举值

↑ 返回属性列表

命令（Commands）

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

Write 请求示例（切换到摄氏度）：

{
  "writeRequests": [{
    "attributePath": {
      "endpointId": 0,
      "clusterId": "0x002D",
      "attributeId": "0x00"        // TemperatureUnit
    },
    "attributeValue": 1            // Celsius（摄氏度）
  }]
}

Read 请求示例（查询当前设置）：

{
  "attributeRequests": [{
    "endpointId": 0,
    "clusterId": "0x002D",
    "attributeId": "0x00"          // TemperatureUnit
  }]
}

示例数据

读取一台恒温器设备 Endpoint 0 上的 Unit Localization Cluster 属性：

{
  // --- 属性 ---
  "0x0": 0          // TemperatureUnit = Fahrenheit（华氏度）
}

实际场景

场景一：美国用户 —— 保持华氏度

App 配网完成后读取属性，发现 TemperatureUnit = 0（Fahrenheit），App 界面同步以 °F 显示温度。 用户在 App 和设备面板上看到的单位一致，不需要额外操作。

场景二：公制用户 —— 切换到摄氏度

写入成功后，恒温器面板立即切换显示为 22°C。App 界面也同步以 °C 显示。 注意：设备通过 Matter 协议上报的原始数据（比如 Thermostat Cluster 的 LocalTemperature）始终是 0.01°C 为单位的整数值， 不受 TemperatureUnit 的影响。这个属性只控制设备本地显示和 App 的展示偏好。