Suche

    Klimaregler

    Dokumentation direkt aus GitHub Wilkware/ClimateControl ↗

    Version Product Version License Actions

    Visuelle Steuerung von Heizung, Kühlung und Klimaanlagen über ein interaktives, vollständig skalierbares HTML-SDK-Widget.

    Module-Visu

    1. Funktionsumfang

    • Interaktive, kreisförmige Temperatur-Anzeige (Gauge) mit Farbverlauf von Kalt- zu Warm-Farbe
    • Zieltemperatur per Ziehen des Reglers, Antippen des Bogens oder über separate Plus-/Minus-Tasten einstellbar
    • Anzeige der Ist-Temperatur, optional erweiterbar um relative Luftfeuchte und Ventilstellung
    • Zwei frei konfigurierbare Status-Icons (z. B. „Fenster offen“, „Prognose“), jeweils an eine eigene Variable gebunden
    • Frei konfigurierbare Betriebsmodi (z. B. Urlaub, Programm, Manuell, Pause, Aus) mit eigenem Icon, Name und Farbe je Modus
    • Komfortabler Import der verfügbaren Modi direkt aus dem Profil bzw. der Darstellung der Modus-Variable per Knopfdruck
    • Vollständig responsives Layout (HTML-SDK/Container Queries) – Gauge, Icons und Beschriftungen skalieren automatisch mit der Kachelgröße
    • Automatische Anpassung an Hoch- und Querformat, inklusive Plus-/Minus-Tasten im Querformat
    • Automatische Unterstützung von hellem und dunklem Theme

    2. Voraussetzungen

    • Symcon ab Version 8.1

    3. Installation

    • Über den Modul Store das Modul Klimaregler installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/ClimateControl oder git://github.com/Wilkware/ClimateControl.git

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Klimaregler-Modul unter dem Hersteller ‘(Sonstige)’ aufgeführt.

    Konfigurationsseite:

    Einstellungsbereich:

    🌡️ Klimadaten …

    NameBeschreibung
    Ist-TemperaturVariable, die die aktuelle (Ist-)Temperatur liefert.
    Soll-TemperaturVariable, die die Ziel-(Soll-)Temperatur liefert bzw. per Gauge gesetzt wird.
    Minimale TemperaturUntere Grenze der Temperaturskala bzw. der einstellbaren Soll-Temperatur (Standard: 4,5 °C), passend zur eigenen Hardware.
    Maximale TemperaturObere Grenze der Temperaturskala bzw. der einstellbaren Soll-Temperatur (Standard: 30,5 °C). Muss größer als die minimale Temperatur sein, sonst geht die Instanz in den Fehlerzustand.
    Ventilstellung (optional)Optionale Variable für die Position des Heizventils. Der Wert wird anhand des Bereichs (Min/Max) der Darstellung bzw. des Profils in 0–100 % umgerechnet (z. B. Homematic 0.0–1.0), boolsche Variablen ergeben 0 % bzw. 100 %. Bleibt das Feld leer, wird der Wert in der Visualisierung nicht angezeigt.
    Luftfeuchte (optional)Optionale Variable für die (relative) Luftfeuchte. Bleibt das Feld leer, wird der Wert in der Visualisierung nicht angezeigt.
    Status-Icon links / rechtsListe mit genau zwei Einträgen für die Status-Icons links/rechts in der Gauge (z. B. Fenster, Prognose). Pro Eintrag: Variable, Name, Icon und Farbe. Bleibt die Variable eines Eintrags leer, wird das entsprechende Icon ausgeblendet.
    Aktiver ModusVariable, die den aktuell aktiven Modus liefert (Wert muss zu einem der Einträge in der Modus-Liste passen).
    VARIABLE ANALYSIERENLiest die Assoziationen aus dem Profil bzw. der Darstellung der gewählten Modus-Variable ein und übernimmt sie automatisch in die Modus-Liste. Bereits manuell angepasste Icons/Farben bleiben dabei erhalten.
    LISTE LEERENLöscht alle Werte aus der Modus-Liste. Wichtig wenn man eine andere Variable verlinkt, welche mit den vorherigen Einstellungen nicht zusammenpasst.
    Verfügbare ModiListe der verfügbaren Betriebsmodi. Name, Icon und Farbe können frei angepasst werden; der zugrundeliegende Wert wird aus dem Profil übernommen.

    Hinweis: Bedienungen aus der Kachel (Soll-Temperatur, Modus, Status) werden ausschließlich über die Aktion der verknüpften Variable ausgeführt, damit das Gerät (z. B. der Stellantrieb) auch tatsächlich schaltet. Hat eine Variable keine Aktion (z. B. eine einfache Benutzervariable), wird sie nicht direkt beschrieben. Ist ein Aktions-Script hinterlegt (siehe Erweiterte Einstellungen), wird die Anfrage nur an das Script übergeben, das sie dann selbst verarbeiten kann. Ohne Aktion und ohne Script wird der Wert in der Kachel nur angezeigt und die Bedienelemente sind gesperrt.

    ✨ Visualisierung …

    NameBeschreibung
    Farbe (KALT)Farbe für das kalte Ende des Temperatur-Farbverlaufs.
    Farbe (WARM)Farbe für das warme Ende des Temperatur-Farbverlaufs.
    Status-Beschriftungen anzeigen?Blendet die Beschriftung unter den Status-Icons ein oder aus.
    Modus-Beschriftungen anzeigen?Blendet die Beschriftung unter den Modus-Icons ein oder aus.

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Steuerungsaktivitäten an Script übergeben:Jede Bedienung in der Kachel (Soll-Temperatur, Modus, Status) wird zusätzlich an das Script übergeben. Hat die verknüpfte Variable eine Aktion, wird diese vorher ausgeführt. Hat sie keine Aktion, übernimmt allein das Script die Verarbeitung.

    Übergebene Parameter (in $_IPS verfügbar):

    ParameterTypWertebereich / Bedeutung
    INSTANCEintID der Klimaregler-Instanz, von der die Bedienung kommt.
    TIMESTAMPintZeitpunkt der Bedienung als Unix-Zeitstempel.
    TYPEstringArt der Bedienung: temperature, mode oder status.
    VARIABLEintID der verknüpften Variable: Soll-Temperatur (bei temperature), aktiver Modus (bei mode) bzw. die Variable des betätigten Status-Icons (bei status).
    VALUEfloatBei temperature: neue Soll-Temperatur in 0,5er-Schritten innerhalb der eingestellten minimalen und maximalen Temperatur.
    VALUEint / stringBei mode: Wert des gewählten Eintrags aus der Liste Verfügbare Modi (Typ entspricht der Modus-Variable).
    VALUEboolBei status: gewünschter neuer Zustand des Status-Icons (der bisherige Zustand umgekehrt, true = ein, false = aus).

    Zusätzlich stehen die üblichen Systemvariablen eines per IPS_RunScriptEx gestarteten Scripts zur Verfügung (SELF, THREAD, SENDER = RunScript). Das Script läuft parallel zur Instanz. Um vom Datentyp unabhängig zu sein, sollte VALUE im Script passend umgewandelt werden (z. B. (float), (bool)).

    Beispiel (Inhalt von $_IPS bei Betätigung eines Status-Icons):

    Array (
        [SELF] => 18056
        [THREAD] => 13
        [SENDER] => RunScript
        [VALUE] => 1
        [VARIABLE] => 12636
        [TYPE] => status
        [TIMESTAMP] => 1783344616
        [INSTANCE] => 47757
    )
    

    Beispiel-Script:

    <?php
    
    switch ($_IPS['TYPE']) {
        case 'temperature':
            $temperature = (float) $_IPS['VALUE'];
            // z. B. Soll-Temperatur an mehrere Stellantriebe verteilen
            break;
        case 'mode':
            $mode = $_IPS['VALUE'];
            // z. B. Heizprogramm umschalten
            break;
        case 'status':
            $state = (bool) $_IPS['VALUE'];
            // z. B. Benutzervariable ohne Aktion selbst setzen
            SetValue((int) $_IPS['VARIABLE'], $state);
            break;
    }
    

    5. Statusvariablen

    Es werden keine Statusvariablen angelegt.

    6. Darstellungen

    Es werden keine Darstellungen oder Profile benötigt.

    7. Visualisierung

    Man kann das gesamte Modul (HTML-SDK Support) direkt in der Visualisierung verlinken.

    8. Befehlsreferenz

    Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

    9. Versionshistorie

    v1.2.20261010

    • NEU: Minimale und maximale Temperatur der Skala einstellbar (Standard 4,5 °C bis 30,5 °C)
    • NEU: Bedienung erfolgt ausschließlich über die Aktion der verknüpften Variable bzw. das Aktions-Script, Variablen ohne Aktion werden nicht mehr direkt beschrieben
    • NEU: Nicht bedienbare Elemente (ohne Aktion und ohne Script) werden in der Kachel gesperrt dargestellt
    • FIX: Status-Icon aktualisierte sich nicht, wenn nur der rechte Slot belegt war
    • FIX: Schalten der Status-Icons funktionierte nicht zuverlässig
    • FIX: Plus-/Minus-Tasten lösten schon beim Überfahren mit der Maus eine Aktion aus
    • FIX: Benutzerdefinierte Darstellung hat beim Einlesen der Modi jetzt Vorrang
    • FIX: Abgelehnte Soll-Temperatur wird in der Kachel zurückgesetzt
    • FIX: Namen mit Sonderzeichen werden in der Kachel korrekt dargestellt
    • FIX: Fehlgeschlagene Schaltbefehle werden als Warnung gemeldet
    • FIX: Bibliotheken überarbeitet und Debug-Ausgaben reduziert

    v1.1.20260708

    • NEU: Ventilstellung erlaubt auch boolsche Variable (false = 0%, true = 100%)
    • FIX: Modusliste kann jetzt auch mit benutzerdefinierten Darstellungen umgehen
    • FIX: Ratio zwischen Quer- und Hochformat angepasst, Buttons erscheinen jetzt etwas später
    • FIX: Kit-Icons (fak) werden jetzt auch korrekt angezeigt

    v1.0.20260706

    • NEU: Initialversion

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skripte und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence