Vorsicht

Dies ist die Dokumentation des aktuellen Entwicklungszweigs der CometVisu. Es besteht daher die Möglichkeit, dass einige der hier beschriebenen Features mit dem aktuellsten Release der CometVisu nicht genutzt werden können.

Widgets in der CometVisu

Widgets sind die einzelnen Elemente aus denen eine CometVisu-Site zusammengebaut wird. Diese können entweder fest in der CometVisu eingebaut sein oder per Plugin-Schnittstelle integriert werden. Die Widgets lassen sich durch den Editor hinzufügen. (Rechtsklick auf das Element, welches ein Widget aufnehmen soll z.B. eine Page oder eine Gruppe (group). Durch Auswahl des Widget aus dem Drop-Down Menü und anschließendem Klick auf das + - Zeichen ist das Widget eingefügt und kann wie folgt konfiguriert werden;

Bedienbare Widgets

Diese Widgets können in irgendeiner Weise bedient werden um so Daten an das Backend zu senden oder andere Aktionen auszulösen, z.B. kann man mit einem Switch durch anklicken einen Lampe schalten, oder mit einem Pagejump kann innerhalb der Visu navigiert werden.

Widget

Beschreibung

Audio

Mit diesem Widget kann in die Visu eine Audio-Datei eingebunden werden, die sich über eine Adresse abspielen lässt.

ColorChooser

Farb-Auswahl-Rad für RGB-Beleuchtung

Designtoggle

Fügt der Visu eine Schaltfläche hinzu, mit der das Design gewechselt werden kann.

ImageTrigger

Fügt der Visu ein klickbares Bild hinzu. Dies kann z.B. für Erinnerungen wie Geburtstage oder Müllabfuhr verwendet werden.

InfoAction

Ermöglicht die Kombination eines darstellenden und bedienbaren Widgets.

InfoTrigger

Fügt der Visu ein Element hinzu, dass zwei Schaltflächen und eine Wertanzeige für Rückmeldungen vom BUS enthält. Z.B. für Multimediasteuerungen.

Multitrigger

Fügt der Visu ein Widget mit 4 Schaltflächen hinzu. Damit kann z.B. die Betriebsart der Heizung umgestellt (Komfort -> Nacht -> Abwesend -> Frostschutz) oder ein Szenenabruf realisiert werden.

Pagejump

Mit dem Widget pagejump lassen sich Seiten der Visu zusätzlich verknüpfen. Von der Funktion ist das vergleichbar mit Hyperlinks.

PushButton

Fügt der Visu eine Schaltfläche hinzu, mit der beim Drücken und Loslassen jeweils ein definierter Wert an den BUS gesendet wird. Z.B. beim Drücken eine 1 und beim Loslassen eine 0. Damit ist es z.B. möglich einen Taster zu simulieren um ein Garagentor, Rollläden oder Raffstores zu öffnen und zu schließen.

Refresh

Mit dem Widget refresh lassen sich die angezeigten Daten der Visu neu abrufen.

Reload

Mit dem Widget reload wird die Visu Seite komplett neu geladen.

Slide

Fügt der Visu einen horizontalen Schieberegler hinzu. Mit diesem kann z.B. gedimmt oder eine Temperatur eingestellt werden.

Switch

Fügt der Visu eine Schaltfläche hinzu, mit der z.B. Schaltaktionen ausgelöst werden können. Der Switch wird typisch für EIN/AUS Aktionen benutzt, wie Licht, Steckdosen, etc.

Toggle

Das toggle Widget ist ähnlich wie der Switch, kann aber mehr als zwei Zustände annehmen - dies kann z.B. für die Umschaltung von Betriebsarten der Heizung genutzt werden. Bei jedem Druck nimmt der Toggle den nächsten möglichen Zustand an.

Trigger

Fügt der Visu eine Schaltfläche hinzu, mit der genau ein definierter Wert für einen kurzen, sowie optional ein definierter Wert für einen langen Tastendruck an den BUS gesendet werden kann, z.B. für das Abrufen und Abspeichern von Szenen oder dem Fahren von Rollos. (kurz = stopp, lang = fahren). Die Adresse für Kurz und Langzeit können unterschiedlich sein.

URL-Trigger

Das UrlTrigger Widget fügt der Visualisierung eine Schaltfläche hinzu, die im Hintergrund eine URL aufruft um dadurch Aktionen auszuführen, z.B. um ein IFTTT Rezept aufzurufen.

Badge

Das NotificationCenterBadge Widget zeigt die aktuelle Anzahl der Nachrichten in der Benachrichtigungszentrale an und öffnet diese, wenn es angeklickt wird.

Darstellende Widgets

Diese Widgets haben eine rein informative Funktion, eine Bedienung ist nicht möglich.

Widget

Beschreibung

Image

Fügt der Visu ein statisches Bild oder ein Kamerabild hinzu.

Info

Fügt der Visu ein dynamisches Feld hinzu, dass Werte vom BUS darstellen kann. Z.B. 14-Byte-Text oder Zählerstände.

Line

Fügt der Visu eine horizontale Linie hinzu, um die Visuseite in einzelne Bereiche zu unterteilen.

RGB

Mit dem RGB-Widget kann man eine Farbe in der Visu anzeigen.

Roundbar

Mit dem Widget roundbar wir ein oder mehrere Indikatoren für einen Wert angezeigt.

Text

Fügt der Visu ein statisches Textfeld hinzu.

Video

Fügt der Visu ein Video oder einen Livestream hinzu. Wird derzeit allerdings von den meisten Quellen noch nicht unterstützt.

Web

Fügt der Visu ein Fläche hinzu, in der externe Webseiten dargestellt werden können.

WG_Plugin_Info

Fügt der Visu ein dynamisches Feld hinzu mit dem Daten aus WireGate Plugins dargestellt werden können.

Sonstige Widgets

Widget

Beschreibung

Break

Fügt der Visu einen Zeilenumbruch hinzu.

Group

Mit group können Widgets in einem Rahmen als Gruppe zusammengefasst werden. Die Größe der Gruppe kann über „layout“ eingestellt werden.

Include

Ermöglicht es, die visu_config.xml in mehrere Dateien aufzuteilen und die Teile über include wieder zusammenzuführen.

Navbar

Mit dem Widget navbar kann der gesamten Visu ein Navigationsmenü hinzu gefügt werden. Das Menü lässt sich an einer Seite (oben, unten, link, rechts) darstellen. Die Navigation durch die Visu lässt sich damit strukturieren.

Page

Erstellt eine neue Visuseite und fügt der aktuellen Seite einen entsprechenden Link hinzu.

Widgets die per Plugin eingebunden werden können

Diese müssen im „meta“ Bereich der visu_config.xml eingebunden werden bevor sie genutzt werden können.

also z.B.:

<plugins>
  <plugin name="diagram"/>
  <plugin name="strftime"/>
</plugins>

Widget

Beschreibung

Clock

Plugin zum Darstellen der Uhrzeit von einer Adresse.

Diagram

RRD-basierte Diagramme

Diagram_Info

Informations-Anzeige, die beim Klick ein Diagramm öffnet

Gauge

Zeigerinstrument

Link

Fügt der Visu einen einfachen anklickbaren Link hinzu

openHAB

Verbesserte Integration mit dem openHAB Backend

OpenweatherMap

Wettervorhersage

PowerSpectrum

Darstellung des Strom-Spektrums

RSS

RSS

RSSlog

Interaktive Log-Meldungen basierend auf RSS-Technologie

Speech

Sprachausgabe (Text-to-speech)

Strftime

Darstellung der Uhrzeit in Textform

SVG

Demo Plugin zur Anzeige einer interaktiv animierten SVG Datei

Timeout

Wechselt nach gewisser Zeit der Inaktivität auf eine andere Seite

tr064

Router Informationen, wie Anruflisten der Fritz!Box, über TR-064.

UPNPController

UPNP-Controller

Hinweis

Das CalendarList-Plugin steht nicht mehr zur Verfügung, da es auf eine Schnittstelle des Google-Kalenders zugegriffen hat, die nicht mehr verfügbar ist.

weitere Plugins befinden sich in der Entwicklung.