# esphome-quietcool: reconstructing QuietCool fan radio control

> esphome-quietcool reconstructs QuietCool fan control over a proprietary 433.92 MHz 2-FSK radio link. Its ESPHome C++ component sends OEM-compatible commands, receives fan status and exposes controls through Home Assistant; the protocol work draws on SDR captures and analysis of two handheld remote firmware dumps.

- Type: Case study
- Targets: Firmware · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/joyfulhouse/esphome-quietcool>
- Primary source: <https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/docs/firmware-analysis.md>
- Catalog page: <https://awesomerea.org/resources/esphome-quietcool-case/>
- Record JSON: <https://awesomerea.org/resources/esphome-quietcool-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/esphome-quietcool-case/index.md)

## Requirements & limits

- **Prerequisites:** A supported ESP32 LoRa board, 433 MHz antenna, QuietCool fan, its working OEM remote, ESPHome and Home Assistant are required for deployment.
- **Limits:** The maintained C++ configuration targets LilyGO TTGO LoRa32 V2.1 with SX1278; the SX1262 V3 path has not been confirmed on hardware.
- **License:** MIT License.

## Primary sources

1. <https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/docs/firmware-analysis.md>
2. <https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/README.md>

## More in Firmware and hardware

- [QuietCool ESPHome: reconstructing IT-AF-SMT BLE control](https://awesomerea.org/resources/quietcool-esphome-native-case/index.md) · Case study
- [ReadyNAS RN426: reconstructing front-panel control under TrueNAS](https://awesomerea.org/resources/truenas-rn426-panel-case/index.md) · Case study
- [Dahua IP cameras: mapping the device JSON-RPC API](https://awesomerea.org/resources/dahua-rpc-api-case/index.md) · Case study
- [GNR-SMU: mapping Ryzen SMU telemetry and controls](https://awesomerea.org/resources/gnr-smu-case/index.md) · Case study
- [SACD daemon reconstruction: rebuilding Sony BDP-BX510 sacd_extract_160](https://awesomerea.org/resources/sacd-daemon-reconstruction-case/index.md) · Case study
- [Holy Stone H120D: reconstructing drone Wi-Fi control and video traffic](https://awesomerea.org/resources/h120d-protocol-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.