Effe ECC Sauna — unofficial local integration (reverse-engineered TCP protocol)

Hi everyone,

I’ve built an unofficial Home Assistant integration for Effe saunas equipped with the ECC WiFi module — the ones controlled by the Effe ECC Android app.

The integration is fully local (no cloud, no account), based on a reverse-engineered TCP binary protocol running on port 8899 (Espressif/ESP32 chip).

Tested on: Effe Sky sauna. Should work on any Effe model compatible with the ECC app.


What it does

  • ON/OFF switch — power the sauna on and off
  • Light switch — control the internal light independently, at any temperature
  • 3 temperature sensors — internal device probe, heating element probe, and the setpoint set via the physical dial

:warning: The temperature sensors reflect device-internal probes, not cabin air temperature. For real cabin temperature I use a Ruuvi Tag inside the sauna. See the README for details.


Installation

Via HACS (custom repository):
https://github.com/pippo0312/effe-sauna-ha

Or manually: copy custom_components/effe_sauna/ into your HA config folder.


Notes

  • No official API — protocol was reverse-engineered from app traffic
  • Features not implemented (not available on my model): mood lighting, chromotherapy, RGB
  • ON/OFF state and light state are tracked locally (optimistic), since the protocol doesn’t expose them directly
  • Provided as-is, no support guaranteed

If you have a different Effe model and find it works (or doesn’t), or if you’ve figured out the protocol bytes for mood/chromo/RGB, feel free to open an issue or PR on GitHub.