ComfoConnect - Anbindung einer Zehnder Lüftungsanlage Qxxx

[RolandSM]

Die Lösung von LexB-Hard hat auch bei mir funktioniert. Vielen Dank.

[blacksun]

Hab eure Probleme alle behoben. PlugIn läuft jetzt auch auf LB4 mit etlichen Verbesserungen.

https://github.com/blacksun80/LoxBerry-Plugin-Comfoconnect/archive/refs/heads/master.zip

Bitte mal testen und Feedback geben. Es gibt noch kein Release oder PreRelease. Version steht auch im Master noch auf 0.3, also nicht wundern, wenn nach Update die Version noch auf 0.3 steht.

Unterstützung ComfoCool ist experimentell, da ich es nicht testen kann, ob es tatsächlich funktioniert.

# Änderungen gegenüber Version 0.3

## Behobene Fehler

**Das Plugin startete auf neueren Systemen gar nicht.** Seit paho-mqtt 2.0 muss
beim Verbindungsaufbau die Callback-Version angegeben werden — ohne diese Angabe
brach das Plugin beim Start ab und baute keine MQTT-Verbindung auf. Betraf unter
anderem LoxBerry 3.0. Der Fix funktioniert weiterhin auch mit älteren
paho-Versionen. *(GitHub-Issues #13 und #14)*

**Ein einziger nicht unterstützter Sensor legte das ganze Plugin lahm.** Meldete
sich beim Start auch nur ein Sensor nicht zurück, brach das komplette Skript ab —
danach wurde kein einziger Wert mehr übertragen. Nicht jede Anlage und nicht jeder
Firmware-Stand kennt alle Messwerte; solche Sensoren werden jetzt übersprungen und
in der Statusanzeige als „46 von 50 Sensoren aktiv" ausgewiesen.

**Abstürze beim Senden von Befehlen.** Wurde ein Befehl geschickt, den die Anlage
nicht beantwortete (zum Beispiel „Abwesend", wenn sie bereits abwesend war),
starb der MQTT-Empfangsthread. Das Plugin lief weiter und lieferte Sensorwerte,
reagierte aber auf keinen Befehl mehr — ohne erkennbare Ursache. *(Issue #11)*

**Abstürze und hängende Verbindungen beim Reconnect.** Riss die Verbindung zur
Lüftungsanlage ab, konnte sich das Plugin dabei aufhängen, ohne es zu bemerken.
Mehrere Ursachen behoben (Wettlaufsituationen zwischen den Threads, falsch
zugeordnete Antworten der Anlage, verschluckte Fehlermeldungen).

---

## Neue Funktionen

**Statusanzeige in der Weboberfläche.** Zeigt sekündlich aktualisiert, ob alles
läuft, wie viele Sensoren aktiv sind und wann zuletzt Daten von der Anlage kamen.
Bei Störungen erscheint im Klartext, was nicht stimmt.

**Überwachung der Sensorwerte.** Erkennt den Fall, dass die Verbindung zwar steht
und die Anlage antwortet, aber keine Messwerte mehr ankommen — bisher fiel das
niemandem auf. Zeitspanne einstellbar, auf Wunsch mit automatischem Neustart.
Wird zusätzlich als `SENSOR_TIMEOUT` per MQTT gemeldet, ist also auch in Loxone
auswertbar.

**Störungsmeldungen im Klartext.** Meldet die Anlage einen Fehler, stand bisher
nur „Unhandled" im Log. Jetzt erscheint die Ursache ausformuliert, zum Beispiel
*„Fortluftdruck zu hoch. Luftauslässe, Kanäle und Filter auf Verschmutzung
prüfen"*. Über `ERROR_COUNT` und `ERROR_TEXT` auch per MQTT verfügbar, und mit
`ERROR_RESET` lassen sich Störungen quittieren.

**Abwesenheit / Urlaubsschaltung.** Die Anlage lässt sich jetzt für einen frei
wählbaren Zeitraum in den Abwesenheitsbetrieb schicken — auch über mehrere Tage,
so wie in der Zehnder-App. Über `AWAY_FOR` (Dauer in Sekunden) und `AWAY_END`
zum vorzeitigen Beenden. Der aktuelle Zustand wird über `AWAY_ACTIVE` und die
Restzeit über `AWAY_REMAINING` zurückgemeldet.

**Unterstützung für ComfoCool.** Ist ein Kühlmodul angeschlossen, werden dessen
Zustand und Kondensatortemperatur als Sensoren übertragen (`COMFOCOOL_STATE`,
`COMFOCOOL_TEMPERATURE_CONDENSOR`), und es lässt sich über `COMFOCOOL` zwischen
Automatik und Aus umschalten — wahlweise dauerhaft oder für eine bestimmte Zeit.

Das Plugin erkennt selbst, ob ein ComfoCool vorhanden ist: Die Anlage meldet ihre
angeschlossenen Geräte beim Verbindungsaufbau von sich aus. Es ist dafür keine
Einstellung nötig, und wer nachrüstet, bekommt die Werte nach dem nächsten
Neustart automatisch. Anlagen ohne Kühlmodul sehen davon nichts.

**Sauberes Beenden.** Beim Neustart meldet sich das Plugin jetzt ordentlich bei
der Lüftungsanlage ab. Vorher hielt die Anlage die alte Verbindung noch mehrere
Sekunden fest, was den Neustart verzögerte.

**Dokumentation aller MQTT-Topics** in der Datei `MQTT-TOPICS.md`.

---

## Hinweise zum Update

Die Einstellungen für die Überwachung sind nach dem Update **ausgeschaltet**. Wer
sie nutzen möchte, aktiviert sie in den Plugin-Einstellungen. Der frühere
Watchdog-Schwellwert wird nicht übernommen, da er anders funktioniert (Sekunden
statt Minuten, und er achtet jetzt auf die Sensordaten statt nur auf die
Verbindung).

Alle bisherigen MQTT-Topics funktionieren unverändert weiter. Die neuen kommen
nur hinzu.

[hme0354]

echt cool. Nur so als Frage, was ist ein Störungsbericht?

[blacksun]

DAs ist ein Auszug aus dem Logfile wie im loglevel debug. das loglevel im loxberry kann jetzt auf error belassen werden, damit er nicht voll gemüllt wird. bei auftreten eines errors wird das log in dem angegebenen verzeichnis gespeichert, damit man jetzt eher feststellen kann, warum und wo es abgestürzt ist. das war in der vergangenheit ja immer so eine sache.

Du kannst auch in ca. 1 std. auch gerne nochmal den aktuellen master testen, da ist jetzt eine liste der sensoren und commands in der gui. man kann nicht verwendete sensoren abwählen und man sieht, welche mqtt topics werte empfangen.

[blacksun]

Claude Opus 4.6 machts möglich :-)

https://github.com/blacksun80/LoxBerry-Plugin-Comfoconnect/archive/refs/heads/master.zip

Verbesserungen im aktuellen Master:

Stabilität

• Absturz im Verbindungsthread behoben (_is_reconnect stand in der falschen Methode) — das Plugin lief als Hülle weiter
• Abstürze werden jetzt überhaupt sichtbar: Threads, Hauptprogramm, Sensor-Rückruf, die fünf MQTT-Rückrufe
• Verbindungsabbrüche werden einmal je Ausfall gezählt statt je Wiederholversuch (2099 → 1)
• Zeitfelder auf 4 Byte: 24-Stunden-Boost war vorher unmöglich, jetzt an deiner Anlage bestätigt

Diagnose

• Statistik über Aussetzer, die sonst unsichtbar bleiben — überlebt Neustarts, mit Reset-Knopf
• Log-Snapshots: 2 Minuten Log vor und nach einer Störung, auf der Speicherkarte statt auf der Ramdisk
• Loglevel wirkt nur noch auf die Logdatei — Snapshot enthält immer volle Details, auch bei Stufe „Fehler"
• Genaue Uhrzeiten statt „vor 2h"

Oberfläche

• Sensorliste: 69 Sensoren (17 neue) in 12 Gruppen, mit Beschreibung, Einheit, Live-Wert, an-/abwählbar
• Befehlsübersicht: alle 46 Topics mit zulässigen Werten und zuletzt Empfangenem
• ComfoCool-Erkennung entfallen (nicht nötig), Statusanzeige, Sensorwert-Überwachung

[blacksun]

So Leute, es gibt jetzt ein Release 0.4. Da hat sich viel getan, dank sei Claude Opus 4.8.

Release Comfoconnect-V0.4 · blacksun80/LoxBerry-Plugin-Comfoconnect

Viel Spaß damit und falls was nicht funktionieren sollte, wie gewünscht, bitte ein Issue aufmachen auf Github