MQTT inputbronnen

koelingsdauwpunt;
buitentemperatuur;
kamertemperatuur;
kamer-setpoint;
aanvoertarget;
warmtetoestemming;
koeltoestemming.

Gebruik voor normale monitoring en bediening bij voorkeur de web-app en, als je die gebruikt, Home Assistant via de native ESPHome API. Voor dezelfde externe bronwaarden zonder MQTT kun je de API-input-entiteiten gebruiken.

De keuze voor gebruiksstatistieken gebruikt aparte outbound-only MQTT-clients om de centrale OpenQuatt-loggingserver te bereiken. De huidige standaardconfiguratie gebruikt poort 1883 zonder TLS. Deze clients delen geen entiteiten, discovery-berichten of reguliere logs en gebruiken niet de brokerconfiguratie van de MQTT inputbronnen. Het uurbericht vermeldt alleen of MQTT inputbronnen als geheel aanstaan. Na een echte firmwarecrash kan daarnaast het begrensde technische ESPHome-crashrapport worden gepubliceerd. Brokergegevens, wifi-netwerknaam, wifi-wachtwoord, gebruikersnamen, andere wachtwoorden, topics en ontvangen waarden worden nooit meegestuurd. Zoals bij iedere internetverbinding is het bron-IP-adres technisch zichtbaar voor de loggingserver; OpenQuatt slaat dit IP-adres niet op.

Het crashbericht gebruikt QoS 1 en retain op openquatt/devices/<installation-id>/crash. Het topic bevat bewust alleen de laatst bekende crash; een volgende crash vervangt de vorige. Na uitschakelen van gebruiksstatistieken wist OpenQuatt dit retained topic met een lege retained payload zodra de broker bereikbaar is. De payload bevat de bronrepository, volledige commit-SHA, het exacte buildtarget, ESPHome- en firmwareversie, buildtijd en volledige ELF-SHA256. Een opnieuw gebouwd ELF mag alleen voor symbolisatie worden gebruikt wanneer die SHA256 exact overeenkomt. OpenQuatt bewaart niet standaard bij iedere build een ELF-bestand. Zie ook Retained crashtelemetrie.

Waar stel je MQTT in?

Open de OpenQuatt web-app en ga naar Instellingen → Bronnen / integraties → MQTT inputbronnen.

Daar stel je de broker in:

MQTT inputbronnen aan of uit;
per MQTT-topic of OpenQuatt dit topic gebruikt;
brokernaam of IP-adres;
poort;
optionele gebruikersnaam en wachtwoord.

Als MQTT inputbronnen uit staan, gebruikt OpenQuatt geen MQTT-bronwaarden en worden de MQTT-sensoren in de web-app niet getoond. Als je een los topic uitzet, bewaart OpenQuatt de brokerconfiguratie en het topic, maar subscribed de firmware niet op dat topic en telt die bron niet mee in de geldigheid.

Topics

De subscribe-topics staan vast en volgen de device-naam:

openquatt/<device_name>/input/cooling/dew_point
openquatt/<device_name>/input/weather/outdoor_temperature
openquatt/<device_name>/input/thermostat/room_temperature
openquatt/<device_name>/input/thermostat/room_setpoint
openquatt/<device_name>/input/heating/supply_target
openquatt/<device_name>/input/thermostat/heating_enable
openquatt/<device_name>/input/thermostat/cooling_enable

Bij de standaard device-naam is dat meestal:

openquatt/openquatt/input/cooling/dew_point
openquatt/openquatt/input/weather/outdoor_temperature
openquatt/openquatt/input/thermostat/room_temperature
openquatt/openquatt/input/thermostat/room_setpoint
openquatt/openquatt/input/heating/supply_target
openquatt/openquatt/input/thermostat/heating_enable
openquatt/openquatt/input/thermostat/cooling_enable

Open in dezelfde sectie MQTT sensoren → Details om de uiteindelijke topics te bekijken. Gebruik bij voorkeur die getoonde topics, omdat daar de actuele device-naam al in verwerkt is. In hetzelfde scherm kun je per topic Topic gebruiken uitzetten als je maar een deel van de MQTT-bronnen wilt inzetten.

Payload

Publiceer temperatuurwaarden in graden Celsius. Deze vormen worden geaccepteerd:

15.6
15,6
15.6°C
15.6 °C
{"value":15.6}
{"value":"15,6 °C"}

Gebruik bij voorkeur een punt als decimaalteken, bijvoorbeeld 15.6. Een komma wordt ook geaccepteerd voor systemen die lokale notatie gebruiken.

Publiceer warmtetoestemming en koeltoestemming als boolean. Deze vormen worden geaccepteerd:

true
false
1
0
on
off
yes
no
{"value":true}
{"value":"off"}

Waarden buiten de geldige range worden genegeerd en maken die MQTT-bron ongeldig:

koelingsdauwpunt: -20..35°C;
buitentemperatuur: -40..60°C;
kamertemperatuur: 0..50°C;
kamer-setpoint: 5..35°C;
aanvoertarget: 20..70°C.

Geldigheid

Een geldige MQTT-waarde blijft beperkt geldig. Komt er in die tijd geen nieuwe MQTT-publicatie binnen, dan wordt die MQTT-bron ongeldig en gebruikt OpenQuatt die waarde niet meer.

koelingsdauwpunt: 15 minuten;
buitentemperatuur: 30 minuten;
kamertemperatuur: 10 minuten;
kamer-setpoint: 30 minuten;
aanvoertarget: 15 minuten;
warmtetoestemming: 10 minuten;
koeltoestemming: 10 minuten.

Publiceer daarom periodiek, bijvoorbeeld elke minuut of telkens wanneer de bronwaarde verandert.

Bronselectie

Ga in de web-app naar Instellingen → Bronnen / integraties → Sensorselectie.

Bij Koelingsdauwpunt kies je:

Auto: gebruik de hoogste geldige waarde van Home Assistant, API-invoer en MQTT;
Home Assistant: vereis de Home Assistant-dauwpuntbron;
API input: vereis de API-invoerbron;
MQTT: vereis de MQTT-dauwpuntbron.

In Auto is de hoogste geldige dauwpuntwaarde bewust leidend, omdat die voor koeling de veiligste ondergrens geeft.

Bij Buitentemperatuur gebruikt Auto de laagste geldige waarde uit buitenunit, Home Assistant, API-invoer en MQTT. Dat houdt verwarming en vorstbeveiliging conservatief. Bij Kamertemperatuur en Kamer setpoint kun je MQTT of API input expliciet als bron kiezen.

Bij Aanvoertarget is Heating curve de standaard. Kies je MQTT, dan gebruikt de stooklijnregeling jouw aanvoertemperatuur in plaats van het eigen stooklijntarget (inclusief kamertrim), zolang die geldig is. Verloopt de waarde, dan valt de regeling terug op de stooklijn. Zie Water Temperature Control.

Kies je MQTT expliciet als buitentemperatuurbron, dan is die bron na een (her)start pas geldig zodra OpenQuatt een nieuwe live publicatie ontvangt. Tot die tijd ontbreekt de buitentemperatuur en kan de regeling naar CM98 (antivriescirculatie) gaan. De wachttijd hangt af van het publicatie-interval van de zender. Overweeg daarom Auto; dan kan OpenQuatt tijdens het wachten een andere geldige buitentemperatuurbron gebruiken.

Bij Warmtetoestemming en Koeltoestemming kun je MQTT ook expliciet als bron kiezen. Een MQTT-enable telt alleen mee als de waarde recent en geldig is. Handmatige koeltoestemming blijft daarnaast een override.

Voorbeeld

Met mosquitto_pub:

mosquitto_pub -h mqtt.local -t openquatt/openquatt/input/cooling/dew_point -m '15.6'

Met JSON:

mosquitto_pub -h mqtt.local -t openquatt/openquatt/input/cooling/dew_point -m '{"value":15.6}'

Voor warmtetoestemming:

mosquitto_pub -h mqtt.local -t openquatt/openquatt/input/thermostat/heating_enable -m 'true'