Plugin-Daten | |
---|---|
Autor | Michael Kaufmann |
Logo | |
Status | UNSTABLE |
Version | 0.3 |
Min. LB Version | 2.0.0 |
Release Download | https://github.com/blacksun80/LoxBerry-Plugin-Comfoconnect/archive/refs/tags/Comfoconnect-V0.2.zip |
Pre-Release Download | https://github.com/blacksun80/LoxBerry-Plugin-Comfoconnect/archive/refs/tags/Comfoconnect-V0.3.zip |
Beschreibung | Das Plugin kommuniziert mit einer Zehnder Lüftungsanlage Qxxx und stellt die Sensoren bzw. Aktoren im MQTT Broker zur Verfügung |
Sprachen | DE |
Diskussion | https://www.loxforum.com/forum/projektforen/loxberry/plugins/312399-comfoconnect-anbindung-einer-zehnder-l%C3%BCftungsanlage-qxxx |
Version History:
Version 0.3
Version 0.2
Repository: https://github.com/blacksun80/LoxBerry-Plugin-Comfoconnect
Direkter Download-Link: Siehe Tabelle oben.
Plugin liest die Sensoren aus der Lüftungsanlage aus und stellt diese dem MQTT Broker zur Verfügung. Steuern lässt sich die Lüftungsanlage ebenfalls über MQTT Topics.
Voraussetzung: Man braucht eine Zehnder ComfoConnect LAN C Schnittstelle zur Anbindung.
https://www.zehnder-systems.de/produkte-und-systeme/komfortable-wohnraumlueftung/zehnder-comfoconnect-lan-c
Entweder man sucht die ComfoConnect LAN C Schnittstelle über den Button "Nach Zehnder Lüftungsanlage suchen" oder man gibt die IP-Adresse ein. Es kann nur gesucht werden, wenn das Feld für die IP-Adresse leer ist.
Die ComfoConnect LAN C Schnittstelle ist mit einem PIN gesichert. Die PIN muss ebenfalls eingegeben werden. Standardmäßig ist das die '0000'. Mit "Speichern" wird die IP und der PIN gespeichert und das Plugin wird gestartet. Im Hintergrund wird eine Verbindung mit der LAN C Schnittstelle aufgebaut.
Im MQTT Gateway Plugin wird automatisch das Topic ComfoConnect/# angelegt.
Hier werden dann die Sensoren bzw. Topics zur Ansteuerung der Lüftungsanlage dargestellt. Diese kann man dann in der LoxoneConfig verarbeiten.
Alle MQTT Daten des Topics ComfoConnect können über virtuelle Eingänge eingelesen werden. Dafür gibt es eine vorgefertigte Vorlage, welche einfach nur eingelesen werden muss und liegt hier zum Download bereit. ZIP Datei muss vorher entpackt werden.
So kann die Vorlage importiert werden:
1. Markiere den Knoten Virtuelle Eingänge
2. Im Menüband auf "Vordefinierte HTTP-Geräte", anschließend Punkt "Vorlage importieren"
3. Zuvor runtergeladene Archiv entpacken. Im Archiv befindet sich die "VI_MQTT_Comfoconnect.xml“. Diese muss hier geöffnet werden.
4. Frage "Soll das Gerät gleich angelegt werden?" mit Ja betätigen.
5. Markiere den angelegten Knoten "MQTT_Comfoconnect" und ersetze im linken Fenster unter URL den Eintrag „IP_MQTT_Gateway“ durch die IP-Adresse des MQTT-Gateways (z.B. des Loxberry).
6. Klappt man nun den Knoten "MQTT_Comfoconnect" auf, sieht man alle verfügbaren Variablen, die aktuell durch das Plugin zur Verfügung gestellt werden. (Info: nicht alle verfügbaren im Screenshot sind sichtbar)
Über virtuelle Ausgangsbefehle kann die Lüftungsanlage angesteuert werden. Wie genau man einen virtuellen Ausgangsbefehl anlegen muss, kannst du hier nachlesen. MQTT - Schritt für Schritt: Loxone -> MQTT
Einfügen der Vorlagen funktioniert dabei gleich wie bei den virtuellen Eingängen nur als virtueller Ausgang. Dabei muss beim Ausgang unter Adresse wieder die IP-Adresse des MQTT Gateway angeben werden.
Die Vorlage für die virtuellen Ausgänge kann hier runtergeladen werden. Das Archiv muss analog zu den virtuellen Eingängen entpackt werden. Im Archiv befindet sich VQ_MQTT_Comfoconnect.xml
Hinweis: Um die Funktionen Bypass_On, Bypass_Off sowie Party zu verwenden, muss für die jeweilige Funktionen die Zeit in Sekunden an das Plugin übergeben werden. |
Es gibt zwei verschiedene Ansätze, für die Steuerbefehle für die es jeweils eine Vorlage für die virtuellen Ausgänge gibt:
1. Ein Ausgangsbefehl für jede einzelne Funktion, wie z.B. für die Lüfterstufe:
2. Ein Ausgangsbefehl für jeweils zusammenhängende Befehle, wie z.B. die Lüfter Stufe ComfoConnect/FAN_MODE <v>, welchen man dann je nachstufe die Werte von 0 – 3 zuweist. Diese Variante ist teilweise in der Loxone Config übersichtlicher.
Folgende Werte können für die folgendes Modis verwendet werden.
Lüfterstufe:
Away: 0
Low: 1
Medium: 2
High: 3
Party:
Betrieb:
Manual: 0
Auto: 1
Temperaturprofil:
Auto: 0
On: 1
Off: 2
Feuchteregelung:
Auto: 0
On: 1
Off: 2
Passive Temperatur:
Auto: 0
On: 1
Off: 2
Bypass:
Auto: 0
On: 1
Off: 2
Aktiver Feuchteschutz:
Auto: 0
On: 1
Off: 2
Diese Werte werden für die korrekte Funktion von Partymodus und Bypass On oder Bypass Off benötigt. Dabei wird der Wert in Sekunden an das Gateway und Plugin übergeben.
Zeit: Party
Zeit: Bypass ON
Zeit: Bypass OFF
Dazu brauchen wir zwei Seiten für die Lüftungsanlage. Hier werden die Betriebsart ausgewertet, Sperre/Verriegelung der Buttons in der Visualisierung, Betriebsartumschaltung AUTO/MANUAL und der BOOST_MODE aktiviert bzw. deaktiviert.
Auf der 2. Seiten befindet sich die Ansteuerung der Lüftungsstufen, Feedbackauswertung bei Umschaltung am Lüftungsgerät selbst, d. h. auch hier stimmt dann die Visualisierung mit der gewählten Betriebsart bzw. Lüfterstufe überein.
Da die Logik der Betriebsartenumschaltung nicht ganz einfach ist, habe ich die zwei Seiten aus meinem Projekt exportiert und stelle es euch hier zum Download bereit. Leider ist es nicht möglich, die Objekte 1:1 zu kopieren, denn es werden keine virtuellen Eingänge oder virtuelle Ausgangsbefehle mit kopiert. Diese musst du per Hand anlegen bzw. mittels der Vorlagen zuerst importieren und den "nicht zugeordneten" Objekten, die nach dem Kopieren entstehen, zuweisen.
Download Beispiel ComfoConnect: ComfoConnect.Loxone
In diesem Projekt sind bisher die Betriebsartenumschaltung, die Lüfterstufenumschaltung sowie der Boostmodus realisiert.
Für die Befehle mit variabler Zeit (Party) müssen von Loxone aus die Werte übermittelt werden. Dafür ist es am einfachsten einen Virtuellen Eingang für jede Zeit zu erstellen und nach folgenden Vorbild zu konfigurieren.
Der Schieberegler in der Loxone App hat eine Schrittweite von 0,25h (15min) Maximalwert ist dabei 24h. Um die Eingabe dann in die vom Plugin geforderten Sekundenwert zu übersetzen, verwendet man einfach einen Formelbaustein.
Das Schalten dieser Befehle ist relativ einfach. Dafür kann man einfach den Baustein Radiotasten verwenden:
Je nach Ausgangsbefehl gibt es auch eine Rückgabewert, der genau die gleichen Werte verwendet. So kann man auch überwachen, ob das Plugin das richtige macht.