# esphome-quietcool：重建 QuietCool 风扇射频控制

> esphome-quietcool 重建 QuietCool 风扇专有的 433.92 MHz 2-FSK 无线控制。ESPHome C++ 组件发送兼容原遥控器的命令、接收风扇状态，并向 Home Assistant 提供控制实体；协议依据 SDR 捕获和两份手持遥控器固件分析得出。

- 类型：案例
- 目标：固件 · 协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-08
- 收录于：2026-11-08
- 原始资源：<https://github.com/joyfulhouse/esphome-quietcool>
- 一手来源：<https://github.com/joyfulhouse/esphome-quietcool/blob/7459d425ef5b14e9390c843c589090576133ad4b/docs/firmware-analysis.md>
- 目录页面：<https://awesomerea.org/zh/resources/esphome-quietcool-case/>
- 记录 JSON：<https://awesomerea.org/resources/esphome-quietcool-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/esphome-quietcool-case/index.md)

## 使用条件与局限

- **前提条件：**部署需要兼容的 ESP32 LoRa 开发板、433 MHz 天线、QuietCool 风扇及其原配遥控器，并使用 ESPHome 和 Home Assistant。
- **局限：**维护中的 C++ 配置面向配备 SX1278 的 LilyGO TTGO LoRa32 V2.1；SX1262 V3 路径尚未完成硬件确认。
- **许可：**采用 MIT 许可证。

## 一手来源

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

## 同分区更多条目：固件与硬件

- [QuietCool ESPHome：重建 IT-AF-SMT 的 BLE 控制协议](https://awesomerea.org/zh/resources/quietcool-esphome-native-case/index.md) · 案例
- [ReadyNAS RN426：在 TrueNAS 下重建前面板控制](https://awesomerea.org/zh/resources/truenas-rn426-panel-case/index.md) · 案例
- [Dahua IP 摄像机：梳理设备 JSON-RPC API](https://awesomerea.org/zh/resources/dahua-rpc-api-case/index.md) · 案例
- [GNR-SMU：解析 Ryzen SMU 遥测与控制字段](https://awesomerea.org/zh/resources/gnr-smu-case/index.md) · 案例
- [SACD daemon reconstruction：重建 Sony BDP-BX510 的 sacd_extract_160](https://awesomerea.org/zh/resources/sacd-daemon-reconstruction-case/index.md) · 案例
- [Holy Stone H120D：重建无人机 Wi-Fi 控制与视频通信](https://awesomerea.org/zh/resources/h120d-protocol-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。