W Home Assistancie 2026.11 integracja OpenTherm Gateway dostanie dwie encje liczbowe: „Control setpoint 1 override” i „Control setpoint 2 override”. Zgłoszenie zmian #182856 przygotował mvn23, opiekun tej integracji i autor biblioteki pyotgw, z której ona korzysta. Scalił je joostlek 16 października 2026 o 14:03 czasu polskiego.

Co dają nowe encje

OpenTherm Gateway (OTGW) to bramka, którą wpina się między termostat OpenTherm a kocioł. Może ona podmieniać wiadomości, które te urządzenia wymieniają. Zadana temperatura zasilania to temperatura wody, którą kocioł ma wysyłać do obiegu grzewczego, a nie temperatura w pokoju. Zwykle wylicza ją termostat. Dzięki nowym encjom Home Assistant może ją zastąpić własną wartością dla pierwszego albo drugiego obiegu, w zakresie od 0 do 90 °C, co 0,1 °C. Wartość 0 oddaje sterowanie z powrotem termostatowi.

Pierwszy obieg dało się nadpisać już wcześniej akcją opentherm_gw.set_control_setpoint, ale ta akcja nie ma pola na drugi obieg. Drugi obieg to nowość, a oba nadpisania są teraz encjami, więc można je umieścić na panelu albo ustawiać akcją number.set_value.

Obie encje znajdziesz w urządzeniu OpenTherm Gateway. Domyślnie są wyłączone, więc najpierw trzeba je włączyć. Home Assistant nie odczytuje ich stanu z bramki, tylko pokazuje wartość, którą bramka przyjęła, a po ustawieniu 0 encja wraca do stanu nieznanego. Gdy Home Assistant się zatrzymuje albo integracja kończy pracę, zeruje ona teraz nadpisania dla obu obiegów, a nie tylko, jak dotąd, dla pierwszego i dla maksymalnej modulacji.

Najpierw przeczytaj ostrzeżenie

W zgłoszeniu zmian do dokumentacji (#48282, 18 października wciąż nie scalone) nad opisem nowych encji jest ostrzeżenie. Odsyła ono do strony projektanta bramki o pracy bez termostatu. Projektant tłumaczy tam, dlaczego sterowanie kotłem z zewnątrz jest trudniejsze, niż się wydaje:

  • ogrzewanie reaguje z dużym opóźnieniem, więc jeśli włączasz kocioł poniżej zadanej temperatury w pokoju i wyłączasz powyżej, temperatura mocno się waha;
  • nowoczesne kotły zwykle pracują najoszczędniej przy niskiej temperaturze wody, więc krótkie cykle pracy z wysoką temperaturą zadaną mogą marnować energię;
  • jeśli zaraz po ustawieniu 80 stopni program sterujący się zawiesi albo komputer zrestartuje się, żeby zainstalować poprawki, w domu może się zrobić naprawdę ciepło.

Projektant pisze, że na wypadek takiej awarii bramka wymaga, żeby temperaturę zadaną wynoszącą co najmniej 8 stopni powtarzać raz na minutę. Jeśli to nie nastąpi, bramka wraca do wartości z termostatu, a bez termostatu do 0. Nowa encja wysyła jedno polecenie przy każdej zmianie wartości. Ani kod ze zgłoszenia, ani funkcja set_control_setpoint w bibliotece pyotgw nie powtarzają go cyklicznie. Jeśli zamierzasz sterować nadpisaniem z automatyzacji, na przykład według własnej krzywej grzewczej zależnej od temperatury zewnętrznej, najpierw sprawdź, jak zachowuje się oprogramowanie bramki.

Dla kogo to jest

Przede wszystkim dla tych, którzy już piszą w Home Assistancie własną logikę ogrzewania, i dla właścicieli kotłów z dwoma obiegami grzewczymi. Pozostali mogą zostawić te encje wyłączone, a termostat będzie działał tak jak dotąd.