Benutzer-Werkzeuge

Webseiten-Werkzeuge


software:controller:vzlogger

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
software:controller:vzlogger [2017/02/26 15:04]
jau loglevel
software:controller:vzlogger [2019/05/06 12:20] (aktuell)
jau Ort Konfig
Zeile 1: Zeile 1:
 ====== vzlogger ====== ====== vzlogger ======
 +
 +This description is also available in [[/​software/​controller/​vzlogger/​overview_en|english]].
  
 **vzlogger**... **vzlogger**...
-  * is a tool to read and log measurements of a wide variety of smartmeters and sensors to the volkszaehler.org middleware+  * ist ein Werkzeug zum Lesen der Messwerte von Sensoren und Smartmeter um sie an die volkszahler.org Middleware weiterzureichen 
-  * can run as a daemon ​in background or via cron. +  * unterstütz auch [[https://​www.mysmartgrid.de/​|MySmartGrid]] und [[https://​en.wikipedia.org/​wiki/​InfluxDB|InfluxDB]] 
-  * includes a tiny onboard HTTPd to serve realtime readings to the AJAX web frontend.+  * kann als daemon ​im Hintergrund arbeiten oder per cron aufgerufen werden
 +  * enthält einen kleinen eingebauten httpd um Echtzeitwerte als AJAX-Frontend bereitzustellen 
 +  * liefert die Daten auch über einen zweiten, zusätzlichen Push-Kanal aus.
  
 ===== Features ===== ===== Features =====
-  * evaluates middleware return code +  * wertet den Return Code der Middleware aus 
-  * buffering readings ​in case of:  +  * puffert die Werte in Falle von:  
-    * network timeout +    * Netzwerktimeout 
-    * invalid middleware return code/​exception or misconfiguration +    * ungültigem Middleware Return Code, Fehlern oder Fehlkonfigurationen 
-  * "local interface" ​onboard HTTPd ([[http://bugs.volkszaehler.org/​view.php?​id=9|[9] ]]) +  * "lokales Interface" ​eingebauter httpd 
-  * easily extendable with new sensor/​meter protocols +  * einfach um weitere Sensoren oder SmartMeter Protokolle zu erweitern 
-  * runs on embedded devices (Plug-ComputersRoutersFluksos ​etc..) +  * auf Embedded Systemen lauffähig ​(Mini-Computer, ​[[/howto/raspberry_pi_image|Raspberry Pi]], Router, Flukso, etc..) 
-  * portable ​(conforms to POSIX standards)+  * portierbar ​(entspricht ​POSIX Standards)
  
 ===== Installation ===== ===== Installation =====
  
-vzlogger is hosted at [[https://​github.com/​volkszaehler/​vzlogger]].+Vzlogger wird über Github bereitgestellt ​[[https://​github.com/​volkszaehler/​vzlogger]].
  
-==== installation ​==== +==== Installationsanleitung ​==== 
-for installing the current version, refer to  ​[[/​software/​controller/​vzlogger/​installation_cpp-version]].+Die Anleitung findet ihr auf einer getrennten Seite: ​[[/​software/​controller/​vzlogger/​installation_cpp-version]].
  
  
-===== Meters ​Protocols ​=====+===== Zähler ​Protokolle ​=====
  
-The following table contains an overview of the existing protocols supported by vzlogger:+Die folgende Tabelle enthält eine Übersicht der von vzlogger ​unterstützen Protokolle:
  
-^ID^Description^Status^Example ​Usecases^Links & References+^ID^Beschreibung^Status^Beispiel ​Anwendung^Links & Referenzen
-|''​file''​|Read from file or fifo|**implemented**|[[http://​owfs.org/​|OWFS]],​ ''/​proc/'' ​Filesystem|[[http://​linux.die.net/​man/​3/​exec|read(3)]]| +|''​file''​|lesen von Datei oder fifo|**implemented**|[[http://​owfs.org/​|OWFS]],​ ''/​proc/'' ​Dateisystem|[[http://​linux.die.net/​man/​3/​exec|read(3)]]| 
-|''​exec''​|Parse program output|**untested**|[[http://​www.digitemp.com/​|digitemp]]|[[http://​linux.die.net/​man/​3/​exec|exec(3)]]| +|''​exec''​|Programmausagben parsen|**untested**|[[http://​www.digitemp.com/​|digitemp]]|[[http://​linux.die.net/​man/​3/​exec|exec(3)]]| 
-|''​sml''​|SML ​as used by EDL-21, eHz and SyM<​sup>​2</​sup> ​meters|**implemented**| |[[software:​sml]]| +|''​sml''​|SML ​wie von  ​EDL-21, eHz and SyM<​sup>​2</​sup> ​Zählern genutzt|**implemented**| |[[software:​sml|SML]]| 
-|''​s0''​|S0-meter directly or indirectly (USB)  connected to UART or GPIO|**implemented**|Quick and dirty method|[[/​hardware/​controllers/​s0-an-rs232]]| +|''​s0''​|S0-Zähler an UARTGPIO oder indirekt über USB angeschlossen|**implemented**|[[/​hardware/​controllers/​raspberry_pi_erweiterung_mit_schaltausgaengen_rev.1|Rpi-Erweiterung Rev.1]] oder [[/​hardware/​controllers/​raspberry_pi_erweiterung_klein|klein]]| 
-|''​d0''​|DLMS/​D0 ​linebased cleartext|**implemented**| | [[development:​standards|DIN EN 62056-21]]| +|''​d0''​|DLMS/​D0 ​zeilenbasiertes Textformat|**implemented**| | [[development:​standards|DIN EN 62056-21]]| 
-|''​w1therm''​| ​Support ​1Wire-Sensors based on DSxxxxx|**implemented**| |1Wire Busmaster DS2482 ist Voraussetzung| +|''​w1therm''​| 1Wire-Sensoren basierend auf DSxxxxx|**implemented**| |1Wire Busmaster DS2482 ist Voraussetzung| 
-|''​ocr''​|OCR (image processing/​recognizingwith USB-Cam|**implemented**| | | +|''​ocr''​|OCR (Bilderkennungz.B. über USB-Cam|**implemented**| |[[http://​wiki.volkszaehler.org/​meterocr_konfigurieren]]
-|''​random''​|Generate random values with a [[http://​en.wikipedia.org/​wiki/​Random_walk|random walk]]|**implemented**|Testing and demonstration ​| | +|''​random''​|Zufallsgenerator für Werte via [[http://​en.wikipedia.org/​wiki/​Random_walk|random walk]]|**implemented**|für Test- und Demonstrationszwecke
-|''​fluksov2''​|Read from Flukso'​s ​onboard SPI fifo|**implemented**| | +|''​oms''​|Open Metering System, based on M-Bus communication|**implemented**| |[[development:​standards#​oms_group|OMS Group]]
-|''​fluksousb''​|[[hardware:​controllers:​fluksousb|]]|**planned**| ​|[[https://​github.com/​comsound/​flukso|'​Bart'​s Protokoll'​]]|+|''​fluksov2''​|auslesen des Flukso onboard SPI fifo|**implemented**| | 
 +|''​fluksousb''​|USB-Adapterplatine für S0 und Stromwandler auslesen|**planned**|[[hardware:​controllers:​fluksousb|]]|[[https://​github.com/​comsound/​flukso|'​Bart'​s Protokoll'​]]|
 |''​vsm103''​|Voldcraft VSM-103 Drehstromzähler|**planned**| |[[hardware:​channels:​meters:​power:​vsm-103|VSM-103]]| |''​vsm103''​|Voldcraft VSM-103 Drehstromzähler|**planned**| |[[hardware:​channels:​meters:​power:​vsm-103|VSM-103]]|
 |''​kd302''​|Energiekostenmessgerät KD 302|**planned**| |[[hardware:​channels:​meters:​power:​kd_302|KD 302]]| |''​kd302''​|Energiekostenmessgerät KD 302|**planned**| |[[hardware:​channels:​meters:​power:​kd_302|KD 302]]|
-|''​ccost''​|Weatherstation alike commercial smart metering system|**planned**| |[[http://​www.currentcost.co.uk/​powermeter/​|CurrentCost]],​ [[http://​umweltsuende.wordpress.com/​2010/​09/​16/​klein-aber-fein/​|Umweltsünde]],​ [[http://​www.jibble.org/​currentcost/​|Jibble]]| +|''​ccost''​|Wetterstation vergleichbar mit kommerziellen SmartMeter Systemen|**planned**| |[[http://​www.currentcost.co.uk/​powermeter/​|CurrentCost]],​ [[http://​umweltsuende.wordpress.com/​2010/​09/​16/​klein-aber-fein/​|Umweltsünde]],​ [[http://​www.jibble.org/​currentcost/​|Jibble]]| 
-|''​tweetawatt''​|KillAWatt mod with XBee wireless ​communication|**planned**| |[[https://​github.com/​adafruit/​Tweet-a-Watt|Sourcecode]],​ [[http://​www.ladyada.net/​make/​tweetawatt/​|Blog]]| +|''​tweetawatt''​|KillAWatt mod mit XBee wireless ​Kommunikation|**planned**| |[[https://​github.com/​adafruit/​Tweet-a-Watt|Sourcecode]],​ [[http://​www.ladyada.net/​make/​tweetawatt/​|Blog]]| 
-|''​ansi''​|ANSI ​standard that describes a protocol used for two-way communications with an electricity meter, mostly used in North American markets.|**planned**| |[[development:​standards#​ansi|ANSI C12]]| +|''​ansi''​|ANSI ​Standard der ein Protokoll beschreibt wie es für Zweiwegekommunkation mit Stromzählern ​in Nordamerika genutzt wird.|**planned**| |[[development:​standards#​ansi|ANSI C12]]| 
-|''​oms''​|Open Metering System, based on M-Bus communication|**implemented**| |[[development:​standards#​oms_group|OMS Group]]|+
  
 ===== APIs ===== ===== APIs =====
  
-Vzlogger ​is able to push the gathered data to different backend systems for further processing or storageThis is done via the `api` parameter that is configured per channel. ​Vzlogger'​s default backend api is volkszaehler, ​which is the volkszaehler middleware. Additonal options are mysmartgrid and a '​null' ​api.+Vzlogger ​ist in der Lage die erfassten Daten an verschiedene Endsysteme, zur weitere Verabeitung oder Speicherung,​ zu schickenDas geschieht über den `api` Parameter der für jedem channel ​konfiguriert wird. 
 +Vzloggers Standard-Endsystem ist die Middleware eines volkszaehler. Weitere Endsysteme sind MySmartGridInfluxDB und eine '​null' ​API.
  
-===== Configuration ===== 
  
-The vzlogger configuration is done with a file containing JSON encoded settings. General settings also can be set via the [[#​command_line_parameters|command line]]. You must have at least one meter in your configuration. Channels are optional. A meter can have more channels. Ex. if you want to log to multiple middleware servers.+===== Konfiguration =====
  
-All meter protocols have own propertiesWe do not describe them here in detailJust take a look at the example configurationIt contains a meter for every protocol.+Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthältÜberlicherweise zu finden unter ''/​etc/​vzlogger.conf''​. Einige grundlegende Parameter lassen sich auch über [[#​Kommandozeilenparameter|Kommandozeile]] bestimmen. 
 +Es sind ein oder mehr meter in der Konfiguration erforderlichChannels sind optionalEin meter kann mehrere channel enthalten und damit auch mehrere Middlewares bedienen.
  
-A detailed example configuration is included in the distribution,​ +Alle Zählerprotokolle haben gesonderte Eigenschaften die hier im Detail nicht weiter beschrieben werden. Zu jedem Protokoll gibt es eine kommentierte Beispielkonfiguration. Einzusehen bei github: ​https://​github.com/​volkszaehler/​vzlogger/​blob/​master/​etc/​
-see https://​github.com/​volkszaehler/​vzlogger/​blob/​master/​etc/​vzlogger.conf+
  
-You can also find different user's configurations ​in the [[//​howto]] ​section.+Die einzelnen Parameter sind hier im Wiki nochmal ​in deutsch beschrieben:​ [[software/​controller/​vzlogger/​vzlogger_conf_parameter]] 
 +Konfigurationen diverser Nutzer finden sich im Bereich ​[[//howto|HowTo]]. Spezifische Beispiele für einzelne Zähler ​ im Bereich [[/​hardware/​channels/​meters/​power/​edl-ehz]].
  
-You can also use these script: ​[[http://​volkszaehler.github.io/​vzlogger/​|vzlogger.conf-editor]]+Als Unterstützung bei der Syntax dient der [[http://​volkszaehler.github.io/​vzlogger/​|vzlogger.conf-Editor]].
  
 +==== Identifier ====
 +Je nach Zähler oder Sensor stehen ein oder mehre Werte zur Verfügung. Um diese den Channels zuordnen zu können sind eindeutige Identifier notwendig. Diese werden zum Teil vom Protokoll oder auch durch die Hardware bestimmt.
 ^ Meter ^ Identifier ^ Bemerkung ^ ^ Meter ^ Identifier ^ Bemerkung ^
-| SML, D0 | Obis-Codes z.B. 1-0:1.8.0 | Welche Obis-Codes/​Identifier gesendet werden ist abhängig vom Gerät | +| SML, D0 | [[software:​obis|Obis-Codes]] z.B. 1-0:1.8.0 | Welche Obis-Codes/​Identifier gesendet werden ist abhängig vom Gerät | 
-| OMS | Obis-Codes 1.8.0, 2.8.0, 1.7.0, 2.7.0 | max. die 4 Obis-Codes, abhängig vom Gerät |+| OMS | [[software:​obis|Obis-Codes]] 1.8.0, 2.8.0, 1.7.0, 2.7.0 | max. die 4 Obis-Codes, abhängig vom Gerät |
 | S0 | "​Impulse"​ und "​Impulse_neg"​ | Anzahl Impulse (pro Sekunde) | | S0 | "​Impulse"​ und "​Impulse_neg"​ | Anzahl Impulse (pro Sekunde) |
 | S0 | "​Power"​ und "​Power_neg"​ | Impulse pro Zeiteinheit umgerechnet in "​Leistung"​ (per Parameter resolution) | | S0 | "​Power"​ und "​Power_neg"​ | Impulse pro Zeiteinheit umgerechnet in "​Leistung"​ (per Parameter resolution) |
Zeile 75: Zeile 83:
  
  
-===== Command line parameters ​===== +===== Kommandozeilenparameter ​===== 
-^parameter^^example ​(default)^description+^Parameter^^Beispiel ​(Default)^Beschreibung
-^long^short| | | +^lang^kurz| | | 
-|%%--%%config|-c|/​etc/​vzlogger.conf|configuration file+|%%--%%config|-c|/​etc/​vzlogger.conf|Konfigurationsdatei
-|%%--%%log|-o|/​var/​log/​vzlogger.log|log file+|%%--%%log|-o|/​var/​log/​vzlogger.log|Logfile
-|%%--%%daemon|-d|//​off//​|run in background+|%%--%%daemon|-d|//​off//​|im Hintergrund ausführen
-|%%--httpd%%|-l|//​off//​|activate local interface ​(tiny HTTPd which serves live readings)| +|%%--httpd%%|-l|//​off//​|lokales Interface aktivieren ​(kleiner httpd für Echtzeitwerte)| 
-|%%--httpd-port%%|-p|8080|TCP ​port for HTTPd+|%%--httpd-port%%|-p|8080|TCP-Port des httpd
-|%%--%%help|-h| |show short help+|%%--%%help|-h| |Kurzhilfe
-|%%--%%verbose|-v//​level//​|0|enable verbose output ​(0-15; 0 = log_alert, 1 = log_error, 3 = log-warning,​ 5 = log_info, 10 = log-debug, 15 = log_finest)| +|%%--%%verbose|-v//​level//​|0|tiefe der Ausgabe erhöhen ​(0-15; 0 = log_alert, 1 = log_error, 3 = log-warning,​ 5 = log_info, 10 = log-debug, 15 = log_finest)| 
-|%%--%%version|-V| |show version of vzlogger|+|%%--%%version|-V| |Version des vzlogger ​ausgeben|
  
 ===== Links ===== ===== Links =====
-  * [[https://​github.com/​volkszaehler/​vzlogger/​|Sourcecode]] on github.com+  * [[https://​github.com/​volkszaehler/​vzlogger/​|Quellcode]] auf github.com
   * [[https://​github.com/​volkszaehler/​libsml|libsml]]   * [[https://​github.com/​volkszaehler/​libsml|libsml]]
- 
-===== Generate Debian packages for your favorite platform ===== 
- 
-<note important>​Package source seems to be defunct!</​note>​ 
- 
-<​code>​ 
-$ sudo echo "​deb-src http://​packages.0l.de/​debian/​ squeeze main non-free"​ >> /​etc/​apt/​sources.list 
-$ sudo apt-get update 
-$ apt-get source vzlogger 
-$ cd vzlogger-<​version>​ 
-$ sudo apt-get install debhelper 
-$ dpkg-buildpackage -b 
-</​code>​ 
  
software/controller/vzlogger.1488117851.txt.gz · Zuletzt geändert: 2017/02/26 15:04 von jau