Case study

Zafro AC: replacing the I4season device cloud locally

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 3
Last commit: 2026-09-12
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: Requires an always-on Linux host, Home Assistant with MQTT, a broker, nginx, Python 3.9+ and local DNS override capability.
Testing evidence: The author tested a Zafro A9092R-12K with firmware 1.0.28; other I4season models are unconfirmed.
Scope: The AC uses legacy TLS 1.2 RSA ciphers and sends no SNI, which the supplied nginx configuration accommodates.
License: MIT license.

Cite

BibTeX

@misc{zafro-ha-local-case,
  title = {{Zafro AC: replacing the I4season device cloud locally}},
  howpublished = {\url{https://github.com/cgstever/zafro-ha-local}},
  url = {https://github.com/cgstever/zafro-ha-local},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/zafro-ha-local-case/}}
}

Plain text

Zafro AC: replacing the I4season device cloud locally. https://github.com/cgstever/zafro-ha-local (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/zafro-ha-local-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · cgstever/zafro-ha-local · Revision 400d22e
docs/PROTOCOL.md GitHub · cgstever/zafro-ha-local · Revision 400d22e