Installatie en ingebruikname

Heb je de Heatpump Controller Q-edition, gebruik dan bij voorkeur de doorlopende handleiding Heatpump Controller Q-edition aansluiten en in gebruik nemen.

OpenQuatt is een open-sourceproject op best-effortbasis, zonder gegarandeerde responstijd of individuele ondersteuning. Voor gebruiksvragen en hulp bij diagnose kun je terecht in het OpenQuatt Discord-kanaal. Een reproduceerbare bug meld je als GitHub-issue.

Installatieroute

Voor een eerste installatie gebruik je de web installer uit de README. Daarmee stel je bij een voorgeïnstalleerde module alleen Wi-Fi in, of flash je zelf de juiste firmware. Bij Ethernet sluit je na het flashen de netwerkkabel aan.

Voor een voorgeïnstalleerde Wi-Fi-module is de route:

1. installer openen;

2. module via USB aansluiten;

3. Alleen Wi-Fi instellen gebruiken;

4. openquatt.local openen;

5. Quick Start afronden;

6. Home Assistant-dashboard importeren.

Als je zelf firmware flasht, is de route:

1. installer openen;

2. opstelling en hardware kiezen;

3. verbinding kiezen;

4. firmware flashen;

5. netwerk verbinden;

6. openquatt.local openen;

7. Quick Start afronden;

8. Home Assistant-dashboard importeren.

Gebruik Handmatige installatie alleen als fallback.

Wat zie je onderweg?

Benodigdheden

• een ondersteund ESP32-bord:

  • Electropaultje Heatpump Controller Q-edition, aanbevolen voor nieuwe installaties

  • Waveshare ESP32-S3-Relay-1CH

  • Electropaultje Heatpump Listener

• een USB-kabel voor de eerste flash

• een werkend Wi-Fi-netwerk of, bij Heatpump Controller Q Ethernet, een aangesloten netwerkkabel

• Chrome of Edge op desktop voor de web installer

• Home Assistant is optioneel voor OpenQuatt zelf en aanbevolen voor dashboards en automatisering

Kies het juiste profiel in de installer

Kies in de installer altijd exact de combinatie van je opstelling, hardware en verbinding. Voor nieuwe installaties is de Heatpump Controller Q-edition de voorkeursmodule.

OpenQuatt ondersteunt Quatt Hybrid V1, V1.5 en V2. Die versie kies je na het flashen in de Quick Start van de web-app.

Je herkent de generatie aan het model en de sensoraansluiting:

Ethernet is alleen beschikbaar voor de Heatpump Controller Q. ESPHome ondersteunt Wi-Fi en Ethernet niet samen in dezelfde build, dus een Ethernet-installatie heeft geen Wi-Fi fallback of captive portal.

Installatie via de web installer

Let op: OpenQuatt kan gevolgen hebben voor Quatts commerciële garantie. Zie de actuele Quatt-voorwaarden; wettelijke rechten staan daar los van.

Voorgeïnstalleerde module: alleen Wi-Fi instellen

Gebruik deze route als je module al met OpenQuatt is geleverd.

1. Open de OpenQuatt installer.

2. Sluit het ESP32-bord via USB aan.

3. Gebruik Alleen Wi-Fi instellen.

4. Kies de USB-poort van de module.

5. Vul je Wi-Fi-netwerk en wachtwoord in.

6. Open na het verbinden http://openquatt.local.

7. Rond de Quick Start in de web-app af.

8. Voeg het apparaat daarna toe in Home Assistant. Selecteer tijdens het toevoegen nog geen area; ken die pas toe nadat de OpenQuatt-entiteiten zijn aangemaakt.

Zelf firmware flashen

1. Open de OpenQuatt installer.

2. Kies de combinatie die past bij je opstelling, hardware en verbinding.

3. Sluit het ESP32-bord via USB aan.

4. Flash de firmware.

5. Laat bij Wi-Fi het browsertabblad open, zodat de Wi-Fi-configuratie direct daarna kan worden aangeboden. Sluit bij Ethernet na de flash de netwerkkabel aan.

6. Open na de eerste start http://openquatt.local.

7. Rond de Quick Start in de web-app af.

8. Voeg het apparaat daarna toe in Home Assistant. Selecteer tijdens het toevoegen nog geen area; ken die pas toe nadat de OpenQuatt-entiteiten zijn aangemaakt.

Praktisch voor een DS18B20: sluit die sensor bij voorkeur aan voordat OpenQuatt opstart. De 1-Wire sensor wordt tijdens het opstarten gedetecteerd; als je hem later aansluit, moet je het bord eerst herstarten voordat de sensor zichtbaar wordt.

Als de browserflow voor Wi-Fi niet werkt, start een Wi-Fi-build het OpenQuatt fallback access point:

• SSID: OpenQuatt

• wachtwoord: openquatt

Eerste start: openquatt.local

De eerste plek na het flashen is de web-app:

http://openquatt.local

Als die naam niet werkt, zoek dan het IP-adres van OpenQuatt in je router en open http://<ip-adres>.

De web-app toont Quick Start zolang de basisinstellingen nog niet zijn afgerond. Loop die eerst rustig door. Quick Start zet de belangrijkste keuzes klaar:

1. setup: Single of Duo en Wi-Fi of Ethernet;

2. Quatt Hybrid-versie: V1, V1.5 of V2;

3. flowmeting;

4. bron voor kamertemperatuur en kamer-setpoint;

5. ondersteuning door CV-ketel of boiler;

6. verwarmingsstrategie;

7. instellingen voor de gekozen strategie;

8. flowregeling en afstelling;

9. watertemperatuurbeveiliging;

10. stille uren en compressorlimieten;

11. controleren en afronden.

Gebruik daarna pas Home Assistant voor dashboard, dagelijkse controle en optionele dynamische bronselectie.

Zie voor de lokale web-app:

• Web-app gebruiken

Daarna: Home Assistant

Home Assistant ontdekt OpenQuatt meestal automatisch zodra beide op hetzelfde netwerk zitten. Open de melding bij Instellingen -> Apparaten & diensten en kies Configureren. Verschijnt er geen melding, kies dan Integratie toevoegen -> ESPHome en vul openquatt.local of het IP-adres van OpenQuatt in. Voer de ESPHome API-encryptiesleutel in als Home Assistant daarom vraagt.

Zie ook de officiële ESPHome-handleiding: Connecting your device to Home Assistant.

Controleer na Quick Start bij voorkeur in deze volgorde:

1. Het apparaat is online en zichtbaar in Home Assistant.

2. De firmwareversie is zichtbaar.

3. De warmtepompdata ververst.

4. De gekozen meetwaarden lijken logisch:

   • aanvoertemperatuur

   • flow

   • buitentemperatuur

5. CM override staat op Auto.

6. Het juiste dashboard is geïmporteerd.

Zie voor het dashboard:

• Dashboard installeren

• Dashboard gebruiken

Bij problemen

Het apparaat verschijnt niet in Home Assistant

• Controleer of Wi-Fi echt is ingesteld.

• Gebruik je Ethernet, controleer dan of de netwerkkabel is aangesloten en DHCP een IP-adres heeft gegeven.

• Kijk of het apparaat nog op het fallback access point zit.

• Herstart het bord een keer.

Ik zie geen warmtepompgegevens

• Controleer RS485-bekabeling.

• Controleer of het gekozen hardwareprofiel klopt.

• Controleer of je niet per ongeluk een Single-bestand gebruikt op een Duo-opstelling, of andersom.

Waarden zijn zichtbaar, maar lijken onlogisch

Controleer in Home Assistant eerst welke bron is geselecteerd voor flow, buitentemperatuur, kamertemperatuur en setpoint. Kijk pas daarna naar afstelling of tuning.

Een aangesloten DS18B20 verschijnt niet

• Controleer of de sensor op de juiste ds18b20_pin van het gekozen hardwareprofiel zit.

• Herstart OpenQuatt nadat je de sensor hebt aangesloten. Zonder reboot wordt een later aangesloten DS18B20 niet ontdekt.

Het dashboard wil niet importeren

• Gebruik de ruwe YAML-editor in Home Assistant.

• Controleer of je het juiste dashboardbestand voor Single of Duo hebt gekozen.

• Controleer of de OpenQuatt-entity-ID's met openquatt_ beginnen en niet met een area-prefix zoals zolder_openquatt_.

Als de installer niet werkt

Gebruik dan pas de fallbackroute: Handmatige installatie.