Skip to the content
2 layers75 × 64 mmESP24V HA XIAO, the printed circuit board in 3D

ESPHome controller for Dimplex ZL 300/400 VF ventilation units – isolated 24 V I/O, XIAO ESP32-C6, KiCad PCB, 3D-printed case. | ESPHome-Steuerung für Dimplex-Lüftungsgeräte ZL 300/400 VF mit Home Assistant.

Size
75 × 64 mm
Copper layers
2
Thickness
1.6 mm
Parts
47
Nets
39
Pads
119
Tracks, vias
110, 28
Pours
3
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
19 Oct 2026
Updated
19 Oct 2026

Overview

ESP24V HA XIAO is an open-source printed circuit board by Traxes, from the Traxes/dimplex-zl400-esphome repository on GitHub, published under the MIT licence. It is a 2-layer board of 75 × 64 mm with 47 parts on 39 nets, routed with 110 tracks and 28 vias.

It is built around the EL817-S1, 1N4148W and MMBT3906. Its parts include 21 resistors, 8 diodes, 7 ICs, 5 connectors and 2 transistors. It belongs with the home automation and IoT boards of this library.

Main components

3

README

README.md

Dimplex ZL 400 VF – ESPHome controller for Home Assistant

English · Deutsch

[!TIP] Want a ready-made one? I can build the assembled PCB and the 3D-printed enclosure for you – in any color, and the case can be adapted to your installation (shape, mounting, cable exits). If you're interested, open a request. Please don't post your address or phone number in the issue – details are arranged privately.

Controller installed on top of a Dimplex ZL 400 VF   Assembled controller v3 in the printed enclosure

Left: installed on a ZL 400 VF, wires to the unit's terminal board. Right: controller v3 in the printed case (lid removed).

A drop-in replacement for the wall control panel (“Bedienelement Typ 1”) of Dimplex ZL 300 VF / ZL 400 VF home ventilation units. A Seeed XIAO ESP32-C6 reads the unit's five 24 V status outputs through optocouplers and “presses” the up/down buttons with optocoupler-driven PNP switches. In Home Assistant the unit shows up as a normal fan with three speeds.

Highlights

  • Galvanically isolated: the ESP is powered only by USB-C, nothing but optocouplers crosses to the unit's 24 V side.
  • Closed-loop control: every key press is verified through the unit's LED outputs; retries with back-off, fault entities for HA.
  • KiCad 10 project + ready-to-order JLCPCB files (Gerber, BOM, CPL).
  • Snap-fit 3D-printed enclosure without screws, generated by a parametric Fusion 360 script.
  • Worst-case analysis, SPICE Monte Carlo and FMEA in docs/qa (German).

Status (2026-10-19): installed and running in a ZL 400 VF. Live test off → 1 → 3 → 2 → off: LED feedback within 3 s for every step, no fault flags.

[!WARNING] The ventilation unit contains mains voltage (230 V). Read the safety notes before you open the unit or connect anything. Build at your own risk. This is not a Dimplex product.

Contents

FolderWhat's inside
hardware/controller-v3KiCad project, schematic PDF, JLCPCB fabrication files
hardware/emulator-lab-v2Bench emulator of the unit's terminal board (not built/tested yet)
firmwareESPHome config trax_ha_c6.yaml, secrets.example.yaml
gehaeuseEnclosure: STL, 3MF, Bambu Studio project, STEP, Fusion 360 script
docsQA reports, interactive commissioning checklist, images, dimension sheet
toolsPython scripts used for QA, simulation and fabrication checks

Safety

[!CAUTION] Working on the ventilation unit can be life-threatening: there is mains voltage (230 V) inside. Read this section completely before you start.

Electrical

  • Before opening the unit or the terminal compartment, disconnect it from mains on all poles (circuit breaker or isolating switch). Secure it against being switched back on and verify that it is dead. Work on mains wiring is for qualified electricians only.
  • The controller is designed only for the unit's 24 V DC control circuit (PCB3 terminals +, −, AUS_x, EIN_x).
    • Never connect any terminal to mains or to another voltage source.
    • The absolute maximum is 30 V; above 27.5 V parts run outside their derating limits.
  • Measure + to − on PCB3 (DC volts) and check every wire against the wiring diagram before you connect the controller. Swapping + and − is blocked by diodes; other wiring mistakes are not.
  • Use ferrules on stranded wires, strip only as much as the terminal needs, and pull-test every wire. A stray strand can short the unit's 24 V supply.
  • Leave all other PCB3 terminals untouched. In particular, keep the RM (smoke detector) bridge in place: it is a safety shutdown input of the unit.
  • Do not connect other loads to the unit's 24 V supply. Its transformer is only rated for a few control panels and sensors (Dimplex manual, table 4.1).

ESP / USB side

  • Power the XIAO only from a certified USB power supply (safety extra-low voltage, CE marked). Never feed it from the unit's 24 V.
  • Never connect USB ground or any ESP pin to the unit's wiring. The isolation between the two sides must stay intact.

Enclosure and location

  • The printed enclosure is not flame-retardant: PLA and PETG are not UL 94 V-0. The controller dissipates only milliwatts, but keep it away from heat sources and out of the air stream of electric heater coils.
  • PLA softens from about 55 °C; use PETG or ASA for warm locations.
  • Install only in dry, frost-free rooms (the same requirements as for the unit itself): no condensation, no outdoor use.
  • Close the lid before operation; it protects the terminals against accidental contact.

Ventilation function

  • Home ventilation protects the building against moisture and mould. Make sure your automations can never keep the unit off for long periods, and keep the minimum ventilation required for your building (in Germany, for example, the moisture-protection level of DIN 1946-6).
  • If a fireplace or other combustion appliance shares the air volume, the safety devices required for that combination (for example a pressure monitor) stay mandatory. This controller does not replace them, and remote control must never override them.
  • The unit's own protective functions (frost protection, smoke-detector shutdown, filter alarm) stay active. Do not bypass them.
  • A Wi-Fi or firmware fault can leave the unit at its last stage. Watch control_failed and feedback_lost in Home Assistant; the unit's own display and buttons keep working as a fallback.

Liability

  • Building and using this is at your own risk. Connecting third-party electronics may affect the warranty of the ventilation unit. The documents come without any guarantee of correctness. This project is not affiliated with Dimplex.

How it works

Block diagram

DirectionCircuit
Unit → ESP (AUS0–AUS4)+24 V → 10 kΩ → EL817 LED → AUS. The unit switches AUS to 0 V, exactly like the LEDs of the original panel (≈ 2 mA). Output side: 3.3 V → GPIO with 10 kΩ pull-down.
ESP → unit (EIN0/EIN1)GPIO → 330 Ω → EL817 → pulls the base of an MMBT3906 (22 kΩ); the PNP puts +24 V on EIN through 1 kΩ – like pressing the panel button. 300 ms pulses.
PowerESP from USB-C only (an ESP powered from the unit's 24 V had tripped error E05 at power-up). 24 V side: 1N4148W reverse-polarity protection in + and −, “24V OK” LED. Load on the unit ≈ 1–10 mA.

Wiring

Wiring diagram

Set the unit to service menu 20 → 21 Bedienelement → “Typ1”. Terminal assignment follows the Dimplex installation manual ZL 300/400 VF, chapter 4.5.4, fig. 4.13 (PDF).

[!IMPORTANT] Unlike the original panel, this controller needs the GND → “−” wire. Measure between PCB3 “+” and “−” first: the design is rated for 21.6–27 V (see Known limitations).

Build it

1. PCB

Controller v3 layout with labels Controller v3, 3D view

  1. Upload hardware/controller-v3/fertigung-jlcpcb/gerbers.zip to JLCPCB (2 layers, 1.6 mm, 75 × 64 mm), choose PCBA Economic and add the BOM and CPL files. Q1/Q2 (SOT-23) rotation is already corrected by 180° in the CPL. Still check the placement preview.
  2. Hand-solder a Seeed XIAO ESP32-C6 and 5.08 mm screw terminals (2-pin J1, 5-pin J2, 2-pin J3). The XIAO can be soldered directly (the enclosure is dimensioned for that) or plugged into 1×7 socket headers.
  3. Commission it step by step with docs/Inbetriebnahme_Controller_v3.html (download and open locally; it covers measuring points, multimeter settings and expected values; German).
Part (assembled by JLCPCB)LCSCQtyRefs
1N4148W SOD-123C815987D1–D5, D7, D8
LED green 0805C22971D6
MMBT3906 SOT-23C21432Q1, Q2
EL817S SMD-4C632687U1–U7
10 kΩ 0805C1741414R1–R10, R15, R16, R18, R19
22 kΩ 0805C175603R13, R14, R17
330 Ω 0805C176302R11, R12
1 kΩ 0805C175132R20, R21

2. Firmware

  1. Copy firmware/secrets.example.yaml to secrets.yaml and fill it in. Never commit it, it is in .gitignore.
  2. Add trax_ha_c6.yaml in the ESPHome dashboard and flash it over USB. If you get “Failed to connect”, hold the B (BOOT) button next to the USB socket while plugging in the cable. After that, OTA works.
  3. Adopt the device in Home Assistant (ESPHome integration).
EntityPurpose
fan.<device>_ventilation3 speeds: 33 / 66 / 100 %, off = unit off
sensor.<device>_ventilation_levelActual stage 0–3 from the unit's LEDs
sensor.<device>_ventilation_statusOK / adjusting / fault text
binary_sensor.<device>_ventilation_auto, …_errorAuto mode, fault/filter LED
…_control_failed, …_feedback_lost, …_stuck_key_suspectedDiagnostics
sensor.<device>_ventilation_uncommanded_changesStage changes not caused by HA
button.<device>_ventilation_clear_faultsReset diagnostics
In Home Assistant

Home Assistant device page with fan dialog, sensors and activity log

Device page with the fan dialog. The activity log shows a real command from an automation: fan on at 22:10:00, LED feedback for stage 1 in the same second, status “OK” at 22:10:02.

  • The fan dialog offers Off / Low / Medium / High: stages 0–3, 0 / 33 / 66 / 100 %.
  • The status sensor uses German texts:
StatusMeaning
OKIdle, stage confirmed by the unit's LEDs
Stellt ein: 1 → 2Adjusting from stage 1 to 2
Aus (oder 24 V fehlt)Unit is off – or there is no 24 V / no LED signal at all
Gestört/unbekannt – keine RückmeldungA key press caused no LED change (check 24 V, wiring, EIN)
Steuerung fehlgeschlagenTarget not reached after all retries
Verdacht Dauerdruck – Hardware prüfen (T2)Stage moved against the pressed direction – possible stuck key
StartBooting; key presses are blocked until the first sync

Tested with ESPHome 2026.9.1 on a XIAO ESP32-C6.

Control logic: A requested speed becomes single key presses (300 ms pulse, 700 ms pause). After each press the firmware waits up to 2 s for the stage LEDs to change. If they don't, it retries with back-off (1/2/4/4 s, max. 10 presses). On boot the entity syncs to the real stage without pressing anything.

yaml
# Example automation action
action: fan.set_percentage
target:
  entity_id: fan.trax_ha_c6_ventilation
data:
  percentage: 66   # 33 = stage 1, 66 = stage 2, 100 = stage 3; use fan.turn_off for off

LED feedback is immediate. The fans themselves need about 30–70 s to reach their speed.

3. Enclosure

Enclosure with labelled wire exits USB side Inside Lid underside with snap hooks

  • Size: 80.7 × 69.8 × 24.1 mm, 95.8 mm long including the two wall-mounting tabs (slots for Ø 4 screws).
  • No hardware needed: pins on the bosses locate the PCB, four hold-downs in the lid clamp it, and the lid snaps into four windows. To open it, push each hook inwards through its window with a small screwdriver.
  • Openings: nine labelled wire holes (Ø 3.9 mm, aligned with the terminal entries), a USB-C opening, pin holes for RESET/BOOT (paper clip) and a light pipe for “24V OK”.
  • Printing (tested on a Bambu Lab P2S, PLA): 0.2 mm layers, 4 walls, 4 bottom layers, 15 % infill, no supports, lid printed top-down. About 1 h 25 min and 49 g. Use PETG for warm locations.
  • Files:
    • CentralVentilationCase_BambuStudio_P2S_PLA.3mf: ready-to-print Bambu Studio project
    • …_Geometrie.3mf: for other slicers
    • single STL files
    • STEP assembly with a PCB dummy
  • Modify: gehaeuse/fusion/gehaeuse_fusion.py rebuilds the whole model in Fusion 360 via the API. All dimensions are at the top of the script; the measurements come from the dimension sheet.

Emulator (optional)

Emulator v2

Bench replica of the unit's terminal board: DIP switches pull AUS0–4 to 0 V, LEDs show EIN0/EIN1. Not manufactured or tested yet. LED polarities in the assembly preview are unverified.

Known limitations

Details are in docs/qa/QA_Verifikation_2026-10-15.md (German).

  • Supply voltage: designed to EEE-INST-002 derating for 21.6–30 V. Above 27.5 V the output optocouplers U6/U7 exceed the derating limit (absolute max 35 V), and above ≈ 29 V so do R1–R5. Spikes on the 24 V line have not been measured.
  • EIN input current of the unit has not been measured. It decides whether R20/R21 = 1 kΩ is optimal (up to 4 mA the unit still sees ≥ 19 V).
  • Short circuit on EIN is tolerable for the pulse length only: a permanent short would put 0.5 W into R20/R21, which are rated 0.125 W.
  • A stuck key is not single-fault safe: a shorted Q1/Q2 or U6/U7 would hold a button down. The firmware only detects it indirectly (stuck_key_suspected).

Tools

tools/qa and tools/verifikation contain the scripts that generated and verified schematic and layout:

  • KiCad 10 Python
  • ngspice via the KiCad DLL
  • gerbonara / shapely

Local paths are replaced by <PROJEKT> / <HOME>; adjust them before running.

License

MIT: free to use, build, modify and share, also commercially, as long as the license notice is kept. Symbols and footprints embedded in the KiCad files come from the KiCad libraries (CC-BY-SA 4.0 with the KiCad design exception) and do not restrict your own boards.

Disclaimer

Dimplex and ZL 400 VF are trademarks of Glen Dimplex Deutschland GmbH; XIAO is a trademark of Seeed Studio. This project is not affiliated with or endorsed by either company.

Parts

47
QtyValueFootprintReferences
1410kResistor_SMD:R_0805_2012MetricR1, R2, R3, R4, R5, R6, R7, R8, R9, R10, R15, R16, R18, R19
71N4148WDiode_SMD:D_SOD-123D1, D2, D3, D4, D5, D7, D8
7EL817SPackage_DIP:SMDIP-4_W9.53mmU1, U2, U3, U4, U5, U6, U7
4M3MountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4
322kResistor_SMD:R_0805_2012MetricR13, R14, R17
21kResistor_SMD:R_0805_2012MetricR20, R21
2330Resistor_SMD:R_0805_2012MetricR11, R12
2MMBT3906Package_TO_SOT_SMD:SOT-23Q1, Q2
124V_from_unitTerminalBlock_Phoenix:TerminalBlock_Phoenix_MKDS-1,5-2-5.08_1x02_P5.08mm_HorizontalJ1
1AUS_0-4_unit_outputsTerminalBlock_Phoenix:TerminalBlock_Phoenix_MKDS-1,5-5-5.08_1x05_P5.08mm_HorizontalJ2
1EIN_0-1_unit_inputsTerminalBlock_Phoenix:TerminalBlock_Phoenix_MKDS-1,5-2-5.08_1x02_P5.08mm_HorizontalJ3
1GREENLED_SMD:LED_0805_2012MetricD6
1XIAO_left_D0-D6Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_VerticalJ4
1XIAO_right_5V_GND_3V3_D10-D7Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_VerticalJ5

More from Traxes/dimplex-zl400-esphome

1
  • 2 layers68 × 56 mmESP24V Ventilation LAB, the printed circuit board in 3D

    ESP24V Ventilation LAB

    Traxes/dimplex-zl400-esphome

    ESPHome controller for Dimplex ZL 300/400 VF ventilation units – isolated 24 V I/O, XIAO ESP32-C6, KiCad PCB, 3D-printed case. | ESPHome-Steuerung für Dimplex-Lüftungsgeräte ZL 300/400 VF mit Home Assistant.

    28 partsMIT

Similar boards

  • 2 layers67 × 54.5 mmUblink, the printed circuit board in 3D

    Ublink

    koraa/ublink

    PWM control for high power LEDs

    61 parts1
  • 2 layers80 × 100 mmPir, the printed circuit board in 3D

    Pir

    buha/pir-trigger

    Camera trigger using PIR sensor

    137 partsGPL-3.0
  • 2 layers60.5 × 65.5 mmBloX ABC MkII, the printed circuit board in 3D

    BloX ABC MkII

    bask185/Train-Science-DIY

    69 parts3
  • 4 layers99 × 53.3 mmPSLab, the printed circuit board in 3D

    PSLab

    fossasia/pslab-hardware

    PSLab Hardware Design and Schematics https://pslab.io

    199 parts1.7kApache-2.0
  • 6 layers160 × 100 mmAdrmu6layer, the printed circuit board in 3D

    Adrmu6layer

    marcoreps/ADRmu

    ADR1000 10V standard

    240 parts149
  • 2 layers60.2 × 106.5 mmTiNRS - DuckTape, the printed circuit board in 3D

    TiNRS - DuckTape

    ThisIsNotRocketScience/Eurorack-Modules

    This is not Rocket Science presents: Eurorack modular synthesizer modules!

    262 parts87MIT
  • 2 layers84 × 85 mmHbr mk2-rxtx, the printed circuit board in 3D

    Hbr mk2-rxtx

    afiskon/hbr-mk2

    All HF bands QRP CW/SSB transceiver

    239 parts76MIT
  • 2 layers155 × 70 mmPayphone v1, the printed circuit board in 3D

    Payphone v1

    sdylewski/Analog-Redial

    A circuit board for old telephones to come back to life. Plug one or two phones in, and you can call the other phone, use bluetooth, connect to others via voip, and do a variety of other things with a plain old rotary…

    137 parts46

Questions

How big is the ESP24V HA XIAO PCB?

It measures 75 × 64 mm and has 2 copper layers, 1.6 mm thick.

What parts does the ESP24V HA XIAO use?

47 parts, built around the EL817-S1, 1N4148W and MMBT3906. 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 ESP24V HA XIAO KiCad files?

From the Traxes/dimplex-zl400-esphome repository on GitHub, at the commit this page was made from: the board is hardware/controller-v3/kicad/ESP24V_HA_XIAO.kicad_pcb and its schematic hardware/controller-v3/kicad/ESP24V_HA_XIAO.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the ESP24V HA XIAO design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).