Daikin Altherma with ESPAltherma

Get all information from your Daikin Altherma Heat Pump

This app enables you to read information from your ESPAltherma device connected to your Daikin Altherma Heat Pump. You will only be able read information, you will -not- be able to control your heat pump with this app.
Also, this app is -not- ment to be a replacement for the Daikin Onecta app by @Mickel_Luiten


IMPORTANT: One of the prerequisites to use this app is to have an MQTT Broker in your network where the information from your ESPAltherma is available. More information about ESPAltherma can be found here.


IMPORTANT: This is still an early test version of this app.


Supported devices

Support is not limited to the below shown devices, your device may look different.


Daikin Altherma Heat Pump

This device has the following capabilities:

  • Operation Mode
  • Thermostat
  • Space Heating - This is for testing capabilities, may be removed.
  • Outdoor Temperature
  • Leaving Water temperature
  • Returning Water temperature
  • ΔT (flow–return)
  • Target temperature
  • Water flow
  • Power
  • Energy Today
  • Energy this Month
  • Energy this Year
  • Power (at 230V) - This is for testing capabilities, will be removed.
  • COP

Daikin Altherma Water Tank

This device has the following capabilities:

  • DHW tank temperature
  • DHW tank target temperature
  • Powerful mode
  • Power
  • Energy Today
  • Energy this Month
  • Energy this Year

How to use the app

Please make sure to configure the required labels in ESPAltherma, go to the App settings and configure the settings for your MQTT Broker.
Detailed instructions can be found in How To: Configure ESPAltherma and the Daikin Altherma app.

Next, add the Heat Pump and Water Tank devices, this is no different then adding any other device to Homey. Head on over to the devices tab in the Homey app, click the + button, select New Device and select the Daikin Altherma app. Next, select the Heat Pump or Water Heater device and complete the steps to add the device.

Additional information

Power usage, Energy consumption, and Coefficient of Performance (COP) are based on data from an internal current sensor. These values require additional information—such as grid voltage—which isn’t measured by your Daikin Altherma. By default, the app assumes a grid voltage of 230V for these calculations. Because grid voltage fluctuates, you can have the app read the actual voltage from your MQTT broker. Instructions to set this up can be found here:

Additional flow cards

Next to the flow cards that are automatically created for the devices, the app features flow cards to be informed of warnings and errors. You can use the A warning occurred in the app flow card to get informed when for example there is no new MQTT data received for a while or the voltage on your ESPAltherma is low. Any unforeseen app error can be made visible by using the An error occurred in the app

Here’s inspiration how to use the cards

Supported languages

Translations were done using ChatGPT, please inform me of any errors on Github
:uk: English

Currently only English is supported more languages will follow shortly.


Links


If you want to support this app, please consider a donation

image

ko-fi

Donations are very welcome, though they come with no guarantees, warranties, or preferential treatment (just think of it that you’re donating for the work already done, not the work to be done).

1 Like

FAQ

Q. I do have a Daikin Altherma Heat Pump, but have not yet setup ESPAltherma. Can you recommend me what ESP device to buy
A. You’re completely free to buy any ESP device you want, but it’s important to realise it’s impossible for me to test or support all ESP device variants out there.
In can only try to give support when an M5Stick C Plus 2 is used.

Q. I can’t get ESPAltherma working, can you help me?
A. This topic is primarily for supporting the Daikin Altherma App for Homey. One of the prerequisites is a working ESPAltherma publishing its information to an MQTT broker.
Please visit ESPAltherma at Github to get support on installing and configuring ESPAltherma

Q. I think the Power Usage and Energy Consumption aren’t accurate.
A. Yes, that can be. There is only a current sensor in your heat pump which isn’t enough to get actual Power Usage and Energy Consumption so the app calculate these values based on an assumed grid voltage of 230V. In reality the grid voltage will fluctuate. Please see How to: Use actual grid voltage for Power usage, Energy consumption, and Coefficient of Performance (COP) calculations to get more accurate values.

Changelog

Current test version: 0.0.3

  • Improved setting up the MQTT broker connection

Current test version: 0.0.2

  • Heat Pump device available
  • Water Tank available
  • Estimated Power Usage, default based on a set Grid Voltage
  • Estimated Power Usage, based on external Voltages
  • Estimated Coefficient of Performance (COP)
  • Flow card triggered on errors
  • Flow card triggered on warnings

Roadmap

In no particular order, no eta will be given

Add Heat Pump device
Add Water Tank device
Add Power usage and Energy consumption capabilities
Add Coefficient of Performance (COP) capability
Add flow card with a tag to make errors available
Add flow card with a tag to make warnings available
Add Method to read actual voltage(s) from MQTT Broker
Add Method to read actual power usage from Smart Meter
Add additional languages
…

How To: Configure ESPAltherma and the Daikin Altherma app.


This assumes your ESPAltherma and MQTT broker are already setup and functioning. See ESPAltherma Github for more information how to setup that part.


Configuring the required information in the ESPAltherma definition file

The Daikin Altherma app will read the need information from your MQTT broker and requires certain information for the devices capabilities. Please make sure the information of your ESPAltherma is published to the (default) topic espaltherma (case sensitive!)
Next, uncommented at least the following labels in the definition file for your particular Heat Pump:

{0x10,0,217,1,-1,"Operation Mode"},
{0x10,1,307,1,-1,"Thermostat ON/OFF"},
{0x10,1,304,1,-1,"Defrost Operation"},
{0x10,4,203,1,-1,"Error type"},
{0x10,5,204,1,-1,"Error Code"},
{0x20,0,105,2,1,"R1T-Outdoor air temp."},
{0x21,0,105,2,-1,"INV primary current (A)"},
{0x21,2,105,2,-1,"INV secondary current (A)"},
{0x60,2,315,1,-1,"I/U operation mode"},
{0x60,7,105,2,1,"DHW setpoint"},
{0x60,9,105,2,1,"LW setpoint (main)"},
{0x60,12,306,1,-1,"3way valve(On:DHW_Off:Space)"},
{0x60,12,304,1,-1,"BUH Step1"},
{0x60,12,303,1,-1,"BUH Step2"},
{0x61,2,105,2,1,"Leaving water temp. before BUH (R1T)"},
{0x61,4,105,2,1,"Leaving water temp. after BUH (R2T)"},
{0x61,8,105,2,1,"Inlet water temp.(R4T)"},
{0x61,10,105,2,1,"DHW tank temp. (R5T)"},
{0x62,2,304,1,-1,"Powerful DHW Operation. ON/OFF"},
{0x62,2,303,1,-1,"Space heating Operation ON/OFF"},
{0x62,5,105,2,1,"RT setpoint"},
{0x62,7,304,1,-1,"Main RT Heating"},
{0x62,9,105,2,-1,"Flow sensor (l/min)"},
{0x64,3,105,2,-1,"BE_COP"},

(Please note, not all labels are visible as a capability but are required in underlying calculations for example for power and energy usage, some are for future use.)

After uncommenting these labels, please make sure to upload the new version to your ESPAltherma device.

Configuring the Daikin Altherma app in Homey

After configuring your ESPAltherma device, it’s time to set up the Daikin Altherma app. Make sure you have the login details for your MQTT broker handy, then open the Homey app and go to the Daikin Altherma app’s settings.

You can use your MQTT broker’s hostname, as long as Homey can resolve it to the correct IP address. If you’re not sure, use the MQTT broker’s IP address instead.

Next, fill in the logon information and click the Connect button

After successful logon, the MQTT Broker authentication state will look like this:

You can now exit the settings by clicking Done and add your Daikin device(s) to Homey!

How to: Use actual grid voltage for Power usage, Energy consumption, and Coefficient of Performance (COP) calculations

Power usage, Energy consumption, and Coefficient of Performance (COP) are based on data from an internal current sensor. These values require additional information—such as grid voltage—which isn’t measured by your Daikin Altherma. By default, the app assumes a grid voltage of 230V for these calculations.

This post will show you how to configure the Daikin Altherma app to read your actual voltage(s) from your MQTT broker, and how you can send the actual voltage(s) to your MQTT broker in case the information is not yet available on your broker.

Configuring the Daikin Altherma app in Homey

Open the Homey app and go to the Daikin Altherma app’s setting. Now scroll past the MQTT information to reach the Use external voltage setting in the Power calculation section.

Slide the slider to the right to turn the feature on and reveal the MQTT topics for phase voltages

As you can see, the topics will default to espaltherma/grid/voltage1, espaltherma/grid/voltage2 and espaltherma/grid/voltage3. You can choose your own topics if you want, but the must be available in the espaltherma topic.
When you don’t have a 3-phase system, please publish your voltage to 1 topic, but enter it on all 3 lines.
When you’re satisfied with the topics, press Save to store them and Done to leave the app’s settings. The app will immediately start using the values that are published, as long as they are within the 207-253 Volt range.

Sending grid voltages from Homey to your MQTT broker

To publish your grid voltages to your MQTT broker (when they’re available in Homey—for example via the Homey Energy Dongle), you first need an app that can send data to an MQTT broker. If you don’t have one installed yet, go to the Homey App Store and install MQTT Client by @scanno.

After setting that up, create a Flow to send the grid voltage data to your MQTT broker. See the example below for how to do this:

That’s it! Every 30 seconds the voltage information will be written to the MQTT broker and the Daikin Altherma app will use them to do the Power Usage and Energy Consumption calculations.

How To Extra

Reserved for How to article 3

First test version published

You can find the test version here: https://homey.app/nl-nl/app/com.altherma.mqtt/test

Current test version: 0.0.2

  • Heat Pump device available
  • Water Tank available
  • Estimated Power Usage, default based on a set Grid Voltage
  • Estimated Power Usage, based on external Voltages
  • Estimated Coefficient of Performance (COP)
  • Flow card triggered on errors
  • Flow card triggered on warnings

New test version published

You can find the test version here: Daikin Altherma | Homey

Current test version: 0.0.3

  • Improved setting up the MQTT broker connection