Today
Hot water target
Leaving water target
The shift set on the unit's interface or in the Daikin app adds to this target: with a +10 K shift, 35 °C here makes 45 °C at the floor or the radiators. Check the effective target above after a change.
Power limit
All readings
Setup
- 1Wi-Fi
- 2Home Assistant
- 3Heat pump
- 4Done
Connect to your Wi-Fi
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.
Not this one? Choose my model from the list
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
MQTT values exceeded the payload buffer. Select fewer readings or use one topic per value in Settings.
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.
With an admin password the page does not set the offset on its own, which would ask for the password: set it here, and again when the clocks change.
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.