IDM heat pump

_Component to integrate with IDM heat pumps._

Note: Your heat pump needs to have the Navigator 2.0 control unit. Other versions of the control unit may not work correctly.

This component will set up the following platforms.

Installation

Configuration of the heat pump

The integration communicates with the heat pump via Modbus TCP. Before Home Assistant can connect to the heat pump you need to make sure Modbus TCP is enabled on the heat pump.

[!IMPORTANT] If Modbus TCP is not enabled, the integration will fail to connect, even if the web UI of the heat pump is reachable via it given IP or hostname.

Install HACS Repository

1. Install HACS and complete its setup.
2. Open HACS and select "Integrations".
3. Add kodebach/hacs-idm-heatpump with category "Integration" as a Custom Repository.
4. Select "IDM heat pump" from the list and click "Download".

Set up integration

The integration now appears like any other Home Assistant integration. To set it up, follow these steps:

1. In the HA UI go to "Settings" -> "Devices & Services", click "+ Add Integration" in the bottom right corner, and search for "IDM heat pump".
2. Make sure the heat pump is configured correctly (see above), then fill out the necessary details in the setup form.

Further configuration

For further configuration you can click "Configure" on the settings page for the integration.

Additional notes for sensor data

• Status Ladepumpe: This value is reported as a percentage in the IDM interface, but has a range of -1 to 100, with -1 meaning "pump is off", 0 meaning "pump running at minimum speed" and 100 meaning "pump running at maximum speed". To avoid confusion about the what -1% means and how values between 0 and 100 should be interpreted, this integration reports the value without unit and leaves interpretation to the user. You may want to add extra sensor to your configuration.yaml file to get more sensible data:

  binary_sensor:
  - platform: threshold # use a threshold sensor to check whether charge pump is active
    name: "Ladepumpe aktiv"
    entity_id: sensor.heatpump_status_ladepumpe # replace with your entity id
    upper: 0

  Note: It may be that your heat pump does not have variable speed charge pumps, in which case you probably would only see the values -1 and 100. The binary sensor above will still work for that case. For the other cases it is harder, because other than -1 meaning "power off" and 0-100 "power on at some speed", IDM documentation doesn't say how values should be interpreted. However, we can make some guesses for the two common types of variable speed pumps:

  • 0-10 V controlled pumps: The 0-100 value probably maps directly to the 0-10 V signal, either 0->0,x->x/10,100->10 or 0->10,x->10-x/10,100->0, depending on whether 10 V or 0 V is for maximum speed.
  • PWM controlled pumps: The 0-100 value probably indicates the PWM duty cycle as a percentage. Again, it could be 0 or 100 that mean PWM always active, depending on what the pump interprets as "run at maximum speed". These conversions could be done with a template sensor in configuration.yaml.

• Status Sole/Zwischenkreispumpe and Status Wärmequellen/Grundwasserpumpe: I assume these two work the same as "Status Ladepumpe". However, the documentation from IDM doesn't really say, and my setup doesn't use these, so I cannot verify it myself.
• Umschaltventil ... X/Y: All the "Umschaltventil ... X/Y" sensors are implemented such that the value 0 from the heat pump is interpreted as X and 1 is interpreted as Y. The special value 0xFFFF/-1 is interpreted as "not available", any other value (e.g. -1) is interpreted as "unknown". This is a bit of a guess, since the documentation from IDM does not give any information for these sensors (other than that they exist), but this interpretation works correctly for my setup.

Contributions are welcome

If you want to contribute to this please read the Contribution guidelines