{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "esphome-quietcool 重建 QuietCool 风扇专有的 433.92 MHz 2-FSK 无线控制。ESPHome C++ 组件发送兼容原遥控器的命令、接收风扇状态，并向 Home Assistant 提供控制实体；协议依据 SDR 捕获和两份手持遥控器固件分析得出。",
  "entry_url": "https://awesomerea.org/resources/esphome-quietcool-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/esphome-quietcool-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/docs/firmware-analysis.md",
  "group": "cases",
  "id": "esphome-quietcool-case",
  "json_url": "https://awesomerea.org/resources/esphome-quietcool-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/esphome-quietcool-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/esphome-quietcool-case/index.md",
  "name": "esphome-quietcool: reconstructing QuietCool fan radio control",
  "name_zh": "esphome-quietcool：重建 QuietCool 风扇射频控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "A supported ESP32 LoRa board, 433 MHz antenna, QuietCool fan, its working OEM remote, ESPHome and Home Assistant are required for deployment.",
    "The maintained C++ configuration targets LilyGO TTGO LoRa32 V2.1 with SX1278; the SX1262 V3 path has not been confirmed on hardware.",
    "MIT License."
  ],
  "requirements_zh": [
    "部署需要兼容的 ESP32 LoRa 开发板、433 MHz 天线、QuietCool 风扇及其原配遥控器，并使用 ESPHome 和 Home Assistant。",
    "维护中的 C++ 配置面向配备 SX1278 的 LilyGO TTGO LoRa32 V2.1；SX1262 V3 路径尚未完成硬件确认。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "firmware",
    "protocol"
  ],
  "url": "https://github.com/joyfulhouse/esphome-quietcool",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}
