[Modul] Helios (KWL mit easyControls Steuerung)

1_IPS-Version-ge-43-red.png 2_Modul_Version-1.0-green.png 3_Code-PHP-green.png 4_Lizenz-GPLv3-blue.png

helios_logo.jpg

Dieses Modul ermöglicht das Auslesen und Steuern von Helios KWL Lüftungsanlagen mit easyControls Steuerung in IP-Symcon.
Zum Auslesen/Steuern der Lüftungsanlage über dieses Modul ist keine Internetverbindung mit dem Helios Cloud-Portal (www.easycontrols.net) erforderlich. Die Kommunikation erfolgt direkt mit der easyControls Steuerung der Lüftungsanlage im lokalen Netzwerk.

1. Voraussetzungen

[ul]
[li]IP-Symcon ab Version 4.3[/li][li]Helios KWL Lüftungsanlage mit easyControls Steuerung[/li][/ul]

2. Installation

>> IP-Symcon ab Version 5.1 >> Installation über den Module-Store
Das Modul kann einfach über den Module Store von IP-Symcon installiert werden. Ihr findet es über die Suche unter dem Namen „Helios“, oder direkt in den Kategorien „Geräte“, „Komfort“ und „Energie“.

>> IP-Symcon Version kleiner 5.1 >> Installation über Module-Control
Der Module-Store steht bei diesen Versionen noch nicht zur Verfügung - hier muss manuell über die Kern Instanz „Module Control“ die folgende URL hinzugefügt werden:

https://github.com/helios-ventilatoren/symcon-kwl-easycontrols.git

…danach kann im Objektbaum von IP-Symcon eine neue Instanz „Helios KWL“ hinzugefügt werden.

3. Inbetriebnahme
In der angelegten Geräte-Instanz müssen nur die IP-Adresse und das Passwort der easyControls Steuerung eingegeben werden (alle weiteren Einstellungsmöglichkeiten sind optional). Nach dem Übernehmen der Einstellungen werden initial alle Daten vom angegebenen Gerät abgerufen (dies kann je nach Gerät einige Sekunden dauern).
Danach kann die Helios KWL schnell und einfach über WebFront/App oder Funktionen in eigenen Skripten ausgelesen und gesteuert werden.
Weitere Informationen und Hinweise bitte der Dokumentation auf GitHub entnehmen.

4. Bedienung
Die Bedienung eurer Lüftungsanlage kann einfach über das WebFront oder die App erfolgen. Zusätzlich stehen euch fast !100! Modul-Funktionen für die Einbindung in eure eigenen Skripte zur Verfügung - ihr könnt euch damit bei Bedarf nach belieben eigene Szenen/Steuerungen bauen oder bauen lassen (die Befehlsreferenz findet ihr in der Dokumentation auf GitHub).

>> Hinweis zum Logging von Variablen
Das Logging muss über die Geräte-Instanz de/aktiviert werden. Wird z.B. das Logging bei den Variablen selbst aktiviert und in der Geräte-Instanz ist das Logging deaktiviert, dann wird das Logging der Variablen beim nächsten IPS Neustart wieder deaktiviert.

5. Links
Modul auf GitHub
Dokumentation auf GitHub in Deutsch
Dokumentation auf GitHub in Englisch

An dieser Stelle möchte ich noch von Herzen ein großes DANKE an die Firma Helios Ventilatoren aussprechen! Ich wurde von Anfang bis Ende in jeder Hinsicht unterstützt und die Kommunikation war zu jeder Tag- und Nacht-Zeit :smiley: perfekt! DANKE!

Und last but not least - auch ein großes Danke an die fleißigen Beta-Tester!

Viel Freude mit dem Modul und beste Grüße,
Chris

Changelog

Version 1.0
- Erster Release

Screenshots

HeliosModul_Instance_3.png

Einige unserer Mitarbeiter bei Helios sind selbst Symcon-Anwender.

Deshalb lag die Idee, unsere Lüftungsgeräte der KWL EC-Serie mit der KWL Easycontrols-Steuerung in Symcon zu integrieren, sehr nahe.

Nachdem wir selbst einige Anläufe mit dem Ziel einer vernünftigen Integration unserer Geräte in Symcon unternommen hatten, hat es nun dank Bayaro endlich geklappt.

Bayaro hat die Aufgabenstellung mit minimalem Aufwand unsererseits erfasst, und die nicht ganz triviale Lösung super umgesetzt.
Somit können wir anderen Herstellern die Zusammenarbeit mit Bayaro vorbehaltlos empfehlen!

Wir würden uns freuen, wenn sich hierdurch weitere Hersteller animiert fühlen, die Integration Ihrer Geräte in Symcon anzugehen.

Quellen auf Github / GPL v3.

Sorry an @chrissi, @PhilippS und alle anderen, dass das Modul nicht schneller kam.
Danke für Eure Vorarbeit die uns Anregung und Ansporn war !!

Coole arbeit, vielen dank

Gesendet von meinem SM-G975F mit Tapatalk

Hey Jürgen,
dass ist ja mal super, wenn so etwas vom Hersteller kommt. Topp ! :slight_smile:
Auch wenn ich keine Lüftungsgeräte im Haus habe, bedanke ich mich.

Hallo Chris,

hab gerade gesehen das du wieder ein Modul fertig hast und es wie von dir erwartet in der selben guten Qualität ist die die davor .
Die Übersichtliche Menüführung sowie die einfache Bedienung machen es auch Nicht-PHP-Programmierer wie mich leichter diese Module zu Installieren und zu benutzen.

Immer wieder Danke dafür.

LG
Christian

Hallo,

da ich keine Kabel verlegen möchte, würde ich einfach bspw. z-wave Feuchtigkeitssensoren zur Steuerung der Anlage verwenden (d.h. nicht die kabelgebundenen Helios-Sensoren). Habt Ihr damit bereits Erfahrungen, gibt es irgendwelche Nachteile, außer, dass der IPS-Server laufen muss und die Sensoren bei einem Ausfall natürlich nicht funktionieren?

VG
Matthias

Hallo zusammen,

bei mir werden die Betriebsstunden der Vorheizung nicht in IP-Symcon angezeigt. Der Wert wird nicht aktualisiert, es steht immer 0 da. Ist das ein Bug? Stunden des Abluft- und Zuluftventilators wird nämlich angezeigt.

VG
Matthias

Hi Matthias!

In der Oberfläche vom easyControls werden dir die Betriebsstunden der Vorheizung korrekt angezeigt?

Bisher wurde zumindest kein Bug dies bezüglich gemeldet - was nicht bedeuten muss, dass es nicht doch einen gibt.

Viele Grüße,
Chris

Hallo Christian,

in EasyControls, auch in der Web-Version, wird es korrekt angezeigt (nicht wundern, die Anlage ist neu, daher erst 21 Stunden):

easycontrols.JPG

nur in IP-Symcon nicht:

Soll ich das Modul nochmal neu installieren?

VG
Matthias

Hi!

Das Modul neu installieren ändert daran nichts - bei IPS Modulen ist das nicht so wie bei einem Programm z.B. unter Windows :slight_smile:
Ich muss mir das am Wochenende mal anschauen - ist schon etwas her, als ich das Modul programmiert hab :smiley:

Bitte etwas Geduld - ich melde mich, wenn ich eine Idee habe, wie wo was man da machen kann.

Viele Grüße,
Chris(toph)

Hi Christoph :wink:

Danke für die Erklärung. Klar habe ich Geduld, freue mich ja, wenn es dann irgendwann funktioniert. Für mich ist der Wert wichtig, da ich den Verbrauch der Vorheizung etwas im Auge behalten möchte und eine Darstellung auf meinem Dashboard Sinn macht :slight_smile:

Viele Grüße!

Matthias

Hi Matthias!

Bitte entschuldige die späte Rückmeldung - ich arbeite in der IT und da geht es momentan etwas drunter und drüber (Corona sei Dank) :rolleyes: :smiley:

Allerdings muss ich dir sagen - die Abfrage der Betriebsstunden der Vorheizung funktioniert bei mir mit dem Modul einwandfrei :confused:

Bitte erstelle ein neues Skript in deinem IP-Symcon (egal wo im Objektbaum), füge den folgenden Inhalt ein und poste die Ausgabe:

<?php
$InstanzID = 12345; // Hier bitte die Instanz-ID deiner Helios Modul-Instanz eintragen
$Daten = HELIOS_System_OperatingHours_Preheater_Get($InstanzID);
var_dump($Daten);

Sollte dir beim oben genannten Skript keine korrekte Ausgabe erzeugt werden, dann bitte die folgenden Schritte durchführen:
Bitte in der Helios Modul-Instanz erst das Debug-Fenster öffnen und dann ganz unten mal die Option „Debug“ aktivieren - die Änderung übernehmen, je nach Anlage so 30 Sekunden warten, jetzt nochmal das oben genannte Test-Skript ausführen und mir die Ausgabe des Debug-Fensters zukommen lassen (bitte die komplette Ausgabe im Debug-Fenster in eine Datei exportieren und mir per Mail an „info@bayaro.net“ senden).
>> Danach kannst du die Option „Debug“ wieder deaktivieren und die Änderung übernehmen - sonst wird dein Log mit reichlich Daten gefüllt :slight_smile:

Viele Grüße,
Chris

Hallo Chris,

vielen Dank für die ausführliche Hilfe :slight_smile: Ich habe deine Antwort gerade erst gelesen, daher sorry, dass ich mich jetzt erst melde…

Nach der Ausführung deines Skripts hat sich die Anzeige aktualisiert und die Betriebsstunden der Vorheizung werden nun tatsächlich korrekt angezeigt! Sollte ich nun ein Ereignis setzen und das Skript bspw. zyklisch aufrufen? Wahrscheinlich ist es ja so gedacht, dass dies automatisch funktioniert?

Viele Grüße!

Matthias

Hi Matthias!

Korrekt - das soll automatisch funktionieren :slight_smile:

Warum es bei dir nicht funktioniert hat ist extrem schwer nachzustellen, weil andere Werte funktioniert haben die in der GLEICHEN Abfrage abgerufen werden. Also sehr seltsam! :confused:

Bitte beobachte es.
Sollte es nochmal so ein seltsames Phänomen geben, dann sehen wir weiter :slight_smile:
Und - ein IPS Neustart wirkt auch oft Wunder :wink:

Viele Grüße,
Chris

Hi Chris,

ok, vielen Dank. Ich sollte wirklich mal neu starten, vielleicht bringt es etwas, denn die anderen Werte werden weiterhin aktualisiert, die Vorheizungs-Betriebsstunden aber nicht. Ich habe übrigens mal den Debug-Modus aktiviert:

10.05.2020, 19:00:09 | HeatRecoveryEfficiency_Calculate | INFO // Etwas ist schief gelaufen… Das Ergebnis ist ein ungültiger Wert oder Division durch 0

Das erscheint jede Minute.

Wie gesagt, ich starte das System mal neu. Es ist nicht super-dringend. Wäre toll, wenn es irgendwann funktionieren würde :slight_smile:

Vg
Matthias

Die Betriebsstunden hatten doch jetzt bei dir funktioniert? Oder nur wenn du manuell das Skript von mir aufgerufen hast?

Das mit der Effizienz könnte an deiner noch recht neuen Anlage liegen. Ich erinnere mich, dass ich daran länger mit einem Mitarbeiter von Helios daran „gebastelt“ und getestet habe - erwarte dort also eigentlich keine Fehler.

-Chris-

Leider nur, wenn das Skript manuell aufgerufen wird. Ich habe den Dienst neu gestartet, hat aber leider nicht zum Erfolg geführt. Und ich habe dir gerade mal die Debug-Datei geschickt. Nicht verwirren lassen, habe das Skript zweimal aufgerufen, daher ist die Datei recht lang :wink:

Viele Grüße!

Matthias