Home Assistant custom integratie die elke minuut het optimale OpenTherm aanvoertemperatuur-setpoint berekent voor een WeHeat-warmtepomp met OpenTherm-aansluiting. Het setpoint wordt via ESPHome op een ESP32-C6 OpenTherm gateway naar de warmtepomp gestuurd.
Dit is een hobbyproject en geen product van WeHeat. Het staat los van de officiële WeHeat-integratie in Home Assistant en kan ernaast draaien.
De berekening combineert klassieke stooklijn-regeling met kamercompensatie, weersvoorspelling (windchill + zon) en dynamische energieprijzen. Een ingebouwd lerend systeem fine-tunet de stooklijn over weken op basis van werkelijke kamer-afwijking.
- Hoe het werkt
- Vereisten
- Installatie
- Architectuur
- Aanpasbare parameters
- Adaptieve stooklijn
- Entiteiten
- Stookgrens (zomerstop)
- Koelen en de status-sensor
- Tips & FAQ
- Licentie
┌──────────────────────────────────────────────────────────────┐
│ Home Assistant (deze integratie) │
│ │
│ buitentemp ──┐ │
│ kamertemp ───┤ │
│ weer-entiteit┼──→ DataUpdateCoordinator (elke 60s) │
│ prijssensor ─┘ ├ stooklijn + kamercompensatie │
│ ├ windchill + zon │
│ ├ prijscorrectie │
│ └ adaptieve offsets (zelflerend) │
│ │
│ t_setpoint ─→ sensor.weheat_opentherm_aanvoersetpoint │
└──────────────────────┬───────────────────────────────────────┘
▼
┌────────────────────┐
│ ESPHome ESP32-C6 │ leest sensor uit HA
│ + OpenTherm shield │ stuurt t_set via OT-bus
└─────────┬──────────┘
▼
┌────────────────────┐
│ WeHeat │
│ warmtepomp │
└────────────────────┘
Eindformule:
T = stooklijn + kamercomp + windchill − zon + prijs
T = clamp(T, T_min, T_max)
- Home Assistant 2024.11 of nieuwer
- WeHeat-warmtepomp met OpenTherm-aansluiting. Gebouwd en getest met een Flint P40; andere WeHeat-modellen met OpenTherm zouden op dezelfde manier moeten werken, maar zijn niet getest
- ESP32-C6 (of een ander OpenTherm-compatibel ESP) met DIYLESS / Ihormelnyk OpenTherm shield
- Een weer-entiteit met uurvoorspelling (Met.no, OpenWeatherMap, KNMI; niet Buienradar) — optioneel maar aanbevolen
- Een dynamische energieprijssensor: Zonneplan, Frank Energie, Tibber, Nordpool, ENTSO-e of een andere met de komende prijzen in een attribuut (zie prijssensoren) — optioneel
- HACS geïnstalleerd
- Open HACS → Integraties
- Klik rechtsboven op het 3-puntsmenu → Custom repositories
- Voeg toe:
- URL:
https://github.com/FutureCow/ha-setpoint-heating - Categorie:
Integration
- URL:
- Zoek op "WeHeat OpenTherm" en klik Download
- Herstart Home Assistant
-
Ga naar Instellingen → Apparaten & diensten → Integratie toevoegen
-
Zoek "WeHeat OpenTherm" en selecteer
-
Doorloop de installatiewizard:
Stap 1 — Sensoren
Veld Verplicht Wat kies je Kamertemperatuursensor ✅ De ruimte die de verwarming het meest bepaalt, meestal de woonkamer. Niet bij een raam, kachel of in de zon. Gebruik dezelfde sensor in de ESPHome-bridge Buitentemperatuursensor ✅ Een stabiele bron: een eigen sensor in de schaduw of een template op de weer-entiteit (zie tips). Niet de buitenvoeler van de WeHeat Weer-entiteit optioneel Voor wind- en zoncorrectie, bv. weather.forecast_home(Met.no). Moet een uurvoorspelling hebben; de wizard weigert een entiteit zonder, zoals BuienradarEnergieprijssensor optioneel Zonneplan, Frank Energie, Tibber, Nordpool of ENTSO-e (zie prijssensoren) Setpoint input_number optioneel Leeg laten — ESPHome leest direct de sensor van de integratie Warmtepomp status-sensor aanbevolen sensor.<warmtepomp>_heat_pumpuit de WeHeat-integratie. Nodig om niet te leren van zon en tapwaterDe sensoren kun je na het instellen niet meer wijzigen, behalve de status-sensor. Wil je een andere sensor, verwijder de integratie dan en voeg haar opnieuw toe.
-
Open daarna Configureren op de integratie en doorloop de 4 stappen: temperatuurinstellingen, stooklijn, geavanceerde correcties en extra sensoren. Stel vooral de stooklijn in: de standaardlijn is een schatting. Ter indicatie bij vloerverwarming: ongeveer 33 °C aanvoer bij −10 °C buiten en 21 °C bij 15 °C. Wordt het te warm of te koud, schuif dan alle punten op; de adaptieve stooklijn doet daarna de fijnafstemming.
Gebruik de meegeleverde YAML als basis. Vul bovenin bij substitutions je eigen entiteiten in.
Let op de entity-ID's. HA maakt ze aan in de taal die HA had toen je de integratie toevoegde. In het Nederlands is dat
sensor.weheat_opentherm_aanvoersetpoint,sensor.weheat_opentherm_actieve_modusenclimate.weheat_opentherm_verwarmingsdoelwit; in het Engelssensor.weheat_opentherm_supply_setpoint,sensor.weheat_opentherm_active_modeenclimate.weheat_opentherm_heating_target. Controleer ze onder Instellingen → Entiteiten.
Belangrijkste regels:
opentherm:
in_pin: GPIO10
out_pin: GPIO11
sync_mode: true
t_set: stooklijn_setpoint # aanvoersetpoint van deze integratie
t_room: kamertemperatuur # gemeten kamertemperatuur
t_room_set: kamer_setpoint # gewenste kamertemperatuur (anders toont de WeHeat -1)
sensor:
- platform: homeassistant
id: stooklijn_setpoint
entity_id: sensor.weheat_opentherm_aanvoersetpoint # ← van deze integratie
filters:
- filter_out: nan # behoud laatste waarde bij verbroken HA-koppeling
- platform: homeassistant
id: kamer_setpoint
entity_id: climate.weheat_opentherm_verwarmingsdoelwit
attribute: temperature
filters:
- filter_out: nanch_enable wordt in de YAML door een switch geschakeld die de actieve modus van de integratie volgt.
Zet in secrets.yaml van ESPHome de namen die de YAML verwacht: wifi_ssid, wifi_password, ap_password, api_key en ota_password. Flash daarna de ESP en voeg het apparaat toe in HA via Instellingen → Apparaten → ESPHome.
Andere hardware? De YAML is gemaakt voor een ESP32-C6-DevKitC-1. Pas bij een ander bord of een andere adapter aan:
| Regel | Nu | Wanneer aanpassen |
|---|---|---|
esp32: board / variant |
esp32-c6-devkitc-1 / esp32c6 |
Ander ESP32-bord |
opentherm: in_pin / out_pin |
GPIO10 / GPIO11 |
Je OpenTherm-adapter zit op andere pinnen |
status_led: pin |
GPIO8 |
Je bord heeft daar geen led; pas de pin aan of haal het blok weg |
Andere warmtepomp of ketel? De OpenTherm-sensoren zijn afgestemd op de Flint P40:
- CV-druk, branderstarts, branderuren en CV-pompuren staan er niet in, want de Flint P40 geeft daar altijd 0. Levert jouw toestel ze wel, zet ze dan terug onder
- platform: openthermalsch_pressure,burner_starts,burner_operation_hoursench_pump_operation_hours. - Het modulatieniveau is bij de Flint alleen 0 of 127, dus aan of uit en geen percentage.
- De temperaturen worden afgerond op 0,1 °C en hooguit eens per 30 seconden doorgestuurd (
throttle_average,round,delta). Zonder die filters komt elke schommeling van 1/256 °C als nieuwe state in de recorder.
De integratie en de Lovelace-kaart gebruiken geen van deze OpenTherm-sensoren.
Voor een compacte dashboard-weergave: ha-weheat-opentherm-card
type: custom:weheat-opentherm-card
entity_prefix: sensor.weheat_opentherm
target_temp_entity: climate.weheat_opentherm_verwarmingsdoelwitMet een SenseCAP Indicator D1 van Seeed Studio heb je een wandscherm voor de thermostaat. Het toont de kamertemperatuur, het doel, het aanvoersetpoint dat naar de warmtepomp gaat en de buitentemperatuur. Met − en + verander je het doel in stappen van 0,5 °C. De boog kleurt naar de status van de warmtepomp: oranje bij heating, wit bij defrosting (ontdooien, bewust niet blauw zodat het niet op koelen lijkt), blauw bij cooling en grijs bij elke andere status.
Weergave van het scherm, nagetekend met de maten en kleuren uit de YAML (geen foto). De pomp verwarmt, dus de boog is oranje.
Gebruik de meegeleverde YAML en vul bovenin bij substitutions in:
| Substitution | Wat |
|---|---|
thermostat_entity |
De climate-entiteit van deze integratie (Nederlands ..._verwarmingsdoelwit, Engels ..._heating_target) |
setpoint_sent_entity |
De sensor "Aanvoersetpoint (naar boiler)" van de bridge uit stap 3 |
pump_status_entity |
De status-sensor van de warmtepomp uit de officiële WeHeat-integratie |
outside_temp_entity |
Een temperatuursensor voor buiten |
thermostat_min / thermostat_max |
Grenzen voor de − en + knoppen |
De secrets hebben dezelfde namen als bij de bridge. De helderheid van het scherm regelt de YAML niet: de knop op de zijkant zet de achtergrondverlichting aan of uit, en een aanraking zet hem op 100 %. Wil je dat hij 's nachts dimt of uitgaat, maak daarvoor dan een automatisering in HA op de entiteit light.<naam>_backlight.
| Module | Bestand | Doel |
|---|---|---|
| Stooklijn | heating_curve.py |
5 instelbare (buitentemp → aanvoertemp) punten met lineaire interpolatie + kamercompensatie (±5°C) |
| Weer | weather_module.py |
Windchill (JAG/TI-gevoelstemperatuur; alleen het verschil boven dat bij 10 km/h telt, want de stooklijn bevat gewone wind al; tussen 10 en 13°C lineair afgebouwd; de helft daarvan telt als kouder buiten, via de helling van de ingestelde stooklijn zonder geleerde offsets omgerekend naar aanvoer, +0…4°C) + zoncorrectie (−0…4°C) over instelbaar vooruitkijkvenster. Zon bij voorkeur uit de PV-prognose van het energiedashboard (automatisch, zie hieronder), anders uit het weertype (alleen uren met de zon > 5° boven de horizon) |
| Prijs | energy_prices.py |
Vergelijkt de huidige prijs met de komende 24 uur. Meer dan een halve standaardafwijking onder het gemiddelde is goedkoop → voorverwarmen (standaard +2 °C, alleen als de kamer minder dan 1,5 °C boven het doel zit); meer dan een halve erboven is duur → bezuinigen (standaard −2 °C). Eén indeling per prijsperiode: een ververste prijslijst halverwege het uur verandert de indeling niet |
Staat er bij de zonnepanelen in het energiedashboard een prognose (Prognose productie), dan gebruikt de zoncorrectie per uur die opbrengstprognose in plaats van het weertype. Het is dezelfde uurprognose die het dashboard toont, opgeteld over alle gekozen prognoses (elke prognose één keer, ook als hij bij meer bronnen staat).
-
Ondersteund: Forecast.Solar (kWp uit de vlakken) en Solar Forecast ML (kWp uit de vlakgroepen). Van andere integraties is het piekvermogen niet bekend; die worden overgeslagen.
-
Staat er geen prognose in het energiedashboard, dan tellen alle Forecast.Solar-entries, zoals vóór v2.6.0.
-
Fractie volle zon = verwachte kWh in dat uur ÷ kWp ÷ 0,6 (max 1); correctie = fractie × zonnig-instelling.
-
Werkt ook als de sensoren van de prognose tijdelijk
unavailablezijn: de laatst opgehaalde prognose blijft gebruikt. -
Dekt de prognose een uur niet (bv. verouderd), dan valt dat uur terug op het weertype.
-
Welke bron gebruikt is staat in het attribuut
zon_bronvan de aanvoersetpoint-sensor (pv-prognose,weerofgemengd; tot v2.6.0 heettepv-prognoseforecast.solar).
| Module | Bestand | Doel |
|---|---|---|
| Lerend systeem | learning.py |
Verzamelt kamer-afwijking per buitentemp-bucket en past de 5 stooklijn-punten bij, met persistente opslag |
Alles wat je kunt bijregelen, op één rij:
- Kamercompensatiefactor (0–10, default 2.0)
- Min/max aanvoertemperatuur (defaults 15/45°C)
- Vooruitkijkvenster (1–6 uur, default 3)
- Max prijscorrectie (0–5°C, default 3.0)
- Leersnelheid adaptieve stooklijn (0–0.5°C/uur, default 0.1, 0 = uit)
- Stookgrens (10–25°C buiten, default 17°C) — boven deze drempel stopt verwarmen automatisch
- Stookgrens-hysterese (0–3°C, default 1.0) — pas weer verwarmen onder stookgrens − hysterese
- Gewenste kamertemperatuur
- HVAC-modus: Verwarmen (stooklijn-berekening) / Uit (warmtepomp stopt). Koelen wordt door de WeHeat intern geregeld (eigen koelstooklijn, geen OpenTherm-aansturing).
- Stap 1 — Temperatuurinstellingen: doel, min/max, factoren
- Stap 2 — Stooklijn: 5 (buitentemp → aanvoertemp) koppels
- Stap 3 — Geavanceerde correcties: voorverwarm-bonus, besparing, zonnig/deels bewolkt
- Stap 4 — Extra sensoren: status-sensor van de warmtepomp
- Wis alle geleerde stooklijn-offsets
De integratie leert over weken automatisch je 5 stooklijn-punten bij te slijpen op basis van werkelijke kamer-afwijking.
Werking in het kort:
- Elke 60s: bij stabiele omstandigheden bewaar
(target − kamer)per buitentemp-bucket - Elk uur: per curve-punt bij persistente afwijking >0.3°C → offset met
learning_rateaanpassen - Offsets begrensd op ±5°C. Oude metingen doven uit: elk uur tellen ze nog half mee
- Te warm terwijl de warmtepomp niet verwarmt telt niet mee: dat komt door zon of weer, niet door de stooklijn
- Auto-reset bij handmatige curve-wijziging (buiten- of aanvoerwaarde)
- Niet leren als het setpoint al op de minimale of maximale aanvoertemperatuur staat
- Niet leren terwijl de warmtepomp tapwater maakt (
dhwoflegionella_prevention, alleen met gekoppelde status-sensor) - Niet leren zolang een temperatuursensor is weggevallen (zie sensoruitval)
Stabiliteitseisen (voorkomt leren van verkeerde signalen):
- Geen doeltemperatuur-wijziging in laatste 60 min
- Buitentemperatuur verandert <1°C/uur
- Minimaal 30 samples per bucket
Wat je ziet:
- 5 diagnostische sensoren
…_stooklijn_offset_1..5met history voor convergentiegrafieken number.…_leersnelheid(slider, 0 = uit)button.…_reset_adaptieve_stooklijn
Te verwachten gedrag:
- Eerste 2–3 dagen: offsets blijven 0 (onvoldoende data)
- Dag 4–14: zichtbare convergentie op meest voorkomende buitentemperaturen
- Na ~3 weken: stabiel, kamer dichter bij doel
Tip: zet leersnelheid op 0.2 in de eerste weken voor snellere convergentie, daarna terug naar 0.05.
Onder device "WeHeat OpenTherm" verschijnen automatisch:
| Entity ID | Wat | Categorie |
|---|---|---|
sensor.…_aanvoersetpoint |
Berekend setpoint (eindwaarde) | normaal |
sensor.…_buitentemperatuur |
Bron buitentemp | normaal |
sensor.…_kamertemperatuur |
Bron kamertemp | normaal |
sensor.…_stooklijn_basistemperatuur |
Basis uit interpolatie | normaal |
sensor.…_kamercompensatie |
Correctie (±5°C) | diagnostic |
sensor.…_windchill_correctie |
Correctie (0…+4°C) | diagnostic |
sensor.…_zoncorrectie |
Correctie (0…+4°C, wordt afgetrokken) | diagnostic |
sensor.…_prijscorrectie |
Correctie (±max) | diagnostic |
sensor.…_huidige_energieprijs |
Actuele prijs | diagnostic |
sensor.…_stooklijn_offset_1..5 |
Adaptieve offsets per curve-punt | diagnostic |
sensor.…_actieve_modus |
heat of off, na de stookgrens; de ESP schakelt hierop |
normaal |
De aanvoersetpoint-sensor heeft attributen die laten zien hoe het setpoint is opgebouwd:
| Attribuut | Wat |
|---|---|
formule |
De hele som in één regel, bv. 25.04 (stooklijn) -0.24 (kamer) +0.01 (windchill) -0.00 (zon) 0.00 (prijs) = 24.81 ≈ 24.8 |
zon_bron |
pv-prognose, weer of gemengd |
begrensd |
true als het setpoint op de minimale of maximale aanvoertemperatuur is afgekapt |
terugval |
Tekst als een temperatuursensor is weggevallen, anders leeg |
geleerde_offset_totaal |
Som van de vijf geleerde offsets |
climate.…_verwarmingsdoelwit— doeltemperatuurnumber.…_kamercompensatiefactor,_minimale_aanvoertemperatuur,_maximale_aanvoertemperatuur,_vooruitkijkvenster,_max_prijscorrectie,_leersnelheid,_stookgrens,_stookgrens_hysterese— instelbare parametersbutton.…_reset_adaptieve_stooklijn— wis leerstaat
De climate-mode is wat jij wilt; de actieve modus is wat er echt gebeurt na een buitentemp-check.
- Stookgrens (default 17°C): bij HEAT-modus + buitentemp ≥ stookgrens → actieve modus wordt
off, warmtepomp stopt. - Hysterese (default 1°C): daarna pas weer
heatals buitentemp < stookgrens − hysterese (dus < 16°C). Daartussen blijft de vorige stand staan, zodat schommelen rond de grens niet steeds aan/uit schakelt.
De ESP leest sensor.weheat_opentherm_actieve_modus rechtstreeks en zet ch_enable op die basis. Geen t_set meer geschreven in off.
Voorbeeld: kamer 21°C, buiten 20°C, climate=HEAT, stookgrens=17 → 20 ≥ 17 → actieve modus = off → warmtepomp doet niks. Zet je stookgrens op 25 dan zou hij wél verwarmen.
Niet aangestuurd door deze integratie — de WeHeat regelt koeling intern via een eigen koelstooklijn (geen OpenTherm-pad). Zet de koelmodus aan/uit via de WeHeat-app of de fysieke knop. De climate-entiteit heeft daarom alleen Verwarmen en Uit.
Koppel de status-sensor (sensor.<warmtepomp>_heat_pump uit de officiële WeHeat-integratie) bij het instellen of via Configureren → Extra sensoren. Die doet twee dingen:
- Beter leren: te warm terwijl de pomp niet verwarmt telt niet mee, en tijdens tapwater wordt niets gemeten.
- Zichtbaar op de thermostaat: de climate-tegel toont via
hvac_actionwat de pomp doet:
| Pomp-status | Climate-tegel laat zien |
|---|---|
| Verwarming | 🔥 Verwarmen |
| Koelen | ❄️ Koelen |
| Stand-by | 💤 Inactief |
Ontdooien (defrosting) |
💤 Inactief (⏻ Uit bij mode Uit) |
Tapwater (dhw, legionella_prevention) |
💤 Inactief (⏻ Uit bij mode Uit) |
| Mode = Uit + pomp Stand-by | ⏻ Uit |
Bij het leren wordt tijdens ontdooien gewoon gemeten, want het hoort bij normaal stoken in de winter. Alleen een te warme kamer telt dan niet mee, net als bij stand-by: de pomp verwarmt op dat moment niet. Tijdens tapwater wordt niets gemeten.
Actief verwarmen/koelen wint altijd van de mode-keuze — je ziet dus ook wanneer de warmtepomp zelf besluit te koelen ondanks climate=HEAT/OFF.
Verwijder de integratie via Instellingen → Apparaten & diensten. De geleerde stooklijn wordt dan ook gewist. Zet de ESPHome-bridge uit of flash hem opnieuw: die houdt anders het laatste setpoint vast.
De WeHeat's eigen t_outside (via OpenTherm) fluctueert wanneer de compressor draait of ontdooit. Een KNMI/Buienradar template-sensor is veel stabieler:
# configuration.yaml → template:
- sensor:
- name: "Buitentemperatuur stabiel"
unit_of_measurement: "°C"
device_class: temperature
state: "{{ state_attr('weather.buienradar', 'temperature') }}"
availability: "{{ state_attr('weather.buienradar', 'temperature') is number }}"Gebruik deze als outdoor_temp_sensor in de integratie-setup. Gebruik geen float(0): valt het weer weg, dan rekent de integratie anders met 0 °C buiten en stookt ze veel te warm. Met availability wordt de sensor unavailable en houdt de ESP het laatste setpoint vast.
De integratie leest de komende prijzen uit een attribuut van de prijssensor. Dat attribuut moet een lijst zijn, met getallen of met items als {start/time/from: tijd, value/price/total/electricity_price: prijs}. Gezocht wordt in forecast, prices, prices_today (+ prices_tomorrow), hourly_prices en raw_today (+ raw_tomorrow).
- Zonneplan: getest (
forecast→electricity_price). Zonneplan slaat de lijst op als integer × 1e7; de integratie herkent dat schaalverschil zelf. - Frank Energie (HACS): kies de sensor met de huidige all-in prijs; die heeft attribuut
prices(from/price). - Tibber (standaard in HA): de sensor heeft geen prijslijst; de integratie haalt de komende 24 uur op via de actie
tibber.get_prices(hooguit eens per 15 minuten). - Nordpool (HACS,
raw_today/raw_tomorrow) en ENTSO-e (prices) volgen dit formaat. - Frank, Tibber, Nordpool en ENTSO-e zijn nagebootst op basis van hun broncode, niet getest met een echt account.
- Heeft je sensor geen prijslijst in een attribuut, dan blijft de prijscorrectie 0. De rest werkt gewoon.
Controleer het in het attribuut prijs_correctie van de aanvoersetpoint-sensor: bij een werkende koppeling wisselt het over de dag tussen −2, 0 en +2.
- Eerste 15 minuten: de integratie rekent niet en de ESP houdt het laatste setpoint vast. Een korte hapering (bv. Bluetooth) laat het setpoint zo niet verspringen.
- Daarna, kamersensor weg: de integratie rekent door zonder kamercompensatie. Het setpoint blijft het weer volgen.
- Daarna, buitensensor weg: de integratie gebruikt de huidige temperatuur van de weer-entiteit. Is er geen weer-entiteit, dan blijft het laatste setpoint staan.
- Zolang de terugval actief is, leert de stooklijn niet. Het attribuut
terugvalvan de aanvoersetpoint-sensor en een waarschuwing in het log laten zien dat het speelt.
In de meegeleverde YAML zit filter_out: nan waardoor het laatste geldige setpoint behouden blijft. De CV-schakelaar reageert alleen op de modus heat of off; bij unavailable (bv. terwijl HA herstart) blijft de laatste stand staan, zodat de warmtepomp niet even uitgaat. Het OpenTherm-protocol heeft zelf ook een fallback (boiler valt terug op interne logica bij signaal-verlies).
Kijk naar de 5 _stooklijn_offset_* sensoren in HA history. Na enkele dagen zie je daar kleine waarden (positief = werkt te koud, integratie verhoogt; negatief = werkt te warm). Een log-regel in de HA logs (zoek op Adaptieve stooklijn:) toont elke succesvolle leerstap.
- Check
sensor.…_stooklijn_basistemperatuur— klopt deze met je curve? - Check
sensor.…_kamercompensatie— als die continu groot is, klopt je curve nog niet voor jouw woning - Wacht 1–2 weken; de adaptieve stooklijn corrigeert dit automatisch
- Of: pas de curve handmatig aan via CONFIGUREREN → Stooklijn (offsets worden dan automatisch gereset)
MIT
