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 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.
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:
- Navigate to
Settings->Devices & Servicesand findItho WiFi Add-on. - For each entry press
⠇(three dots) and pressDelete. - Reconfigure a new entry by pressing
ADD DEVICEfor 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.
- Rename the entity to the entity-id of the old entity. (For example, change
sensor.itho_hru_actual_exhaust_fanback tosensor.noncve_actual_exhaust_fan) - Wait 24 hours
- Rename the entity back to the new naming scheme. The history should now be kept with your new entity-id
- Heatpump WPU sensors
- NONCVE / HRU sensors
- CVE sensors
- Up to 5 remotes for monitoring CO2 levels
- Up to 8 autotemp rooms using custom room names instead of Room 1, Room 2
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
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.
| 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 (%) | ||
| 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) | ||
| WPU | ||
| Boiler pump (%) | ||
| Boiler temp up (°C) | ||
| CV pressure (Bar) | ||
| Cv pump (%) | ||
| CV return temp (°C) | ||
| 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 (%) | ||
| All devices | ||
| Last Command (disabled by default) | ||
| Last Command Source (disabled by default) |
Missing a sensor? Feel free to create an issue
- Working WiFi add-on connected to the Itho device(s)
- MQTT HA Integration
- State topics for MQTT like table below
| Device | MQTT base topic |
|---|---|
| Autotemp | ithotemp |
| CVE | ithocve |
| HRU | ithohru |
| WPU | ithowpu |
- In the Add-On from Arjen: Update the add-on MQTT configuration and set MQTT Base Topic as per below above
- On the system running Home Assistant: Create /usr/share/hassio/homeassistant/custom_components/ithodaalderop
- Install the component via HACS custom repo. See https://hacs.xyz/docs/faq/custom_repositories/ and use Integration in the dropdown and https://github.com/jasperslits/haithowifi/ as name OR
- Git clone or download the content to custom_components in the /usr/share/hassio/homeassistant/custom_components/ithodaalderop directory
- Restart Home Assistant
- Go to Integrations
- Search for Itho Add-on integration
- Add an entry for each device
- 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
- Add Integration to HACS default (waiting for hacs/default#2494)
- Explore adding Fan without autodiscovery
