🌡️ ClimateControl

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

Inhaltsverzeichnis

1. Funktionsumfang
2. Voraussetzungen
3. Installation
4. Einrichten der Instanzen in IP-Symcon
5. Statusvariablen und Darstellungen
6. Visualisierung
7. PHP-Befehlsreferenz
8. Versionshistorie

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

• IP-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 IP-Symcon

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

Konfigurationsseite:

Einstellungsbereich:

🌡️ Klimadaten ...

Name	Beschreibung
Ist-Temperature	Variable, die die aktuelle (Ist-)Temperatur liefert.
Soll-Temperature	Variable, 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 / rechts	Liste 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 Modus	Variable, die den aktuell aktiven Modus liefert (Wert muss zu einem der Einträge in der Modus-Liste passen).
VARIABLE ANALYSIEREN	Liest 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 LEEREN	Löscht alle Werte aus der Modus-Liste. Wichtig wenn man eine andere Variable verlinkt, welche mit den vorheriegen Einstellungen nicht zusammenpasst.
Verfügbare Modi	Liste der verfügbaren Betriebsmodi. Name, Icon und Farbe können frei angepasst werden; der zugrundeliegende Wert wird aus dem Profil übernommen.

✨ Visualisierung ...

Name	Beschreibung
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 ...

Name	Beschreibung
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 ;-)

Spenden

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

Lizenz

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