Skip to the content
2 layers70 × 55 mmKwl esp32, the printed circuit board in 3D

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

8

README

README.md

comfoair-esp32

Zehnder ComfoAir, StorkAir WHR oder Wernig G90 in Home Assistant einbinden — lokal, ohne Cloud und ohne MQTT.

English · Projektseite

comfoair-esp32 Platine

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

Home-Assistant-Dashboard

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

Weboberfläche

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öße70 × 55 mm, 2 Lagen, 1,6 mm
ProzessorESP32-WROOM-32E (WLAN, Leiterplattenantenne)
PegelwandlerMAX3232 (2 Kanäle)
USBUSB-C, CH340K, ESD-Schutz USBLC6
Versorgung5 V über USB-C, Regler AP2112K 3,3 V, unter 1 W
Anschluss GerätDB9-Stecker, DTE-Belegung: Pin 2 RX, Pin 3 TX, Pin 5 GND
Zweiter Anschluss3-polige Schraubklemme (RS232-Kanal 2)
LötbrückenJP1/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ätMarkeStatusHinweis
G90-380 (CS / Luxe)Wernig✅ mit dieser Platine nachgewiesenmeldet „CA350 luxe“, Firmware 3.20
G90-160Wernig✅ nachgewiesen (andere Projekte)openHAB-Binding
ComfoAir 350Zehnder✅ nachgewiesen (andere Projekte)Referenzgerät des Protokolls
ComfoAir 160Zehnder✅ nachgewiesen (andere Projekte)esphome-comfoair
ComfoD 450Zehnder✅ nachgewiesen (andere Projekte)
G90-200 CSWernig🟡 wahrscheinlich„RS232 PC“ im Schaltplan
ComfoAir 200 / 500 / 550Zehnder🟡 wahrscheinlichgelistet, kein Testbericht
ComfoD 300 / 350 / 550Zehnder🟡 wahrscheinlichgelistet
WHR 920 / 930 / 950 / 960J.E. StorkAir🟡 wahrscheinlichgelistet
Santos 370 DCPaul🟡 wahrscheinlichgelistet
G90-300Wernig❔ ungeprüftSchnittstelle nicht bestätigt
ComfoAir Q350 / Q450 / Q600, Wernig Q350 / Q600Zehnder / Wernig❌ nicht kompatibelCAN / ComfoNet
ComfoAir E300 / E350 / E400Zehnder❌ nicht kompatibelModbus RTU (RS485)
Novus 300Paul❌ nicht kompatibelRS485
Vitovent 300-WViessmann❌ nicht kompatibelOpenTherm / Modbus

Ein 🟡-Gerät getestet? Bitte ein Issue anlegen — es wandert dann zu ✅.

So prüfst du dein Gerät

  1. Typenschild: eines der Modelle oben. Ein „Q“ oder „E“ im Modellnamen heißt: passt nicht.
  2. 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.
  3. 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.
  4. 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:

📧 office@gfrerrer.at

Selbst bauen

  1. Bei JLCPCB mit Bestückung (PCBA) bestellen: gerber.zip, jlcpcb-bom.csv und jlcpcb-cpl.csv hochladen. Die Bestückungsdatei enthält bereits die Dreh- und Lagekorrekturen, die JLCPCB braucht. Die LCSC-Nummern beim Bestellen auf Lagerbestand prüfen.
  2. 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.
  3. 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.)
  4. 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).

  1. firmware/comfoair-esp32.yaml, den Ordner firmware/webui/ und firmware/secrets.yaml.example (als secrets.yaml) in den ESPHome-Ordner kopieren und ausfüllen.
  2. Erstes Flashen über USB-C, z. B. mit dem ESPHome-Dashboard oder esphome run comfoair-esp32.yaml. Die Platine wechselt selbst in den Bootloader.
  3. Danach laufen Updates über WLAN.
  4. Home Assistant findet das Gerät; den API-Schlüssel eingeben, wenn danach gefragt wird.
  5. Webinterface: http://<adresse-der-platine>/, Anmeldung mit web_username / web_password aus secrets.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:

ModusBedeutungErgebnis
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
QtyValueFootprintReferences
11100nCapacitor_SMD:C_0603_1608MetricC2, C4, C5, C7, C8, C9, C10, C11, C12, C13, C14
210kResistor_SMD:R_0603_1608MetricR5, R6
212kResistor_SMD:R_0603_1608MetricR3, R4
21uCapacitor_SMD:C_0603_1608MetricC3, C6
25k1Resistor_SMD:R_0603_1608MetricR1, R2
2MMBT3904Package_TO_SOT_SMD:SOT-23Q1, Q2
2RX-WahlJumper:SolderJumper-3_P1.3mm_Open_Pad1.0x1.5mmJP1, JP3
2TX-WahlJumper:SolderJumper-3_P1.3mm_Open_Pad1.0x1.5mmJP2, JP4
11N4148WDiode_SMD:D_SOD-123D2
122uCapacitor_SMD:C_0805_2012MetricC1
1330Resistor_SMD:R_0603_1608MetricR7
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U4
1BOOTButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW2
1CC-EASETerminalBlock:TerminalBlock_MaiXu_MX126-5.0-03P_1x03_P5.00mmJ3
1CH340KPackage_SO:SSOP-10-1EP_3.9x4.9mm_P1mm_EP2.1x3.3mmU3
1DE9 KWLConnector_Dsub:DSUB-9_Pins_Horizontal_P2.77x2.84mm_EdgePinOffset4.94mm_Housed_MountingHolesOffset4.94mmJ2
1ESP32-WROOM-32ERF_Module:ESP32-WROOM-32EU1
1MAX3232Package_SO:SOIC-16_3.9x9.9mm_P1.27mmU2
1RESETButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW1
1TASTERButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW3
1USB-CConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U5
1WS2812BLED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmD1

Similar boards

  • 2 layers102.9 × 103.7 mmDrone ESP32, the printed circuit board in 3D

    Drone ESP32

    Asaf66/Drone_ESP32

    Rev 2 fixes the issues found while assembling the first board:

    80 parts
  • 2 layers52.8 × 71.8 mmESPBoosted, the printed circuit board in 3D

    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 mmFra clock, the printed circuit board in 3D

    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 mmESP32 FlightController, the printed circuit board in 3D

    ESP32 FlightController

    durveshpathak1989/kicad-local-agent

    Free local Ollama agent for generating and validating KiCad project files

    73 partsMIT
  • 2 layers76.8 × 100 mmProject CV, the printed circuit board in 3D

    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 mmBigCore, the printed circuit board in 3D

    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 mmCosplayCore, the printed circuit board in 3D

    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 mmWigglecam, the printed circuit board in 3D

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