Note
The QuietCool Smart Attic Fan Control works with both whole house fans and attic fans. In my application, I used it for a whole house fan. This project requires having a Smart Attic Fan Control, which can be purchased separately from QuietCool and is a drop-in replacement for the RF controller.
This repository contains ESPHome configurations for controlling QuietCool whole house fans and attic fans. QuietCool fans can be automated and integrated into your smart home using ESP32 devices flashed with these configurations.
The project provides a web-based installation interface using ESP Web Tools, making it easy to flash your ESP device directly from your browser.
This configuration file provides smart control for QuietCool attic fans. Features include:
- Temperature-based automatic control
- Manual speed control (Low/High)
- Integration with Home Assistant
- Real-time temperature and humidity monitoring
- Automatic shutdown when attic temperature reaches desired level
- Web-based control interface
- Pair your phone with the Smart Attic Fan Control.
- Retrieve the MAC address of your controller from the QuietCool app.
- Flash an ESP32 using this template. See Packages for details on how to use this repository in your ESPHome configuration. The gist is that you can simply add the following YAML to your configuration:
substitutions:
mac_address: "00:00:00:00:00:00" # Replace with your Smart Attic Fan Control's MAC address
packages:
remote_package_shorthand: github://awkaplan/quietcool-esphome/quietcool-smart-attic-fan-control.yaml@main- Add the ESPHome device to Home Assistant and update the pairing ID with a unique, 16-digit hex string.
- Use the QuietCool app to put the controller in pairing mode.
- Press the ESPHome device's pair button in Home Assistant.
- Forget the bluetooth device on your phone (optional).
This project builds upon the research and development done by @emerose, who created a Python-based BLE client for the QuietCool Wireless RF Control Kit. Their work was instrumental in understanding the QuietCool BLE protocol and making this ESPHome integration possible.
Contributions are welcome! Please feel free to submit a Pull Request.