Table of Contents

• Home Assistant sensor component/integration for Itho Wifi)
  • What can be configured via this Integration
  • Differences with the add-on's Home Assistant MQTT Discovery
  • Use-case
  • Available entities
  • Why don't I see all entities?
• Installation
  • Prerequisites
  • Install via HACS (recommended)
  • Manual install
  • Upgrading from 1.4 or below (+ keeping history)
• Screenshots
• Help us improve!

Home Assistant sensor component/integration for Itho Wifi

This integration for Home Assistant provides a simple configuration screen for the MQTT based "Itho Wifi add-on" from https://github.com/arjenhiemstra/ithowifi This simplifies the integration by creating the sensors for the various Itho Daalderop devices: Heatpump WPU 5G, HRU units, CVE boxes, Autotemp units for floor heating.

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.

What can be configured via this Integration

1. Autotemp sensors with up to 10 autotemp rooms using custom room names instead of Room 1, Room 2
2. Heatpump WPU sensors
3. CVE sensors
4. NON-CVE / HRU sensors
5. Up to 5 remotes for monitoring CO2 levels for CVE/NON-CVE (HRU)

Differences with the Itho WiFi add-on Home Assistant MQTT Discovery

This integration does not support the MQTT fan entity while this is provided via the MQTT Discovery. To add this to Home Assistant enable Home Assistant MQTT Discovery in Arjen's module under MQTT settings or manually configure it in YAML. See the wiki for details.

Custom autotemp roomnames and CO2 remote names are also unique to this integration.

Additional differences include the translations in Dutch, support for other Itho devices besides a fan, value translations for e.g. status.

Use-case

This integration should eliminate the manual creation via YAML of sensors for:

• Non-CVE (HRU) 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

Available entities

The integration creates a device and sensors and uses a predefined MQTT state topic to distinct the devices. At first only a (by the authors) selected group of entities will be created. If you want to create all available entities for your device, you need to re-configure the integation entry:

Navigate to integrations and find the Itho WiFi Add-on. Click the three dots of the entry you want edit:

Click Reconfigure and reconfigure the created entities

Why don't I see all entities?

Some sensor are disabled by default. Follow these instructions to enable an entity.

Click xx entities not shown within the device or just navigate to the entity directly

Click the cogwheel icon

Click enable

Installation

Prerequisites

1. Working WiFi add-on connected to the Itho device(s) (buy)
2. Official HA MQTT Integration configured and connected to the MQTT broker.
3. In the Itho WiFi add-on under 'MQTT' 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 here 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 this repository 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

Add integration

Define remotes for CO2 monitoring

Define rooms for autotemp

Created devices

Created HRU sensors and two remotes

CVE sensors

Autotemp Control Unit + Connected Sensors

TODO:

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

Help us improve!

As we don't own all Itho devices ourselves, we don't always know the exact meaning and usage of an available sensor. You can help us improve the integration by providing feedback about:

• Translations
• Binary sensors. When a sensor provides only binary data (on/off, open/close, ...)
• Should a sensor be within the 'selected' group of sensors
• Should a sensor be enabled by default
• ...

Feel free to create an issue!