SonoffLAN集成中风扇功能常量的弃用与更新方案

问题背景

在Home Assistant 2024.1版本中，用户使用SonoffLAN集成时遇到了关于风扇功能常量的弃用警告。系统日志显示两个关键警告信息：

1. SUPPORT_PRESET_MODE常量已被弃用
2. SUPPORT_SET_SPEED常量已被弃用

这两个警告都提示这些常量将在Home Assistant Core 2025.1版本中完全移除，建议使用新的FanEntityFeature枚举类替代。

技术解析

弃用常量的含义

在早期版本的Home Assistant中，风扇实体使用一系列SUPPORT_*常量来表示设备支持的功能。例如：

• SUPPORT_PRESET_MODE：表示设备支持预设模式
• SUPPORT_SET_SPEED：表示设备支持速度调节

随着Home Assistant的架构演进，这些常量正被更规范的枚举类所替代。新的FanEntityFeature枚举提供了相同的功能表示，但采用了更现代的Python实现方式。

影响范围

此变更主要影响以下设备：

• 通过SonoffLAN集成的智能风扇设备
• 任何支持预设模式或速度调节的风扇类设备

解决方案

对于终端用户

1. 检查集成版本：确保使用的是SonoffLAN集成的最新版本
2. 更新集成：通过HACS(Home Assistant社区商店)更新SonoffLAN集成
3. 重启Home Assistant：更新后必须重启使变更生效

对于开发者

如果开发者基于SonoffLAN进行二次开发，需要修改代码：

# 旧代码
from homeassistant.components.fan import SUPPORT_PRESET_MODE, SUPPORT_SET_SPEED

# 新代码
from homeassistant.components.fan import FanEntityFeature

具体替换方式：

• SUPPORT_PRESET_MODE → FanEntityFeature.PRESET_MODE
• SUPPORT_SET_SPEED → FanEntityFeature.SET_SPEED

注意事项

1. 此变更不会立即导致功能失效，但会在2025.1版本中完全移除旧常量
2. 更新后建议检查所有风扇设备的功能是否正常
3. 如果更新后问题仍然存在，可能需要检查设备固件版本

总结

Home Assistant正在逐步规范化其代码结构，这类弃用警告是框架演进过程中的正常现象。对于SonoffLAN用户而言，及时更新集成版本是解决此类问题的最佳方案。开发者社区已经针对这些变更进行了适配，用户只需保持集成更新即可平稳过渡。