Zustandszähler

Zählt aktive Lichter, Fenster und eigene Zustände gesamt und je Gruppe, mit Kachel.

Beta 1.1.271 Downloads71 in 30 Tagen

Privat kostenlos Gewerblich auf Anfrage Anfrage senden

Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 1.1.2 im Kanal Beta.

Zustandszähler

Zählt, wie viele Lichter an oder Fenster offen sind, getrennt nach Gruppen wie Etagen. Die Instanz zeigt eine Kachel mit der Gesamtzahl und je Gruppe die aktiven Elemente und legt Variablen für Skripte und Ereignisse an. Alle Variablen werden in einer Liste der Instanz gepflegt, Ereignisse oder Zählskripte sind nicht nötig.

Inhaltsverzeichnis

1. Konfiguration

Das Formular zeigt nur die Felder, die zur Art passen: “Stufen für Rollos” nur bei der Art Rollos, die beiden Farben nur mit der Option “Eigene Farben”.

FeldBeschreibung
ArtLicht (an / aus), Fenster (offen / geschlossen), Rollos (nicht ganz offen) oder Benutzerdefiniert. Die Art bestimmt die Texte der Kachel und bei Rollos, wann ein Rollladen zählt.
Text für aktivGilt für jede Art. Ersetzt die Überschrift der Kachel, zum Beispiel “Geräte aktiv”. Leer bleibt die Vorgabe der Art (“Lichter an”, “Fenster offen”, “aktiv”). Bei der Art Benutzerdefiniert steht der Text auch als Bezeichnung des Zustands in der Liste.
Stufen für RollosProzentwerte “geschlossen” zwischen 1 und 99, durch Komma getrennt, zum Beispiel 25, 50, 75, 99. Daraus entstehen die Knöpfe der Rollladen-Steuerung in der Kachel, dazu kommen immer Auf und Zu. Leer gilt die Vorgabe 25, 50, 75, 99. Ungültige Einträge fallen weg, die Instanz zeigt dann den Status “Ungültige Stufen für Rollos”.
Text für nichts aktivGilt für jede Art. Ersetzt die Meldung, wenn nichts aktiv ist, zum Beispiel “Alles inaktiv”, auch in der Übersicht. Leer bleibt die Vorgabe der Art (“Alles aus”, “Alles geschlossen”, “Alles inaktiv”).
Zählvariable je Gruppe anlegenLegt für jede Gruppe eine eigene Zählvariable an. Standard: an.
Kleine Kachel vollständig einfärbenFärbt die ganze kleine Kachel in der Zustandsfarbe, nicht nur eine Fläche darin. In der maximierten Ansicht bleibt der Hintergrund normal, damit die Liste lesbar ist. Standard: an.
Eigene Farben statt Symcon-Design verwendenStandardmäßig übernimmt die Kachel das Design der Visualisierung: Akzentfarbe, wenn etwas aktiv ist, eine neutrale Fläche mit grünem “OK”, wenn nichts aktiv ist. Mit dieser Option gelten die beiden Farben darunter. Standard: aus.
Farbe, wenn etwas aktiv istNur bei eigenen Farben: Farbe der Kachel, solange mindestens ein Element aktiv ist.
Farbe, wenn nichts aktiv istNur bei eigenen Farben: Farbe der Kachel, wenn nichts aktiv ist.
VariablenListe der überwachten Variablen. Neue Zeilen kommen mit dem Plus unter der Liste dazu.

Spalten der Liste:

SpalteBeschreibung
GruppeName der Gruppe, zum Beispiel “EG”. Zeilen mit gleichem Namen bilden eine Gruppe. Die Gruppen erscheinen in der Reihenfolge, in der sie zuerst in der Liste stehen. Ohne Eintrag landet die Zeile in der Gruppe “Ohne Gruppe”. Die Zeilen lassen sich per Drag and Drop umsortieren. Gruppen, Variablen der Gruppen und die Liste der Kachel folgen dieser Reihenfolge.
NameAnzeigename in Kachel und Übersicht. Bleibt das Feld leer, gilt der Name der Variable.
VariableDie überwachte Variable.
oder ZustandszählerStatt einer Variable eine andere Zustandszähler-Instanz. Deren Variablen werden übernommen, sie bilden eine Gruppe mit dem Eintrag in “Gruppe”, ohne Eintrag mit dem Namen der Instanz. So entsteht eine Gesamtzahl aus den Instanzen je Etage, ohne die Variablen noch einmal zu pflegen. Ändert sich die Liste der übernommenen Instanz, baut sich diese Instanz selbst neu auf. Verweist eine Instanz im Kreis auf sich selbst, zählt die Zeile als nicht verfügbar.
InvertiertZählt das Gegenteil, zum Beispiel bei einem Fensterkontakt, der bei true geschlossen meldet.

Wann ein Element zählt:

VariablentypZählt als aktiv
Ja/Neinbei true
Ganzzahl und Kommazahlbei einem Wert über 0
Textbei einem Wert, der nicht leer und nicht 0 ist

Bei der Art Rollos zählt ein Rollladen, solange er nicht ganz offen ist. Das gilt für Variablen mit der Darstellung Rollladen: Offen ist der Wert “Öffnen bei” der Darstellung, ein Wert innerhalb von 0,5 % der Strecke bis “Geschlossen bei” zählt noch als offen. Andere Variablen zählen auch bei dieser Art nach der Tabelle oben. Bei den anderen Arten gilt die Tabelle für alle Variablen, auch für Rollladen.

Existiert eine Variable nicht mehr, zählt sie nicht mit. Die Instanz zeigt dann den Status “Mindestens eine Variable fehlt”, die Kachel kennzeichnet das Element als nicht verfügbar.

2. Variablen

VariableIdentTypBeschreibung
GesamtTotalGanzzahlAnzahl aller aktiven Elemente.
Mindestens eines aktivAnyActiveJa/Neintrue, sobald mindestens ein Element aktiv ist.
ÜbersichtSummaryTextAktive Elemente je Gruppe, zum Beispiel “EG: Küche · OG: Bad”. Sind alle inaktiv, steht dort der Text für nichts aktiv.
Name der GruppeGroup_<Gruppenname>GanzzahlAnzahl der aktiven Elemente der Gruppe. Umlaute werden im Ident umgeschrieben (“Büro” wird Group_Buero). Die Variable entfällt mit der Gruppe oder wenn die Option abgewählt wird.

Alle Variablen sind schreibgeschützt und werden vom Modul berechnet. Entfernt man eine Gruppe oder die Option, fällt die zugehörige Variable samt Archivdaten weg.

3. Kachel

Die Instanz erscheint in der Kachel-Visualisierung.

Eine Instanz ergibt eine Kachel. Für eine Kachel je Etage legt man deshalb je Etage eine Instanz an und trägt dort nur die Variablen dieser Etage ein. Für eine Gesamtzahl über das ganze Haus genügt eine weitere Instanz, in deren Liste je Zeile eine Etagen-Instanz steht. Steht eine Variable über mehrere Wege in der Liste, zählt sie nur einmal.

  • Die kleine Kachel zeigt die Anzahl der aktiven Elemente auf farbigem Grund, auf Wunsch über die ganze Kachel. Ist nichts aktiv, steht dort “OK” statt der Zahl, darunter “Alles aus” beziehungsweise “Alles geschlossen”.
  • Die Kachel passt sich der Größe des Felds an. In einem kleinen Feld (1×1) bleibt nur die Zahl, etwas größer kommt die Überschrift dazu, erst in einem großen Feld auch die Zeile “x von y”.
  • In der maximierten Ansicht steht darunter die Liste der Variablen in der Reihenfolge der Konfiguration. Bei mehreren Gruppen ist die Liste nach Gruppen gegliedert.
  • Der Zustand einer Zeile steht rechts als Badge: aktiv gefüllt in der Farbe für aktiv, nicht aktiv in der Farbe für “nichts aktiv” (ohne eigene Farben grün), nicht verfügbare Variablen gestrichelt. Schaltbare Variablen zeigen stattdessen nur den Schalter.
  • Variablen mit Aktion lassen sich in der Liste direkt bedienen. Das Steuerelement richtet sich nach der Darstellung der Variable:
Darstellung der VariableSteuerelement in der Liste
Ja/Nein (zum Beispiel Schalter)Schalter
Auswahl, oder Variablenprofil mit AssoziationenKnöpfe mit den Beschriftungen und Farben der Auswahl, ab 7 Einträgen eine Auswahlliste
RollladenKnöpfe Auf, die Stufen (zum Beispiel 25 %, 50 %, 75 %, 99 %) und Zu. Der Knopf der aktuellen Position ist gefüllt, liegt die Position dazwischen, steht der Wert als Text davor (“60 % geschlossen”). Die Prozentwerte sind “geschlossen”.
Schieberegler, oder Zahlenprofil mit WertebereichSchieberegler mit Wert, gesendet wird beim Loslassen
FarbeFarbwähler
Werteingabe und TextfeldEingabefeld, gesendet beim Verlassen des Felds
alle anderen und Variablen ohne Aktionnur der Zustand als Badge

Geschaltet wird über die Aktion der Variable, das Gerät schaltet also tatsächlich. Das Modul schreibt nur Werte, die zum Steuerelement passen (zum Beispiel ein Wert aus der Auswahl oder im Bereich des Reglers), und nur in Variablen der Liste. Während jemand in ein Feld tippt oder einen Regler zieht, zeichnet die Kachel nicht neu.

  • Die Schaltfläche “Alle anzeigen” blendet auch die inaktiven Elemente ein. Die Auswahl merkt sich der Browser.
  • Elemente mit fehlender Variable erscheinen gestrichelt als nicht verfügbar.

Die maximierte Ansicht der Kachel zeigt erst ab Symcon 9.1 Inhalt, unter 9.0 bleibt sie leer.

4. Funktionen

void ZSZ_Update(integer $InstanzID); Zählt neu, schreibt die Variablen und aktualisiert die Kachel. Läuft automatisch bei jeder Änderung einer überwachten Variable.

array ZSZ_GetActive(integer $InstanzID, string $Gruppe); Liefert die Namen der aktiven Elemente. Mit einem Gruppennamen nur die dieser Gruppe, mit einem leeren Text alle.

5. Spenden

Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

PayPal Amazon Wunschzettel

6. Lizenz

CC BY-NC-SA 4.0