

OpenThermGW
Firmware ESPHome + własny komponent + sprzęt (PCB + obudowa) dla ESP8266 (Wemos D1 mini) działający jako bramka / monitor OpenTherm między kotłem a termostatem z integracją Home Assistant.
- Size
- 75 × 65 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 48
- Nets
- 38
- Pads
- 118
- Tracks, vias
- 157, 12
- Pours
- 5
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 22 Oct 2026
- Updated
- 22 Oct 2026
Overview
OpenThermGW is an open-source printed circuit board by macdems, from the macdems/ESPHome-OpenTherm-Gateway repository on GitHub. It is a 2-layer board of 75 × 65 mm with 48 parts on 38 nets, routed with 157 tracks and 12 vias.
It is built around the WEMOS D1 MINI, HLK-5M24C and LM2596T-5.0, with the 2SA1015, LL4148 and MMBT5551L among its other parts. Its parts include 14 resistors, 10 diodes, 6 transistors, 4 ICs and 4 connectors. It belongs with the ESP8266 boards of this library.
Main components
7WEMOS D1 MINI
A mini wifi board with 4MB flash based on ESP-8266EX, hardware version 4.0.0.LolinUncategorisedHLK-5M24C
插件,47.5x28.5mm-25℃~+60℃ 0.1W 100mVp-p 120V~350V 208mA 22mm 24V 28.5mm 3kV 47.5mm 5W 80% 85VAC~265VAC AC/DC-DC Short Circuit Protection、Over Current Protection、Fault self-recovery 插件,47.5x28.5mm AC-DC Power Modules ROHSHI-LINKAC-DC Power ModulesLM2596T-5.0
TO-220-5-40℃~+125℃@(TJ) 1 150kHz 3A 4.5V~40V 5V 5mA Buck Buck Built-in Fixed No TO-220-5 DC-DC Converters ROHSTexas InstrumentsDC-DC Converters2SA1015
SOT-231 PNP 100nA 130 150mA 200mW 300mV 50V 5V 80MHz PNP SOT-23 Bipolar (BJT) ROHSHXY MOSFETBipolar (BJT)LL4148
LL-341 Independent 1V@10mA 200mA 4A 4ns 500mW 5uA@75V 75V LL-34 Switching Diodes ROHSMDDSwitching DiodesMMBT5551L
SOT-23-55℃~+150℃ 1 NPN 100nA 160V 250mV 300mW 600mA 6V 80 NPN SOT-23 Bipolar (BJT) ROHSonsemiBipolar (BJT)SS24
SMA(DO-214AC)-55℃~+150℃ 200uA@40V 2A 40V 50A 550mV@2A Independent SMA(DO-214AC) Schottky Diodes ROHShongjiachengSchottky Diodes
README
README.mdOpenTherm ESPHome Gateway (piec)
Firmware ESPHome + własny komponent + sprzęt (PCB + obudowa) dla ESP8266 (Wemos D1 mini) działający jako bramka / monitor OpenTherm między kotłem a termostatem z integracją Home Assistant.
Funkcje
- Odczyt i wysyłanie ramek OpenTherm (custom component w
components/openthermgw) - Ekspozycja temperatur (CO, powrotu, CWU, pomieszczenia) oraz stanów kotła
- Odczyt poziomu modulacji palnika (%)
- Regulacja nastawy CWU z opcjonalnym przełącznikiem nadpisania
- Monitoring flag błędów (ciśnienie, palnik, przegrzanie)
- Sygnał Wi-Fi (RSSI)
- Projekt PCB (KiCad) + obudowa do druku 3D (STL + FreeCAD)
Struktura repozytorium
piec.yaml– główna konfiguracja ESPHomecomponents/openthermgw– zewnętrzny komponent OpenTherm (kod)OpenThermGW/– projekt KiCad (sprzęt)SelfTest/– szkic testowy / PlatformIO (kod)*.stl,Obudowa.FCStd,obudowa.dxf– obudowa (sprzęt)
Pinout (Wemos D1 mini)
| Rola | Klucz YAML | Pin |
|---|---|---|
| Termostat -> Gateway | thermostat_in_pin | D1 |
| Gateway -> Termostat | thermostat_out_pin | D2 |
| Kocioł -> Gateway | boiler_in_pin | D5 |
| Gateway -> Kocioł | boiler_out_pin | D6 |
Zdefiniowane w sekcji openthermgw: w piec.yaml.
Udostępniane encje (Home Assistant)
Sensory (platform: openthermgw)
| Nazwa | ID OpenTherm | Typ | Uwagi |
|---|---|---|---|
| Temperatura CWU | DHW_TEMP | F88 | Woda użytkowa |
| Temperatura CO | FEED_TEMP | F88 | Zasilanie CO |
| Temperatura powrotna | RETURN_WATER_TEMP | F88 | Powrót CO |
| Temperatura na schodach | ROOM_TEMP | F88 | Z żądania (request) |
| Ustawiona temperatura CWU | DHW_SETPOINT | F88 | Odczyt nastawy |
| Żądana temperatura CO | CH_SETPOINT | F88 | Zadana CO |
| Względna moc palnika | MODULATION_LEVEL | F88 | % modulacji |
Sensory binarne
| Nazwa | Ramka | Bit |
|---|---|---|
| Palnik | STATUS | 3 |
| Tryb CO | STATUS | 1 |
| Tryb CWU | STATUS | 2 |
| Niskie ciśnienie wody | FAULT_FLAGS | 10 |
| Problem z palnikiem | FAULT_FLAGS | 11 |
| Zbyt wysoka temperatura | FAULT_FLAGS | 13 |
Number (zapis)
| Nazwa | ID OT | Zakres | Uwagi |
|---|---|---|---|
| Zadana temperatura CWU | DHW_SETPOINT | 10–60°C | Przełącznik nadpisania |
Przełącznik: "Nadpisz temperaturę CWU".
Sekrety
Plik secrets.yaml (nie commituj):
wifi_ssid: "TWOJE_WIFI"
wifi_password: "HASLO_WIFI"
api_encryption_key: "KLUCZ_32_BAJTY"Budowanie / Flash
Wymagania: Python 3, pip.
pip install esphome
esphome run piec.yamlPierwsze uruchomienie: wybór portu USB. Kolejne aktualizacje OTA.
Komponent zewnętrzny
Sekcja:
external_components:
- source:
type: local
path: componentsFolder components/openthermgw musi mieć strukturę kompatybilną z ESPHome.
Sprzęt
- KiCad:
OpenThermGW/OpenThermGW.kicad_pro - PCB:
OpenThermGW/OpenThermGW.kicad_pcb - Schemat:
OpenThermGW/OpenThermGW.kicad_sch - Fab:
OpenThermGW-F_Fab.svg - Obudowa:
Obudowa.FCStd+Obudowa-*.stl
Parametry bezpieczeństwa
- OpenTherm to interfejs prądowy – zapewnij poprawną izolację
- Nie podłączaj bez pewności co do pinów w kotle
- Przed montażem odłącz zasilanie
- Na własne ryzyko
Rozszerzanie
- Nowe Data IDs: dodaj kolejne
sensor/binary_sensor - Automatyka: ESPHome / Home Assistant
- Log błędów:
text_sensor+on_value - MQTT: sekcja
mqtt:(opcjonalnie)
Typowe problemy
| Objaw | Przyczyna | Działanie |
|---|---|---|
| Brak ramek | Odwrócone linie | Sprawdź IN/OUT |
| 0.0°C wszystko | Brak odpowiedzi kotła | Zasilanie pętli |
| Palnik OFF | Brak bitów STATUS | Warstwa sprzętowa |
| Brak zapisu CWU | Override OFF | Włącz przełącznik |
Roadmapa (pomysły)
- Log historii błędów
- Limit modulacji
- ESP32 + Ethernet
- Pogodówka
Licencja
Podwójna struktura licencyjna:
-
Kod (firmware, konfiguracje, skrypty, komponenty):
Licencja: Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
SPDX:CC-BY-SA-4.0
Wymagania: podaj autorstwo, zachowaj tę samą licencję przy modyfikacjach. -
Sprzęt (pliki KiCad, PCB, schematy, STL, FreeCAD, DXF):
Licencja: CERN Open Hardware Licence Version 2 – Weakly Reciprocal (CERN-OHL-W-2.0)
SPDX:CERN-OHL-W-2.0
Wymagania: udostępnij zmiany projektowe przy dystrybucji produktów lub modyfikowanych źródeł.
Plik LICENSE.md zawiera obie licencje (streszczenia + linki do pełnych tekstów).
Dodawaj nagłówki SPDX:
- W plikach kodu:
SPDX-License-Identifier: CC-BY-SA-4.0 - W plikach sprzętowych:
SPDX-License-Identifier: CERN-OHL-W-2.0
Zastrzeżenie
Projekt "as is" bez gwarancji. Nie stosuj w krytycznych systemach bez oceny ryzyka.
Krótko: Bramka OpenTherm na ESP8266 z ESPHome; kod CC BY-SA 4.0, sprzęt CERN-OHL-W-2.0.
Parts
48| Qty | Value | Footprint | References |
|---|---|---|---|
| 5 | ~ | MountingHole:MountingHole_3.5mm | H1, H2, H3, H4, H5 |
| 4 | 2SA1015 | Package_TO_SOT_SMD:SOT-23_Handsoldering | Q1, Q2, Q4, Q5 |
| 4 | LL4148 | Diode_SMD:D_MiniMELF_Handsoldering | D1, D2, D5, D6 |
| 2 | 100 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R4, R6 |
| 2 | 10k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R11, R14 |
| 2 | 330 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R1, R2 |
| 2 | 33k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R9, R10 |
| 2 | MMBT5551L | Package_TO_SOT_SMD:SOT-23_Handsoldering | Q3, Q6 |
| 2 | PC817 | Package_DIP:DIP-4_W7.62mm | U1, U3 |
| 1 | 13V | Diode_SMD:D_MiniMELF_Handsoldering | D3 |
| 1 | 150mH | Inductor_SMD:L_10.4x10.4_H4.8 | L1 |
| 1 | 1k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R12 |
| 1 | 220 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R3 |
| 1 | 220µF | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C2 |
| 1 | 220µF/35V | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C1 |
| 1 | 230V | TerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type055_RT01502HDWU_1x02_P5.00mm_Horizontal | J2 |
| 1 | 24V | Connector_JST:JST_XH_B2B-XH-A_1x02_P2.50mm_Vertical | J3 |
| 1 | 2k2 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R5 |
| 1 | 39 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R7 |
| 1 | 3k3 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R13 |
| 1 | 4V3 | Diode_SMD:D_MiniMELF_Handsoldering | D4 |
| 1 | 4V7 | Diode_SMD:D_MiniMELF_Handsoldering | D7 |
| 1 | 4k7 | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R8 |
| 1 | HLK-5M24 | Converter_ACDC:Converter_ACDC_Hi-Link_HLK-5Mxx | PS1 |
| 1 | Heatsink | Custom:Heatsink_T8WC_TO-220 | HS1 |
| 1 | LM2596T-5 | Package_TO_SOT_THT:TO-220-5_P3.4x3.7mm_StaggerOdd_Lead3.8mm_Vertical | U4 |
| 1 | Piec | TerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type059_RT06302HBWC_1x02_P3.50mm_Horizontal | J1 |
| 1 | Rx Piec | LED_SMD:LED_1206_3216Metric_Pad1.42x1.75mm_HandSolder | D8 |
| 1 | Rx Termostat | LED_SMD:LED_1206_3216Metric_Pad1.42x1.75mm_HandSolder | D10 |
| 1 | SS24 | Diode_SMD:D_SMA_Handsoldering | D9 |
| 1 | Termostat | TerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type059_RT06302HBWC_1x02_P3.50mm_Horizontal | J4 |
| 1 | WEMOS_D1_mini | RF_Module:WEMOS_D1_mini_light | U2 |
Similar boards
- 2 layers92 × 87 mm

- 2 layers164 × 60.5 mm

NixieClock
macdems/NixieClock
A compact IN-14 Nixie clock project with both vintage character and modern connectivity.
48 partsCC-BY-SA-4.0 - 2 layers

- 2 layers53.3 × 64.4 mm

Wifi homesensor
masterfoxxhu/wifi_homesensor
Quick and dirty ESP8266 based thermo and humidity meter for ESPhome
33 partsGPL-3.0 - 2 layers35.6 × 27 mm

- 2 layers43.9 × 27.7 mm

- 2 layers70 × 81 mm

Mitsumi M1M-24HB QuickDisk Drive
4920616d20546f6d/Mitsumi_Famicom_Disk_Drive
Mitsumi Famicom Disk System disk drive controller PCB
84 parts18MIT - 2 layers100 × 100 mm

Questions
How big is the OpenThermGW PCB?
It measures 75 × 65 mm and has 2 copper layers, 1.6 mm thick.
What parts does the OpenThermGW use?
48 parts, built around the WEMOS D1 MINI, HLK-5M24C, LM2596T-5.0 and 2SA1015. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the OpenThermGW KiCad files?
From the macdems/ESPHome-OpenTherm-Gateway repository on GitHub, at the commit this page was made from: the board is OpenThermGW/OpenThermGW.kicad_pcb and its schematic OpenThermGW/BojlerSim.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the OpenThermGW design in my own project?
Its repository states no licence, so its author keeps all rights: ask macdems before reusing the design.