

Kwl esp32
ESP32-Platine, um Zehnder ComfoAir, StorkAir WHR und Wernig G90 über RS232 in Home Assistant einzubinden (ESPHome, ohne Cloud)
- Size
- 70 × 55 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 40
- Nets
- 72
- Pads
- 212
- Tracks, vias
- 576, 54
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 3 Oct 2026
- Updated
- 3 Oct 2026
Overview
Kwl esp32 is an open-source printed circuit board by hpralfi, from the hpralfi/comfoair-esp32 repository on GitHub, published under the CERN-OHL-S-2.0 licence. It is a 2-layer board of 70 × 55 mm with 40 parts on 72 nets, routed with 576 tracks and 54 vias.
It is built around the ESP32-WROOM-32E, MAX3232ID and CH340K, with the AP2112K-3.3, USBLC6-2SC6 and MMBT3904 among its other parts. Its parts include 14 capacitors, 7 resistors, 5 ICs, 3 connectors and 3 switches. It belongs with the home automation and IoT boards and the ESP32 boards of this library.
Main components
8ESP32-WROOM-32E
SMD,18x25.5mmSMD,18x25.5mm WiFi Modules ROHSEspressif SystemsWiFi ModulesMAX3232ID
SOIC-16-40℃~+85℃ 2 2 250Kbps 300uA 3V~5.5V Short-Circuit Protection Transceiver Yes ±15kV SOIC-16 RS232 ICs ROHSTexas InstrumentsRS232 ICsCH340K
ESSOP-10-150mil-1mm-20℃~+70℃ 2Mbps 3.3V、5V USB 2.0 USB to serial ESSOP-10-150mil-1mm USB Converters ROHSWCH (Nanjing Qinheng Microelectronics)USB ConvertersAP2112K-3.3
SOT253.3V 600mA CMOS Low Dropout Linear Regulator with EnableDiodes IncorporatedUncategorisedUSBLC6-2SC6
SOT-23-60.35pF、0.8pF 100nA 150W@8/20us 15V 2 5V 6A@8/20us 6V ESD SOT-23-6 ESD and Surge Protection (TVS/ESD) ROHSUMWESD And Surge Protection (TVS/ESD)MMBT3904
SOT-23-55℃~+150℃ 1 NPN 100 100nA 200mA 200mW 300MHz 300mV 40V 6V NPN SOT-23 Bipolar (BJT) ROHSJiangsu Changjing Electronics Technology (CJ)Bipolar (BJT)1N4148W
SOD-123150mA 1A 1V@50mA 1uA@75V 400mW 4ns 75V Independent SOD-123 Switching Diodes ROHSSTMicroelectronicsSwitching DiodesWS2812B
5mm X 5mm Surface Mount RGB LED with Intelligent ControlWorldsemiUncategorised
README
README.mdcomfoair-esp32
Zehnder ComfoAir, StorkAir WHR oder Wernig G90 in Home Assistant einbinden — lokal, ohne Cloud und ohne MQTT.

Eine kleine ESP32-Platine für die Buchse „RS232 PC“ von Lüftungsgeräten mit der Zehnder-Steuerplatine CA350. Sie läuft mit ESPHome und erscheint in Home Assistant mit über 40 Entitäten: Temperaturen, Lüftungsstufe, Ventilatorleistung und Drehzahl, Bypass, Filterzustand, Frostschutz, Betriebsstunden.
Entstanden ist sie als Ersatz für einen Gira HomeServer mit Moxa-Seriell-Gateway an einer Wernig G90-380. Dort läuft sie seit Oktober 2026.
Funktionen
- Native Home-Assistant-Anbindung über die ESPHome-API — kein MQTT-Broker, keine Cloud
- Alle Werte des Geräts: vier Temperaturen, Stufe, Leistung und Drehzahl der Ventilatoren, Bypass, Filter, Frostschutz, Vorheizung, Betriebsstunden je Stufe
- Steuern: Lüftungsstufe 0–3, Komforttemperatur, Stufenwerte in Prozent, Stoßlüften-Taster auf der Platine
- Schalter für das Bedienteil: CC-Ease / CC-Luxe parallel weiter nutzen oder dunkel schalten, sodass nur Home Assistant bedient (siehe RS232-Modus)
- Eigene Weboberfläche im Browser (mit Anmeldung): Stufenwahl, Wärmetauscher-Schaubild mit allen vier Temperaturen, Ventilatoren, Filterwarnung, Einstellungen, Live-Log, Firmware-Update per Datei — auch ohne Home Assistant, am Handy wie am PC
- Updates über WLAN nach dem ersten Flashen
- USB-C für Versorgung und Programmierung (CH340K an Bord, automatischer Wechsel in den Bootloader)
- Zweiter RS232-Kanal an einer Schraubklemme, vorgesehen für einen späteren Proxy-Betrieb des Bedienteils
- Status-LED (WS2812B) und ein frei belegbarer Taster
In Home Assistant

Beispiel-Dashboard: Stufenknöpfe, Schalter für das Bedienteil, Ventilatoren, Bypass, Filter, Betriebsstunden und Temperaturverlauf über 24 Stunden.
Weboberfläche

Unter http://<adresse-der-platine>/, eingebettet in die Firmware (firmware/webui/comfoair-ui.js), braucht kein Internet. Wer die Standardansicht von ESPHome bevorzugt, entfernt in der Konfiguration die Zeilen js_url und js_include.
Hardware
| Größe | 70 × 55 mm, 2 Lagen, 1,6 mm |
| Prozessor | ESP32-WROOM-32E (WLAN, Leiterplattenantenne) |
| Pegelwandler | MAX3232 (2 Kanäle) |
| USB | USB-C, CH340K, ESD-Schutz USBLC6 |
| Versorgung | 5 V über USB-C, Regler AP2112K 3,3 V, unter 1 W |
| Anschluss Gerät | DB9-Stecker, DTE-Belegung: Pin 2 RX, Pin 3 TX, Pin 5 GND |
| Zweiter Anschluss | 3-polige Schraubklemme (RS232-Kanal 2) |
| Lötbrücken | JP1/JP2 kreuzen RX/TX am DB9 bei Bedarf |
Der DB9 ist belegt wie bei einer Moxa NPort 5110: Hängt am Gerät schon ein Seriell-Gateway oder PC-Kabel, dieses abstecken und die Platine mit demselben Kabel anschließen. An der Wernig G90-380 war kein Kreuzen nötig.
Schaltplan: hardware/schematic.pdf · KiCad-Projekt: hardware/kicad/ · Fertigungsdaten: hardware/production/
Kompatible Geräte
Das ComfoAir-Seriellprotokoll sprechen viele Geräte und ihre Handelsmarken-Varianten. Die meisten Kompatibilitätsangaben im Netz sind aus derselben Protokollbeschreibung abgeschrieben — deshalb trennt diese Liste nachgewiesene von nur gelisteten Geräten.
| Gerät | Marke | Status | Hinweis |
|---|---|---|---|
| G90-380 (CS / Luxe) | Wernig | ✅ mit dieser Platine nachgewiesen | meldet „CA350 luxe“, Firmware 3.20 |
| G90-160 | Wernig | ✅ nachgewiesen (andere Projekte) | openHAB-Binding |
| ComfoAir 350 | Zehnder | ✅ nachgewiesen (andere Projekte) | Referenzgerät des Protokolls |
| ComfoAir 160 | Zehnder | ✅ nachgewiesen (andere Projekte) | esphome-comfoair |
| ComfoD 450 | Zehnder | ✅ nachgewiesen (andere Projekte) | |
| G90-200 CS | Wernig | 🟡 wahrscheinlich | „RS232 PC“ im Schaltplan |
| ComfoAir 200 / 500 / 550 | Zehnder | 🟡 wahrscheinlich | gelistet, kein Testbericht |
| ComfoD 300 / 350 / 550 | Zehnder | 🟡 wahrscheinlich | gelistet |
| WHR 920 / 930 / 950 / 960 | J.E. StorkAir | 🟡 wahrscheinlich | gelistet |
| Santos 370 DC | Paul | 🟡 wahrscheinlich | gelistet |
| G90-300 | Wernig | ❔ ungeprüft | Schnittstelle nicht bestätigt |
| ComfoAir Q350 / Q450 / Q600, Wernig Q350 / Q600 | Zehnder / Wernig | ❌ nicht kompatibel | CAN / ComfoNet |
| ComfoAir E300 / E350 / E400 | Zehnder | ❌ nicht kompatibel | Modbus RTU (RS485) |
| Novus 300 | Paul | ❌ nicht kompatibel | RS485 |
| Vitovent 300-W | Viessmann | ❌ nicht kompatibel | OpenTherm / Modbus |
Ein 🟡-Gerät getestet? Bitte ein Issue anlegen — es wandert dann zu ✅.
So prüfst du dein Gerät
- Typenschild: eines der Modelle oben. Ein „Q“ oder „E“ im Modellnamen heißt: passt nicht.
- Bedienteil: CC-Ease (Drehrad mit Display), CC-Luxe oder die alte ComfoSense sind gute Zeichen. ComfoConnect, ComfoSense C oder ein Touch-Display deuten auf die Q-Plattform.
- Steuerplatine: CA350 / CA550 mit einem Anschluss „RS232“ oder „RS232 PC“. Bei manchen Geräten ist das keine DB9-Buchse, sondern RJ45 oder Schraubklemmen (RX/TX/GND) — dann braucht es ein Adapterkabel.
- Auf der Konnektorplatine der Wernig G90-380 CS gibt es zusätzlich RS485-Klemmen („Entalpy“, „Hybalans“). Die sind für Zubehör, nicht der PC-Anschluss.
Platine bekommen
Fertige Platine
Bestückte und geprüfte Platinen: DB9 und Schraubklemme gelötet, Lötbrücken gesetzt, Firmware aufgespielt.
Fertige Platinen sind in Vorbereitung. Melde dich unverbindlich — mit Gerätemodell und Land, dann sage ich Bescheid, sobald es losgeht:
Selbst bauen
- Bei JLCPCB mit Bestückung (PCBA) bestellen:
gerber.zip,jlcpcb-bom.csvundjlcpcb-cpl.csvhochladen. Die Bestückungsdatei enthält bereits die Dreh- und Lagekorrekturen, die JLCPCB braucht. Die LCSC-Nummern beim Bestellen auf Lagerbestand prüfen. - Von Hand löten: J2 (DB9-Stecker, gewinkelt, mit Befestigungsbohrungen) und J3 (3-polige Schraubklemme, 5,08 mm). Auch die beiden Befestigungslaschen des DB9 verlöten — sie tragen die Steckkraft. Sie hängen an der Massefläche: breite Meißelspitze, etwa 380 °C.
- Lötbrücken JP1 und JP2 auf Pad 1–2 schließen. Sie sind ab Werk offen — ohne sie ist der DB9 nicht mit dem MAX3232 verbunden und das Gerät bleibt stumm. (Pad 2–3 kreuzt RX/TX, falls das Kabel es braucht.)
- Firmware aufspielen (unten).
Firmware
Die Platine nutzt einen Fork von wichers/esphome-comfoair mit zwei Ergänzungen: RS232-Modus setzen (Kommando 0x9B) und den vom Gerät gemeldeten Modus auswerten (0x9C).
firmware/comfoair-esp32.yaml, den Ordnerfirmware/webui/undfirmware/secrets.yaml.example(alssecrets.yaml) in den ESPHome-Ordner kopieren und ausfüllen.- Erstes Flashen über USB-C, z. B. mit dem ESPHome-Dashboard oder
esphome run comfoair-esp32.yaml. Die Platine wechselt selbst in den Bootloader. - Danach laufen Updates über WLAN.
- Home Assistant findet das Gerät; den API-Schlüssel eingeben, wenn danach gefragt wird.
- Webinterface:
http://<adresse-der-platine>/, Anmeldung mitweb_username/web_passwordaussecrets.yaml. Dort lassen sich auch neue Firmware-Dateien (.bin) hochladen.
RS232-Modus und das Bedienteil
Das Gerät kennt mehrere RS232-Modi. Gemessen an einer CA350 mit Firmware 3.20:
| Modus | Bedeutung | Ergebnis |
|---|---|---|
| 1 „nur PC“ | wird quittiert, aber ignoriert | |
| 3 „PC Master“ | angenommen — Bedienteil wird dunkel | |
| 0 „Ende“ (aus 3) | zurück auf 2 „nur CC-Ease“ | Bedienteil aktiv, Home Assistant liest und schaltet trotzdem |
Der Schalter „Wall panel“ in Home Assistant wählt zwischen beiden: aus = Modus 3 (Bedienteil dunkel), an = Modus 2 (beide parallel). Nach einem Stromausfall startet das Gerät in Modus 2; die Platine prüft den gemeldeten Modus jede Minute und stellt die Einstellung wieder her.
Einbau
- Die Platine hängt nur an der Kleinspannungs-Schnittstelle RS232. Den Netzspannungsteil des Geräts nicht öffnen.
- Versorgung über ein beliebiges USB-C-Netzteil (5 V, 0,5 A reichen).
- Das Antennenende der Platine frei von Metall halten, dann ist der WLAN-Empfang gut.
- Auf der RS232-Leitung darf nur ein Master sprechen: anderes Gateway oder PC vorher abstecken.
Lizenz
- Hardware (
hardware/): CERN-OHL-S-2.0 - Firmware-Konfiguration und Dokumentation: GPL-3.0, wie die zugrunde liegende ESPHome-Komponente
Haftungsausschluss
Ein unabhängiges Hobbyprojekt ohne Verbindung zu Zehnder Group, J.E. StorkAir, Wernig oder Paul. Marken- und Modellnamen dienen nur zur Angabe der Kompatibilität. Nutzung auf eigene Gefahr.
Dank
- wichers/esphome-comfoair — die ESPHome-Komponente
- Die ComfoAir-Protokollbeschreibung der Community sowie die Projekte FHEM, openHAB und hacomfoairmqtt
Parts
40| Qty | Value | Footprint | References |
|---|---|---|---|
| 11 | 100n | Capacitor_SMD:C_0603_1608Metric | C2, C4, C5, C7, C8, C9, C10, C11, C12, C13, C14 |
| 2 | 10k | Resistor_SMD:R_0603_1608Metric | R5, R6 |
| 2 | 12k | Resistor_SMD:R_0603_1608Metric | R3, R4 |
| 2 | 1u | Capacitor_SMD:C_0603_1608Metric | C3, C6 |
| 2 | 5k1 | Resistor_SMD:R_0603_1608Metric | R1, R2 |
| 2 | MMBT3904 | Package_TO_SOT_SMD:SOT-23 | Q1, Q2 |
| 2 | RX-Wahl | Jumper:SolderJumper-3_P1.3mm_Open_Pad1.0x1.5mm | JP1, JP3 |
| 2 | TX-Wahl | Jumper:SolderJumper-3_P1.3mm_Open_Pad1.0x1.5mm | JP2, JP4 |
| 1 | 1N4148W | Diode_SMD:D_SOD-123 | D2 |
| 1 | 22u | Capacitor_SMD:C_0805_2012Metric | C1 |
| 1 | 330 | Resistor_SMD:R_0603_1608Metric | R7 |
| 1 | AP2112K-3.3 | Package_TO_SOT_SMD:SOT-23-5 | U4 |
| 1 | BOOT | Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2 | SW2 |
| 1 | CC-EASE | TerminalBlock:TerminalBlock_MaiXu_MX126-5.0-03P_1x03_P5.00mm | J3 |
| 1 | CH340K | Package_SO:SSOP-10-1EP_3.9x4.9mm_P1mm_EP2.1x3.3mm | U3 |
| 1 | DE9 KWL | Connector_Dsub:DSUB-9_Pins_Horizontal_P2.77x2.84mm_EdgePinOffset4.94mm_Housed_MountingHolesOffset4.94mm | J2 |
| 1 | ESP32-WROOM-32E | RF_Module:ESP32-WROOM-32E | U1 |
| 1 | MAX3232 | Package_SO:SOIC-16_3.9x9.9mm_P1.27mm | U2 |
| 1 | RESET | Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2 | SW1 |
| 1 | TASTER | Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2 | SW3 |
| 1 | USB-C | Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J1 |
| 1 | USBLC6-2SC6 | Package_TO_SOT_SMD:SOT-23-6 | U5 |
| 1 | WS2812B | LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm | D1 |
Similar boards
- 2 layers102.9 × 103.7 mm

- 2 layers52.8 × 71.8 mm

ESPBoosted
schoolllex/ESPBoosted
A custom, feature-rich ESP32-WROOM-32 development board featuring built-in environmental sensors, power management, and expansion interfaces.
51 parts - 2 layers210 × 297 mm

Fra clock
albertoboffi-PERSONAL/fra-clock
A one-off gift PCB designed in KiCad 10: an ESP32 clock with a ring of 180 WS2812B‑2020 LEDs, a photo printed in exposed copper on the front, two Makerverse 8 Ω / 5 W speakers driven by two MAX98357A I²S amplifiers…
428 parts - 4 layers60.2 × 60.5 mm

ESP32 FlightController
durveshpathak1989/kicad-local-agent
Free local Ollama agent for generating and validating KiCad project files
73 partsMIT - 2 layers76.8 × 100 mm

Project CV
KazimGL/ESP32-PowerIoT-DevBoard
ESP32 battery-powered IoT dev board with Li-ion charging, protection, and sensor support — designed in KiCad
62 parts - 4 layers61 × 100 mm

BigCore
Dschadu/Geistwerk-BigCore
An ESP32-based open hardware control board designed for Bottango-powered animatronic and motion projects.
152 parts4CERN-OHL-W-2.0 - 4 layers50 × 50 mm

CosplayCore
professoralex13/CosplayCore
This overrides the strapping pin so the memory supply voltage is permenantly set at 3.3V. Until this comand is run and the fuses are burned on the ESP32, it cannot be flashed with any code.
80 parts - 4 layers76 × 50 mm

Wigglecam
jadenrhee/wigglecam-controller
RP2040 co-processor board for a 4-lens wigglegram camera: constant-current flash, controls, battery telemetry, Pi 5 I2C interface. 4-layer, DRC-clean, fab-ready.
105 parts
Questions
How big is the Kwl esp32 PCB?
It measures 70 × 55 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Kwl esp32 use?
40 parts, built around the ESP32-WROOM-32E, MAX3232ID, CH340K and AP2112K-3.3. 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 Kwl esp32 KiCad files?
From the hpralfi/comfoair-esp32 repository on GitHub, at the commit this page was made from: the board is hardware/kicad/kwl-esp32.kicad_pcb and its schematic hardware/kicad/kwl-esp32.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Kwl esp32 design in my own project?
Its repository publishes it under the CERN-OHL-S-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).