Geräte-Widget

Dokumentation direkt aus GitHub Wilkware/DeviceWidget ↗

Version Product Version License Actions

Dieses Modul dient der Anzeige von Statusinformationen von Geräten als Kachel in der Tile Visualisierung.
Ideal zur übersichtlichen Darstellung auf Dashboards.

Module-Visu

1. Funktionsumfang

Durch Nutzung des HTML-SDKs kann dieses Widget Geräteinformationen und zusammenhängende Inhalte klar Strukturiert und kachelfüllend darstellen. Neben reiner textuellen Darstellung unterstützt das Modul Bilder, Fortschrittsbalken und einen Ein/Aus-Schalter.

2. Voraussetzungen

  • Symcon ab Version 8.1

3. Installation

  • Über den Module Store das ‘Geräte-Widget’-Modul installieren.
  • Alternativ über das Module Control folgende URL hinzufügen
    https://github.com/Wilkware/DeviceWidget oder git://github.com/Wilkware/DeviceWidget.git

4. Einrichten der Instanzen in Symcon

  • Unter “Instanz hinzufügen” ist das ‘Geräte-Widget’-Modul unter dem Hersteller ‘Geräte’ aufgeführt. Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen

Konfigurationsseite:

Einstellungsbereich:

⬛ Kachel …

NameBeschreibung
HintergrundfarbeTransparent oder beliebiege Farbauswahl
FarbtransparenzDurchsichtigkeit der gewählten Farbe von 0 bis 100%
AufteilungsverhältnisAufteilung Bild zu Informationen (von 20/80 bis 50/50)

🖼️ Bild …

NameBeschreibung
Statusbild (AN)Angezeigtes Bild im eingeschaltetem oder aktiven Status
Statusbild (AUS)Angezeigtes Bild im ausgeschaltetem oder inaktiven Status

🎚️ Schalter …

NameBeschreibung
VariableStatusvariable (An/Aus, Auf/Zu usw.)
TypeVariablentyp (bool, int, float oder string)
Wert (AN)Vergleichswert für Zustand AN, AUF oder AKTIV
Wert (AUS)Vergleichswert für Zustand AUS, ZU, INAKTIV

ℹ️ Informationen …

Status (1.Zeilenbereich)Beschreibung
BeschriftungÜberschrift/Label für Variablenwert
VariableVariablenwert selbst
Schriftgrößezu verwendende Schriftgröße in Pixel
Statsuabhängige DarstellungTabelle mit den ausgelesen möglichen Variablenwerten (Profile) und entsprechende Zurodnungen
Aktion (2.Zeilenbereich)Beschreibung
BeschriftungÜberschrift/Label für Variablenwert
VariableVariablenwert selbst
Schriftgrößezu verwendende Schriftgröße in Pixel
Fortschritt (3.Zeilenbereich)Beschreibung
BeschriftungÜberschrift/Label für Fortschritsbalken
VariableVariablenwert selbst
Schriftgrößezu verwendende Schriftgröße in Pixel
RestlaufzeitMöglichkeit zur Angabe einer Variablen mit Reslaufzeitinformationen
Farbe(START)Farbwert für Balkendarstellung (Start-Gradient)
Farbe(STOP )Farbwert für Balkendarstellung (End-Gradient)
Zusätzliche Werte (4.Zeilenbereich)Beschreibung (1. links, 2. mittig, 3. rechts)
SymbolZeichen oder Emoji für Info
PräfixText vor Variablenwert
VariableVariablenwert
SuffixText nach Variablenwert
Schriftgrößezu verwendende Schriftgröße in Pixel

5. Statusvariablen und Profile

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

6. Visualisierung

Das Modul kann direkt als Link in die TileVisu eingebunden werden.
Die Kachel zeigt rechts im gewählten Seitenverhältnis das statusabhängige Bild, während auf der linken Seite bis zu vier Zeilen mit Statusinformationen dargestellt werden. Ein optionaler Schalter erscheint oben rechts in der Ecke.

7. PHP-Befehlsreferenz

Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

8. Versionshistorie

v1.1.20250916

  • NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
  • FIX: Fehler bei gleichem Wert für Min/Max für Fortschritsbalken behoben
  • FIX: Dokumentation überarbeitet

v1.0.20250729

  • NEU: Initialversion

Danksagung

Ich möchte mich für die großartige Idee und Vorarbeit zu diesem Moduls bedanken bei …

  • da8ter : für sein Vorbild-Modul Geräte-Status Kachel 👍

Vielen Dank 🙏!

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 Skript 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