ESPALTHERMA
Indoor unit Outdoor unit Compressor Heat exchanger Backup heater Add pump Main pump R7TMixed water 3-way valve Hot water Living room Direct zone Mixed zone 15°35°55° Water temperature
Swipe the drawing sideways to see the tank and the house →
Right now
Compressor
rps
Water circuit
l/min
Water pressure
bar
Health
All readings

Setup

  1. 1Wi-Fi
  2. 2Home Assistant
  3. 3Heat pump
  4. 4Done
Step 1 · Wi-Fi

Connect to your Wi-Fi

Step 2 · Home Assistant

Connect to Home Assistant

ESPAltherma sends its values to Home Assistant through an MQTT broker, usually the Mosquitto add-on. Home Assistant then creates the sensors automatically.

Tip: in Home Assistant, create a dedicated user for ESPAltherma (Settings → People) and use it here.

No Home Assistant? Use ESPAltherma on its own: the readings stay on this page, nothing is sent anywhere, and a broker can be connected here later.

Step 3 · Your heat pump
Not this one? Choose my model from the list
Step 4 · Done

All set!

The sensors appear in Home Assistant under “Daikin Altherma via ESPAltherma”. You can add or remove readings any time in the Values tab.

Values

Settings

Heat pump connection

When field setting [C-08] is "outdoor sensor" or "room sensor", the unit follows the external sensor: choose it here to show it, with the auxiliary sensor (R6T) among the selected values. Only this page changes: both readings stay in the values and in Home Assistant.

Relays

Optional: a thermostat input, the safety stop, Smart Grid. -1 = not used.

MQTT output

For other home automation systems; Home Assistant needs nothing here.

Two ESPAltherma on one broker, for instance one on the indoor unit and one on the outdoor unit, need different base topics, such as espaltherma-idu and espaltherma-odu: every topic and every Home Assistant entity then starts with it.

Energy and cycles

Computed on the board from the values it reads: the heat delivered (flow and water temperatures), the electricity drawn (inverter current and the mains voltage) and their ratio, the day's figures per mode and the compressor cycles. Shown on the home page and sent to Home Assistant.

The electricity is an estimate: the inverter current, which the unit reports, times the phase voltage (times 3 on three phases); units that report their voltage use it. The pump and the electronics are added while the compressor runs, 100 W unless a meter on your unit says otherwise, and the backup heater's kW while a step is on (3 kW steps on most kits, 3 and 6 kW on the 9 kW one; 0 for a step your unit has not).

The power factor turns the inverter's volt-amperes into watts. 1 by default, which reads high at low compressor speed: with a meter on the unit, set the value that matches it, 0.6 to 0.9 on most units. The pump and the backup heater are not affected.

Experimental

Under test: may not work on every unit.

ESPAltherma writes the target into the weather-dependent curve of the unit: the hot water curve, or the leaving water curve of the main zone. The corresponding setpoint mode must be set to weather dependent on the unit's interface, and the hydro board software must be a supported one (the versions are listed in the README). The interface may show its old curve until it restarts.

By default, a target is also saved in the unit's memory, 30 s after it was set and at most every 5 minutes, so that it survives a restart. For a target that changes often (an automation following the price or the solar surplus), keep it in the working memory only: the memory is never written and keeps the unit's own curve, a restart of the heat pump brings that curve back and ESPAltherma writes the target again within 2 minutes. Restoring the unit's curve ends it. For the leaving water it also opens the range up to the unit's own maximum ([9-00]) instead of the 45 °C the interface allows for the mild point of the curve.

The power limit caps what the heat pump may draw, in kW or in A as the unit is set, through the installer's power limitation settings, held in the unit's working memory only: a restart of the heat pump brings its own settings back and ESPAltherma applies the limit again. Under the compressor's minimum the unit stops it instead.

This device

The language also names the Home Assistant sensors (in English when automatic).

With an admin password, changing the settings or the firmware asks for the user name "admin" and this password.

Diagnostics

Definition corrections

Some definitions do not match every unit: a value is then read across two neighbours and shows absurd, jumping numbers. ESPAltherma checks the replies and reads such a registry with the layout of the definition that fits.

Event history

Restarts and their causes, network and MQTT changes, supply drops, firmware updates. Kept across restarts; after a power cut, the last two minutes may be missing.

Heat pump survey

Every registry of the heat pump, read once, with its identification codes and the detection result.

Memory read

Reads bytes of the hydro board's memory, for the people mapping a unit: nothing is written. Paste the result in the issue that asked for it.


  

A whole range at once, as a file to attach to the issue: a few hundred frames, a minute or two. 16 KB at most, 0x3000-0x5FFF holds the settings and the counters of most softwares, 0x0800-0x0FFF the meters.

Log

System

Firmware update

Check for a newer release: this browser downloads it from the ESPAltherma site and sends it to the board. Or select the OTA firmware file (.bin) of your board, from the releases on GitHub

Configuration

Backups do not contain passwords.

Restart

A restart releases the relays for a few seconds.