QuietCool BLE: Native Bluetooth Integration (fan control, smart mode, temp/humidity)

Share your Projects! Custom Integrations
, ,
1

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!)

GitHub: GitHub - rwarner/ha-quietcool-ble: Native Bluetooth Low Energy Home Assistant integration for QuietCool attic and whole-house fans — stock firmware, no modifications required · GitHub

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.

2

Just in time! I just got one of these and planning on installing over the weekend. I will test it out before its mounted and let you kow if I come across anything, or have a newer firmware installed. Thanks!

3

Excellent yeah lemme know. I spoke with one of the other repo guys and he sent me some newer firmware findings so I might also upgrade my fan to make sure things still work. But definitely lemme know how it goes.

Currently waiting in line to be approved to be on HACS directly

4

It has been working great so far. Did some limited testing both before and after mounting and haven’t had any issues at all.

1 Like
5

My sensors died out after a few days, pushed up a new release which hopefully fixes that without the need to restart HASS

1 Like