software:controller:vzlogger
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
software:controller:vzlogger [2017/11/01 01:04] – Typo jau | software:controller:vzlogger [2022/06/17 08:15] (aktuell) – [vzlogger] typo boenki | ||
---|---|---|---|
Zeile 5: | Zeile 5: | ||
**vzlogger**... | **vzlogger**... | ||
* ist ein Werkzeug zum Lesen der Messwerte von Sensoren und Smartmeter um sie an die volkszahler.org Middleware weiterzureichen | * ist ein Werkzeug zum Lesen der Messwerte von Sensoren und Smartmeter um sie an die volkszahler.org Middleware weiterzureichen | ||
- | * unterstütz | + | * unterstützt |
- | * arbeitet | + | * läuft |
* enthält einen kleinen eingebauten httpd um Echtzeitwerte als AJAX-Frontend bereitzustellen | * enthält einen kleinen eingebauten httpd um Echtzeitwerte als AJAX-Frontend bereitzustellen | ||
- | * liefert die Daten auch über einen zweiten, zusätzlichen Push-Kanal aus | + | * liefert die Daten auch über einen zweiten, zusätzlichen Push-Kanal aus. |
===== Features ===== | ===== Features ===== | ||
* wertet den Return Code der Middleware aus | * wertet den Return Code der Middleware aus | ||
- | * puffert die Werte in Falle von: | + | * puffert die Werte (im RAM) im Falle von: |
* Netzwerktimeout | * Netzwerktimeout | ||
* ungültigem Middleware Return Code, Fehlern oder Fehlkonfigurationen | * ungültigem Middleware Return Code, Fehlern oder Fehlkonfigurationen | ||
Zeile 53: | Zeile 53: | ||
===== APIs ===== | ===== APIs ===== | ||
- | Vzlogger ist in der Lage die erfassten Daten an verschiedene Endsysteme, zur weitere | + | Vzlogger ist in der Lage die erfassten Daten an verschiedene Endsysteme, zur weiteren |
Vzloggers Standard-Endsystem ist die Middleware eines volkszaehler. Weitere Endsysteme sind MySmartGrid, | Vzloggers Standard-Endsystem ist die Middleware eines volkszaehler. Weitere Endsysteme sind MySmartGrid, | ||
===== Konfiguration ===== | ===== Konfiguration ===== | ||
- | + | < | |
- | Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Einige grundlegende Parameter lassen sich auch über [[# | + | Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Überlicherweise zu finden unter ''/ |
Es sind ein oder mehr meter in der Konfiguration erforderlich. Channels sind optional. Ein meter kann mehrere channel enthalten und damit auch mehrere Middlewares bedienen. | Es sind ein oder mehr meter in der Konfiguration erforderlich. Channels sind optional. Ein meter kann mehrere channel enthalten und damit auch mehrere Middlewares bedienen. | ||
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:// | 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:// | ||
- | Die einzelnen Parameter sind hier im Wiki nochmal in deutsch beschrieben: | + | Die einzelnen Parameter sind hier im Wiki nochmal in deutsch beschrieben: |
- | Konfigurationen diverser Nutzer finden sich im Bereich [[// | + | Konfigurationen diverser Nutzer finden sich im Bereich [[// |
Als Unterstützung bei der Syntax dient der [[http:// | Als Unterstützung bei der Syntax dient der [[http:// | ||
Zeile 72: | Zeile 72: | ||
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. | 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/ | + | | SML, D0 | [[software: |
- | | 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: |
| S0 | " | | S0 | " | ||
| S0 | " | | S0 | " | ||
Zeile 87: | Zeile 87: | ||
^lang^kurz| | | | ^lang^kurz| | | | ||
|%%--%%config|-c|/ | |%%--%%config|-c|/ | ||
- | |%%--%%log|-o|/ | + | |%%--%%log|-o|/ |
- | |%%--%%daemon|-d|// | + | |
|%%--httpd%%|-l|// | |%%--httpd%%|-l|// | ||
- | |%%--httpd-port%%|-p|8080|TCP-Port des httpd| | + | |%%--httpd-port%%|-p|8081|TCP-Port des httpd| |
|%%--%%help|-h| |Kurzhilfe| | |%%--%%help|-h| |Kurzhilfe| | ||
|%%--%%verbose|-v// | |%%--%%verbose|-v// | ||
|%%--%%version|-V| |Version des vzlogger ausgeben| | |%%--%%version|-V| |Version des vzlogger ausgeben| | ||
+ | |||
+ | ===== Exit-Codes ===== | ||
+ | Da vzlogger als Hintergrunddienst konzipiert ist wird primär über das Logfile diagnostiziert. In Fällen bei denen dies nicht möglich ist werden Standard Exit-Codes ausgegeben.\\ | ||
+ | Z.B. bei Aufruf von '' | ||
+ | ^Code^Text^Bedeutung^ | ||
+ | |1|FAILURE|generischer Fehler, dieser tritt auch auf wenn die Konfiguration unlogisch ist und vzlogger ohne definierte Aufgaben (Beispielconfig im git) beendet wird| | ||
+ | |64|USAGE|Kommandozeilenargument war nicht ausführbar| | ||
+ | |71|OSERR|die Verschiebung in den Hintergrund (daemon) schlug fehl| | ||
+ | |73|CANTCREAT|vzlogger hat nicht die nötigen Rechte das Logfile an der konfigurierten Stelle zu schreiben| | ||
+ | |78|CONFIG|Syntaxfehler in der Konfiguration oder Datei nicht vorhanden| | ||
===== Links ===== | ===== Links ===== |
software/controller/vzlogger.1509494698.txt.gz · Zuletzt geändert: 2017/11/01 01:04 von jau