Skip to content

jasperslits/haithowifi

Repository files navigation

Table of Contents

Home Assistant sensor component/integration for Itho Wifi

Requires WiFi add-on from https://github.com/arjenhiemstra/ithowifi and MQTT integration with Home Assistant.

This simplifies the integration by creating the sensors for the various Itho Daalderop devices: Heatpump WPU 5G, HRU-350 and related devices, CVE boxes, Autotemp units for floor heating. Combine this integration with the Home Assistant auto-discovery in the MQTT configuration for the CVE / non-CVE devices in the add-on.

This integration is intended for standard domestic set ups: 1 WPU, 1 CVE or HRU unit, up to 10 rooms connected to autotemp and up to 5 CO2 remotes. More complex setups should be managed via YAML and are out of scope.

This custom component has no affiliation with the Itho Daalderop company or with Arjen Hiemstra's Itho WiFi add-on. Note: The 'add-on' here in the context is the ESP32 add-on to the Itho Daalderop units, not an Add-on in Home Assistant.

What can be configured via this Integration

  1. Heatpump WPU sensors
  2. NONCVE / HRU sensors
  3. CVE sensors
  4. Up to 5 remotes for monitoring CO2 levels
  5. Up to 10 autotemp rooms using custom room names instead of Room 1, Room 2

Not (yet) supported

The fan entity is not supported yet. To add this to Home Assistant enable the Auto-discovery in Arjen's module under MQTT settings or manually configured it. See https://github.com/arjenhiemstra/ithowifi/wiki/Home-Assistant the wiki for details

Use-case

Full auto-discovery from the WiFi add-on to Home Assistant is the best experience but as this is not there yet, this integration should eliminate the manual creation via YAML of sensors for:

  • Non-CVE like Actual mode, Supply Temp, Supply / Exhaust RPM, Bypass
  • CVE like Humidity, Temperature, Speed
  • Autotemp like Power kW, Power %, Set Point Temp, Actual Temp per Room
  • CO2 concencration for supported remotes
  • WPU like Pump Percentage, Boiler Temp, From / To Source Temps, Operating Mode etc

It creates a device and commonly used sensors and uses a predefined MQTT state topic to distinct the devices.

Available sensors

Device Sensor Attributes
Autotemp
Empty battery
Error Code
Mode Code
Room X power % (%)
Room X power kW (kW)
Room X setpoint
Room X temp
Status Code
CVE
Error
Fan Setpoint (rpm)
Fan Speed (rpm)
Filter dirty
Humidity
Temperature
Total Operating Time
Ventilation setpoint (%)
Last Command (disabled by default)
Last Command Source (disabled by default)
NONCVE (HRU)
Actual Mode Code
Air Quality (%)
Airfilter counter Last Maintenance
Next Maintenance Estimate
Balance (%)
Bypass position
Exhaust fan (RPM)
Exhaust temp (°C)
Global fault code Description
Highest received CO2 value (Ppm) (disabled by default)
Highest received RH value (%RH) (disabled by default) Error Description
Remaining override timer (Sec)
Supply fan (RPM)
Supply temp (°C)
Last Command (disabled by default)
Last Command Source (disabled by default)
WPU
Boiler pump (%)
Boiler temp up (°C)
CV pressure (Bar)
Cv pump (%)
CV return temp (°C)
Error
Flow sensor (lt_hr)
Heat demand thermost. (%)
Status
Temp from source (°C)
Temp to source (°C)
Requested room temp (°C)
Room temp (°C)
Well pump (%)

Missing a sensor? Feel free to create an issue

Installation

Prerequisites

  1. Working WiFi add-on connected to the Itho device(s) (buy)
  2. Official HA MQTT Integration - Other MQTT integrations are not supported
  3. In the Itho WiFi add-on the MQTT base topic should be configured like the table below:
Device MQTT base topic
Autotemp ithotemp
CVE ithocve
HRU ithohru
WPU ithowpu

Install via HACS (recommended)

  1. Install HACS by following these steps
  2. Install the component via HACS custom repository. See https://hacs.xyz/docs/faq/custom_repositories/ and use Integration in the dropdown and https://github.com/jasperslits/haithowifi/ as name

Manual install

  1. Using a HA file editor like Studio Code Server or File Editor, create a folder /usr/share/hassio/homeassistant/custom_components/ithodaalderop
  2. Git clone or download the content to custom_components in the /usr/share/hassio/homeassistant/custom_components/ithodaalderop directory
  3. Restart Home Assistant
  4. Go to Integrations
  5. Search for Itho Add-on integration
  6. Add an entry for each device

Upgrading from 1.4 or below (+ keeping history)

Version 2.0.0 includes major improvements that changes the entity id's for all entities within a device. Due to this change old entities will no longer be provided by the integration and no longer work. You will need to reconfigure the integration:

  1. Navigate to Settings -> Devices & Services and find Itho WiFi Add-on.
  2. For each entry press (three dots) and press Delete.
  3. Reconfigure a new entry by pressing ADD DEVICE for each Itho Wifi Add-on you own.

In order to keep the history from your old entities follow this process for each entity:

According to https://www.home-assistant.io/blog/2023/04/05/release-20234/#database-scalability:

It may take a while to complete background data migration, depending on the size of your stored data. To ensure Home Assistant keeps history when renaming an entity, wait 24 hours after upgrading before renaming.

  1. Rename the entity to the entity-id of the old entity. (For example, change sensor.itho_hru_actual_exhaust_fan back to sensor.noncve_actual_exhaust_fan)
  2. Wait 24 hours
  3. Rename the entity back to the new naming scheme. The history should now be kept with your new entity-id

Screenshots

  1. Add integration
image
  1. Define remotes for CO2 monitoring
image
  1. Define rooms for autotemp
image
  1. Created devices
image
  1. Created HRU sensors and two remotes
image
  1. CVE sensors
  1. Autotemp Control Unit + Connected Sensors
image

TODO:

  • Add Integration to HACS default (waiting for hacs/default#2494)
  • Explore adding Fan without autodiscovery