OpenQuatt - open-source besturing voor Quatt warmtepompen
/f/image/IdJxPDpH9TsK3osVw0pAtPru.png?f=fotoalbum_large)
Inleiding
OpenQuatt is open-source software voor Quatt warmtepompen. Het draait op een losse ESP-module en kan de rol van de standaard Quatt-controller (CiC) overnemen.Het doel is eenvoudig: meer inzicht, meer eigen instelmogelijkheden en minder afhankelijkheid van externe diensten.
Status: OpenQuatt is experimenteel, maar actief in ontwikkeling. Op dit moment is er ondersteuning voor Quatt Single en Duo installaties, voor V1 en V1.5.
Let op: OpenQuatt is geen officieel Quatt-product. Gebruik is op eigen verantwoordelijkheid. Test daarom rustig en zorg altijd dat je terug kunt naar je oorspronkelijke situatie.
Waarom OpenQuatt?
- Open source: de werking is zichtbaar en controleerbaar
- Lokaal: geen verplichte cloud of gesloten app
- Meer inzicht: je ziet beter wat je installatie echt doet
- Meer vrijheid: instellingen en metingen zijn beter aan te passen aan jouw woning
- Praktisch: koppeling met Home Assistant is goed mogelijk
Voor wie is dit?
- Voor gebruikers van een Quatt Single of Duo die meer grip willen op hun installatie
- Voor mensen die lokaal willen meten en regelen
- Voor Tweakers die bewust willen testen en zelf verantwoordelijkheid willen nemen voor hun opstelling
Wat kun je ermee?
- De verwarming rustiger en slimmer laten regelen
- Meer inzicht krijgen in verbruik, draaitijden en prestaties
- Eigen meetwaarden gebruiken, bijvoorbeeld uit Home Assistant of via extra temperatuursensoren
- De samenwerking tussen warmtepomp, watercirculatie en eventueel cv-ketel beter afstemmen
- OpenQuatt werkt lokaal; opslag en historie kun je zelf regelen, bijvoorbeeld via Home Assistant
Home Assistant
OpenQuatt werkt goed samen met Home Assistant. Dat is software waarmee je apparaten in huis lokaal kunt beheren en gegevens overzichtelijk kunt bekijken.Home Assistant is niet verplicht, maar wel sterk aan te raden. Voor eerste controle, instellingen, grafieken en dashboards werkt het simpelweg het prettigst.
Ondersteunde hardware
OpenQuatt ondersteunt momenteel twee ESP-modules:We houden de focus bewust op deze twee hardwaremodules, zodat installatie, documentatie en ondersteuning overzichtelijk blijven.Veiligheid en aandachtspunten
- OpenQuatt bewaakt basiszaken zoals watercirculatie en geldige meetwaarden
- Je moet altijd kunnen terugvallen op je oorspronkelijke situatie
- Verander instellingen stap voor stap, niet alles tegelijk
- Neem de tijd om na iedere wijziging te kijken of de installatie logisch blijft reageren
Snelle start
Deze korte handleiding is bedoeld voor gebruikers die OpenQuatt willen installeren zonder zelf firmware te bouwen. De uitgebreidere uitleg staat in de README op GitHub en in de uitgebreide startgids.Wat heb je nodig?
- Een Quatt Single of Duo
- Een ondersteunde ESP-module
- Een USB-datakabel
- Toegang tot je wifi-netwerk
- Home Assistant (aanbevolen)
- Een terugvaloptie: zorg dat je altijd terug kunt naar je oorspronkelijke situatie
Stap 1: Controleer wat je hebt
Bepaal eerst of je een Single of Duo installatie hebt en welke ESP-module je gaat gebruiken. Dat is belangrijk, omdat je daarna de juiste firmware moet kiezen.Lees bij twijfel eerst de README. Daar staat ook de meest actuele documentatie.
Stap 2: Kies de juiste firmware
Ga naar de laatste release en download het bestand dat past bij jouw installatie:- Duo + Waveshare: openquatt-duo-waveshare.firmware.factory.bin
- Duo + Heatpump Listener: openquatt-duo-heatpump-listener.firmware.factory.bin
- Single + Waveshare: openquatt-single-waveshare.firmware.factory.bin
- Single + Heatpump Listener: openquatt-single-heatpump-listener.firmware.factory.bin
Wil je later zelf dingen aanpassen of zelf bouwen, kijk dan in de startgids.
Stap 3: Flash de ESP-module via USB
- Open web.esphome.io
- Sluit de ESP-module met een USB-datakabel aan op je computer
- Kies voor handmatige installatie
- Selecteer het gedownloade .firmware.factory.bin-bestand
- Wacht tot het flashen klaar is en de module opnieuw opstart
Stap 4: Stel wifi in
Na de eerste start maakt OpenQuatt tijdelijk een eigen wifi-netwerk aan:- Netwerknaam: OpenQuatt
- Wachtwoord: openquatt
Stap 5: Sluit de module aan op je installatie
De exacte aansluiting verschilt per hardwaremodule en per installatie. Volg daarvoor de uitleg in de README en de startgids.Neem hier de tijd voor. Dit is niet het deel om op goed geluk te doen. Controleer rustig of alles klopt voordat je verder gaat.
Stap 6: Voeg OpenQuatt toe aan Home Assistant
Als de module op je netwerk zit, wordt hij normaal automatisch gevonden door Home Assistant.- Voeg het gevonden OpenQuatt-apparaat toe
- Controleer of het apparaat online is
- Controleer of de firmwareversie zichtbaar is
- Controleer of de basisgegevens binnenkomen
- Controleer of de regelstatus een geldige waarde heeft
Stap 7: Laad het juiste dashboard
Voor een bruikbaar overzicht kun je daarna het bijpassende dashboard importeren:De uitleg daarvoor staat in de dashboard-handleiding.Stap 8: Eerste controle vóór dagelijks gebruik
Begin rustig en controleer eerst of:- de module stabiel online blijft
- meetwaarden blijven verversen
- de installatie logisch reageert
- er geen onbekende of duidelijk foute waarden blijven staan
Links
Heb je vragen over OpenQuatt, je installatie, of wil je bijdragen? Laat het weten 🔥Oude Topic Start
En hier het bericht dat de eerste tests zijn geslaagd met een eigen aansturing van de Quatt met de module van @leejoow 🥳TeslaNerd schreef op dinsdag 20 januari 2026 @ 16:24:
[...]
Korte update uit het testhok voor de aansturing van de Quatt met de module van @leejoow.
Voordat ik een eigen aansturing van de Quatt kan testen heb ik vandaag een pretest gedaan om te zien of de flow meter van mijn Quatt V1 data blijft doorsturen naar de CiC en blijft doorkomen in Home Assistant via de CiC-JSON als ik de modbus-verbinding tussen de CiC en de Quatt buitenunit verbreek.
Ik heb dat live getest met de Quatt draaiend door een van de modbus-verbindingen van de CiC los te maken. Gevolg was dat mijn Quatt stopte met verwarmen maar dat de waterpomp van de Quatt bleef doordraaien. Omdat de data van de flowmeter bij de Quatt V1 niet via de modbus bij de CiC binnenkomt maar met een eigen aansluiting kon ik de flow data in HA zien doorlopen.
De flow zakte wel wat in van 800 l/u naar ca 750 l/u omdat de pump level nu niet meer werd aangestuurd door de CiC.
Daarna heb ik om 15:23 nog een grote radiator dicht en een minuut later weer open gedraaid om te zien dat de flow daar normaal op reageerde.
Na een half uurtje de modbusverbinding met de CiC weer hersteld en het geheel draait weer normaal verder.
@leejoow verwacht deze week een eerste test firmware voor de aansturing via modbus gereed te hebben waarmee ik dan de daadwerkelijke aansturing zal gaan testen.
Wordt vervolgd…
[Afbeelding]
@leejoow heeft vanmiddag een eerste testversie voor OpenQuatt geleverd waarmee zijn module zelfstandig de Quatt aanstuurt:
- zelf de working mode kiezen: standby / koelen / verwarmen
- zelf de waterpomp aan/uit zetten
- zelf het pomp level instellen voor iets anders dan 800 l/u
- zelf de compressorfrequentie instellen
Met de feedback via modbus van de sensoren in de buitenunit en van de JSON-data van de CiC voor thermostaat, ketel en flowmeter (Quatt V1) kan de OpenQuatt besturing verder worden ingericht in Home Assistant.
Voor de techneuten hieronder een sample van de debug log:
[ Voor 83% gewijzigd door jj85 op 07-03-2026 20:39 . Reden: Uitgebreide OpenQuatt TS ]
120m2 bovenwoning met 6 radiatoren en vvw in de badkamer. Intergas HRE 36/30A met Honeywell Round Modulation en Quatt hybrid op het dak van de dakkapel
:strip_exif()/f/image/phQ6g2rimXlj12V29ZswZAZZ.jpg?f=fotoalbum_large)
/f/image/cF20H6dsxYDRcJh1vZ3C6jOC.png?f=fotoalbum_large)
/f/image/RCKYJjcA6obo9OPoxBrjXArI.png?f=fotoalbum_large)
/f/image/lm8A0hDRIEGCi8OPfZZCO5zV.png?f=fotoalbum_large)
:strip_exif()/f/image/lBvMp8hXJDUqOEVlw6EiR9kx.jpg?f=fotoalbum_large)
/f/image/HXYXkWBI6rswgPrkyJZqmvg6.png?f=fotoalbum_large)
/f/image/LHsfWwb3ZCXIRAUqt1CfLEYv.png?f=fotoalbum_large)
/f/image/E2l2MlfzQsbaU4HksDITd28x.png?f=fotoalbum_large)
:strip_exif()/f/image/HoWuS09fKKKjKhwU713XT3Kp.png?f=user_large)
:no_upscale():strip_icc():strip_exif()/f/image/mQf32C3Fr7oBOjHbjWpLU2g2.jpg?f=user_large)
/f/image/RZNUEmOkdYASyuKtIuJWcY7c.png?f=fotoalbum_large)
/f/image/dohTvW21D79ukVdPaOIrDRkI.png?f=fotoalbum_large)
/f/image/Y0qII1jf8g7IV1rYOSRfJLWC.png?f=fotoalbum_large)
/f/image/BQABHOFxVdQ08NvcEWiiIYWR.png?f=fotoalbum_large)
:strip_exif()/f/image/IwbwfAWdMy9XWAVQEk9R5r5A.jpg?f=fotoalbum_large)
:strip_exif()/f/image/orcTlyoNTvn3CxUxilJvxWV3.jpg?f=fotoalbum_large)
:strip_exif()/f/image/wqKX41EfW0qyCoCNK6HtS76B.jpg?f=fotoalbum_large)
:strip_exif()/f/image/Yz0UFwff1Y4G1uAUxMuRFATI.jpg?f=fotoalbum_large)
/f/image/WmEO6bLI5VLBpzLlQvqqJpzS.png?f=fotoalbum_large)
/f/image/psvnuzTT2wJ8dqXcr0RYMupL.png?f=fotoalbum_large)
/f/image/LBB570NjW7A2YXTECuPA8ADv.png?f=fotoalbum_large)
/f/image/MMV4jdKlJ4FOWw0MGvBNThob.png?f=fotoalbum_large)
/f/image/AiSf9GpNz8xoCrC4VJaig7B4.png?f=fotoalbum_large)
/f/image/jjDCTMznAqjJ7A0OxpmZJn5h.png?f=fotoalbum_large)
:strip_exif()/f/image/ppFDKHAKeITO6iSmuBm8X0gq.png?f=user_large)
:strip_exif()/f/image/Ombwa5iCxXEgSKHm6qK6iYvH.jpg?f=fotoalbum_large)