I put together a native BLE integration for QuietCool attic fans that works directly over Bluetooth with the stock manufacturer firmware, no ESPHome, no cloud, no hardware modification required. Utilizing previous efforts listed in the README.md (Thank you!)
What it does
Auto-discovers any QuietCool controller advertising as ATTICFAN_* and sets
up 10 entities:
- Fan on/off with Low/High speed presets
- Mode selector: Idle / Timer / TH smart mode
- Temperature and humidity sensors (attic)
- Timer remaining countdown
- Smart mode threshold controls (high/medium/low temp, high humidity) fully adjustable from HA, no app needed
- Protect temperature diagnostic sensor
Hardware confirmed
Tested on the AFG SMT PRO-2.0 running firmware IT-BLT-ATTICFAN_V3.0.
All read and write paths verified including threshold persistence across power cycles and HA restarts.
Installation
Via HACS (add as custom repository) or manual copy. Full instructions in the README.
Help wanted: firmware 3.9+
Devices running firmware ≥ 3.9 use an updated BLE protocol (numeric command codes, single char response keys, QQ prefix). Fan control still works, but temperature and humidity sensors are unavailable until the V2 GetWorkState command code is confirmed.
If you have a 3.9+ device and can capture a BLE exchange (nRF Sniffer, Wireshark HCI log, or Android BLE debugging), please open an issue that’s the missing piece to unlock sensors on all newer firmware.
Happy to answer questions or take reports from anyone who tries it.