小米智能风扇在Home Assistant中实现1-99%精细调速的解决方案

问题背景

在使用hass-xiaomi-miot集成控制dmaker.fan.p18型号的小米智能风扇时，用户发现只能以25%为步进单位（0/25/50/75/100%）调节风速，无法实现1-99%的精细控制。值得注意的是，官方小米Home应用实际上支持1-100%的无级调速，这表明设备本身具备精细调速能力。

技术分析

通过分析设备属性，我们发现几个关键控制参数：

• fan.fan_level：当前风扇档位
• fan.speed_level：风速级别（可能是实现精细控制的关键属性）
• fan.mode：运行模式

设备型号dmaker.fan.p18的MIOT类型为urn:miot-spec-v2:device:fan:0000A005:dmaker-p18:1，属于第二代智能风扇设备。这类设备通常通过speed_level属性实现精细调速。

解决方案

方法一：修改配置文件

在Home Assistant的configuration.yaml中添加以下配置：

xiaomi_miot:
  device_customizes:
    dmaker.fan.p18:
      percentage_property: speed_level
      speed_range: [1, 100]  # 设置调速范围为1-100%

方法二：检查可用属性

如果上述方法无效，可以尝试以下替代属性：

1. prop.2.6 - 部分dmaker风扇使用的调速属性
2. fan_level - 部分型号的基础档位控制
3. speed_level - 最可能实现精细控制的属性

方法三：设备自定义

对于高级用户，可以通过以下步骤实现完全控制：

1. 获取设备完整属性列表
2. 识别正确的调速属性
3. 创建自定义控件覆盖默认行为

实现原理

小米设备通过MIOT协议与Home Assistant通信。默认情况下，集成可能使用简化的控制模式，而实际上设备支持更精细的控制参数。通过明确指定percentage_property，我们可以绕过集成的默认限制，直接使用设备原生支持的控制方式。

验证与调试

实施修改后，建议通过以下方式验证：

1. 检查实体属性是否显示正确的调速范围
2. 观察设备响应是否与设置值一致
3. 查看Home Assistant日志中是否有相关错误信息

注意事项

1. 不同固件版本可能有差异，建议先备份当前配置
2. 调速精度可能受设备实际硬件限制
3. 某些模式（如自然风）可能不支持精细调速

通过以上方法，大多数用户应该能够恢复风扇的精细调速功能，实现在Home Assistant中1-99%的无级风速控制。