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.

Power entity

Verfügbar seit: 2023
Autor: Tobias Bräutigam

Beschreibung

Mit der <cv-power-entity>-Komponente lässt sich die elektrische Leistung eines bestimmten Geräts anzeigen. Es besteht aus einem Icon, einem Wert in der Einheit Watt und einem farblichen Kreis um beide, der optional auch einen Fortschrittsbalken enthalten kann (z.B. im den Ladestand einer Batterie anzuzeigen).

Das Power-Entity ist im Kern ein Svg round value mit vordefiniertem Farbschema, Icon und speziellem Mapping für den Wert. Diese Voreinstellungen sind an das type-Attribut gebunden.

Es existieren folgende Power entity Typen:

`type="pv"`	`type="battery"`	`type="grid"`
`type="charger"`	`type="consumer"`	`type="heatpump"`
`type="house"`

So entspricht zum Beispiel ein

<cv-power-entity type="pv">
   <cv-address transform="DPT:5.001" mode="read">1/4/2</cv-address>
</cv-power-entity>

einem

<cv-svg-round-value icon="knxuf-weather_sun" styling="tile-pv-power" mapping="tile-kilo-watts">
   <cv-address transform="DPT:5.001" mode="read">1/4/2</cv-address>
</cv-svg-round-value>

Werte addieren

Man kann auch mehrere Werte addiert in dieser Komponente anzeigen. Hat man z.B. mehrere einzelnen PV-Module so kann man die mit einer Address-Group summieren und die Menge der Werte die ungleich 0 sind werden neben dem Icon angezeigt.

../../../_images/cv-power-entity-multiple.png

<cv-power-entity type="pv">
    <cv-address-group operator="+">
        <cv-address transform="DPT:12.001" mode="read">1/4/2</cv-address>
        <cv-address transform="DPT:12.001" mode="read">1/4/3</cv-address>
    </cv-address-group>
</cv-power-entity>

Verbindungen

Power Entities können mit einander verbunden werden. Das wird durch eine Linie zwischen 2 Entities dargestellt. Diese Linie kann eine Pfeilspitze an einem der beiden Enden haben um eine Richtung darzustellen. Die Richtung stellt dann den Energiefluss dar, z.B. vom PV-Modul ins Haus.

Weitere Informationen zu den Verbindungen sind im Energy-Widget zu finden.

Erlaubte Attribute

Element	Attribut
	Name	Inhalt	Beschreibung
cv-power-entity	id	Text	ID dieses Elements.
	title	Text	Titel dieses Elements.
	icon	Text	Icon festlegen, wird automatisch von Typ festgelegt und kann hiermit überschrieben werden.
	radius	integer	Radius des Kreises.
	stroke	integer	Randbreite des Kreises.
	min	Zahl	Minimaler Wert.
	max	Zahl	Maximaler Wert.
	foreground-color	Text	Farbe des Wertbalkens.
	background-color	Text	Farbe des Hintergrundbalkens.
	styling	Text	Ändert die Farbe des angezeigten Wertes abhängig vom Wert selbst. Siehe auch Styling
	mapping	Text	Ordnet den Werten vom Bus andere Werte, Texte oder Symbole zur Anzeige zu. Siehe auch Mapping
	format	Text	Formatierung des Wertes (printf-Syntax).
	x	integer	Position dieses Elements auch der x-Achse.
	y	integer	Position dieses Elements auch der y-Achse.
	row	Zahl	Zeile in der dieses Element platziert wird.
	column	Zahl	Spalte in der dieses Element platziert wird.
	rowspan	Zahl	Anzahl der Zeilen die dieses Element belegt
	colspan	Zahl	Anzahl der Spalten die dieses Element belegt
	type	pv, battery, grid, consumer, charger, heatpump oder house	Typ dieser Entität.
	connect-to	Text	Verbindung zu anderer cv-power-entity herstellen.
	connect-from	Text	Verbindung von anderer cv-power-entity herstellen.
	connection-points	Text	Legt fest wo die Verbindungslinie starten und enden soll

Erlaubte Kind-Elemente und deren Attribute

Element	Attribut
Struktur	Name	Inhalt	Beschreibung
cv-power-entity cv-address	transform	Text	Legt den Datentyp im Backend fest, z.B. DPT:1.001 für den KNX Datenpunkttyp 1.001.
	mode	disable, read, write oder readwrite	Legt fest, ob auf dieser Adresse nur gelesen `read`, geschrieben `write`, beides `readwrite` oder nichts davon `disable` werden soll
	value	Text	Fixer Wert welcher an diese Adresse gesendet wird.
	on	click, down oder up	Event bei dem ein Wert and diese Adresse geschickt wird (nur in Verbindung mit `value` und mode=``read`` oder `readwrite`).
	target	Text	Ziel innerhalb der Eltern-Widgets für das die Werte dieser Adresse benutzt werden sollen. Die möglichen Werte hängen vom Eltern-Widget ab.
	format-pos	Zahl	Position für Format-String wenn mehrere Adressen gleichzeitig genutzt werden.
	qos	Zahl	Nur MQTT: QoS
	retain	true oder false	Nur MQTT: retain Flag
	selector	Text	Nur MQTT: JSON Selektor
	backend	Text	Optionaler Name des Backends zu dem diese Adresse gehört.
	mapping	Text	Ordnet den Werten vom Bus andere Werte, Texte oder Symbole zur Anzeige zu. Siehe auch Mapping
	format	Text	Formatierung des Wertes (printf-Syntax).
	delay	positiveInteger	Optionales delay in Millisekunden, um welches das Schreiben an diese Adresse verzögert wird.
	send-mode	on-change oder always	Normalerweise bekommen Elemente, die diese Adresse benutzen nur eine Update-Benachrichtigung, wenn sich der Wert tatsächlich geändert hat (`on-change`). Mit `always` wird diese Überprüfung umgangen und die Update-Benachrichtigung jedes Mal geschickt, wenn ein neuer Wert vom Backend empfangen wurde.
cv-power-entity cv-address #text		Text	Die Gruppenadresse (z.B: 12/0/7) bei KNX-Backends, der Item-Name beim openHAB-Backend oder das Topic bei MQTT.

Element	Attribut
Struktur	Name	Inhalt	Beschreibung
cv-power-entity cv-address-group	operator	+, -, * oder /	Mathematischer Operator für Berechnung.
	round	true oder false	Ergebnis runden.
	factor	float	Ergebnis mit diesem Wert multiplizieren.
cv-power-entity cv-address-group cv-address	transform	Text	Umwandlung des Bus-System Wertes um angezeigt werden zu können.
	mode	disable, read, write oder readwrite	„disable“ deaktiviert die Kommunikation, bei „read“ wird nur vom Backend gelesen, bei „write“ wird nur geschrieben und „readwrite“ wird die Adresse zum Lesen und zum Schreiben verwendet.
	variant	Text
	format-pos	Zahl	Position für Format-String wenn mehrere Adressen gleichzeitig genutzt werden.
	selector	Text	Nur MQTT: JSON Selektor
	qos	Zahl	Nur MQTT: QoS
	retain	true oder false	Nur MQTT: retain Flag
	ignore-error	true oder false	Nur MQTT: ignoriere Dekodierfehler.
cv-power-entity cv-address-group cv-address #text		Text	Die Gruppenadresse (z.B: 12/0/7) bei KNX-Backends, der Item-Name beim openHAB-Backend oder das Topic bei MQTT.