Skip to content

v1.2.0 - DC fan support (configurable speed count)

Choose a tag to compare

@sumgup0 sumgup0 released this 25 Apr 02:07

What's new

Dynamic speed count for DC fans (#1, thanks @JesusSanchezLopez)
The integration now adapts to fans with more than 3 speeds. Set "Number of fan speeds" under Settings -> Devices & Services -> Fanimation -> ⋮ -> Configure to match your hardware (e.g. 32 for the Odyn 84" with TR305 remote, 6 for smaller DC fans). The fan UI becomes a percentage slider, and the low / medium / high presets scale with the configured count - so on a 32-speed fan, "high" maps to speed 32 rather than speed 3.

Bug fixes

  • Fixed ValueError: The item "5" is not in "[1, 2, 3]" raised when an RF remote set a DC fan above speed 3 with the integration still configured for 3 speeds. (#1)
  • Fixed a stuck-off loop with default_speed = "Last Used" and a misconfigured speed count: the entity cached the requested speed before sending the BLE write, so when the BTCR9 firmware silently rejected an out-of-range speed byte (turning the fan off with no error), "Last Used" turn-on would resend the bad value forever. _last_speed now syncs from the verified GET_STATUS response.

Tested on

  • 3-speed AC fans (BTCR9 controller) on HA Yellow running HA 2026.2.3
  • 4 AC + DC fans including the Odyn 84" (TR305 FanSync remote), community-tested by @JesusSanchezLopez

Credits

Bug report, original PR, and real-DC-hardware verification by @JesusSanchezLopez. Thank you.