{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/cgstever/zafro-ha-local/blob/400d22ec1586bacf2192816149ea4c1fc3836eea/docs/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "zafro-ha-local replaces the cloud endpoint used by a Zafro A9092R air conditioner with a LAN server. Its protocol notes derive the device's REST login, MQTT 3.1 WebSocket messages, topics and state commands from captured traffic. The Python service handles the device connection and publishes Home Assistant entities through MQTT Discovery.",
  "description_zh": "zafro-ha-local 用局域网服务器替代 Zafro A9092R 空调使用的云端点。协议笔记根据抓取的设备流量记录 REST 登录、MQTT 3.1 WebSocket 消息、主题及状态命令；Python 服务处理设备连接，并通过 MQTT Discovery 向 Home Assistant 发布实体。",
  "entry_url": "https://awesomerea.org/resources/zafro-ha-local-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/zafro-ha-local-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/cgstever/zafro-ha-local/blob/400d22ec1586bacf2192816149ea4c1fc3836eea/README.md",
  "group": "cases",
  "id": "zafro-ha-local-case",
  "json_url": "https://awesomerea.org/resources/zafro-ha-local-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/zafro-ha-local-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/zafro-ha-local-case/index.md",
  "name": "Zafro AC: replacing the I4season device cloud locally",
  "name_zh": "Zafro AC：本地替代 I4season 设备云服务",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "testing",
    "prerequisites",
    "scope",
    "license"
  ],
  "requirements": [
    "The author tested a Zafro A9092R-12K with firmware 1.0.28; other I4season models are unconfirmed.",
    "Requires an always-on Linux host, Home Assistant with MQTT, a broker, nginx, Python 3.9+ and local DNS override capability.",
    "The AC uses legacy TLS 1.2 RSA ciphers and sends no SNI, which the supplied nginx configuration accommodates.",
    "MIT license."
  ],
  "requirements_zh": [
    "作者测试的设备为固件 1.0.28 的 Zafro A9092R-12K；其他 I4season 型号尚未确认。",
    "需要常开的 Linux 主机、启用 MQTT 的 Home Assistant、消息代理、nginx、Python 3.9 或更新版本，以及本地 DNS 覆盖能力。",
    "空调使用旧式 TLS 1.2 RSA 密码套件且不发送 SNI，仓库提供的 nginx 配置对此作了适配。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/cgstever/zafro-ha-local",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}