Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:controller:vzlogger:vzlogger_conf_parameter [2019/01/26 07:52] – alle OBIS in SML bei verbosity=15 jau
+++ software:controller:vzlogger:vzlogger_conf_parameter [2020/01/19 16:08] – Korrektur protocol 1-wire -> w1therm ruperts
@@ Zeile 25: / Zeile 25: @@
 === daemon ===
-Betreibt vzlogger als Dienst (daemon) in den Hintergrund.
+Betreibt vzlogger als Dienst (daemon) in den Hintergrund.\\
+Bedingt durch einen Fehler im Code werden bei ''false'' die erfassten Daten nicht versendet, es taugt daher leider nur für Tests.
 ^ Typ | Bool |
 ^ Wert | true/false |
@@ Zeile 55: / Zeile 56: @@
 ====== push ======
 Empfangsort des VZ-[[https://de.wikipedia.org/wiki/Push-Pull-Strategie|Push]]-Servers.\\
-Über den Dienst ist es zum Beispiel möglich Daten an die VZ-Middleware zu schicken die zwar dargestellt, aber nicht gespeichert werden sollen. Es muss parallel dazu der [[software/middleware/push-server|Push-Server der Middleware]] aktiviert werden.
+Über den Dienst ist es zum Beispiel möglich Daten an die VZ-Middleware zu schicken die zwar dargestellt, aber nicht gespeichert werden. Es muss parallel dazu der [[software/middleware/push-server|Push-Server der Middleware]] aktiviert werden.
 <code>
   "push": [
@@ Zeile 215: / Zeile 216: @@
 | ''ocr'' | z.B. "wert" | wie unter ''meter'', ''identifier'' parametriert |
 | ''oms'' | z.B. "1.8.0" | [[software:obis|OBIS-Codes]] |
-| ''1-wire'' | z.B. "28-00000450cbbd" | ID des Sensors |
+| ''w1therm'' | z.B. "28-00000450cbbd" | ID des Sensors |
@@ Zeile 502: / Zeile 503: @@
 ^ Wert | "" eine gültige URL mit Port |
 ^ Empfehlung | "" |
 === pullseq ===
 Initialisierungssequenz für Pull-Meter.
@@ Zeile 541: / Zeile 542: @@
 ----
 ==== exec ====
-Programmausgaben parsen
+In einem exec-Kanal wird für jede Abfrage das im Parameter ''command'' angegebene Shellkommando aufgerufen und die Standard-Ausgabe dieses Kommandos geparst. Dabei kann das erwartete Format mit Hilfe des ''format'' Parameters spezifiziert werden.
+  * exec-Kanäle sind nicht möglich, wenn der vzlogger als ''root'' ausgeführt wird. Durch einen Compiler-Parameter lässt sich diese Sicherheitsmaßnahme ausschalten. Es wird allerdings empfohlen, den vzlogger besser nicht als ''root'' auszuführen. In vielen Standard-Images ist dies nicht der Fall.
+  * Es wird für den Aufruf eine Shell verwendet, damit sind Pipes etc in vollem Umfang möglich
+  * Enthält der Formatstring kein $t, wird die aktuelle Uhrzeit als Timestamp verwendet
+=== command ===
+Dieses Kommando wird ausgeführt; seine Ausgabe geparst
+^ Typ | string |
+^ Wert | Shell-Kommando |
+^ Beispiel | Siehe Wikiseiten zum [[hardware:channels:solar_inverters:kostal_pico|Kostal Piko]] oder zum [[hardware:channels:meters:power:dzg_dvh4013_modbus|DZG DVH 4013 Modbus]] |
+=== format ===
+Jede Zeile der Ausgabe des ''command'' wird mit diesem Formatstring geparst und für jede Zeile ein eigener Datensatz erzeugt. Somit können sowohl mehrere Werte (z.B. verschiedene Register, die mit einem einzigen Aufruf des ''command'' ausgelesen wurden) als auch Werte unterschiedlicher Zeitstempel (z.B. man fragt die Quelle alle 30 Sekunden ab, möchte aber aus Gründen immer Batches von sechs Werten gleichzeitig in die Datenbank schreiben) mit einem einzelnen Aufruf eingetragen werden.
+^ Typ | string |
+^ Wert | Formatstring |
+^ Beispiel | '$t: $i = $v' für Ausgaben wie '1559656949: Gesamtenergie = 23294' |
+  * $t: timestamp
+  * $i: identifier (beliebiger String, taucht im Channel unter ''identifier'' wieder auf)
+  * $v: value
+Werte ohne identifier-Angabe landen beim Channel mit '"identifier": ""'.
+Weitere Dokumentation könnte man in den Mailinglistenarchiven, z.B. [[https://demo.volkszaehler.org/pipermail/volkszaehler-dev/2016-March/004933.html|hier ff.]], finden.
 ----