Installatie en ingebruikname

Installatieroute

Voor een eerste installatie gebruik je de web installer uit de README. Daarmee flash je de juiste firmware en kun je bij Wi-Fi direct daarna de Wi-Fi-configuratie afronden. Bij Ethernet sluit je na het flashen de netwerkkabel aan.

De route is:

installer openen;
opstelling en hardware kiezen;
verbinding kiezen;
firmware flashen;
netwerk verbinden;
openquatt.local openen;
Quick Start afronden;
Home Assistant-dashboard importeren.

Gebruik Handmatige installatie alleen als fallback.

Wat zie je onderweg?

Moment	Wat zie je?	Volgende actie
Installer	Keuzes voor `Single` of `Duo`, ESP-module en verbinding	Kies de exacte combinatie die bij je hardware past.
ESP Web Tools	Browserdialoog voor verbinden, wissen en flashen	Laat het tabblad bij Wi-Fi open tot de Wi-Fi-configuratie is afgerond. Bij Ethernet sluit je na de flash de netwerkkabel aan.
Web-app	`http://openquatt.local` met Quick Start	Kies Quatt Hybrid V1, V1.5 of V2 en rond de basisinstellingen af.
Home Assistant	ESPHome-apparaat en dashboard	Voeg OpenQuatt toe en importeer daarna het juiste `Single`- of `Duo`-dashboard.

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 voor de web installer
Home Assistant wordt sterk aanbevolen

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.

Opstelling	Hardware	Verbinding	Installerkeuze
Single	Heatpump Controller Q	Wi-Fi	`Single` + `Heatpump Controller Q` + `Wi-Fi`
Duo	Heatpump Controller Q	Wi-Fi	`Duo` + `Heatpump Controller Q` + `Wi-Fi`
Single	Heatpump Controller Q	Ethernet	`Single` + `Heatpump Controller Q` + `Ethernet`
Duo	Heatpump Controller Q	Ethernet	`Duo` + `Heatpump Controller Q` + `Ethernet`
Single	Heatpump Listener	Wi-Fi	`Single` + `Heatpump Listener` + `Wi-Fi`
Duo	Heatpump Listener	Wi-Fi	`Duo` + `Heatpump Listener` + `Wi-Fi`
Single	Waveshare	Wi-Fi	`Single` + `Waveshare` + `Wi-Fi`
Duo	Waveshare	Wi-Fi	`Duo` + `Waveshare` + `Wi-Fi`

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: gebruik van OpenQuatt kan gevolgen hebben voor je Quatt-garantie. De standaard commerciële Quatt-garantie vervalt in principe bij gebruik van externe aansturing zoals OpenQuatt. De wettelijke garantie blijft bestaan, maar een garantieclaim kan daardoor in de praktijk wel ingewikkelder worden.

Open de OpenQuatt installer.
Kies de combinatie die past bij je opstelling, hardware en verbinding.
Sluit het ESP32-bord via USB aan.
Flash de firmware.
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.
Open na de eerste start http://openquatt.local.
Rond de Quick Start in de web-app af.
Voeg het apparaat daarna toe in Home Assistant.

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:

Quatt Hybrid-versie;
verwarmingsstrategie;
instellingen voor de gekozen strategie;
flowregeling;
watertemperatuurbeveiliging;
stille uren;
bevestigen 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

Controleer na Quick Start bij voorkeur in deze volgorde:

Het apparaat is online en zichtbaar in Home Assistant.
De firmwareversie is zichtbaar.
De warmtepompdata ververst.
De gekozen meetwaarden lijken logisch:
- aanvoertemperatuur
- flow
- buitentemperatuur
CM override staat op Auto.
Het juiste dashboard is geïmporteerd.

Zie voor het dashboard:

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.

Als de installer niet werkt

Gebruik dan pas de fallbackroute: Handmatige installatie.