Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
Zähler/Sensoren einrichten
Um die Installationen benutzen zu können müssen wir erst einen neuen Kanal (Zähler/Sensor) erstellen:
Kanäle im Frontend anlegen
Im WebFrontend: Kanal hinzufügen → Kanal erstellen
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/
Typ (Pflicht-Parameter)
Typ des Kanals (z.B. Sensor, Zähler), den Umfang der zurzeit verfügbaren Sensoren bzw. Zähler findet sich in der Datei EntityDefinition.json in den Scriptes des Frontends, d.h. beispielsweise auf der Linux-Festplatte unterhalb von /var/www/volkszaehler.org/ und auch hier im Wiki z.B.:
- Typ für aktuelle Leistung: Stromsensor
- Typ für S0-Impulse: Strommesser (auf korrekte Auflösung achten!)
- Typ für absolute Leistung (Zählerstand): Stromzaehler
Auflösung (engl. resolution) (typabhängiger Pflicht-Parameter)
bei einem Kanal vom Typ Stromzähler, die Anzahl der Impulse pro kWh über die s0-Schnittstelle, z.B. bei einem Wechselstromzähler Eltako WSZ12DE-32A sind es 2000 Impulse pro kWh
Titel (Pflicht-Parameter)
Name des Kanals, der im Frontend angezeigt werden soll
Toleranz (Wahl-Parameter)
???
Kosten (engl. cost) (Wahl-Parameter)
Bei einem Kanal vom Typ Stromzählern werden hier die Kosten in Cent pro 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.000226. 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)
Wenn hier der Haken gesetzt wird ist der Kanal später im Frontend unter „öffentliche Kanäle“ auswählbar. Wenn der Haken nicht gesetzt wird kann man den Kanal nur an Hand seiner UUID abrufen. Vor allem wenn man im Browser die Cookies löscht … Wer einen lokalen, privaten Server betreibt sollte „öffentlich“ einschalten, erspart viel Tipperei der UUIDs. Bei Servern die im Internet erreichbar sind sollte das aus bleiben !
Farbe (Wahl-Parameter)
Farbe für die Darstellung des Graphen im Frontend
Aktiv (Wahl-Parameter)
Aktiviert den Kanal.
Style (Wahl-Parameter)
Wahl der Darstellung der Messwerte im Diagramm des Frontends. Zurzeit existieren die Styles lines, points und steps. Welcher Style für welchen Typ eines Kanals günstig wäre, kann hier gern ergänzt werden.
Typ: Stromzaehler, Meßgröße: Impulse, Style: points
Hyperlink (Wahl-Parameter)
???
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.
Kanäle manuell über HTTP Request anlegen
http://<server>/<path>/volkszaehler.org/middleware.php/channel.json?operation=add&title=Testzaehler&type=power&resolution=1000&description=Swissnox[...]
Die Middleware antwortet daraufhin mit einer JSON codierten Antwort, die die UUID des Kanals enthält.
Die UUID läßt sich auch per phpMyAdmin aus der Tabelle „entities“ entnehmen.
Testen
Mit folgendem Request können wir dann bereits die ersten Impulse/Messwerte simulieren:
http://<server>/<path>/volkszaehler.org/middleware.php/data/<uuid>.json?operation=add&value=<1|Sensor Wert>
und mit folgendem die daten zuruecklesen:
http://<server>/<path>/volkszaehler.org/middleware.php/data/<uuid>.json
Um uns nun die Daten anzeigen zu können, müssen wir nur noch das Frontend mit der entsprechenden UUID aufrufen:
http://<server>/<path>/volkszaehler.org/frontend/?uuid=<uuid>
a301d8d0-903b-1234-94bb-d943d061b6a8
Alternativ kann man die UUID auch über das Fenster im Frontend direkt eingeben.