Skip to content

v1.3.0 — Reverse direction for DC fans

Latest

Choose a tag to compare

@sumgup0 sumgup0 released this 15 Jun 18:18

What's new

Forward/reverse direction control for DC fans (#4, thanks @markjandejong)

The fan entity now exposes a direction (forward/reverse) control on fans that actually support electronic reverse. The integration auto-detects reverse-capable DC motors — via the fan_type byte the fan reports — and shows the control by default. Direction changes apply instantly, whether the fan is stopped or spinning. A per-fan Change direction option (Settings → Devices → Configure) lets you override the auto-detection either way.

AC fans are unaffected: capacitor-switched AC motors reverse via a physical switch on the motor housing, not over Bluetooth, so the control stays hidden unless you enable it manually.

Upgrade notes

No action required — backward compatible. If your fan isn't auto-detected, enable Change direction in the integration's options.

  • AC fans: no change; the direction control stays hidden.
  • DC fans: a forward/reverse control appears automatically.

Tested on

  • DC motor fan with electronic reverse — blades physically reverse (instantly, whether stopped or spinning) and the direction reads back reliably; confirmed on real hardware by @markjandejong (#4) - thank you!
  • 3-speed AC fan (BTCR9 + BTT9) — direction correctly stays hidden (no electronic reverse)

Also in this release

  • README overhaul — clearer Bluetooth-only scope so Fanimation FanSync WiFi fans aren't mistaken for supported, a "which receiver do I have?" self-test, reorganized around the install decision, and a dedicated tools/README.md for the diagnostic scripts.