GerlCraft Zehnder Bridge

Für den Aufbau werden folgende Komponenten benötigt:

Komponente	Aufgabe
M5Stack AtomS3 Lite	ESP32-S3, WLAN, Weboberfläche und Firmware
M5Stack Atomic CAN Base A103	galvanisch isolierte CAN-Schnittstelle
USB-C-Datenkabel	Erstinstallation und Testversorgung
Anschlussleitung	Verbindung zu CAN-H und CAN-L des ComfoNet
Mean Well HDR-15-5	separate 5-V-Hutschienenversorgung für den dauerhaften Betrieb
optionaler DC/DC-Wandler	wandelt eine vorhandene 12-/24-V-Versorgung sicher auf 5 V

Die veröffentlichte Browser-Firmware ist für den AtomS3 Lite gebaut. Der ältere M5Stack Atom Lite ist ein anderes Gerät und wird von diesem Installationspaket nicht unterstützt.

Die Atomic CAN Base verwendet einen CA-IS3050G-Transceiver mit integrierter galvanischer Trennung. Technische Details stehen in der offiziellen M5Stack-Dokumentation.

Wer CAN-Bus, ESP32 und M5Stack zunächst grundsätzlich kennenlernen möchte, findet die Grundlagen im Beitrag RS-485, CAN-Bus, ESP32 und M5Stack einfach erklärt.

Der AtomS3 Lite wird direkt auf die Atomic CAN Base gesteckt. Stecker und Gehäuse müssen dabei sauber ausgerichtet sein. Die Verbindung nur im spannungslosen Zustand herstellen.

Die Firmware verwendet bei dieser Hardware folgende Konfiguration:

CAN TX: GPIO 5
CAN RX: GPIO 6
Bitrate: 50 kbit/s
CAN-IDs: Extended Frames

Diese Zuordnung ist bereits in der Firmware hinterlegt und muss bei der Standardhardware nicht angepasst werden.

Für die Datenverbindung werden die beiden CAN-Signalleitungen verbunden:

Zehnder ComfoNet	Atomic CAN Base
CAN-H	CAN-H
CAN-L	CAN-L

Zehnder ComfoAir Q                 GerlCraft Bridge
ComfoNet CAN-H  ---------------->  Atomic CAN Base CAN-H
ComfoNet CAN-L  ---------------->  Atomic CAN Base CAN-L
geregelte 5 V   ---------------->  AtomS3 Lite / USB-C-Versorgung

Bei meinen ersten Versuchen habe ich die 12-V-Versorgungsleitung der Zehnder angezapft und die Spannung mit einem DC/DC-Wandler auf 5 V reduziert. Dieser Aufbau funktionierte grundsätzlich. Der AtomS3 Lite darf jedoch niemals direkt mit 12 oder 24 V verbunden werden. Der Wandler muss für die benötigte Leistung ausgelegt, korrekt eingestellt und seine Ausgangsspannung vor dem Anschluss mit einem Multimeter kontrolliert werden.

Verwendet habe ich dafür ein XY-3606 Step-Down-Modul mit Schraubklemmen und USB-Ausgang. Das Modul wird als 12-/24-V-auf-5-V-Wandler angeboten: verwendeten DC/DC-Wandler bei Amazon ansehen. Der Link dokumentiert meinen damaligen Aufbau; unabhängig von den Angaben des Anbieters sollte die Ausgangsspannung vor dem Anschluss immer selbst gemessen werden.

Da mir diese Lösung für den dauerhaften Einbau nicht gefiel, habe ich später auf ein separates Mean Well HDR-15-5 Hutschienennetzteil gewechselt. Es liefert 5 V DC mit bis zu 2,4 A und wird direkt auf einer DIN-Schiene montiert: verwendetes Mean Well HDR-15-5 bei Amazon ansehen. Die Bridge erhält dadurch eine eigene, sauber aufgebaute 5-V-Versorgung und ist nicht mehr von der 12-V-Leitung der Lüftungsanlage abhängig.

Für den ersten Test genügt ein geeignetes USB-C-Netzteil. Erst wenn Firmware, WLAN und Weboberfläche funktionieren, wird die spannungsfreie Bridge mit CAN-H und CAN-L verbunden.

Die einfachste Installation erfolgt über den offiziellen Projekt-Installer:

Benötigt werden Google Chrome oder Microsoft Edge auf einem Computer sowie ein USB-C-Datenkabel.

1. AtomS3 Lite noch nicht mit dem ComfoNet verbinden.
2. AtomS3 Lite per USB-C am Computer anschließen.
3. Browser-Installer öffnen.
4. AtomS3 verbinden und installieren anklicken.
5. Den passenden Espressif- beziehungsweise USB-Anschluss auswählen.
6. Bei einer Erstinstallation das Löschen vorhandener Daten bestätigen.
7. Installation abwarten und den AtomS3 anschließend neu starten.

Nach dem ersten Start erzeugt die Bridge ein eigenes Einrichtungs-WLAN:

WLAN: Zehnder-Bridge-Setup
Passwort: zehnder-setup
Adresse: http://192.168.4.1

Mit einem Handy oder Laptop mit diesem WLAN verbinden. Die Meldung Kein Internet ist dabei normal. Danach http://192.168.4.1 öffnen und Konfiguration öffnen auswählen.

• WLAN-Name und WLAN-Passwort
• MQTT-Broker und MQTT-Port
• optionaler MQTT-Benutzername und MQTT-Passwort
• eigenes Admin-/OTA-Passwort
• Hostname und optionaler lokaler DNS-Name
• sichtbarer Gerätename
• Aktualisierungsrate der Webansichten

Nach dem Speichern die Bridge neu starten. Standardmäßig ist sie anschließend unter http://zehnder-bridge.local erreichbar. Falls .local im eigenen Netzwerk nicht funktioniert, kann die IP-Adresse im Router nachgesehen und direkt aufgerufen werden.

Wenn die Weboberfläche im Heimnetz erreichbar ist, kann die Bridge mit der Lüftungsanlage verbunden werden.

1. Zehnder-Anlage und Bridge ausschalten.
2. CAN-H und CAN-L wie oben beschrieben verbinden.
3. Anschlüsse und 5-V-Versorgung erneut kontrollieren.
4. Bridge und Anlage einschalten.
5. Nach dem Start die Weboberfläche aufrufen.

CAN-Bus: aktiv
Zehnder: online
MQTT: verbunden
Bridge-Gesundheit: OK

Die Zahl der empfangenen Frames und PDO-Anfragen muss steigen. Einzelne fehlgeschlagene PDO-Anfragen können bei Neustarts oder hoher Buslast vorkommen. Entscheidend sind eine geringe Fehlerquote, ein aktiver CAN-Bus und aktuelle Antworten der Anlage.

In Home Assistant muss die MQTT-Integration eingerichtet sein und denselben Broker wie die Bridge verwenden. Sobald die MQTT-Verbindung steht, veröffentlicht die Bridge ihre Discovery-Daten automatisch.

Einstellungen
→ Geräte & Dienste
→ MQTT

Die internen MQTT-Topics und Home-Assistant-Unique-IDs bleiben bei Updates unverändert. Dadurch entstehen keine doppelten Entitäten.

GerlCraft Zehnder Card installieren

Auf der Browser-Installer-Seite steht ein vollständiges Home-Assistant-Paket zum Download bereit. Für ein bestehendes Dashboard ist die responsive GerlCraft Zehnder Card der komfortabelste Weg.

1. JavaScript-Datei kopieren

Lade das Home-Assistant-Paket herunter und kopiere die Datei gerlcraft-zehnder-card.js in den folgenden Ordner deiner Home-Assistant-Installation:

/config/www/gerlcraft-zehnder-card.js

Falls der Ordner www noch nicht existiert, kann er innerhalb von /config/ neu angelegt werden.

2. Dashboard-Ressource eintragen

Öffne anschließend in Home Assistant die Ressourcenverwaltung:

Einstellungen
→ Dashboards
→ Drei-Punkte-Menü oben rechts
→ Ressourcen
→ Ressource hinzufügen

Trage anschließend folgende Werte ein:

Feld	Eintrag
URL	/local/gerlcraft-zehnder-card.js
Ressourcentyp	JavaScript-Modul

Bestätige den Eintrag mit Erstellen.

3. Ansicht zum Dashboard hinzufügen

1. Die mitgelieferte Datei view-custom-card.yaml öffnen.
2. Den vollständigen YAML-Inhalt kopieren.
3. Das gewünschte Dashboard in Home Assistant öffnen.
4. Den Bearbeitungsmodus des Dashboards aufrufen und eine neue Ansicht hinzufügen.
5. Den kopierten YAML-Code in die Konfiguration der neuen Ansicht einfügen.
6. Ansicht speichern und die Browserseite vollständig neu laden.

Die Karte erkennt den Entity-Präfix normalerweise automatisch und benötigt keine weitere HACS-Karte.

Für Langzeitauswertungen können die Messwerte zusätzlich in InfluxDB gespeichert und mit Grafana dargestellt werden. Die Einrichtung zeigt das Tutorial Home Assistant mit InfluxDB und Grafana erweitern.

Die Bridge stellt eine übersichtliche Diagnoseseite und einen vollständigen JSON-Bericht bereit.

http://DEIN-HOSTNAME.local/diagnostics
http://DEIN-HOSTNAME.local/api/diagnostics
http://DEIN-HOSTNAME.local/diagnostics.json

Dort lassen sich Firmwareversion, Laufzeit, WLAN-Signal, MQTT-Verbindung, CAN-Zähler, PDO-Fehlerquote und der aktuelle Zustand der Zehnder kontrollieren.