{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/CrazyCoder/quietcool-esphome-native/blob/01cdda32003022b47b4bd7d65cb057ea0ed37417/README.md",
    "https://github.com/CrazyCoder/quietcool-esphome-native/blob/01cdda32003022b47b4bd7d65cb057ea0ed37417/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "QuietCool ESPHome replaces firmware on the IT-AF-SMT attic-fan controller and reimplements its stock BLE interface so the vendor app can still control the hub. Its protocol reference draws on analysis of the OEM firmware, Android app, and live BLE captures, while the new firmware adds Wi-Fi and Home Assistant control.",
  "description_zh": "QuietCool ESPHome 为 IT-AF-SMT 阁楼风扇控制器提供替代固件，并重建原厂 BLE 接口，使厂商应用仍可控制设备。协议文档依据原厂固件、Android 应用及实时 BLE 抓包分析；新固件另提供 Wi-Fi 和 Home Assistant 控制。",
  "entry_url": "https://awesomerea.org/resources/quietcool-esphome-native-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/quietcool-esphome-native-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/CrazyCoder/quietcool-esphome-native/blob/01cdda32003022b47b4bd7d65cb057ea0ed37417/docs/OEM-BLE-PROTOCOL.md",
  "group": "cases",
  "id": "quietcool-esphome-native-case",
  "json_url": "https://awesomerea.org/resources/quietcool-esphome-native-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/quietcool-esphome-native-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/quietcool-esphome-native-case/index.md",
  "name": "QuietCool ESPHome: reconstructing IT-AF-SMT BLE control",
  "name_zh": "QuietCool ESPHome：重建 IT-AF-SMT 的 BLE 控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "A QuietCool IT-AF-SMT Smart Attic Fan Control hub.",
    "Historical analytics charts and AirControl Venting Assist are unimplemented; the browser installer does not support iOS or iPadOS.",
    "GPL-3.0 License."
  ],
  "requirements_zh": [
    "需要 QuietCool IT-AF-SMT Smart Attic Fan Control 控制器。",
    "未实现历史统计图表和 AirControl Venting Assist；浏览器安装器不支持 iOS 或 iPadOS。",
    "采用 GPL-3.0 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "firmware",
    "protocol"
  ],
  "url": "https://github.com/CrazyCoder/quietcool-esphome-native",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}