Skip to the content
2 layers75 × 65 mmOpenThermGW, the printed circuit board in 3D

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

7

README

README.md

OpenTherm 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 ESPHome
  • components/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)

RolaKlucz YAMLPin
Termostat -> Gatewaythermostat_in_pinD1
Gateway -> Termostatthermostat_out_pinD2
Kocioł -> Gatewayboiler_in_pinD5
Gateway -> Kociołboiler_out_pinD6

Zdefiniowane w sekcji openthermgw: w piec.yaml.

Udostępniane encje (Home Assistant)

Sensory (platform: openthermgw)

NazwaID OpenThermTypUwagi
Temperatura CWUDHW_TEMPF88Woda użytkowa
Temperatura COFEED_TEMPF88Zasilanie CO
Temperatura powrotnaRETURN_WATER_TEMPF88Powrót CO
Temperatura na schodachROOM_TEMPF88Z żądania (request)
Ustawiona temperatura CWUDHW_SETPOINTF88Odczyt nastawy
Żądana temperatura COCH_SETPOINTF88Zadana CO
Względna moc palnikaMODULATION_LEVELF88% modulacji

Sensory binarne

NazwaRamkaBit
PalnikSTATUS3
Tryb COSTATUS1
Tryb CWUSTATUS2
Niskie ciśnienie wodyFAULT_FLAGS10
Problem z palnikiemFAULT_FLAGS11
Zbyt wysoka temperaturaFAULT_FLAGS13

Number (zapis)

NazwaID OTZakresUwagi
Zadana temperatura CWUDHW_SETPOINT10–60°CPrzełącznik nadpisania

Przełącznik: "Nadpisz temperaturę CWU".

Sekrety

Plik secrets.yaml (nie commituj):

yaml
wifi_ssid: "TWOJE_WIFI"
wifi_password: "HASLO_WIFI"
api_encryption_key: "KLUCZ_32_BAJTY"

Budowanie / Flash

Wymagania: Python 3, pip.

bash
pip install esphome
esphome run piec.yaml

Pierwsze uruchomienie: wybór portu USB. Kolejne aktualizacje OTA.

Komponent zewnętrzny

Sekcja:

yaml
external_components:
  - source:
      type: local
      path: components

Folder 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

ObjawPrzyczynaDziałanie
Brak ramekOdwrócone linieSprawdź IN/OUT
0.0°C wszystkoBrak odpowiedzi kotłaZasilanie pętli
Palnik OFFBrak bitów STATUSWarstwa sprzętowa
Brak zapisu CWUOverride OFFWłącz przełącznik

Roadmapa (pomysły)

  • Log historii błędów
  • Limit modulacji
  • ESP32 + Ethernet
  • Pogodówka

Licencja

Podwójna struktura licencyjna:

  1. 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.

  2. 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
QtyValueFootprintReferences
5~MountingHole:MountingHole_3.5mmH1, H2, H3, H4, H5
42SA1015Package_TO_SOT_SMD:SOT-23_HandsolderingQ1, Q2, Q4, Q5
4LL4148Diode_SMD:D_MiniMELF_HandsolderingD1, D2, D5, D6
2100Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR4, R6
210kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR11, R14
2330Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2
233kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR9, R10
2MMBT5551LPackage_TO_SOT_SMD:SOT-23_HandsolderingQ3, Q6
2PC817Package_DIP:DIP-4_W7.62mmU1, U3
113VDiode_SMD:D_MiniMELF_HandsolderingD3
1150mHInductor_SMD:L_10.4x10.4_H4.8L1
11kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR12
1220Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR3
1220µFCapacitor_THT:CP_Radial_D5.0mm_P2.50mmC2
1220µF/35VCapacitor_THT:CP_Radial_D5.0mm_P2.50mmC1
1230VTerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type055_RT01502HDWU_1x02_P5.00mm_HorizontalJ2
124VConnector_JST:JST_XH_B2B-XH-A_1x02_P2.50mm_VerticalJ3
12k2Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR5
139Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR7
13k3Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR13
14V3Diode_SMD:D_MiniMELF_HandsolderingD4
14V7Diode_SMD:D_MiniMELF_HandsolderingD7
14k7Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR8
1HLK-5M24Converter_ACDC:Converter_ACDC_Hi-Link_HLK-5MxxPS1
1HeatsinkCustom:Heatsink_T8WC_TO-220HS1
1LM2596T-5Package_TO_SOT_THT:TO-220-5_P3.4x3.7mm_StaggerOdd_Lead3.8mm_VerticalU4
1PiecTerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type059_RT06302HBWC_1x02_P3.50mm_HorizontalJ1
1Rx PiecLED_SMD:LED_1206_3216Metric_Pad1.42x1.75mm_HandSolderD8
1Rx TermostatLED_SMD:LED_1206_3216Metric_Pad1.42x1.75mm_HandSolderD10
1SS24Diode_SMD:D_SMA_HandsolderingD9
1TermostatTerminalBlock_MetzConnect:TerminalBlock_MetzConnect_Type059_RT06302HBWC_1x02_P3.50mm_HorizontalJ4
1WEMOS_D1_miniRF_Module:WEMOS_D1_mini_lightU2

Similar boards

  • 2 layers164 × 60.5 mmNixieClock, the printed circuit board in 3D

    NixieClock

    macdems/NixieClock

    A compact IN-14 Nixie clock project with both vintage character and modern connectivity.

    48 partsCC-BY-SA-4.0
  • 2 layers53.3 × 64.4 mmWifi homesensor, the printed circuit board in 3D

    Wifi homesensor

    masterfoxxhu/wifi_homesensor

    Quick and dirty ESP8266 based thermo and humidity meter for ESPhome

    33 partsGPL-3.0
  • 2 layers35.6 × 27 mmWemosMosfet, the printed circuit board in 3D

    WemosMosfet

    TheBlueManCoding/WemosMosfet

    WemosMosfet

    26 partsCC0-1.0
  • 2 layers43.9 × 27.7 mmTcd1304-4v, the printed circuit board in 3D

    Tcd1304-4v

    OpnTec/open-spectrometer-hardware

    Open source VIS spectrometer

    19 parts1.5k
  • 2 layers70 × 81 mmMitsumi M1M-24HB QuickDisk Drive, the printed circuit board in 3D

    Mitsumi M1M-24HB QuickDisk Drive

    4920616d20546f6d/Mitsumi_Famicom_Disk_Drive

    Mitsumi Famicom Disk System disk drive controller PCB

    84 parts18MIT
  • 2 layers100 × 100 mmMotherboard, the printed circuit board in 3D

    Motherboard

    Terminus-IMRC/RPiCluster2

    Yet another Raspberry Pi cluster, version 2

    334 parts9

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.