Wilkware Logo Wilkware

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 die Bibliothek Klimaregler (engl. ClimateControl) installieren.
  • Alternativ über das Modul-Control folgende URL hinzufügen.
    https://github.com/Wilkware/ClimateControl oder git://github.com/Wilkware/ClimateControl.git

4. Einrichten der Instanzen in Symcon

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

Konfigurationsseite:

Einstellungsbereich:

🌡️ Klimadaten …

NameBeschreibung
Ist-TemperatureVariable, die die aktuelle (Ist-)Temperatur liefert.
Soll-TemperatureVariable, die die Ziel-(Soll-)Temperatur liefert bzw. per Gauge gesetzt wird.
Ventilstellung (optional)Optionale Variable für die Position des Heizventils. 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, Wert, 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 vorheriegen 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.

✨ 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:Alle angefragten Aktivitäten werden an das Script weitergereicht (INSTANCE, TIMESTAMP, TYPE, VARIABLE und VALUE).

Beispiel:

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

5. Statusvariablen und Darstellungen

Es werden keine zusätzlichen Statusvariablen unf Profile/Darstellungen benötigt.

6. Visualisierung

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

7. PHP-Befehlsreferenz

Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

8. Versionshistorie

v1.1.20260708

  • NEU: Ventilstellung erlaubt auch boolsche Variable (false = 0%, true = 100%)
  • FIX: Modusliste kann jetzt auch mit benutzerdefinierten Darstellungen umgehen
  • FIX: Ration 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