Suche

    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 rein textueller Darstellung unterstützt das Modul Bilder, Fortschrittsbalken und einen Ein/Aus-Schalter.

    2. Voraussetzungen

    • Symcon ab Version 8.1

    3. Installation

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

    4. Einrichtung

    • 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 beliebige 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)Bild für Status-Einträge mit der Zuordnung AN (siehe statusabhängige Darstellung)
    Statusbild (AUS)Bild für Status-Einträge mit der Zuordnung AUS sowie bei leerer Zuordnungstabelle

    📴 Erreichbarkeit …

    NameBeschreibung
    VariableVariable beliebigen Typs, die die Erreichbarkeit des Gerätes anzeigt (z. B. UNREACH, Online oder Status)
    Online bei WertWert der Variable, bei dem das Gerät erreichbar ist (z. B. true, 1 oder online) - jeder andere Wert gilt als offline
    Badge-FarbeHintergrundfarbe des ‘OFFLINE’-Badges

    Ist das Gerät offline, wird oben rechts ein ‘OFFLINE’-Badge angezeigt. Ein eingerichteter Schalter wird solange ausgeblendet. Ohne ausgewählte Variable entfällt die Funktion.

    🎚️ Schalter …

    NameBeschreibung
    VariableStatusvariable (An/Aus, Auf/Zu usw.), muss eine Aktion besitzen - ohne Aktion wird kein Schalter angezeigt
    TypVariablentyp (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
    Statusabhängige DarstellungTabelle mit den ausgelesenen möglichen Variablenwerten (Profile) und entsprechenden Zuordnungen
    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 Fortschrittsbalken
    VariableVariablenwert selbst
    Schriftgrößezu verwendende Schriftgröße in Pixel
    RestlaufzeitMöglichkeit zur Angabe einer Variablen mit Restlaufzeitinformationen (Sekunden oder HH:MM:SS)
    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)
    SymbolIcon für Info (bisherige Zeichen/Emojis werden weiterhin als Text angezeigt)
    PräfixText vor Variablenwert
    VariableVariablenwert
    SuffixText nach Variablenwert
    Schriftgrößezu verwendende Schriftgröße in Pixel

    Existiert eine ausgewählte Variable oder ein ausgewähltes Medienobjekt nicht (mehr), wechselt die Instanz in den Status 201 (Fehler). Die übrigen Bereiche werden weiterhin angezeigt.

    5. Statusvariablen

    Es werden keine Statusvariablen angelegt.

    6. Darstellungen

    Es werden keine Darstellungen oder Profile benötigt.

    7. Visualisierung

    Das Modul kann direkt als Link in die TileVisu eingebunden werden. Werte und Einstellungen werden bei Änderungen sofort in der Kachel aktualisiert, ohne dass sie neu geladen werden muss.

    Die Kachel ist zweigeteilt (Aufteilungsverhältnis siehe Kachel-Einstellungen):

    • Links: das statusabhängige Bild (AN oder AUS). Welches Bild angezeigt wird, legt die Spalte Bild der statusabhängigen Darstellung fest.
    • Rechts: bis zu vier Zeilenbereiche, nicht belegte Bereiche bleiben leer:
      1. Status: Beschriftung und formatierter Wert, Textfarbe gemäß statusabhängiger Darstellung
      2. Aktion: Beschriftung und formatierter Wert (z. B. aktuelles Programm)
      3. Fortschritt: Balken mit Farbverlauf (START → STOP), links der formatierte Wert, rechts die Restlaufzeit in Minuten
      4. Zusatzinfos: drei Werte mit Icon (links, mittig, rechts)
    • Oben rechts: der Schalter (nur bei Variablen mit Aktion) oder, wenn das Gerät nicht erreichbar ist, das ‘OFFLINE’-Badge.

    Statusabhängige Darstellung

    Beim Auswählen der Statusvariable wird die Tabelle aus deren Darstellung bzw. Profil befüllt. Je Wert lässt sich festlegen:

    SpalteBedeutung
    FortschrittsbalkenBalken anzeigen; deaktiviert wird er auf 0 % / 0 min gesetzt (z. B. im Zustand ‘Aus’)
    FarbeTextfarbe des Statuswertes
    BildAnzuzeigendes Statusbild (AN oder AUS)

    Werte ohne Eintrag verwenden den Eintrag mit dem Wert 0. Ist die Tabelle leer, wird das AUS-Bild mit Fortschrittsbalken angezeigt.

    Fortschrittsbalken

    Der Wertebereich wird in folgender Reihenfolge ermittelt: Minimum/Maximum der Darstellung, Werte der Zuordnungen (Darstellung oder Profil), Minimum/Maximum des Profils, sonst 0 bis 100. Bei ganzzahligen Bereichen ab 1 (z. B. Programmschritte 1..6) füllt bereits die erste Stufe 1/n des Balkens, alle anderen Bereiche werden linear berechnet. Die Restlaufzeit kann in Sekunden oder als HH:MM:SS vorliegen.

    8. Befehlsreferenz

    Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

    9. Versionshistorie

    v1.2.20261002

    • NEU: Offline-Badge über Erreichbarkeits-Variable (beliebiger Typ) mit Online-Wert und Badge-Farbe
    • NEU: Unterstützung von Darstellungen (Symcon 8) für Fortschrittsbalken und statusabhängige Darstellung
    • NEU: Fortschrittsbalken rechnet ganzzahlige Bereiche ab 1 stufig (erste Stufe = 1/n), alle anderen linear
    • NEU: Bilder und Statuszuordnung werden mit dem Update übertragen, Änderungen wirken ohne Neuladen der Kachel
    • NEU: Instanzstatus 201, wenn eine ausgewählte Variable oder ein Medienobjekt nicht existiert
    • NEU: Initialisierung erst nach vollständigem Systemstart
    • NEU: Schalter wird nur noch für Variablen mit Aktion angezeigt
    • NEU: Symbole der Zusatzinfos über Icon-Auswahl (bisherige Zeichen/Emojis werden weiterhin angezeigt)
    • NEU: Kachelränder werden aus der Visualisierung übernommen (dynamischer Kopfbereich)
    • NEU: Skript der Kachel überarbeitet und strukturiert
    • FIX: Warnung ‘Cannot auto-convert value for parameter ID’ bei Ermittlung von Min/Max behoben
    • FIX: Fehlende Anzeige von Aktion, Fortschritt und Infos ohne konfigurierte Statusbilder behoben
    • FIX: Fortschritt und Restlaufzeit mit Wert 0 werden jetzt angezeigt
    • FIX: Fortschrittswert zur Laufzeit passt jetzt zum ermittelten Bereich
    • FIX: Schriftgröße der dritten Zusatzinfo und Standard-Textfarbe des Status korrigiert
    • FIX: Bilder mit Dateiendungen in Großbuchstaben werden jetzt erkannt
    • FIX: Dokumentation überarbeitet

    v1.1.20250916

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

    v1.0.20250729

    • NEU: Initialversion

    Danksagung

    Ich möchte mich für die großartige Idee und Vorarbeit zu diesem Modul 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 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