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.mdfor the diagnostic scripts.