software:controller:vzlogger:conf_parameter
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
software:controller:vzlogger:conf_parameter [2017/03/14 17:56] – angelegt jau | software:controller:vzlogger:conf_parameter [2017/12/14 23:03] (aktuell) – verschoben jau | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ======= vzlogger.conf ======= | + | ==== (verschobene seite) ==== |
- | Eine Beschreibung der Konfigurationsdatei von [[software: | + | #redirect |
- | + | ||
- | Formatiert ist sie nach [[https:// | + | |
- | Korrekte Kommata und Klammerung ist zwingend. Der [[http:// | + | |
- | Zeichenketten | + | |
- | + | ||
- | + | ||
- | ====== root ====== | + | |
- | Im Wurzelverzeichnis haben wir die allgemeinen Einstellungen. | + | |
- | < | + | |
- | { | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | </ | + | |
- | + | ||
- | === retry === | + | |
- | Wartezeit in Sekunden nach einer fehlgeschlagenen Anfrage. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0 | | + | |
- | + | ||
- | === deamon === | + | |
- | Verschiebt vzlogger als Dienst (deamon) in den Hintergrund. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | true | | + | |
- | + | ||
- | === verbosity === | + | |
- | Auführlichkeit des Fehlerlogs. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0 = Alarme | | + | |
- | ^ ::: | 1 = Fehler | | + | |
- | ^ ::: | 3 = Warnungen | | + | |
- | ^ ::: | 5 = Informationen | | + | |
- | ^ ::: | 10 = Diagnose | | + | |
- | ^ ::: | 15 = Dateilinformationen | | + | |
- | ^ Empfehlung | 15 zu Beginn | | + | |
- | ^ ::: | 0 wenn alles fehlerfrei läuft | | + | |
- | + | ||
- | === log === | + | |
- | Speicherort des Fehlerlogs. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | Muss eine vorhandenes Verzeichnis sein auf dem schreibender Zugriff erlaubt ist. | | + | |
- | ^ Empfehlung | "/ | + | |
- | ^ ::: | "/ | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ====== push ====== | + | |
- | Konfiguration des [[https:// | + | |
- | Damit ist es möglich Daten an die VZ-Middleware zu schicken die zwar dargestellt, | + | |
- | < | + | |
- | " | + | |
- | { | + | |
- | " | + | |
- | } | + | |
- | </ | + | |
- | + | ||
- | === push === | + | |
- | ^ Typ | Array | | + | |
- | ^ Empfehlung | [] - nicht aktiv | | + | |
- | + | ||
- | === url === | + | |
- | Zielort an dem die Daten in Empfang genommen werden. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | eine gültige URL | | + | |
- | ^ Empfehlung | http:// | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ====== local ====== | + | |
- | HTTP-Dienst (httpd) für Daten-[[https:// | + | |
- | Stellt die Daten der konfigurierten //meter// zu manuellen Kontrolle oder für andere Anwendungen bereit. Erspart einem z.B einen das Parsen des SML-Telegramms von einem eHz. | + | |
- | < | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | }, | + | |
- | </ | + | |
- | + | ||
- | === local === | + | |
- | ^ Typ | Gruppe | | + | |
- | + | ||
- | === enabled === | + | |
- | Aktiviert den httpd. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | false | | + | |
- | + | ||
- | === port === | + | |
- | Der [[https:// | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | ? | | + | |
- | ^ Empfehlung | 8080 | | + | |
- | + | ||
- | === index === | + | |
- | Normal sollte die Anfrage die UUID des gewünschten channel enthalten, wird der Index aktiviert werden alle //channel// dargestellt. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | false bei Systemen die von öffentlichen Netzwerken aus verfügbar sind | | + | |
- | + | ||
- | === timeout === | + | |
- | ? | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0 | | + | |
- | + | ||
- | === buffer === | + | |
- | ? | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0 | | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ====== meters ====== | + | |
- | Hier werden die Datenquellen (Zähler, Sensoren) definiert mit denen der vzlogger kommunizieren soll. Jede Quelle ist eine Gruppe von Schlüsseln, | + | |
- | Nicht alle Paramter sind in allen Konfigurationen erforderlich oder sinnvoll. Erst werden die Allgemeinen, | + | |
- | ^ Typ | Array | | + | |
- | + | ||
- | + | ||
- | ===== Allgemein ===== | + | |
- | < | + | |
- | " | + | |
- | { | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | </ | + | |
- | + | ||
- | === enabled === | + | |
- | Den betreffenden Meter (z.B. für Diagnosezwecke) an- oder abstellen. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | true | | + | |
- | + | ||
- | === allowskip === | + | |
- | Schlägt das öffnen des Meter fehl bricht vzlogger ab oder ignoriert ihn und setzt mit dem nächsten konfigurierten Meter fort. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | true - der Meter wird im Fehlerfall übersprungen | | + | |
- | + | ||
- | === aggtime === | + | |
- | Vzlogger kann Messwerte sammeln und zusammenfügen (aggregieren) bevor sie an die MW gesendet werden. Hier wird die Sammelzeit in Sekunden definiert. Es ist darauf zu achten das die aggtime nicht kürzer ist als // | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ ::: | -1 deaktiviert die Funktion sicher | | + | |
- | ^ Empfehlung | -1 | | + | |
- | + | ||
- | === aggfixedinterval === | + | |
- | Für eine optisch schönere Darstellung im Frontend ist es möglich alle aggregierten Kanäle dieses Meters mit identischem Timestamp an die Middleware zu senden. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | - | | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== channels ===== | + | |
- | So ziemlich die wichtigste Gruppe. Hier erfolgt die Zuordnung der von vzlogger gelesenen Daten zu den Kanälen der Middleware. Es sind mehrere // | + | |
- | < | + | |
- | < | + | |
- | " | + | |
- | { | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | } | + | |
- | </ | + | |
- | + | ||
- | === uuid === | + | |
- | Über die [[https:// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | z.B. " | + | |
- | + | ||
- | === identifier === | + | |
- | Über diesen String werden die Werte zu diesem //channel// aus den Daten des //meter// identifiziert. | + | |
- | Wie der String aussieht hängt vom // | + | |
- | ^ Typ | String | | + | |
- | + | ||
- | ^ // | + | |
- | | //s0// | " | + | |
- | | //s0// | " | + | |
- | | //d0// |z.B. " | + | |
- | | //sml// |z.B. " | + | |
- | | //random// | "" | + | |
- | | //file// | "" | + | |
- | | //exec// | "" | + | |
- | | // | + | |
- | | //ocr// | z.B. " | + | |
- | | //oms// | z.B. " | + | |
- | | //1-wire// | z.B. " | + | |
- | + | ||
- | + | ||
- | === api === | + | |
- | Hier wird die [[https:// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === middleware === | + | |
- | Die [[https:// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | z.B. " | + | |
- | ^ ::: | z.B. " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === secretKey === | + | |
- | Schlüssel für die Kommunikation mit der mySmartGrid-// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | ? | | + | |
- | ^ Empfehlung | "" | + | |
- | + | ||
- | === type === | + | |
- | Art des //meter//, nur für mySmartGid-// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | "" | + | |
- | + | ||
- | === scaler === | + | |
- | Faktor für die Werte, nur für mySmartGid-// | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | 0-? | | + | |
- | + | ||
- | === aggmode === | + | |
- | Mathematische Art der Aggregation die der vzlogger vornehmen soll. Nur wirksam in Verbindung mit //aggtime// größer als 0. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === duplicates === | + | |
- | Zeit in Sekunden in denen wiederholende, | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0, insbesondere bei // | + | |
- | + | ||
- | === protocol === | + | |
- | Das Protokoll mit dem der Meter sendet. Der [[http:// | + | |
- | ^ Typ | String || | + | |
- | ^ Wert | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | - || | + | |
- | + | ||
- | === device === | + | |
- | Das Linux-Device über den der Meter angebunden ist. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | "" | + | |
- | ^ ::: | "/ | + | |
- | ^ Empfehlung | "/ | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== protocol-spezifische Schlüssel ===== | + | |
- | Jedes // | + | |
- | + | ||
- | ==== s0 ==== | + | |
- | < | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | </ | + | |
- | + | ||
- | === gpio === | + | |
- | Bestimmt den GPIO am RaspberryPi an dem der Meter angeschlossen ist. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 4, 17, 18, 22, 23, 27, je nach verwendeter Erweiterung und Eingang. | | + | |
- | ^ Empfehlung | - | | + | |
- | + | ||
- | === mmap === | + | |
- | Für hochfrequente Impulssignale können die GPIO des RaspberryPi auf Memory-Mapping umgestellt werden. Die Ports müssen manuell als Eingänge konfiguriert werden. Nur für Impulssignale! | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | "" | + | |
- | ^ ::: | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | "" | + | |
- | + | ||
- | === gpio_dir === | + | |
- | Es kann zwischen steigender und fallender Flanke unterschieden werden. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0 fallende Flanke ? | | + | |
- | ^ ::: | 1 steigende Flanke ? | | + | |
- | ^ ::: | -1 deaktiviert die Funktion sicher | | + | |
- | ^ Empfehlung | -1 | | + | |
- | + | ||
- | === configureGPIO === | + | |
- | Vzlogger kann die E/ | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | true | | + | |
- | + | ||
- | === resolution === | + | |
- | Impulse/ | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 1-? | | + | |
- | ^ Empfehlung | Entsprechend den Angaben auf dem Zähler | | + | |
- | + | ||
- | === send_zero === | + | |
- | Wenn keine Impulssignale eintreffen wird der vzlogger auch keinen Datentupel an die MW senden. Ist send_zero aktiv wird jede Sekunde ein Tuple gesendet auch wen keine Impulse registriert wurden. In Verbindung mit //aggtime// kann der Zeitraum vergrößert werden. | + | |
- | ^ Typ | Bool | | + | |
- | ^ Wert | true/false | | + | |
- | ^ Empfehlung | false | | + | |
- | + | ||
- | === debounce_delay === | + | |
- | Bei mechanischen Impulsquellen (Reedkontakten) kann es zu Kontaktprellen kommen. Hier wird definiert wie viele Millisekunden nachfolgende Signalflanken ignoriert werden. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0 für elektronische Signalquellen. 30 oder mehr für mechanische. | | + | |
- | + | ||
- | === nonblocking_delay === | + | |
- | Zeitverzögerung in Nanosekunden bei aktiviertem //mmap//. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 10000, bei 5000 können auf einem RaspberryPi 2 Impulse mit bis zu 30kHz geloggt werden. | | + | |
- | + | ||
- | ---- | + | |
- | ==== d0 ==== | + | |
- | Manche Zähler senden ihre Daten unaufgeforder alle paar Sekunden (Push), andere müssen dazu aufgefordert werden (Pull). Ob es sich um einen Pull- oder Push-Meter handelt kann mit einer Digitalkamera an der IR-Diode geprüft werden. Vielleicht ist dein Zählertyp aber auch schon [[hardware: | + | |
- | < | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | </ | + | |
- | + | ||
- | === interval === | + | |
- | Verzögerung zwischen Zugriffen auf Pull-Meter in Sekunden. Es ist darauf zu achten das der Meter genug Zeit hat zu antworten, z.B. wenn er seriell mit nur 300bd sendet. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ ::: | -1 deaktiviert die Funktion sicher | | + | |
- | ^ Empfehlung | -1 bei Push-Meter | | + | |
- | ^ ::: | Nach Bedarf | | + | |
- | + | ||
- | === host === | + | |
- | Für Meter die nicht lokal sondern übers TCP/ | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | "" | + | |
- | ^ Empfehlung | "" | + | |
- | + | ||
- | === dump_file === | + | |
- | Das Datentelegramm kann zu Dignosezwecken zusätzlich in eine Datei ausgegeben werden. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | "" | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === pullseq === | + | |
- | Initialisierungssequenz für Pull-Meter. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | z.B. " | + | |
- | ^ Empfehlung | "" | + | |
- | ^ ::: | " | + | |
- | + | ||
- | === ackseq === | + | |
- | Nach der Initilisierungssequenz antwortet ein Pull-Meter mit einem Einzeiler, um das Datentelegramm zu erhalten ist eine Startsequenz nötig. Ev. wird dabei auch die Baudrate umgestellt. Ist aber stark vom Zähler abhängig. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ ::: | z.B. " | + | |
- | ^ ::: | z.B. " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === baudrate === | + | |
- | Die serielle Geschwindigkeit mit der der Meter kommuniziert. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | + | |
- | ^ Empfehlung | 300 | | + | |
- | + | ||
- | === baudrate_read === | + | |
- | Pull-Meter erlauben teilweise auch mehr als 300bd. Diese muss in der //ackseq// angefordert und hier dem vzlogger mitgeteilt werden. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | + | |
- | ^ Empfehlung | 300 geht eigentlich immer. Je nach Länge des Datentelegramms kann die zeitliche Auflösung aber zu wünschen übrig lassen weil // | + | |
- | + | ||
- | === parity === | + | |
- | [[hardware: | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === wait_sync === | + | |
- | Manche Zähler schicken kein Synchronisationssignal " | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ ::: | " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | === read_timeout === | + | |
- | Zeit in Sekunden nach denen der vzlogger die Kommunikation für beendet erachtet. Ist erforderlich falls der Zähler kein Synchronisationssignal sendet, die Startsequenz fehlt schlägt oder sonstwie Zeichen verloren gehen. Die Zeit darf aber nicht zu kurz sein sonst wird mitten im Datentelegramm abgebrochen. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 1-? | | + | |
- | ^ Empfehlung | 10 | | + | |
- | + | ||
- | === baudrate_change_delay === | + | |
- | Zeit in ms nach //ackseq// bevor die Baudrate auf // | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ Empfehlung | 0, da vor umstellen der Baudrate der UART sowieso geleert wird | | + | |
- | + | ||
- | ---- | + | |
- | ==== sml ==== | + | |
- | Manche Zähler senden ihre Daten unaufgeforder alle paar Sekunden (Push), andere müssen dazu aufgefordert werden (Pull). Ob es sich um einen Pull- oder Push-Meter handelt kann mit einer Digitalkamera an der IR-Diode geprüft werden. Vielleicht ist dein Zähler aber auch schon [[hardware: | + | |
- | < | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | </ | + | |
- | + | ||
- | === interval === | + | |
- | Verzögerung zwischen Zugriffen auf Pull-Meter in Sekunden. Es ist darauf zu achten das der Meter genug Zeit hat zu antworten, z.B. wenn er seriell mit nur 300bd sendet. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 0-? | | + | |
- | ^ ::: | -1 deaktiviert die Funktion sicher | | + | |
- | ^ Empfehlung | -1 bei Push-Meter | | + | |
- | ^ ::: | Nach Bedarf | | + | |
- | + | ||
- | === host === | + | |
- | Für Meter die nicht lokal sondern übers TCP/ | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | "" | + | |
- | ^ Empfehlung | "" | + | |
- | + | ||
- | === pullseq === | + | |
- | Initialisierungssequenz für Pull-Meter. | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | z.B. " | + | |
- | ^ Empfehlung | "" | + | |
- | ^ ::: | " | + | |
- | + | ||
- | === baudrate === | + | |
- | Die serielle Geschwindigkeit mit der der Meter kommuniziert. | + | |
- | ^ Typ | Integer | | + | |
- | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | + | |
- | ^ Empfehlung | 9600 | | + | |
- | + | ||
- | === parity === | + | |
- | [[hardware: | + | |
- | ^ Typ | String | | + | |
- | ^ Wert | " | + | |
- | ^ Empfehlung | " | + | |
- | + | ||
- | ---- | + | |
- | ==== random ==== | + | |
- | Zufallsgenerator | + | |
- | + | ||
- | ---- | + | |
- | ==== file ==== | + | |
- | Auswerten einer bestehenden Datei, wird mittels //format// weiter parametriert | + | |
- | + | ||
- | ---- | + | |
- | ==== exec ==== | + | |
- | Programmausgaben parsen | + | |
- | + | ||
- | ---- | + | |
- | ==== fluksov2 ==== | + | |
- | Protokoll der [[https:// | + | |
- | + | ||
- | ---- | + | |
- | ==== ocr ==== | + | |
- | Bilderkennung | + | |
- | + | ||
- | ---- | + | |
- | ==== oms ==== | + | |
- | Open Metering System, ein Ableger von M-Bus | + | |
- | + | ||
- | ---- | + | |
- | ==== w1therm ==== | + | |
- | Für 1-Wire-Temperatursensoren am Busmaster DS2482 sind keine weiteren Parameter nötig. | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== Schluss ===== | + | |
- | Und ganz wichtig: Klammern schließen! | + | |
- | < | + | |
- | } | + | |
- | ] | + | |
- | } | + | |
- | </ | + |
software/controller/vzlogger/conf_parameter.1489510606.txt.gz · Zuletzt geändert: 2017/03/14 17:56 von jau