Handleiding

Overzicht van de web-app

De OpenQuatt web-app is de lokale bedienings- en instellingenpagina van je OpenQuatt-module. Zodra de controller online is, is dit de eerste plek waar je naartoe gaat: open http://openquatt.local en rond Quick Start af. Home Assistant komt eventueel daarna.

Openen

Probeer eerst:

http://openquatt.local

Lukt dat niet, zoek dan het IP-adres van OpenQuatt in je router of in Home Assistant en open:

http://<ip-adres>

De web-app draait lokaal op je eigen netwerk. Je gebruikt dus geen cloudaccount en hoeft niets externs open te zetten.

Wil je de interface eerst rustig bekijken zonder echte hardware, open dan de web-app demo op GitHub Pages. Die gebruikt dezelfde look-and-feel in mockmodus.

Taal kiezen

De web-app is volledig beschikbaar in het Nederlands en Engels. Open rechtsboven het paneel Weergave en systeem en kies onder Taal / Language voor Nederlands of English. De keuze wordt lokaal in de browser bewaard en blijft na herladen en een controllerherstart actief. Zonder opgeslagen keuze blijft Nederlands de standaardtaal.

De taalkeuze vertaalt de interface, meldingen, statussen en datum-/getalopmaak. Technische firmwarewaarden, entitynamen en API-/MQTT-waarden blijven ongewijzigd zodat koppelingen en backupbestanden compatibel blijven.

Thema kiezen

In hetzelfde paneel kies je onder Uiterlijk en overzicht voor Automatisch, Licht of Donker. Automatisch volgt de licht- of donkerinstelling van je apparaat en wisselt direct mee wanneer die verandert. De keuze wordt lokaal in de browser bewaard; zonder opgeslagen keuze staat het thema op Automatisch.

Hoofdschermen

De web-app heeft zes hoofdschermen.

SchermGebruik
OverzichtLive zien wat OpenQuatt nu doet en of de belangrijkste waarden logisch zijn.
EnergieVermogen, energie, COP en EER bekijken.
GrafiekenOnder Resultaten opgeslagen energie- en resultaathistorie over een langere periode bekijken. Onder Diagnose live waarden en korte trendhistorie naast elkaar bekijken om gedrag te onderzoeken.
LerenMeetvoortgang, dagmetingen en het woningmodel bekijken.
BeslislogTerugzien welke regelbeslissingen OpenQuatt nam en waarom. Deze functie is nog beta.
InstellingenOpenQuatt configureren, bijwerken en beheren.

Voor dagelijks kijken is Overzicht meestal genoeg. Ga pas naar Instellingen als je bewust iets wilt veranderen.

In de Beslislog staat de nieuwste melding bovenaan, met seconden in het tijdstip. Een startverloop bundelt de gelogde voorbereiding, startopdracht en compressorbevestiging. Klik erop om de stappen te zien; onder de technische details blijven alle meldingen en CM-overgangen beschikbaar. Ontbrekende voorbereiding of bevestiging wordt niet ingevuld. Start- en stopverlopen verschijnen beide als periode, met begin- en eindtijd op afzonderlijke regels. Ook een stopverloop bundelt de stopopdracht, compressorbevestiging, bijbehorende naloop en bewezen herstartpauze. De stappen behouden hun werkelijke volgorde: naloop kan al vóór de stopopdracht beginnen. Bij onduidelijke Duo-toewijzing blijven meldingen apart staan. Storingen en vereiste resets blijven zelfstandige meldingen met hun oorspronkelijke ernst. Routinematige CM-overgangen staan bij de technische details; een aparte rolkeuze krijgt gewone taal. Het detailpaneel toont de concrete uitleg en alleen een vervolgstap als die iets toevoegt, zonder vaste herhaling van het label Normaal.

De pompkeuze en koelwaarden bij een oude gebeurtenis volgen het opgeslagen event, niet de actuele draaiuren of live koelwaarden. Niet opgeslagen waarden blijven onbekend. De HP-balken in de grafiek gebruiken compressorbevestigingen; opdrachten en topologiekeuzes bewijzen geen draaien. Bij oudere of onvolledige logs kunnen bevestigde periodes daarom ontbreken. Open periodes lopen tot de logsnapshot. Na 80 tijdlijnmeldingen toont Toon meer de volgende meldingen uit de geladen periode. Olie-retour en ontdooien verschijnen als één periode met de vastgelegde begin- en eindtijd. De afzonderlijke stappen blijven zichtbaar in het detailpaneel. Ontbreekt een grens of is de geschiedenis onderbroken, dan wordt geen complete cyclus of actuele activiteit verondersteld. De uitleg bij olie-retour beschrijft hoe meegevoerde smeerolie terugkomt bij de compressor. Ook ontdooien krijgt uitleg over het doel van de cyclus. Voorverwarming eindigt met afgerond; druk- en buitentemperatuurbegrenzingen eindigen met opgeheven. Zolang voorverwarming of een vermogensbegrenzing actief is, blijft de tijdelijke beperking zichtbaar. Een losse waterpompdiagnose bewijst geen pompdefect. Een afgelopen melding betekent alleen dat deze melding niet meer actief is: overige startvoorwaarden en eventuele vereiste resets blijven gelden. Volgt een startblokkade direct op een bevestigde compressorstop zonder incidenten, dan heet deze wacht op minimale uit-tijd. De uitleg beschrijft de herstartpauze; een niet opgeslagen resterende tijd wordt niet uit actuele instellingen ingevuld. De herstartpauze krijgt één korte zin; aanvullende uitleg staat onder technische details. Nieuwe firmware registreert de minimale uit-tijd als oorzaak met de op dat moment resterende seconden. Dat is een historische waarde, geen afteller. Bij andere blokkades toont de beslislog de gelogde melding of vermeldt zij dat de specifieke oorzaak ontbreekt.

Warmtecapaciteit op het overzicht

Geschatte beschikbare warmtecapaciteit toont bij Power House én Stooklijnregeling het geschatte maximale thermische vermogen van de beschikbare warmtepomp(en). De berekening gebruikt de actuele buiten- en aanvoertemperatuur, het bevestigde warmtepompmodel, de frequentiegrenzen en de elektrische piekgrens. Een geblokkeerde warmtepomp telt niet mee; tijdens ontdooien geldt een modelcorrectie. De waarde kan daardoor veranderen zonder dat de warmtevraag verandert.

Dit is een modelschatting, geen meting van het geleverde vermogen of garantie op het startmoment. Vraagregeling, waterbeveiligingen en startvoorwaarden blijven bepalen wat werkelijk wordt geleverd. Ontbreken benodigde model-, frequentie- of temperatuurgegevens, dan staat er —. 0 W betekent dat de berekening met geldige gegevens geen beschikbare capaciteit vindt. De sensornaam HP capacity (W) blijft gelijk; bij koelen is deze verwarmingsschatting niet beschikbaar.

Wat wil je doen?

OnderwerpHandleiding
OpenQuatt voor het eerst configurerenEerste keer instellen
Comfort en installatie-instellingen aanpassenInstellingen aanpassen
Kiezen welke sensoren en externe waarden de regeling gebruiktBronnen en integraties
Dagmeting, meetkwaliteit en woningmodel volgenLeren
Vermogen, rendement en historie bekijkenEnergie en resultaten
Onverwacht gedrag onderzoeken en gegevens bewarenDiagnose en logboeken
Firmware bijwerken of instellingen veiligstellenUpdates en backups
Kiezen welke gegevens je deeltGegevens delen en privacy
Wachtwoord, Home Assistant-koppeling of Wi-Fi herstellenHerstelpagina gebruiken

Voor normaal gebruik begin je bij Dagelijkse controle. Voor uitleg van comfortkeuzes zie Verwarmen en comfort en Koelen.

Bij problemen

Ga naar Problemen oplossen. Voor een eerste Home Assistant-koppeling zie OpenQuatt koppelen.