Home Assistant Core中ZHA集成窗帘设备状态误判问题分析

问题背景

在Home Assistant Core 2025.4.x版本中，使用ZHA集成的Zigbee窗帘设备出现了一个状态判断异常问题。具体表现为：当窗帘设备仅支持升降功能而不支持倾斜功能时，系统仍会错误地参考倾斜位置(tilt_position)来判断窗帘状态，导致即使升降位置(position)为0%（完全关闭），系统仍显示窗帘为"打开"状态。

技术原理分析

在Zigbee协议中，窗帘设备(Window Covering)通常通过WindowCovering集群实现控制。该集群支持多种窗帘类型，包括：

1. 仅升降(Rollershade/Lift)
2. 仅倾斜(Tilt)
3. 升降和倾斜组合(Tilt_blind_tilt_and_lift)

在Home Assistant中，设备功能通过supported_features属性声明，其中：

• 15表示支持打开、关闭、停止和设置位置（不支持倾斜）
• 255表示支持所有功能（包括倾斜）

问题根源

问题的核心在于2025.4.x版本对窗帘状态判断逻辑的修改。新版本中，系统会无条件地检查current_tilt_position属性，即使设备明确声明不支持倾斜功能（supported_features=15）。

当设备硬件本身支持倾斜功能（如Vimar Window_Cov_v1.0设备默认报告为Tilt_blind_tilt_and_lift类型），但实际未配置使用时，倾斜位置会保持默认值100%。系统错误地将此值纳入状态判断，导致：

1. 即使current_position=0（完全关闭）
2. 由于current_tilt_position=100
3. 系统综合判断结果为"打开"

影响范围

此问题主要影响以下场景：

1. 使用ZHA集成连接的Zigbee窗帘设备
2. 设备硬件支持倾斜功能但实际未使用
3. 系统版本为2025.4.x
4. 用户通过supported_features=15显式声明不支持倾斜

临时解决方案

目前可用的临时解决方案包括：

1. 回退到2025.3.x版本
2. 创建模板窗帘实体，忽略倾斜属性
3. 开发自定义quirk移除倾斜属性

修复方向

正确的实现应该：

1. 严格遵循supported_features声明
2. 当supported_features不包含倾斜功能时，完全忽略tilt相关属性
3. 仅基于position属性判断升降状态

用户建议

对于遇到此问题的用户，建议：

1. 检查设备的window_covering_type属性
2. 确认supported_features设置是否符合实际功能
3. 关注后续版本更新，等待官方修复
4. 如需立即使用，可考虑2025.3.x版本

该问题预计将在后续版本中修复，届时系统将正确区分仅升降设备和升降/倾斜组合设备的状态判断逻辑。