OpenTherm Gateway – jak połączyć kocioł gazowy z Domoticzem i poprawić sterowanie?

Autor: [Twoje imię lub pseudonim] | Data: maj 2026

Spis treści

Co to jest OpenTherm Gateway (OTGW) i dlaczego warto?

Zalety OTGW w Domoticzu
Kompatybilność

Co potrzebujesz do instalacji?
Krok 1 – podłączenie sprzętowe OTGW do kotła
Krok 2 – konfiguracja OTGW (firmware i sieć)
Krok 3 – integracja z Domoticzem – dodanie sprzętu

Problemy?

Krok 4 – konfiguracja czujników i termostatu
Krok 5 – automatyzacja i optymalizacja

Zaawansowane: ESP i DIYLESS

Rozwiązywanie problemów

W erze smart home sterowanie systemami grzewczymi przeszło rewolucję. Jeśli posiadasz kocioł gazowy z protokołem OpenTherm, OpenTherm Gateway (OTGW) to idealne rozwiązanie do integracji z Domoticzem – popularnym, darmowym systemem automatyki domowej. Ten poradnik krok po kroku wyjaśni, jak podłączyć OTGW do kotła, skonfigurować komunikację z Domoticzem i zoptymalizować sterowanie ogrzewaniem, CWU czy nawet chłodzeniem. Dzięki temu zyskasz precyzyjne zarządzanie temperaturą, oszczędność gazu i pełną automatyzację.

Artykuł oparty na oficjalnej dokumentacji Domoticz, wiki OTGW oraz doświadczeniach społeczności (m.in. fora Domoticz i SmartnyDom). Zakładamy podstawową wiedzę o Raspberry Pi i sieci LAN – jeśli jesteś początkujący, zacznij od instalacji Domoticza.

Co to jest OpenTherm Gateway (OTGW) i dlaczego warto?

OpenTherm to otwarty protokół komunikacyjny stworzony przez Honeywell i innych producentów kotłów (np. Vaillant, Viessmann, Termet, Junkers). Umożliwia dwukierunkową wymianę danych między termostatem a kotłem: temperaturę wody, stan kotła, błędy, setpointy itp. Standardowe termostaty OpenTherm są ograniczone – OTGW to mostek, który przekształca te dane na USB/LAN/Wi‑Fi i integruje je z systemami jak Domoticz, Home Assistant czy MQTT.

Zalety OTGW w Domoticzu

Najważniejsze korzyści integracji OTGW z Domoticzem to:

precyzyjne sterowanie – ustawiaj setpointy kotła bezpośrednio z aplikacji mobilnej Domoticza;
monitoring w czasie rzeczywistym – podgląd temperatury wody, modulacji palnika, stanów i błędów kotła;
automatyzacja – reguły oparte na pogodzie, obecności domowników i danych z czujników;
oszczędność gazu – niższe zużycie dzięki regulatorom PID oraz krzywym grzewczym;
stabilne wsparcie – integracja Domoticz obsługuje firmware OTGW 5.x (stabilna od 2021).

Kompatybilność

Wspierana jest większość nowoczesnych kotłów gazowych z OpenTherm (np. Termet Ecocondens, Bosch, Viessmann). Przed montażem sprawdź w dokumentacji kotła, czy wspiera OpenTherm i które funkcje są dostępne.

Schemat OTGW (oficjalna dokumentacja): https://otgw.tclcode.com/schematic.html

Co potrzebujesz do instalacji?

Przygotuj poniższe elementy:

OpenTherm Gateway – oryginalny (ok. 150–200 zł) lub klon na ESP (np. DIYLESS, ok. 50 zł);
kabel OpenTherm – dwużyłowy, niepolaryzowany, długość do ok. 50 m;
serwer Domoticz – Raspberry Pi 4/Zero z aktualnym Domoticzem (stabilna 2024+ lub beta);
czujniki – temperatura zewnętrzna/wewnętrzna (np. DHT22, BME280) lub źródła wirtualne (np. Buienradar);
połączenie OTGW – USB do Raspberry Pi lub LAN/Wi‑Fi dla zdalnego dostępu;
narzędzia – śrubokrętak, multimetr (do testów), broker MQTT (opcjonalnie).

Koszt całkowity: 200–500 zł.

Krok 1 – podłączenie sprzętowe OTGW do kotła

Wyłącz kocioł i odłącz zasilanie. Jeśli masz podłączony termostat, odłącz go przed montażem OTGW.

Podłącz OTGW. Wykonaj poniższe połączenia, zgodnie z instrukcją urządzenia:

do kotła – użyj szyny OpenTherm (zwykle oznaczone piny 1 i 2 na płycie kotła);
zasilanie – 5–24 V DC z zasilacza lub z kotła (jeśli producent to dopuszcza);
sieć – wybierz i skonfiguruj jedną z opcji łączności (USB/LAN/Wi‑Fi).

Szczegóły typów połączeń:

Typ połączenia	Port	Uwagi
USB	/dev/ttyUSB0 (lub by-id)	Proste, lokalne połączenie.
LAN	Ethernet RJ45	Ustaw statyczne IP, port 6638.
Wi‑Fi	Konfiguracja w interfejsie WWW OTGW	Dotyczy wersji na ESP.

Wykonaj test komunikacji. Włącz kocioł – dioda OTGW powinna migać. Jeśli masz narzędzie, sprawdź komunikację komendą otcli.

Uwaga bezpieczeństwa: OpenTherm to niskonapięciowy protokół (5–24 V), ale zawsze odłączaj zasilanie przed pracami. Schemat: https://otgw.tclcode.com/schematic.html

Krok 2 – konfiguracja OTGW (firmware i sieć)

Zaktualizuj firmware. Pobierz najnowszą wersję z: http://otgw.tclcode.com/firmware.html. Domoticz wspiera firmware OTGW v5.x.
Uzyskaj dostęp do OTGW. Dla interfejsu LAN/ESP użyj telnet/HTTP pod adresem IP:6638. Jeśli wymagane, domyślny login/hasło to otgw / otgw. Do szybkich testów możesz wysłać komendy: =CH=0 (wyłączenie CO) oraz =Tset=50 (setpoint CO 50°C).
Skonfiguruj Wi‑Fi (ESP). Skorzystaj z interfejsu WWW modułu lub integracji przez ESPHome zgodnie z dokumentacją projektu.

Krok 3 – integracja z Domoticzem – dodanie sprzętu

Zaloguj się do Domoticza pod adresem HTTP serwera (np. http://twoj-ip:8080).

Dodaj sprzęt OTGW. Przejdź: Ustawienia > Sprzęt > Dodaj, wybierz odpowiedni typ i uzupełnij pola.

Przykładowe konfiguracje:

Typ	Ustawienia	Przykład
USB	Opentherm Gateway USB	Serial port: `/dev/serial/by-id/usb-OTGW...` (sprawdź poleceniem `ls /dev/serial/by-id/`).
LAN	Opentherm Gateway with LAN interface	IP: `192.168.1.81`, port: `6638`.

Nazwa urządzenia: „OTGW kocioł”.

Aktywuj i odczekaj. Po dodaniu Domoticz utworzy około 28 urządzeń (temperatura kotła, CWU, błędy, setpointy itp.). Odczekaj 1–2 minuty na pełną inicjalizację.

Zrzut ekranu z integracji (Domoticz Wiki): https://wiki.domoticz.com/images/OTGW.png

Problemy?

„Nie można nawiązać połączenia” – sprawdź firewall, adres IP i port. W niektórych integracjach użyj formatu socket://IP:6638.

Port szeregowy – ustaw trwały identyfikator USB (na Raspberry Pi przez reguły udev), aby uniknąć zmian portu po restarcie.

Krok 4 – konfiguracja czujników i termostatu

Dodaj/wybierz czujnik zewnętrzny. Skonfiguruj źródło temperatury zewnętrznej w Domoticzu:
- przejdź do: Ustawienia > Sprzęt > OTGW > Konfiguracja,
- wskaż istniejący czujnik (np. 1‑Wire) lub źródło wirtualne (np. Buienradar),
- gdy brak czujnika – skorzystaj z odczytu z OTGW.
Skonfiguruj wirtualny termostat. Jeśli chcesz sterować setpointem z poziomu automatyzacji:
MQTT (zaawansowane) – dodaj „MQTT Client Gateway” i publikuj setpointy w formacie JSON, np. {"EnableCentralHeating":"on","BoilerSetpoint":40.93}.

Domoticz Thermostat Plugin – połącz czujniki temperatury (wewn./zewn.) i użyj wbudowanego regulatora PID.
Wysyłaj komendy sterujące. Z poziomu konfiguracji OTGW w Domoticzu użyj ścieżki: Ustawienia > Sprzęt > OTGW > Konfiguracja > Polecenie.

Najczęściej używane komendy OTGW:

Komenda	Opis	Przykład
`=CH=1`	Włącz CO	Centralne ogrzewanie: on.
`=Tset=45`	Ustaw setpoint CO	45°C.
`=DHW=1`	Włącz CWU	Setpoint CWU 37°C: `=sDHW=37`.
`=Cl=0`	Wyłącz chłodzenie	Wymagane wsparcie w kotle.

API Domoticz (JSON): http://domoticz/api/1/json.htm?type=command&param=udevice&idx=XX&nvalue=1&svalue=50

Krok 5 – automatyzacja i optymalizacja

Aby w pełni wykorzystać integrację, zaplanuj reguły i harmonogramy dopasowane do Twojego domu:

scenariusze w Domoticz – buduj reguły uzależnione od temperatury zewnętrznej, obecności oraz pory dnia;
dzienne harmonogramy – skonfiguruj tryby komfort/noc/wyjazd w „Zdarzeniach” lub przez skrypty Lua;
oszczędności – oprzyj sterowanie na krzywych grzewczych i ogranicz szybkie skoki temperatury;
monitoring – dodaj wykresy modulacji palnika i temperatur, aby utrzymać stabilną pracę (unikaj długotrwałych 100%).

Przykładowa reguła (warunek/akcja):

Jeśli: temp. zewn. < 5°C ORAZ obecność = tak

Wtedy: setpoint CO = 55°C, Enable CH = 1

Zaawansowane: ESP i DIYLESS

Wersje na ESP pracują na logice 3,3 V (typowo piny 2/18). Zadbaj o stabilne zasilanie – niskie napięcie 3,3 V może powodować błędy.

Integracja przez MQTT – publikuj/ subskrybuj tematy, np. otgw/#, aby wymieniać stany i komendy między OTGW a Domoticzem/HA.

Rozwiązywanie problemów

Poniższa tabela zawiera najczęstsze problemy oraz szybkie wskazówki serwisowe:

Problem	Rozwiązanie
Brak urządzeń	Wykonaj restart Domoticz; sprawdź logi (zakładka `Log`).
Błędy połączenia	Sprawdź ping do IP OTGW oraz czy port 6638 jest otwarty.
Brak temp. zewn.	Dodaj czujnik wirtualny (np. Buienradar) i przypisz go w konfiguracji OTGW.
Klon ESP nie działa	Zweryfikuj stabilność 3,3 V i pinout płytki.
Kompatybilność Termet	Ecocondens Gold+ – sterowanie CO/CWU wspierane.