Manual

Itho WiFi add-on — Gebruikershandleiding

Versie: V1.13

Datum: 14-06-2026
CVE add-on revisie 1.x CVE add-on revisie 2.x
CVE add-on revisie 1.x CVE add-on revisie 2.x
Non-CVE add-on revisie 1.x
Non-CVE add-on revisie 1.x

Voorwoord

Bedankt voor de aanschaf van een (of meerdere) add-on modules, veel plezier met het gebruik!

Een belangrijke waarschuwing vooraf! Verschillende Itho apparaten (in ieder geval de CVE's en HRU200) zijn niet aanraakveilig als er spanning op staat, ook de laag voltage delen niet. Haal daarom altijd de spanning van het apparaat bij het installeren van een add-on op de printplaat. Zo voorkom je schade aan jezelf en je itho! Indien nodig, bedien de knopjes op de printplaat van de CVE add-on alleen met materiaal dat geen stroom kan geleiden.

Dit is een beknopte handleiding om je op weg te helpen de add-on fysiek te installeren en te verbinden met je eigen wifi netwerk. Informatie over verdere specifieke installaties is online te vinden.

Deze handleiding, de plug-ins voor oa. Home Assistant en Homey, de wiki en verdere informatie online zijn een community effort, een verzameling van bijdragen van gebruikers voor gebruikers. Zonder deze bijdragen was oa. dit document er niet geweest. Het wordt zeer gewaardeerd als je aanvullingen, aanpassingen en/of suggesties hebt!

Bronnen waar verdere informatie te vinden is:

Fysieke Installatie CVE Add-on

Om de add-on (PCB) goed te beschermen, leveren wij deze in een antistatisch zakje.

Hieronder volgt een genummerde lijst met handelingen, om de installatie van de add-on te realiseren.

  1. Haal de add-on uit het antistatische zakje;
  2. U treft naast de add-on, ook een PCB-afstandshouder aan, leg deze even apart.
  3. Haal nu de spanning van de Itho ventilatie-unit, door de stekker uit de wandcontactdoos te halen;
  4. Om bij de basisprint van de Itho te komen, haalt u de deksel van de unit. Dat kan door met een platte schroevendraaier de klemnokken aan de boven- en onderzijde te ontgrendelen. U ziet nu het kastje waarin de basisprint zit, deze is eenvoudig te bereiken door het deurtje te openen of in geval van een zwarte kap kan deze verwijderd worden door wat zijwaartse druk te combineren met een trek beweging naar boven. Zie de installatie & gebruik handleiding van de fabrikant, voor eventuele andere/specifieke instructies;
  5. Plaats nu de PCB-afstandshouder met de kromme / korte kant in het gat op de itho basisprint dat overeenkomt met het gat op de add-on. Door gebruik van deze afstandshouder reduceert de kans, dat door trillingen, gesoldeerde punten mogelijk lostrillen. Eventueel kan deze stap ook na het testen van de add-on gedaan worden;
  6. Het plaatsen van de add-on, benodigd geen speciaal gereedschap of andere materialen. U kunt, de add-on plaatsen door deze op de 2×4 pin interface aan te brengen. Zie Installatievoorbeeld, in het rood omcirkeld, waar de 2×4 pin interface zich bevindt op de basisprint;
  7. Breng nu de spanning van de Itho terug door de stekker in de wandcontactdoos te plaatsen.
  8. Als de initialisatie succesvol is, licht de Itho status led (zie Hardware revisies) kort op. Vervolgens blijft deze uit. Dit is een teken dat de communicatie, tussen de Itho basis/hoofdprint en add-on succesvol is gestart. De wifi status led zal knipperen als indicatie dat er een access point gestart is.
  9. Nu is de add-on geïnstalleerd, sluit het kastje van de basisprint en plaatst u de deksel terug op de unit.

Fysieke Installatie non-CVE Add-on

Om de add-on (PCB) goed te beschermen, leveren wij deze in een antistatisch zakje. Indien u een behuizing mee besteld hebt is de add-on al in de behuizing geplaatst. Laat de add-on in de behuizing zitten, het verwijderen van de print uit de behuizing kan de behuizing beschadigen.

Hieronder volgt een genummerde lijst met handelingen, om de fysieke installatie van de add-on te realiseren.

  1. Haal, indien van toepassing, de add-on uit het antistatische zakje;
  2. Zoek de COM/Service poort op je Itho device. Dit is aansluiting die lijkt op een netwerkpoort (RJ45 connector). Sluit de add-on met een goede, korte (CAT6a, STP, 25cm) netwerk kabel aan op de COM/Service poort;
  3. De add-on is geïnstalleerd en zal een access point starten.

Nb. Stroom voor de add-on komt via de netwerkkabel vanuit de aangesloten Itho. In uitzonderlijke gevallen lijkt de Itho niet voldoende stroom te kunnen leveren (bepaalde revisies van de HRU300). Hierdoor is de communicatie met de HRU niet altijd stabiel. Sluit in dat geval een USB voeding aan op de add-on. In alle andere gevallen is dit niet nodig.

Extra informatie voor de HRU250 en HRU300

Om de add-on te kunnen gebruiken met de HRU250 en HRU300 zijn een adapter bordje en PCI-e splitter kabel nodig.

Om deze te installeren:

  1. Verwijder de PCI-e kabel uit de HMI van de HRU.
  2. Sluit de PCI-e kabel van de HMI aan op de PCI-e splitterkabel.
  3. Sluit 1 kant van de splitterkabel aan op de HMI, sluit de overgebleven kant aan op het HRU250/300 adapter bordje.
  4. Met de netwerkkabel kan het adapter bordje verbonden worden met de add-on.

HRU250/300 adapter installatie

Bediening van de HRU250 en HRU300

Deze modellen zijn iets beperkter in de bediening via de add-on in vergelijking met andere Itho modellen. Om deze HRU te bedienen moet je gebruik maken van de CC1101 RF module op de add-on. De Virtual Remote optie werkt bij deze HRU modellen niet.

Om gebruik te maken van de RF module moet deze via de web interface van de add-on geactiveerd worden, dat kan onder het menu "System settings". Na een reboot komt er een menu item bij genaamd "RF Devices". Hier kan een RF device geconfigureerd worden. Dit RF device moet vervolgens gekoppeld worden aan de HRU. Volg hiervoor dezelfde procedure als waarmee ook fysieke remotes gekoppeld worden.

Add-on Instellen

Hieronder treft je een genummerde lijst met stappen om de basis instellingen van de add-on te maken.

Add-on instellen — Verbinden met de add-on

  1. Na het aansluiten start de add-on automatisch een WiFi access point. De WiFi status led knippert dan 1x per seconde (zie Hardware revisies).

    Let op: zolang de add-on nog geen verbinding heeft met je WiFi-netwerk, blijft het access point actief. Zodra de add-on verbonden is, schakelt het access point na de ingestelde tijd (standaard 15 minuten) automatisch uit. Deze tijd is aan te passen in de instellingen.

  2. Maak met je telefoon, tablet of computer verbinding met het WiFi netwerk van de add-on:

    • Netwerknaam (SSID): nrg-itho-XXXX (de laatste 4 tekens zijn uniek per add-on)
    • Wachtwoord: password

  3. Open een browser en ga naar: http://nrg-itho-XXXX.local (vervang XXXX door de 4 tekens uit de netwerknaam) Werkt dit niet (bijv. op Android)? Ga dan naar http://192.168.4.1

Add-on instellen — Setup Wizard

Vanaf firmware versie 3.0 start automatisch een Setup Wizard die je in een aantal stappen door de configuratie leidt:

Stap 1 — WiFi

Vul de naam (SSID) en het wachtwoord van je eigen WiFi netwerk in. Optioneel kun je een eigen hostname instellen. Klik op Connect en wacht tot de verbinding bevestigd wordt. Noteer het IP-adres dat getoond wordt — dit heb je nodig om de add-on later te bereiken vanuit je eigen netwerk.

Stap 2 — Device

De wizard detecteert automatisch welk type Itho apparaat is aangesloten (bijv. CVE-Silent, HRU 350, DemandFlow) en stelt de meest voorkomende standaardinstellingen in. Bij apparaten zonder I2C-verbinding (bijv. HRU 400) wordt de optie aangeboden om RF standalone modus te activeren.

Stap 3 — RF (wordt overgeslagen als er geen CC1101 RF module aanwezig is)

Hier configureer je de RF-afstandsbedieningen. Je kunt een afstandsbediening koppelen (join) met de Itho apparaat, of deze stap overslaan en later via het menu "RF Devices" instellen.

Werk je in RF-standalone modus (een apparaat zonder I2C, bijvoorbeeld de HRU 400)? Dan is dit het moment om een geëmuleerde RFT CO2-remote aan de Itho te koppelen — daarmee stuur je het apparaat vervolgens aan en lees je de status uit.

Stap 4 — MQTT (optioneel)

Vul de gegevens van je MQTT server in als je de add-on wilt koppelen aan Home Assistant, Domoticz of een ander domotica platform via MQTT. Schakel eventueel Home Assistant MQTT Auto Discovery in zodat de add-on automatisch als apparaat in Home Assistant verschijnt.

Stap 5 — HA Discovery (wordt overgeslagen als MQTT niet is ingeschakeld)

Configureer welke sensoren en statusinformatie via HA Auto Discovery beschikbaar worden gesteld aan Home Assistant.

Add-on instellen — Na de wizard

Verbind je telefoon/computer weer met je eigen WiFi netwerk en open de browser op het IP-adres uit de wizard.

Alle instellingen zijn ook achteraf aan te passen via de web interface. De wizard hoeft niet opnieuw doorlopen te worden.

Gebruik (Webinterface, API)

De Itho unit is nu d.m.v. de web interface (http://nrg-itho-A1B2.local, A1B2 vervangen), via MQTT of WebAPI te bedienen.

Wil je de add-on via MQTT koppelen aan domotica? Dan heb je een MQTT-server (broker) nodig. De web interface en de WebAPI werken overigens ook zonder MQTT. Heb je nog geen MQTT-server, dan vind je via onderstaande link een prima voorbeeld hoe je deze installeert op bijvoorbeeld een Raspberry Pi:

https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/

Itho bedienen

Er zijn verschillende mogelijkheden om de Itho te bedienen en de settings aan te passen.

Voor CVE's en de HRU 200 zijn er 2 manieren om de snelheid te regelen: remote-commando's (virtual of RF) en het traploze PWM2I2C-protocol. Voor andere apparaten (bijvoorbeeld de HRU 350) zijn alleen de remote-commando's (virtual remote en/of RF-remote) beschikbaar. Voor de HRU 250 en HRU 300 werken uitsluitend RF-remote commando's. Om RF-remote commando's te versturen moet de CC1101 RF-module aanwezig zijn op de add-on. Virtual-remote commando's (waarbij de add-on een fysieke remote emuleert) worden via de fysieke I2C-verbinding met de Itho verstuurd.

Wat per apparaat precies mogelijk is, staat in het hoofdstuk Apparaat-specifieke informatie.

Meer details over de verschillende mogelijkheden en de eventuele beperkingen zijn op de wiki te vinden:

https://github.com/arjenhiemstra/ithowifi/wiki/Controlling-the-speed-of-a-fan

Koppeling met Home Domotica software

De add-on kan met andere apparaten en domotica gekoppeld worden via MQTT en de WebAPI. De details hiervan staan in het kopje De API gebruiken hieronder.

Voor de meest gebruikte platforms zijn er kant-en-klare integraties:

  • Home Assistant — MQTT Auto Discovery. Schakel je MQTT in met Home Assistant MQTT Auto Discovery, dan wordt de add-on automatisch als apparaat in Home Assistant geconfigureerd met een basis configuratie. Deze kan handmatig aangepast en uitgebreid worden.
  • Home Assistant — losse integraties. Er zijn daarnaast twee community-integraties voor Home Assistant:
  • Homey. De Itho Daalderop-app in de Homey app store gebruikt de WebAPI (REST); MQTT is daarvoor niet nodig.
  • Homebridge (Apple HomeKit). De community-plugin Homebridge Itho Daalderop HUE brengt je CVE naar Apple HomeKit. Hij communiceert via de WebAPI of MQTT (MQTT aanbevolen voor directe updates) en biedt optioneel een koppeling met Philips Hue.
  • Domoticz en andere platforms. Koppeling verloopt via MQTT (of de WebAPI).

De API gebruiken (WebAPI en MQTT)

De add-on heeft twee API's waarmee je de Itho kunt uitlezen en bedienen, bijvoorbeeld vanuit eigen scripts of domotica: een WebAPI (HTTP) en een MQTT API. Beide accepteren dezelfde commando's.

De volledige en altijd actuele lijst met endpoints en commando's voor jouw firmwareversie vind je in de web interface onder het menu API (interactieve documentatie). De onderliggende OpenAPI-specificatie is ook rechtstreeks op te halen via http://<add-on>/api/openapi.json.

WebAPI (HTTP)

Er zijn twee varianten:

  • REST API (v2) — een JSON-API onder /api/v2/…. Een greep uit de endpoints:

    • GET /api/v2/deviceinfo — apparaat- en firmware-informatie
    • GET /api/v2/ithostatus — alle actuele statuswaarden
    • GET /api/v2/speed en GET /api/v2/lastcmd — huidige snelheid en laatste commando
    • GET /api/v2/remotes, /api/v2/vremotes en /api/v2/rfstatus — (virtuele) remotes en RF-status
    • GET en PUT /api/v2/settings — instellingen uitlezen en wijzigen
    • POST /api/v2/command — een commando sturen (bijvoorbeeld een ventilatiestand)
    • POST /api/v2/vremote en POST /api/v2/rfremote/command, /co2, /demand, /config — virtual- en RF-remote commando's
    • POST /api/v2/wpu/outside_temp en /api/v2/wpu/manual_control — WPU-specifiek

  • Legacy API (v1) — eenvoudige uitlees-API in query-stijl via /api.html, bijvoorbeeld:

    • http://<add-on>/api.html?get=ithostatus
    • http://<add-on>/api.html?get=currentspeed (overige waarden: lastcmd, queue, remotesinfo)

    Het uitlezen en wijzigen van instellingen is verplaatst naar de REST API (GET/PUT /api/v2/settings).

MQTT API

Als MQTT is geconfigureerd, gebruikt de add-on onderstaande topics. Het base topic is instelbaar (standaard itho):

  • itho/cmd — publiceer hier je commando's naar de add-on (dezelfde set als de WebAPI).
  • itho/cmd/response — het antwoord van de add-on op een commando.
  • itho/state — hier publiceert de add-on een JSON met alle statuswaarden.
  • itho/lwt — de online/offline status van de add-on (Last Will & Testament).

Een werkend voorbeeld (Node-RED) dat naar itho/cmd publiceert, staat in het Node-RED automatiseringsvoorbeeld.

Apparaat-specifieke informatie

De add-on herkent automatisch welk Itho-apparaat is aangesloten en past de beschikbare instellingen en uitleesbare statuswaarden daarop aan. Hieronder staat per apparaat(groep) hoe het wordt aangestuurd, welke informatie de add-on uitleest en waar je op moet letten.

Naast de hieronder per apparaat beschreven aansturing kan vanaf de add-on bij elke ventilator (CVE en HRU) en DemandFlow een RFT CO2-remote geëmuleerd worden. Na koppeling met het apparaat kan het daarmee traploos van 0–100% aangestuurd worden, in stapjes van een half procent. Dit werkt zowel bij een I2C-aansluiting als in RF-standalone modus. Alleen bij de CVE's kan deze RF-communicatie minder betrouwbaar zijn; zie het hoofdstuk CVE-familie hieronder.

Let op: welke statuswaarden en instellingen precies beschikbaar zijn, hangt af van het model én de firmwareversie van het Itho-apparaat. De web interface en de API-pagina tonen altijd de actuele, volledige lijst voor jouw apparaat. De waarden hieronder zijn voorbeelden van wat een apparaat zoal rapporteert.

CVE-familie (CVE, CVE-Silent, HRU 200)

Modellen: CVE, CVE-Silent en de HRU 200 (in de web interface herkend als CVE-SilentExtPlus). Ook de CVE ECO2 en CVE-SilentExt worden herkend, maar bieden alleen basisstatus.

Aansturing: deze units communiceren via de fysieke I2C-verbinding op de basisprint. De snelheid kan op twee manieren geregeld worden:

  • Remote-commando's — een virtual remote die de add-on emuleert, of een fysieke/RF-remote (RF vereist hardware revisie 2 met CC1101-module).
  • PWM2I2C — een traploos protocol voor staploze regeling (0–100%). Dit is alleen beschikbaar op de CVE's en de HRU 200, niet op de andere apparaten.

Standaard staat de add-on in PWM2I2C-modus; de remote-modus kun je instellen via System settings.

Let op (modellen met ingebouwde CO2-sensor): bij CVE-S Optima Inside-modellen met een ingebouwde CO2-sensor werkt PWM2I2C niet — de PWM2I2C-commando's worden overruled door de interne CO2-sensor. Gebruik bij deze modellen virtual remote-aansturing.

Wat de add-on uitleest (o.a.): ventilatieniveau/-setpoint (%), gevraagd en actueel toerental (rpm), gekozen stand, foutcode, opstartteller, bedrijfsuren, CO2-waarde (ppm), klepstand en aanwezigheidstimer. Nieuwere CVE's hebben een ingebouwde vochtsensor — zie het hoofdstuk Temperatuur/Vochtsensor.

De CVE-Silent meldt aanvullend onder meer de hoogst gemeten CO2 (ppm) en RH (%), de interne luchtvochtigheid (%) en temperatuur (°C) en afwezigheidstimers. De HRU 200 heeft de meest uitgebreide set van de familie, met daarnaast onder meer filtergebruik (uren), buiten- en afblaastemperatuur, gemiddelde uitblaastemperatuur, bypassmodus en -stand, en de maximale CO2-/RH-niveaus.

Let op (RF bij CVE's): bij de CVE's zitten de antennes van de add-on en de unit dicht bij elkaar. Dit kan bij RF-aansturing (zoals een geëmuleerde RFT CO2-remote) tot communicatieproblemen leiden. Gebruik bij de CVE's daarom bij voorkeur de I2C-aansturing (virtual remote of PWM2I2C).

HRU warmteterugwinning via I2C (HRU 350, HRU ECO-fan)

Modellen: HRU 350 en HRU ECO-fan.

Aansturing: via de I2C-verbinding, met remote-commando's (virtual remote of RF). Het traploze PWM2I2C-protocol is bij deze modellen niet beschikbaar — alleen de remote-standen/commando's.

Wat de add-on uitleest (o.a.): gevraagde ventilatiestand (%), balans (%), toevoer- en afvoerventilator (zowel gevraagd als actueel toerental), toevoer-, afvoer-, ruimte- en buitentemperatuur (°C), klep- en bypassstand, vorst- en boilertimers, filterteller, globale foutcode, actuele modus, hoogst gemeten CO2 (ppm) en RH (%), luchtkwaliteit (%) en de resterende override-timer. De HRU ECO-fan rapporteert een vergelijkbare set rond toevoer/afvoer, temperaturen, bypass en filtergebruik.

DuoZone: HRU-units met twee zones (DuoZone) worden herkend; de zonegegevens verschijnen op de RF Status-pagina van de web interface (en via GET /api/v2/rfstatus).

HRU 250 / HRU 300

Aansturing: deze modellen worden uitsluitend via RF (CC1101) aangestuurd en uitgelezen — de Virtual Remote-optie werkt hier niet. Er moet daarvoor een RF-remote vanaf de add-on gekoppeld worden.

Speciale hardware: een adapterbordje en een PCI-e splitterkabel zijn nodig. De fysieke installatie hiervan staat in het hoofdstuk Extra informatie voor de HRU250 en HRU300. Bij sommige revisies van de HRU 300 kan de unit te weinig stroom leveren; sluit in dat geval een USB-voeding aan op de add-on.

Wat de add-on uitleest (o.a.): buiten- en gemengde-luchttemperatuur (°C), toevoer- en afvoerdebiet (m³/h), inlaat-, afvoer- en uitgeblazen-luchttemperatuur (°C), relatieve en absolute ventilatorsnelheid (%), de massflow in- en uitgaand (kg/h), bypassstand (%), gewenste inlaattemperatuur, uitgebreide vorstgegevens, motortoerental (rpm), de hoogst gemeten RH/CO2 en het stroomverbruik van de ventilator (mA).

Apparaten zonder I2C — RF-standalone (bijv. HRU 400)

Sommige units (bijvoorbeeld de HRU 400) hebben geen voor de add-on bruikbare I2C-verbinding. Hiervoor is de RF-standalone modus: de add-on slaat I2C volledig over en werkt alleen via RF (CC1101).

  • Activeren: de Setup Wizard biedt dit aan bij apparaten zonder I2C; later kan het ook via System settings.
  • Vanaf de add-on kan een RFT CO2-remote geëmuleerd worden. Nadat deze aan de HRU is gekoppeld, kan de HRU hiermee traploos aangestuurd worden van 0–100% in stapjes van een half procent.
  • Met een gekoppelde, geëmuleerde RFT CO2-remote kan periodiek de status (zoals ventilatiestand en temperaturen) opgevraagd worden.

Voor deze modus is een CC1101 RF-module (hardware revisie 2) vereist.

DemandFlow

Aansturing: via de I2C-verbinding. DemandFlow is een vraaggestuurd ventilatiesysteem met meerdere ruimtes; bediening en uitlezing lopen via de web interface, MQTT en de WebAPI.

Wat de add-on uitleest (o.a.): bedrijfsstatus en -modus, relatieve vochtigheid per badkamer (%), afvoerventilator (%), CO2 in het plenum (ppm) plus de berekende CO2 per ruimte (keuken, toilet, woonkamer, slaapkamers, enzovoort), de berekende klep-/flapstanden en het berekende luchtdebiet per ruimte (m³/h), en de foutcode.

AutoTemp

Modellen: AutoTemp en AutoTemp Basic.

Aansturing: via de I2C-verbinding. AutoTemp is een zoneregeling (per kamer), bijvoorbeeld voor vloerverwarming; bediening en uitlezing via de web interface, MQTT en de WebAPI.

Wat de add-on uitleest (o.a.): modus, conditie en foutcode, en per ruimte (tot 12 kamers) de gemeten temperatuur, het setpoint en het afgegeven vermogen (% en kW), plus de klepstanden per verdeler/zone.

WPU (warmtepomp)

De WPU is een warmtepomp (in de firmware aangeduid als Heatpump), geen ventilatie-apparaat. Het heeft veruit de uitgebreidste set uitleesbare waarden.

Aansturing: via de I2C-verbinding; uitlezing en instellingen via de web interface, MQTT en de WebAPI.

Wat de add-on uitleest (o.a.): een groot aantal temperaturen (buiten, boiler boven/onder, verdamper, zuig- en persgas, vloeistof, bron aan/af, CV-aanvoer en -retour, °C), CV-druk (bar), het stroomverbruik van compressor en elektrisch element (A), pompsnelheden voor CV, bron en boiler (%), klepstanden, de status van compressor/element/steunverwarming, diverse timers en een foutcode met gedetailleerde foutbytes.

De foutbytes worden als ruwe waarden getoond; een vertaaltabel naar omschrijvingen zit niet in de add-on. Raadpleeg voor de betekenis de documentatie van Itho.

Overige herkende apparaten

De add-on herkent daarnaast nog diverse andere Itho-apparaten op naam (zoals Air curtain, LoadBoiler, GGBB, CO2 relay, OLB, RF+, Extended (Plus), AreaFlow en RF_CO2). Hiervan toont de add-on de basisinformatie, maar (nog) geen uitgebreide instellingen of statuslijst.

Temperatuur/Vochtsensor

Nieuwe Itho CVE units worden standaard geleverd met een vochtsensor. De add-on kan deze sensor uitlezen.

CVE PCB met vochtsensor

Oudere Itho modellen zonder vochtsensor zijn, met wat tweakers skills, ook uit te rusten met een temperatuur/vochtsensor.

De aansluitingen van de vochtsensor zijn als volgt en corresponderende aansluitingen op de add-on print zijn aangegeven met rode markeringen en labels.
Vochtsensor pinout diagram Add-on PCB met SCL/SDA/3v3/GND markering

Hier is een voorbeeld te vinden van een tweaker die dit succesvol heeft gedaan:

https://gathering.tweakers.net/forum/list_message/66500576#66500576

Virtual Remote

De add-on kan zich voordoen als een of meer virtuele remotes. Een virtuele remote emuleert een fysieke afstandsbediening volledig in software en stuurt de Itho rechtstreeks aan via de I2C-verbinding (de bedrade verbinding op de basisprint). Hiervoor is dus géén CC1101 RF-module nodig.

Welke apparaten? Virtuele remotes werken bij de via I2C aangesloten ventilatie-apparaten, zoals de CVE-familie, de HRU 350 en de HRU ECO. De meeste fan-apparaten hebben baat bij minstens één virtuele remote voor de bediening. Ze werken niet bij de HRU 250, HRU 300 en HRU 400; die worden uitsluitend via RF aangestuurd (zie RF-Module).

Koppelen. Net als een fysieke remote moet ook een virtuele remote eerst aan de Itho gekoppeld (joined) worden. De add-on kan hiervoor automatisch een join-commando sturen (optie Send join command, bij de eerstvolgende keer inschakelen).

Verschil met een geëmuleerde RF-remote. Een virtuele remote communiceert via de bedrade I2C-verbinding met de Itho; een geëmuleerde RF-remote communiceert draadloos via de CC1101-module (868 MHz), net als een fysieke afstandsbediening. Gebruik een virtuele remote bij apparaten met een I2C-verbinding, en een geëmuleerde RF-remote bij apparaten die alleen via RF werken (HRU 250/300/400) of om draadloze sensoren (zoals RFT CO2) te emuleren.

RF-Module

RF remote support is alleen beschikbaar vanaf hardware revisie 2.

De CC1101 module kan de RF-signalen van Itho-afstandsbedieningen ontvangen en versturen. De meest verkochte afstandsbedieningen van Itho worden ondersteund.

Een bestaande remote overzetten naar de add-on. Een bestaande fysieke afstandsbediening kan overgezet worden naar de add-on, zodat de add-on de RF-commando's van die remote ontvangt en vertaalt naar de Itho. De remote wordt daarbij van de Itho ontkoppeld en aan de add-on gekoppeld, volgens onderstaande procedure.

Let op: de keuze voor het afhandelen van RF commando's van bestaande remotes via de add-on is niet beschikbaar voor de HRU 250, HRU 300 en HRU 400. Het monitoren van RF communicatie is wel mogelijk. Laat daarom bestaande RF remotes gekoppeld aan de Itho en koppel de add-on als extra remote aan je HRU.

  1. Ontleer de afstandsbediening door een leave commando te versturen binnen de eerste 2 minuten nadat je de Itho unit aan hebt gezet (op de afstandsbediening doe je dat door alle 4 de knoppen tegelijkertijd in te drukken);
  2. Als je dat nog niet gedaan hebt; stel de add-on module verder in en activeer (als laatste) de RF-module onder het menu "System settings";
  3. De add-on reboot;
  4. Als de RF-module correct gedetecteerd is verschijnt in hetzelfde menu de optie om Itho afstandsbedieningen te beheren. Voeg pas afstandsbedieningen toe, nadat de Itho unit uit learn/leave mode is (dus minimaal 2 minuten na inschakelen) anders wordt de remote opnieuw aan de Itho gekoppeld;
  5. Zet de add-on in learn/leave mode (via de web interface);
  6. Verstuur een learn commando met je remote (meestal 2 diagonaal tegenover elkaar liggende knoppen tegelijkertijd indrukken, zie anders de handleiding van de specifieke remote);
  7. Als het goed is komt nu je remote ID op de eerste vrije positie te staan (zie plaatje hieronder), mocht na meerdere pogingen nog niet slagen, dan kan het zijn dat de remote (nog) niet wordt ondersteund. Neem dan contact op met support.

RF Remotes setup screenshot

De add-on als geëmuleerde RF-remote. De add-on kan zich ook voordoen als een geëmuleerde RF-remote: via de CC1101-module gedraagt de add-on zich draadloos als een Itho-afstandsbediening. Met de Remote function op Send verstuurt de add-on draadloos snelheids- en timercommando's naar de Itho. Dit wordt gebruikt bij apparaten zonder bruikbare I2C-verbinding (zoals de HRU 250, HRU 300 en HRU 400) en om bijvoorbeeld een RFT CO2-sensor te emuleren.

Voordat een geëmuleerde RF-remote werkt, moet deze eenmalig aan de Itho gekoppeld (joined) worden — net als een fysieke remote. Zet de Itho daarvoor in zijn koppel-/learn-modus (zie handleiding van je Itho) en start het koppelen met de blauwe join-knop bij de betreffende remote op de RF devices-pagina. Daarna is de add-on te gebruiken zoals een echte fysieke remote.

Opmerking: Er is een debug optie om RF-commando's zichtbaar te maken in de web interface. Stel hiervoor op de Syslog pagina, bij RF Debug log level, één van de volgende niveaus in:

  • Level 1: toont alle herkende Itho remote commando's incl. remote ID
  • Level 2: toont alle RF-pakketten die vanaf een ingestelde remote komen (zie https://github.com/arjenhiemstra/ithowifi/tree/master/remotes voor meer details hoe dit te gebruiken)
  • Level 3: toont alle RF-pakketten die verwerkt worden (hier zitten waarschijnlijk heel veel niet Itho gerelateerde pakketten tussen)
  • Level 0: schakelt de debug-optie weer uit

De RF-log verschijnt op de Syslog pagina zodra het eerste RF-commando ontvangen is.

RF debug log screenshot

Firmware bijwerken

De firmware van de add-on werk je eenvoudig bij via de web interface.

  1. Open de web interface en ga naar het menu Update.
  2. Kies welke firmware je wilt installeren:
    • Stable — de aanbevolen, stabiele versie.
    • Beta — de nieuwste testversie met de laatste functies (kan nog fouten bevatten).
  3. Klik op de knop Install.
  4. De add-on haalt de gekozen firmware automatisch op van GitHub en installeert deze. Volg de voortgang op de pagina; zodra de update klaar is, herstart de add-on automatisch.

Bij een normale update blijven je instellingen behouden. Alleen een factory reset wist de configuratie (zie Module resetten).

Voortgang in Home Assistant. Beide Home Assistant-integraties — de REST- en de MQTT-variant — tonen de add-on als update entity; tijdens een update wordt de voortgang als voortgangsbalk getoond.

Zelf een firmwarebestand uploaden. Lukt het automatisch ophalen niet (bijvoorbeeld zonder internetverbinding), dan kun je op de Update-pagina ook handmatig een .bin-firmwarebestand uploaden. Datzelfde kan via de nood-firmware na een failsafe boot (zie Module resetten).

Module resetten

Fail safe boot / module factory reset

Mocht het onverhoopt voorkomen dat de module door een verkeerde configuratie niet meer bereikbaar is, dan is het mogelijk om de module te booten in fail safe mode. Hierbij wordt het bestandssysteem met configuratie bestanden geformatteerd, en start de module een vereenvoudigde web interface waarmee het mogelijk is om een nieuwe firmware te flashen.

De procedure voor deze reset is als volgt:

  1. reset knop indrukken
  2. wachten totdat de WiFi status led snel gaat knipperen (2x per sec)
  3. druk vervolgens binnen 2 sec op de "Fail save" (sommige revisies "default") knop
  4. Kort hierna zal het wifi ledje 1x per seconde gaan knipperen
  5. Als je geen nieuwe firmware wilt flashen, sla dan deze stop over. De add-on heeft nu een access point gestart met een vereenvoudige "nood" firmware. Hiermee kan alleen een nieuwe firmware geflashed worden. De webpagina is te bereiken op het volgende adres: http://192.168.4.1/update Het uploaden van een nieuwe firmware kan een minuut duren, wacht rustig af totdat de pagina refreshed en het resultaat laat zien.
  6. reset knop indrukken

hierna zijn alle instellingen gewist en zal de add-on in factory default mode starten.

Er is ook een youtube filmpje beschikbaar die deze procedure laat zien: https://youtu.be/3sWclzq73n4

Deze methode is alleen beschikbaar als er gebruik wordt gemaakt van een 'officiële' firmware of, een firmware die hierop gebaseerd is.

Hardware revisies t/m 2.5 (zie achterkant add-on):

Om deze mode te activeren voor de hardware revisies t/m versie 2.5 moet een andere procedure gevolgd worden:

Verbind de twee metalen vlakjes waarbij 'failsafe' staat op de print met elkaar. Dit gaat het makkelijkst met een soldeerbout en een beetje soldeer of door de vlakjes met bijvoorbeeld een schroevendraaier met elkaar te verbinden.

Bij het aanzetten van de Itho met de add-on geinstalleerd zal de add-on de fail save procedure uitvoeren en alle instellingen verwijderen. Ook kan eventueel een nieuwe firmware geladen worden zoals eerder beschreven.

Verwijder na deze procedure de eventueel aanwezige soldeerverbinding, en neem de module weer in gebruik zoals beschreven in deze handleiding.

Hmmm, maar…. Waar vind ik verdere informatie?

Er staat ontzettend veel nuttige informatie op de wiki: https://github.com/arjenhiemstra/ithowifi/wiki Deze is voor gebruikers en door gebruikers. Voel je vrij om hier ook aanpassingen te doen.

Op tweakers.net, loopt een draadje op het forum over deze add-on. Hier staat ook meer informatie over het gebruik van deze add-on, in combinatie met bv. Home Assistant, Domoticz andere systemen.

Verder kun je daar terecht voor vragen. De link is: https://gathering.tweakers.net/forum/list_messages/1976492/0

Voor verdere vragen, feedback en code aanpassingen kun je contact opnemen via contact@nrgwatch.nl of https://www.github.com/arjenhiemstra/ithowifi.

Hardware revisies

Afbeeldingen kunnen iets afwijken met het product dat u ontvangen heeft, de werking is echter gelijk.

Hardware revisie 1:

Hardware revisie 1 — Status LED, Wifi led, Connectie itho print

Hardware revisie 2 (nieuwe revisies met fail safe knop):

Hardware revisie 2 met fail safe knop

Hardware revisie 2 (oude revisies met failsafe soldeer optie):

Hardware revisie 2 met failsafe soldeer optie

Installatievoorbeeld

Installatie header voor de add-on in de rode cirkel. Afhankelijk van de productiedatum van de Itho box, kan de print er iets anders uit zien.

Itho basisprint met installatie header rood omcirkeld

Add-on correct geïnstalleerd:

Add-on correct geïnstalleerd op basisprint

Node-RED automatiseringsvoorbeeld

Hieronder treft u een Node-red voorbeeld aan:

[{"id":"78e45008.cda2f","type":"mqtt out","z":"79360772.4553e8","name":"itho","topic":"itho/cmd","qos":"0","retain":"true","broker":"b4eed736.102278","x":430,"y":1000,"wires":[]},{"id":"98cc2161.c3896","type":"inject","z":"79360772.4553e8","name":"itho level 127","topic":"","payload":"127","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":170,"y":1000,"wires":[["78e45008.cda2f"]]},{"id":"5a4ffa98.c88454","type":"inject","z":"79360772.4553e8","name":"itho level 254","topic":"","payload":"254","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":170,"y":1060,"wires":[["78e45008.cda2f"]]},{"id":"1e824b95.a04104","type":"inject","z":"79360772.4553e8","name":"itho level 0","topic":"","payload":"0","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":160,"y":940,"wires":[["78e45008.cda2f"]]},{"id":"b4eed736.102278","type":"mqtt-broker","z":"","name":"MQTT Server","broker":"192.168.1.2","port":"1883","clientid":"","usetls":false,"compatmode":false,"keepalive":"60","cleansession":true,"birthTopic":"","birthQos":"0","birthPayload":"","closeTopic":"","closeQos":"0","closePayload":"","willTopic":"","willQos":"0","willPayload":""}]

Ondersteunde afstandsbedieningen

Itho afstandsbedieningen die werkend zijn getest:

Overzicht RFT-zenders Itho Daalderop

Itho WiFi add-on — User Manual

Version: V1.13

Date: 14-06-2026
CVE add-on revision 1.x CVE add-on revision 2.x
CVE add-on revision 1.x CVE add-on revision 2.x
Non-CVE add-on revision 1.x
Non-CVE add-on revision 1.x

Foreword

Thank you for purchasing one (or more) add-on modules — enjoy using it!

An important warning first! Several Itho devices (at least the CVE's and the HRU200) are not touch-safe when powered, including the low-voltage parts. Therefore, always disconnect power from the device when installing an add-on on the circuit board. This prevents harm to yourself and to your Itho! If needed, operate the buttons on the CVE add-on circuit board only with a non-conductive material.

This is a concise manual to help you physically install the add-on and connect it to your own WiFi network. Information about further specific installations can be found online.

This manual, the plug-ins for e.g. Home Assistant and Homey, the wiki and further information online are a community effort — a collection of contributions from users for users. Without these contributions this document, among other things, would not exist. Additions, changes and/or suggestions are highly appreciated!

Sources where further information can be found:

Physical Installation CVE Add-on

To properly protect the add-on (PCB), we deliver it in an antistatic bag.

Below is a numbered list of steps to complete the installation of the add-on.

  1. Take the add-on out of the antistatic bag;
  2. Besides the add-on, you will also find a PCB spacer — set it aside for now.
  3. Now disconnect power from the Itho ventilation unit by pulling the plug from the wall socket;
  4. To reach the Itho's main board, remove the cover of the unit. This can be done by releasing the clips on the top and bottom with a flat screwdriver. You now see the housing that contains the main board; it is easily reached by opening the little door, or in case of a black cap it can be removed by combining some sideways pressure with an upward pulling motion. See the manufacturer's installation & user manual for any other/specific instructions;
  5. Now place the PCB spacer with the curved / short side into the hole on the Itho main board that matches the hole on the add-on. Using this spacer reduces the chance of soldered joints vibrating loose over time. This step can optionally also be done after testing the add-on;
  6. Placing the add-on requires no special tools or other materials. You can place the add-on by mounting it onto the 2×4 pin interface. See Installation example, circled in red, for where the 2×4 pin interface is located on the main board;
  7. Now restore power to the Itho by inserting the plug into the wall socket.
  8. If initialization is successful, the Itho status LED (see Hardware revisions) lights up briefly. After that it stays off. This indicates that communication between the Itho main board and the add-on has started successfully. The WiFi status LED will blink to indicate that an access point has been started.
  9. The add-on is now installed; close the main board housing and place the cover back on the unit.

Physical Installation non-CVE Add-on

To properly protect the add-on (PCB), we deliver it in an antistatic bag. If you ordered an enclosure with it, the add-on is already placed in the enclosure. Leave the add-on in the enclosure; removing the board from the enclosure can damage the enclosure.

Below is a numbered list of steps to complete the physical installation of the add-on.

  1. If applicable, take the add-on out of the antistatic bag;
  2. Find the COM/Service port on your Itho device. This is a connection that looks like a network port (RJ45 connector). Connect the add-on to the COM/Service port with a good, short (CAT6a, STP, 25cm) network cable;
  3. The add-on is installed and will start an access point.

Note. Power for the add-on comes through the network cable from the connected Itho. In exceptional cases the Itho appears unable to supply enough power (certain revisions of the HRU300). As a result, communication with the HRU is not always stable. In that case, connect a USB power supply to the add-on. In all other cases this is not necessary.

Additional information for the HRU250 and HRU300

To use the add-on with the HRU250 and HRU300, an adapter board and a PCI-e splitter cable are required.

To install these:

  1. Remove the PCI-e cable from the HRU's HMI.
  2. Connect the PCI-e cable of the HMI to the PCI-e splitter cable.
  3. Connect one end of the splitter cable to the HMI, and the remaining end to the HRU250/300 adapter board.
  4. The adapter board can be connected to the add-on with the network cable.

HRU250/300 adapter installation

Controlling the HRU250 and HRU300

These models are somewhat more limited in control via the add-on compared to other Itho models. To control this HRU you must use the CC1101 RF module on the add-on. The Virtual Remote option does not work on these HRU models.

To use the RF module it must be activated via the add-on's web interface, under the "System settings" menu. After a reboot, an additional menu item named "RF Devices" appears. Here an RF device can be configured. This RF device must then be paired with the HRU. Follow the same procedure used to pair physical remotes.

Configuring the Add-on

Below is a numbered list of steps to make the basic settings of the add-on.

Configuring the add-on — Connecting to the add-on

  1. After connecting, the add-on automatically starts a WiFi access point. The WiFi status LED then blinks once per second (see Hardware revisions).

    Note: as long as the add-on is not yet connected to your WiFi network, the access point stays active. Once the add-on is connected, the access point automatically switches off after the configured time (15 minutes by default). This time can be changed in the settings.

  2. Connect your phone, tablet or computer to the add-on's WiFi network:

    • Network name (SSID): nrg-itho-XXXX (the last 4 characters are unique per add-on)
    • Password: password

  3. Open a browser and go to: http://nrg-itho-XXXX.local (replace XXXX with the 4 characters from the network name) Doesn't work (e.g. on Android)? Then go to http://192.168.4.1

Configuring the add-on — Setup Wizard

From firmware version 3.0 onward, a Setup Wizard automatically starts and guides you through the configuration in a number of steps:

Step 1 — WiFi

Enter the name (SSID) and password of your own WiFi network. Optionally you can set a custom hostname. Click Connect and wait until the connection is confirmed. Note the IP address that is shown — you need it to reach the add-on later from your own network.

Step 2 — Device

The wizard automatically detects which type of Itho device is connected (e.g. CVE-Silent, HRU 350, DemandFlow) and applies the most common default settings. For devices without an I2C connection (e.g. the HRU 400), the option to activate RF standalone mode is offered.

Step 3 — RF (skipped if no CC1101 RF module is present)

Here you configure the RF remotes. You can pair (join) a remote with the Itho device, or skip this step and set it up later via the "RF Devices" menu.

Working in RF-standalone mode (a device without I2C, for example the HRU 400)? Then this is the moment to pair an emulated RFT CO2 remote with the Itho — you then use it to control the device and read out its status.

Step 4 — MQTT (optional)

Enter the details of your MQTT server if you want to connect the add-on to Home Assistant, Domoticz or another home automation platform via MQTT. Optionally enable Home Assistant MQTT Auto Discovery so the add-on automatically appears as a device in Home Assistant.

Step 5 — HA Discovery (skipped if MQTT is not enabled)

Configure which sensors and status information are made available to Home Assistant via HA Auto Discovery.

Configuring the add-on — After the wizard

Reconnect your phone/computer to your own WiFi network and open the browser at the IP address from the wizard.

All settings can also be changed afterwards via the web interface. The wizard does not need to be run again.

Usage (Web interface, API)

The Itho unit can now be controlled via the web interface (http://nrg-itho-A1B2.local, replace A1B2), via MQTT or the WebAPI.

Do you want to connect the add-on to home automation via MQTT? Then you need an MQTT server (broker). Note that the web interface and the WebAPI also work without MQTT. If you don't have an MQTT server yet, the link below provides a good example of how to install one on, for example, a Raspberry Pi:

https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/

Controlling the Itho

There are several ways to control the Itho and change its settings.

For CVE's and the HRU 200 there are 2 ways to control the speed: remote commands (virtual or RF) and the stepless PWM2I2C protocol. For other devices (for example the HRU 350) only the remote commands (virtual remote and/or RF remote) are available. For the HRU 250 and HRU 300 only RF remote commands work. To send RF remote commands the CC1101 RF module must be present on the add-on. Virtual remote commands (where the add-on emulates a physical remote) are sent via the physical I2C connection with the Itho.

What is exactly possible per device is described in the Device-specific information chapter.

More details about the various options and any limitations can be found on the wiki:

https://github.com/arjenhiemstra/ithowifi/wiki/Controlling-the-speed-of-a-fan

Connecting to home automation software

The add-on can be connected to other devices and home automation via MQTT and the WebAPI. The details are described under the Using the API heading below.

For the most commonly used platforms there are ready-made integrations:

  • Home Assistant — MQTT Auto Discovery. If you enable MQTT with Home Assistant MQTT Auto Discovery, the add-on is automatically configured as a device in Home Assistant with a basic configuration. This can be adjusted and extended manually.
  • Home Assistant — separate integrations. In addition, there are two community integrations for Home Assistant:
  • Homey. The Itho Daalderop app in the Homey app store uses the WebAPI (REST); MQTT is not required for it.
  • Homebridge (Apple HomeKit). The community plugin Homebridge Itho Daalderop HUE brings your CVE to Apple HomeKit. It talks to the add-on via the WebAPI or MQTT (MQTT recommended for instant updates) and optionally integrates with Philips Hue.
  • Domoticz and other platforms. Integration is done via MQTT (or the WebAPI).

Using the API (WebAPI and MQTT)

The add-on has two APIs with which you can read out and control the Itho, for example from your own scripts or home automation: a WebAPI (HTTP) and an MQTT API. Both accept the same commands.

The complete and always up-to-date list of endpoints and commands for your firmware version is in the web interface under the API menu (interactive documentation). The underlying OpenAPI specification can also be retrieved directly via http://<add-on>/api/openapi.json.

WebAPI (HTTP)

There are two variants:

  • REST API (v2) — a JSON API under /api/v2/…. A selection of the endpoints:

    • GET /api/v2/deviceinfo — device and firmware information
    • GET /api/v2/ithostatus — all current status values
    • GET /api/v2/speed and GET /api/v2/lastcmd — current speed and last command
    • GET /api/v2/remotes, /api/v2/vremotes and /api/v2/rfstatus — (virtual) remotes and RF status
    • GET and PUT /api/v2/settings — read and change settings
    • POST /api/v2/command — send a command (for example a ventilation level)
    • POST /api/v2/vremote and POST /api/v2/rfremote/command, /co2, /demand, /config — virtual and RF remote commands
    • POST /api/v2/wpu/outside_temp and /api/v2/wpu/manual_control — WPU-specific

  • Legacy API (v1) — a simple read-only API in query style via /api.html, for example:

    • http://<add-on>/api.html?get=ithostatus
    • http://<add-on>/api.html?get=currentspeed (other values: lastcmd, queue, remotesinfo)

    Reading and changing settings has moved to the REST API (GET/PUT /api/v2/settings).

MQTT API

If MQTT is configured, the add-on uses the topics below. The base topic is configurable (default itho):

  • itho/cmd — publish your commands to the add-on here (same set as the WebAPI).
  • itho/cmd/response — the add-on's response to a command.
  • itho/state — the add-on publishes a JSON with all status values here.
  • itho/lwt — the online/offline status of the add-on (Last Will & Testament).

A working example (Node-RED) that publishes to itho/cmd is in the Node-red automation example.

Device-specific information

The add-on automatically detects which Itho device is connected and adapts the available settings and readable status values accordingly. Below is described, per device (group), how it is controlled, which information the add-on reads out and what to watch out for.

In addition to the per-device control described below, the add-on can emulate an RFT CO2 remote for every fan (CVE and HRU) and for DemandFlow. After pairing it with the device, it can be controlled steplessly from 0–100%, in steps of half a percent. This works both with an I2C connection and in RF-standalone mode. Only with the CVE's can this RF communication be less reliable; see the CVE family section below.

Note: which status values and settings are exactly available depends on the model and the firmware version of the Itho device. The web interface and the API page always show the current, complete list for your device. The values below are examples of what a device typically reports.

CVE family (CVE, CVE-Silent, HRU 200)

Models: CVE, CVE-Silent and the HRU 200 (recognized in the web interface as CVE-SilentExtPlus). The CVE ECO2 and CVE-SilentExt are also recognized, but only provide basic status.

Control: these units communicate via the physical I2C connection on the main board. The speed can be controlled in two ways:

  • Remote commands — a virtual remote emulated by the add-on, or a physical/RF remote (RF requires hardware revision 2 with the CC1101 module).
  • PWM2I2C — a stepless protocol for continuous control (0–100%). This is only available on the CVE's and the HRU 200, not on the other devices.

By default the add-on is in PWM2I2C mode; the remote mode can be set via System settings.

Note (models with a built-in CO2 sensor): on CVE-S Optima Inside models with a built-in CO2 sensor, PWM2I2C does not work — the PWM2I2C commands are overruled by the internal CO2 sensor. Use virtual remote control on these models.

What the add-on reads out (among others): ventilation level/setpoint (%), requested and actual speed (rpm), selected mode, error code, startup counter, operating hours, CO2 value (ppm), valve position and presence timer. Newer CVE's have a built-in humidity sensor — see the Temperature/Humidity sensor chapter.

The CVE-Silent additionally reports, among other things, the highest measured CO2 (ppm) and RH (%), the internal humidity (%) and temperature (°C), and absence timers. The HRU 200 has the most extensive set of the family, additionally including filter usage (hours), outside and exhaust temperature, average outlet temperature, bypass mode and position, and the maximum CO2/RH levels.

Note (RF with CVE's): on the CVE's the antennas of the add-on and the unit are close together. This can cause communication problems with RF control (such as an emulated RFT CO2 remote). On the CVE's, therefore, preferably use I2C control (virtual remote or PWM2I2C).

HRU heat recovery via I2C (HRU 350, HRU ECO-fan)

Models: HRU 350 and HRU ECO-fan.

Control: via the I2C connection, with remote commands (virtual remote or RF). The stepless PWM2I2C protocol is not available on these models — only the remote modes/commands.

What the add-on reads out (among others): requested ventilation level (%), balance (%), supply and exhaust fan (both requested and actual speed), supply, exhaust, room and outside temperature (°C), valve and bypass position, frost and boiler timers, filter counter, global fault code, current mode, highest measured CO2 (ppm) and RH (%), air quality (%) and the remaining override timer. The HRU ECO-fan reports a comparable set around supply/exhaust, temperatures, bypass and filter usage.

DuoZone: HRU units with two zones (DuoZone) are recognized; the zone data appears on the RF Status page of the web interface (and via GET /api/v2/rfstatus).

HRU 250 / HRU 300

Control: these models are controlled and read out exclusively via RF (CC1101) — the Virtual Remote option does not work here. An RF remote must therefore be paired from the add-on.

Special hardware: an adapter board and a PCI-e splitter cable are required. The physical installation is described in the Additional information for the HRU250 and HRU300 chapter. On some revisions of the HRU 300 the unit may supply too little power; in that case, connect a USB power supply to the add-on.

What the add-on reads out (among others): outside and mixed-air temperature (°C), supply and exhaust airflow (m³/h), inlet, exhaust and blown-out air temperature (°C), relative and absolute fan speed (%), the inbound and outbound mass flow (kg/h), bypass position (%), desired inlet temperature, extensive frost data, motor speed (rpm), the highest measured RH/CO2 and the fan's current consumption (mA).

Devices without I2C — RF standalone (e.g. HRU 400)

Some units (for example the HRU 400) have no I2C connection usable by the add-on. For these there is RF standalone mode: the add-on skips I2C entirely and works only via RF (CC1101).

  • Activating: the Setup Wizard offers this for devices without I2C; later it can also be done via System settings.
  • The add-on can emulate an RFT CO2 remote. After it is paired with the HRU, the HRU can be controlled steplessly from 0–100% in steps of half a percent.
  • With a paired, emulated RFT CO2 remote, the status (such as ventilation level and temperatures) can be requested periodically.

This mode requires a CC1101 RF module (hardware revision 2).

DemandFlow

Control: via the I2C connection. DemandFlow is a demand-driven ventilation system with multiple rooms; control and read-out go via the web interface, MQTT and the WebAPI.

What the add-on reads out (among others): operating status and mode, relative humidity per bathroom (%), exhaust fan (%), CO2 in the plenum (ppm) plus the calculated CO2 per room (kitchen, toilet, living room, bedrooms, etc.), the calculated valve/flap positions and the calculated airflow per room (m³/h), and the error code.

AutoTemp

Models: AutoTemp and AutoTemp Basic.

Control: via the I2C connection. AutoTemp is a zone control system (per room), for example for underfloor heating; control and read-out via the web interface, MQTT and the WebAPI.

What the add-on reads out (among others): mode, condition and error code, and per room (up to 12 rooms) the measured temperature, the setpoint and the delivered power (% and kW), plus the valve positions per manifold/zone.

WPU (heat pump)

The WPU is a heat pump (referred to in the firmware as Heatpump), not a ventilation device. It has by far the most extensive set of readable values.

Control: via the I2C connection; read-out and settings via the web interface, MQTT and the WebAPI.

What the add-on reads out (among others): a large number of temperatures (outside, boiler top/bottom, evaporator, suction and compressed gas, liquid, source in/out, CV supply and return, °C), CV pressure (bar), the current consumption of the compressor and the electric element (A), pump speeds for CV, source and boiler (%), valve positions, the status of compressor/element/trickle heating, various timers and an error code with detailed error bytes.

The error bytes are shown as raw values; a translation table to descriptions is not included in the add-on. Consult the Itho documentation for their meaning.

Other recognized devices

The add-on also recognizes various other Itho devices by name (such as Air curtain, LoadBoiler, GGBB, CO2 relay, OLB, RF+, Extended (Plus), AreaFlow and RF_CO2). For these, the add-on shows basic information, but (as yet) no extensive settings or status list.

Temperature/Humidity sensor

New Itho CVE units come standard with a humidity sensor. The add-on can read out this sensor.

CVE PCB with humidity sensor

Older Itho models without a humidity sensor can, with some tweaker skills, also be equipped with a temperature/humidity sensor.

The connections of the humidity sensor are as follows, and the corresponding connections on the add-on board are indicated with red markings and labels.
Humidity sensor pinout diagram Add-on PCB with SCL/SDA/3v3/GND marking

Here you can find an example of a tweaker who did this successfully:

https://gathering.tweakers.net/forum/list_message/66500576#66500576

Virtual Remote

The add-on can present itself as one or more virtual remotes. A virtual remote emulates a physical remote entirely in software and controls the Itho directly over the I2C connection (the wired connection on the main board) — so no CC1101 RF module is required.

Which devices? Virtual remotes work with the I2C-connected ventilation devices, such as the CVE family, the HRU 350 and the HRU ECO. Most fan devices benefit from at least one virtual remote for control. They do not work with the HRU 250, HRU 300 and HRU 400, which are controlled exclusively via RF (see RF Module).

Pairing. Like a physical remote, a virtual remote must first be joined to the Itho. The add-on can send a join command automatically (the Send join command option, on the next power-on).

Difference from an emulated RF remote. A virtual remote communicates with the Itho over the wired I2C connection; an emulated RF remote communicates wirelessly via the CC1101 module (868 MHz), just like a physical remote. Use a virtual remote for devices with an I2C connection, and an emulated RF remote for devices that only work via RF (HRU 250/300/400) or to emulate wireless sensors (such as RFT CO2).

RF Module

RF remote support is only available from hardware revision 2 onward.

The CC1101 module can receive and send the RF signals of Itho remotes. The most commonly sold Itho remotes are supported.

Moving an existing remote to the add-on. An existing physical remote can be moved to the add-on, so the add-on receives that remote's RF commands and translates them to the Itho. The remote is unpaired from the Itho and paired with the add-on, following the procedure below.

Note: handling the RF commands of existing remotes via the add-on is not available for the HRU 250, HRU 300 and HRU 400. Monitoring RF communication is possible, however. Therefore, leave existing RF remotes paired with the Itho and pair the add-on as an additional remote with your HRU.

  1. Unlearn the remote by sending a leave command within the first 2 minutes after powering on the Itho unit (on the remote you do this by pressing all 4 buttons simultaneously);
  2. If you have not already done so, configure the add-on module further and (last) activate the RF module under the "System settings" menu;
  3. The add-on reboots;
  4. If the RF module is correctly detected, the option to manage Itho remotes appears in the same menu. Only add remotes after the Itho unit is out of learn/leave mode (so at least 2 minutes after powering on), otherwise the remote will be paired with the Itho again;
  5. Put the add-on in learn/leave mode (via the web interface);
  6. Send a learn command with your remote (usually press 2 diagonally opposite buttons simultaneously; otherwise see the manual of the specific remote);
  7. If all goes well, your remote ID now appears in the first free position (see the image below). If it still does not succeed after several attempts, the remote may not (yet) be supported. In that case, contact support.

RF Remotes setup screenshot

The add-on as an emulated RF remote. The add-on can also present itself as an emulated RF remote: via the CC1101 module it behaves wirelessly like an Itho remote. With the Remote function set to Send, the add-on sends speed and timer commands to the Itho over the air. This is used for devices without a usable I2C connection (such as the HRU 250, HRU 300 and HRU 400) and to emulate, for example, an RFT CO2 sensor.

Before an emulated RF remote works, it must be joined to the Itho once — just like a physical remote. Put the Itho in its pairing/learn mode (see your Itho's manual) and start the join with the blue join button next to the relevant remote on the RF devices page. After that, the add-on can be used like a real physical remote.

Note: There is a debug option to make RF commands visible in the web interface. Set one of the following levels on the Syslog page, under RF Debug log level:

  • Level 1: shows all recognized Itho remote commands incl. remote ID
  • Level 2: shows all RF packets coming from a configured remote (see https://github.com/arjenhiemstra/ithowifi/tree/master/remotes for more details on how to use this)
  • Level 3: shows all RF packets that are processed (this probably includes a lot of non-Itho-related packets)
  • Level 0: turns the debug option off again

The RF log appears on the Syslog page once the first RF command has been received.

RF debug log screenshot

Updating firmware

You can easily update the add-on's firmware via the web interface.

  1. Open the web interface and go to the Update menu.
  2. Choose which firmware you want to install:
    • Stable — the recommended, stable version.
    • Beta — the newest test version with the latest features (may still contain bugs).
  3. Click the Install button.
  4. The add-on automatically retrieves the chosen firmware from GitHub and installs it. Follow the progress on the page; once the update is done, the add-on automatically reboots.

With a normal update your settings are preserved. Only a factory reset erases the configuration (see Resetting the module).

Progress in Home Assistant. Both Home Assistant integrations — the REST and the MQTT one — show the add-on as an update entity; during an update the progress is shown as a progress bar.

Uploading a firmware file yourself. If the automatic retrieval does not work (for example without an internet connection), you can also manually upload a .bin firmware file on the Update page. The same can be done via the emergency firmware after a failsafe boot (see Resetting the module).

Resetting the module

Fail safe boot / module factory reset

Should it unexpectedly happen that the module is no longer reachable due to an incorrect configuration, it is possible to boot the module in fail safe mode. This formats the file system with the configuration files, and the module starts a simplified web interface with which it is possible to flash new firmware.

The procedure for this reset is as follows:

  1. press the reset button
  2. wait until the WiFi status LED starts blinking rapidly (2x per sec)
  3. then, within 2 sec, press the "Fail save" (on some revisions "default") button
  4. shortly after, the WiFi LED will start blinking once per second
  5. If you do not want to flash new firmware, skip this step. The add-on has now started an access point with a simplified "emergency" firmware. With this, only new firmware can be flashed. The web page can be reached at the following address: http://192.168.4.1/update Uploading new firmware can take a minute; wait calmly until the page refreshes and shows the result.
  6. press the reset button

After this, all settings are erased and the add-on will start in factory default mode.

There is also a YouTube video available that shows this procedure: https://youtu.be/3sWclzq73n4

This method is only available when using 'official' firmware, or firmware based on it.

Hardware revisions up to 2.5 (see the back of the add-on):

To activate this mode for hardware revisions up to version 2.5, a different procedure must be followed:

Connect the two metal pads labelled 'failsafe' on the board to each other. This is easiest with a soldering iron and a bit of solder, or by connecting the pads with, for example, a screwdriver.

When powering on the Itho with the add-on installed, the add-on will perform the fail save procedure and remove all settings. New firmware can optionally also be loaded as described earlier.

After this procedure, remove any solder connection that is present, and put the module back into use as described in this manual.

Hmmm… where do I find more information?

There is an enormous amount of useful information on the wiki: https://github.com/arjenhiemstra/ithowifi/wiki It is for users and by users. Feel free to make changes here too.

On tweakers.net there is a thread on the forum about this add-on. It also contains more information about using this add-on in combination with e.g. Home Assistant, Domoticz and other systems.

You can also go there for questions. The link is: https://gathering.tweakers.net/forum/list_messages/1976492/0

For further questions, feedback and code changes, you can get in touch via contact@nrgwatch.nl or https://www.github.com/arjenhiemstra/ithowifi.

Hardware revisions

Images may differ slightly from the product you received; the operation is identical.

Hardware revision 1:

Hardware revision 1 — Status LED, WiFi LED, connection to Itho board

Hardware revision 2 (newer revisions with fail safe button):

Hardware revision 2 with fail safe button

Hardware revision 2 (older revisions with failsafe solder option):

Hardware revision 2 with failsafe solder option

Installation example

Installation header for the add-on in the red circle. Depending on the production date of the Itho box, the board may look slightly different.

Itho main board with installation header circled in red

Add-on correctly installed:

Add-on correctly installed on the main board

Node-red automation example

Below is a Node-RED example:

[{"id":"78e45008.cda2f","type":"mqtt out","z":"79360772.4553e8","name":"itho","topic":"itho/cmd","qos":"0","retain":"true","broker":"b4eed736.102278","x":430,"y":1000,"wires":[]},{"id":"98cc2161.c3896","type":"inject","z":"79360772.4553e8","name":"itho level 127","topic":"","payload":"127","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":170,"y":1000,"wires":[["78e45008.cda2f"]]},{"id":"5a4ffa98.c88454","type":"inject","z":"79360772.4553e8","name":"itho level 254","topic":"","payload":"254","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":170,"y":1060,"wires":[["78e45008.cda2f"]]},{"id":"1e824b95.a04104","type":"inject","z":"79360772.4553e8","name":"itho level 0","topic":"","payload":"0","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":160,"y":940,"wires":[["78e45008.cda2f"]]},{"id":"b4eed736.102278","type":"mqtt-broker","z":"","name":"MQTT Server","broker":"192.168.1.2","port":"1883","clientid":"","usetls":false,"compatmode":false,"keepalive":"60","cleansession":true,"birthTopic":"","birthQos":"0","birthPayload":"","closeTopic":"","closeQos":"0","closePayload":"","willTopic":"","willQos":"0","willPayload":""}]

Supported remotes

Itho remotes that have been tested working:

Overview of Itho Daalderop RFT transmitters