Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:middleware:einrichtung [2015/09/30 11:15] – [Kanäle im Frontend anlegen] udo1
+++ software:middleware:einrichtung [2023/04/12 18:54] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 3: / Zeile 3: @@
 ==== Kanäle im Frontend anlegen ====
-Im WebFrontend: **Kanal hinzufügen -> Kanal erstellen**
+Im WebFrontend unten links: **Kanal hinzufügen -> Kanal erstellen**
-<note important>Hier werden bisher noch nicht alle Zählertypen unterstützt!</note>
+{{/software/frontends/frontend/kanal_erstellen.png?300|}}
 Die Parameter im Fenster **"Kanal hinzufügen"** gliedern sich in Pflicht-Parameter (schwarze Schrift) und Wahl-Parameter (graue Schrift). Die Parameter haben folgende Bedeutung:
 === Middleware (Pflicht-Parameter)===
-Pfad zum Script middleware.php, in der Regel unter ../middleware.php, d.h. beispielsweise auf der Linux-Festplatte unter /var/www/volkszaehler.org/htdocs/
+Pfad zum Script middleware.php, in der Regel unter ./middleware.php, d.h. beispielsweise auf der Linux-Festplatte unter /var/www/volkszaehler.org/htdocs/
 === Typ (Pflicht-Parameter) ===
@@ Zeile 17: / Zeile 17: @@
   * Typ für S0-Impulse: El.Energie (S0-Impulse)  #(auf korrekte Auflösung achten!)
   * Typ für absolute Leistung (Zählerstand): El.Energie (Zählerstände)  #(Initialwert eingeben)
+  * Typ für aktuelle Leistung: El.Energie (Leistungswerte)
+  * freier Typ ohne vorherbestimmte Einheit: Sensor
+  * Typ ohne Istwerte: virtuelle Kanäle (virt.)
+  * Struktur: Gruppe, Gebäude und Nutzer
+=== Titel (Pflicht-Parameter) ===
+Name des Kanals, der im Frontend angezeigt werden soll
 === Auflösung (engl. resolution) (typabhängiger Pflicht-Parameter) ===
@@ Zeile 22: / Zeile 29: @@
 Bei einem Gaszähler mit einer Auflösung von 0,01m³/Impuls wird eine Auflösung von 100 eingetragen.
-=== Titel (Pflicht-Parameter) ===
+Für Stromzähler mit Absolutwerten (Zählerstände) wird ebenfalls die Einheit kWh angenommen. Sind die Rohdaten in Wh wäre die korrekte Auflösung 1000.
-Name des Kanals, der im Frontend angezeigt werden soll
-=== Toleranz (Wahl-Parameter) ===
+=== Einheit (typabhängiger Pflicht-Parameter) ===
-???
+Bei virtuellen Kanälen oder freiem Typ "Sensor" ist keine physikalische Einheit vordefiniert, die soll hier eingegeben werden.
-=== Kosten (engl. cost) (Wahl-Parameter) ===
-Bei einem Kanal vom Typ Stromzählern werden hier die Kosten in €/kWh eingetragen. Betragen die Kosten beispielsweise 22.6 Cent prp kWh, so steht in der Datenbank in der Tabelle properties ein Datensatz mit pkey = cost und value = 0.226. Bitte beim Eintragen der Kosten im Frontend beachten: Die Nachkommastellen des Kostenbetrages werden mit einem Punkt (.) und nicht mit einem Komma (,) abgetrennt.
-=== Lokale Adresse (Wahl-Parameter) ===
-???
-=== Beschreibung (Wahl-Parameter) ===
-???
 === Öffentlich (Wahl-Parameter) ===
@@ Zeile 47: / Zeile 44: @@
 Farbe für die Darstellung des Graphen im Frontend
-=== Aktiv (Wahl-Parameter) ===
+=== Stil (Wahl-Parameter) ===
-Aktiviert den Kanal.
+Wahl der Darstellung der Messwerte im Diagramm des Frontends. Zurzeit existieren die Styles lines, steps, states und points.\\
-=== Style (Wahl-Parameter) ===
-Wahl der Darstellung der Messwerte im Diagramm des Frontends. Zurzeit existieren die Styles lines, points und steps.\\
 Temperaturen: lines\\
 S0-Impulse, Zählerstand, Leistungswerte: steps\\
-=== Hyperlink (Wahl-Parameter) ===
+=== Füllgrad (Wahl-Parameter) ===
-???
+Deckungsgrad der Farbe unterhalb des Graphen.
+=== Achse ===
+Hier kann der horizontalen Skala zu dem Kanal eine höher Priorität zugeordnet werden.
+In den meisten Fällen ist auto passend.
+=== Kosten (engl. cost) (Wahl-Parameter) ===
+Bei einem Kanal vom Typ Stromzählern werden hier die Kosten in €/kWh eingetragen. Betragen die Kosten beispielsweise 22.6 Cent pro kWh, so steht in der Datenbank in der Tabelle properties ein Datensatz mit pkey = cost und value = 0.226.
+<note important>Bitte beim Eintragen der Kosten im Frontend beachten: Die Nachkommastellen des Kostenbetrages werden mit einem Punkt (.) und nicht mit einem Komma (,) abgetrennt.</note>
+=== Initialverbrauch (Wahl-Parameter) ===
+Ausgängszählerstand bei Inbetriebnahme des Kanals. Dient dazu den Gesamtzählerstand zu ermitteln und in der Tabelle unterhalb des Graphen mit auszugeben. Auch bei Kanälen in denen tatsächliche Zählerstände geloggt werden ist es erforderlich und sollte dem aktuellen Zählerstand bei erstellen des Kanals entsprechen.
 === Cookie (Wahl-Parameter) ===
 Grundlage für die permanente Speicherung einer Ansicht des Frontends im Browser. Sollen verschiedene Ansichten des Frontends abrufbar sein, wird die Nutzung von multi-user-fähigen Browsern (iOS-app: switch, Firefox-Add-On: CookieSwap) empfohlen.
+=== Regel (typabhängiger Pflicht-Parameter) ===
+{{ :software:frontends:frontend:virtuellen_kanal_erstellen.png?300|}}
+Für virtuelle Kanäle ist eine Formel nötig um Daten aus anderen Kanälen ermitteln zu können. Es sind einfache mathematische Operationen möglich. Dazu müssen Eingang (1-4) passend zur Formel definiert sein.
+Z.B. würde ''val(in1) - val(in2)'' den Eingang 2 von Eingang 1 subtrahieren.\\
+Für brauchbare Werte müssen die Einheiten der Eingänge zueinander passen. Ausnahme sind Zählerstände (Wh), sie werden von der Middleware grundsätzlich von der Zeit "befreit" und stehen z.B. als Leistung (W) zur Verfügung. Dementsprechend ist die Einheit des virtuellen Kanals auch immer ohne Zeit (W).
+=== Eingang (1-4) (typabhängiger Pflicht und Wahl-Parameter) ===
+Hier sind die UUID der Kanäle einzutragen aus denen der virtuelle Kanal errechnet werden soll.
+Eingang 1 ''(in1)'' ist Pflicht, Eingänge 2-4 (''(in2)'', ''(in3)'' und ''(in4)'') sind optional.
+=== UUID ===
+Die UUID wird beim Anlegen eines Kanals automatisch erzeugt und wird nach Anlegen des Kanals in einem Fenster angezeigt. Später kann die über das (i) rechts neben dem Kanal abgefragt werden.
 ==== Kanäle manuell über HTTP Request anlegen ====
+Ein alternativer Weg. Der gesamte, verfügbare Funktionsumfang kann unter [[/development/api/reference|Referenz]] eingesehen werden.
 <code>
-http://<server>/<path>/volkszaehler.org/middleware.php/channel.json?operation=add&title=Testzaehler&type=power&resolution=1000&description=Swissnox[...]
+http://<server>/<path>/middleware.php/channel.json?operation=add&title=Testzaehler&type=power&resolution=1000&description=Swissnox[...]
 </code>
@@ Zeile 75: / Zeile 95: @@
 Mit folgendem Request können wir dann bereits die ersten Impulse/Messwerte simulieren:
 <code>
-http://<server>/<path>/volkszaehler.org/middleware.php/data/<uuid>.json?operation=add&value=<1|Sensor Wert>
+http://<server>/<path>/middleware.php/data/<uuid>.json?operation=add&value=<1|Sensor Wert>
 </code>
-und mit folgendem die daten zuruecklesen:
+und mit folgendem die Daten zurücklesen:
 <code>
-http://<server>/<path>/volkszaehler.org/middleware.php/data/<uuid>.json</code>
+http://<server>/<path>/middleware.php/data/<uuid>.json</code>
 Um uns nun die Daten anzeigen zu können, müssen wir nur noch das Frontend mit der entsprechenden UUID aufrufen:
 <code>
-http://<server>/<path>/volkszaehler.org/frontend/?uuid=<uuid>
+http://<server>/<path>/?uuid=<uuid>
 </code>