software:controller:vzlogger:vzlogger_conf_parameter
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Vorhergehende Überarbeitung | |||
— | software:controller:vzlogger:vzlogger_conf_parameter [2023/05/31 19:44] (aktuell) – [channels] narc-ontakac2 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ======= vzlogger.conf ======= | ||
+ | Eine Beschreibung der Konfigurationsdatei von [[software: | ||
+ | |||
+ | Formatiert ist sie nach [[https:// | ||
+ | Korrekte Kommata und Klammerung sind zwingend. Der [[http:// | ||
+ | Zeichenketten (String) müssen in Anführungszeichen gesetzt werden, Ganzzahlen (Integer) und Logische Ausdrücke (Bool) hingegen nicht. Gruppen **{}** und Schlüssel dürfen in root nur einmalig verwendet werden, in Arrays **[]** aber mehrmals.\\ | ||
+ | |||
+ | Bestimmte Schlüssel bekommen, wenn sie nicht explizit genannt werden, bei Bedarf einen Standardwert (Default) zugewiesen. | ||
+ | |||
+ | ====== root ====== | ||
+ | Im Wurzelverzeichnis haben wir die allgemeinen Einstellungen. | ||
+ | < | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | </ | ||
+ | |||
+ | === retry === | ||
+ | Wartezeit in Sekunden nach einer fehlgeschlagenen Anfrage. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Empfehlung | 0 | | ||
+ | |||
+ | === verbosity === | ||
+ | Ausführlichkeit des Fehlerlogs.\\ | ||
+ | In der höchsten Detailstufe werden auch alle verfügbaren [[/ | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0 = Alarme | | ||
+ | ^ ::: | 1 = Fehler | | ||
+ | ^ ::: | 3 = Warnungen | | ||
+ | ^ ::: | 5 = Informationen | | ||
+ | ^ ::: | 10 = Diagnose | | ||
+ | ^ ::: | 15 = Detailinformationen | | ||
+ | ^ 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 ====== | ||
+ | Empfangsort des VZ-[[https:// | ||
+ | Über den Dienst ist es zum Beispiel 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 | " | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ====== local ====== | ||
+ | HTTP-Dienst (httpd) für Daten-[[https:// | ||
+ | Stellt die Daten der konfigurierten '' | ||
+ | Es können alle Werte angezeigt werden für die ein '' | ||
+ | < | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | </ | ||
+ | |||
+ | === local === | ||
+ | ^ Typ | Gruppe | | ||
+ | |||
+ | === enabled === | ||
+ | Aktiviert den httpd. | ||
+ | ^ Typ | Bool | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Empfehlung | false | | ||
+ | |||
+ | === port === | ||
+ | Der [[https:// | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | ? | | ||
+ | ^ Empfehlung | 8081 | | ||
+ | |||
+ | === index === | ||
+ | Normal sollte die Anfrage auch die UUID des gewünschten '' | ||
+ | ^ 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 === | ||
+ | ? Größe des Ringspeichers ? | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Empfehlung | 0 | | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ====== mqtt ====== | ||
+ | Hier kann die Verbindung zum einem MQTT-Broker (Server) eingetragen werden. Die in '' | ||
+ | <note important> | ||
+ | |||
+ | < | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | === enabled === | ||
+ | MQTT an- oder abstellen. | ||
+ | ^ Typ | Bool | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | false | | ||
+ | ^ Empfehlung | true | | ||
+ | |||
+ | === host === | ||
+ | Server-Adresse des MQTT-Brokers. | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | eine gültige URL | | ||
+ | ^ Standard | test.mosquitto.org | | ||
+ | |||
+ | === port === | ||
+ | Port des MQTT-Brokers. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 1883 (unverschlüsselt), | ||
+ | ^ Standard | 1883 | | ||
+ | |||
+ | === cafile === | ||
+ | Optionaler Dateiname der Server CA | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Dateiname | | ||
+ | ^ Standard | | | ||
+ | |||
+ | === capath === | ||
+ | Optionaler Pfad für Server CAs | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Pfad | | ||
+ | ^ Standard | | | ||
+ | |||
+ | <note important> | ||
+ | |||
+ | === certfile === | ||
+ | Optionaler Dateiname des Client-Zertifikats (z.B. '' | ||
+ | |||
+ | === keyfile === | ||
+ | Optionaler Pfad zum privaten Schlüssel des Client-Zertifikats (z.B. '' | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Dateiname | | ||
+ | ^ Standard | | | ||
+ | |||
+ | === keypass === | ||
+ | Optionales Passwort des privaten Schlüssels | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Passwort | | ||
+ | ^ Standard | | | ||
+ | |||
+ | === keepalive === | ||
+ | Optionales Angabe der Sekunden zur Aufrechterhaltung der Verbindung (Keepalive) | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Standard | 30 | | ||
+ | |||
+ | === topic === | ||
+ | Optionale Angabe des MQTT-Topics, | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | MQTT-Topic | | ||
+ | ^ Standard | vzlogger/ | ||
+ | |||
+ | <note important> | ||
+ | |||
+ | === id === | ||
+ | Optionale statische Client-ID. Bei Nichtangabe wird eine Client-ID nach dem Muster '' | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Client-ID | | ||
+ | ^ Standard | vzlogger_< | ||
+ | |||
+ | === user === | ||
+ | Optionaler Benutzername zur Anmeldung an den MQTT-Broker. | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Benutzername | | ||
+ | ^ Standard | | | ||
+ | |||
+ | === password === | ||
+ | Optionales Password zur Anmeldung an den MQTT-Broker. | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | Passwort | | ||
+ | ^ Standard | | | ||
+ | |||
+ | === retain === | ||
+ | Optionale Anweisung zum Zwischenspeichern der MQTT-Nachricht, | ||
+ | ^ Typ | Boolean | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | false | | ||
+ | |||
+ | === rawAndAgg === | ||
+ | Optionale Veröffentlichung der Rohdaten selbst wenn der Zusammenfassungs-Modus ('' | ||
+ | ^ Typ | Boolean | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | false | | ||
+ | |||
+ | === qos === | ||
+ | Optionale Angabe des Quality of Service. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0/1 | | ||
+ | ^ Standard | 0 | | ||
+ | |||
+ | === timestamp === | ||
+ | Optionale Angabe, ob ein Zeitstempel im Payload mit angegeben werden soll. | ||
+ | ^ Typ | Boolean | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | false | | ||
+ | |||
+ | ====== 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 | | ||
+ | ^ Standard | 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 | | ||
+ | ^ Standard | 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, dass die aggtime nicht kürzer ist als '' | ||
+ | '' | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ ::: | -1 deaktiviert die Funktion sicher (Bitte auch '' | ||
+ | ^ Standard | -1 | | ||
+ | ^ 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 | | ||
+ | ^ Standard | false | | ||
+ | ^ Empfehlung | - | | ||
+ | |||
+ | === 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 | "/ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== 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 '' | ||
+ | Wie der String aussieht hängt vom '' | ||
+ | ^ Typ | String | | ||
+ | |||
+ | ^ '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | |||
+ | |||
+ | === api === | ||
+ | Hier wird die [[https:// | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | " | ||
+ | ^ ::: | " | ||
+ | ^ ::: | " | ||
+ | ^ ::: | " | ||
+ | ^ Standard| " | ||
+ | ^ Empfehlung | " | ||
+ | Achtung: Der Wert ist ggfs. " | ||
+ | |||
+ | === middleware === | ||
+ | Die [[https:// | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | z.B. " | ||
+ | ^ ::: | z.B. " | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === host === | ||
+ | Die [[https:// | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | z.B. " | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | < | ||
+ | |||
+ | === secretKey === | ||
+ | Schlüssel für die Kommunikation mit der mySmartGrid-'' | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | ? | | ||
+ | ^ Empfehlung | "" | ||
+ | |||
+ | === type === | ||
+ | Art des '' | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | " | ||
+ | ^ ::: | " | ||
+ | ^ Empfehlung | "" | ||
+ | |||
+ | === scaler === | ||
+ | Faktor für die Werte, nur für mySmartGid-'' | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | |||
+ | === timeout === | ||
+ | Zeit in Sekunden für die Zustellung per Curl nach der die Verbindung als misslungen betrachtet wird. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Standard | 30 | | ||
+ | |||
+ | === aggmode === | ||
+ | Mathematische Art der Aggregation die der vzlogger vornehmen soll. Nur wirksam in Verbindung mit '' | ||
+ | Wenn '' | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | " | ||
+ | ^ ::: | " | ||
+ | ^ ::: | " | ||
+ | ^ ::: | " | ||
+ | ^ Standard | " | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === duplicates === | ||
+ | Zeit in Sekunden in denen wiederholende, | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Empfehlung | 0, insbesondere bei '' | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== 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 die Zählrichtung umgekehrt werden. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0 Zählung positiv | | ||
+ | ^ ::: | 1 Zählung negativ | | ||
+ | ^ ::: | -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-? | | ||
+ | ^ Standard | 1000 | | ||
+ | ^ Empfehlung | Entsprechend der Angabe 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 '' | ||
+ | ^ Typ | Bool | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | 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-? | | ||
+ | ^ Standard | 30 | | ||
+ | ^ Empfehlung | 0 für elektronische Signalquellen. 30 oder mehr für mechanische. | | ||
+ | |||
+ | === nonblocking_delay === | ||
+ | Zeitverzögerung in Nanosekunden bei aktiviertem '' | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Standard | 10000 | | ||
+ | ^ 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 | | ||
+ | ^ Standard | -1 | | ||
+ | ^ 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 Diagnosezwecken zusätzlich in eine Datei ausgegeben werden. | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | "" | ||
+ | ^ Standard | "" | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === pullseq === | ||
+ | Initialisierungssequenz für Pull-Meter. | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | z.B. " | ||
+ | ^ Standard | "" | ||
+ | ^ 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. " | ||
+ | ^ Standard | "" | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === baudrate === | ||
+ | Die serielle Geschwindigkeit mit der der Meter kommuniziert. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | ||
+ | ^ Standard | 9600 | | ||
+ | ^ Empfehlung | 300 | | ||
+ | |||
+ | === baudrate_read === | ||
+ | Pull-Meter erlauben teilweise auch mehr als 300bd. Diese muss in der '' | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | ||
+ | ^ Standard | wie unter '' | ||
+ | ^ 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 | " | ||
+ | ^ Standard | " | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === wait_sync === | ||
+ | Manche Zähler schicken kein Synchronisationssignal " | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | " | ||
+ | ^ ::: | " | ||
+ | ^ Standard | " | ||
+ | ^ 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-? | | ||
+ | ^ Standard | 10 | | ||
+ | ^ Empfehlung | 10 | | ||
+ | |||
+ | === baudrate_change_delay === | ||
+ | Zeit in ms nach '' | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 0-? | | ||
+ | ^ Standard | 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 | | ||
+ | ^ Standard | -1 | | ||
+ | ^ 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. " | ||
+ | ^ Standard | "" | ||
+ | ^ Empfehlung | "" | ||
+ | ^ ::: | " | ||
+ | |||
+ | === baudrate === | ||
+ | Die serielle Geschwindigkeit mit der der Meter kommuniziert. | ||
+ | ^ Typ | Integer | | ||
+ | ^ Wert | 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, u.A. | | ||
+ | ^ Standard | 9600 | | ||
+ | ^ Empfehlung | 9600 | | ||
+ | |||
+ | === parity === | ||
+ | [[hardware: | ||
+ | ^ Typ | String | | ||
+ | ^ Wert | " | ||
+ | ^ Standard | " | ||
+ | ^ Empfehlung | " | ||
+ | |||
+ | === use_local_time === | ||
+ | Nutzt zur Erstellung des Timestamp die aktuelle Uhrzeit des Rechners (" | ||
+ | Die meisten Zähler liefern im Datenstrom die Echtzeit mit. Wenn diese bei der Inbetriebnahme korrekt eingestellt wurde, verwenden wir sie um z.B. mögliche Zeitverschiebungen durch FiFo-Puffer auszuschließen. Sind die Timestamp falsch oder fehlen sogar ganz muss der vzlogger die lokale Rechnerzeit heranziehen. | ||
+ | ^ Typ | Bool | | ||
+ | ^ Wert | true/false | | ||
+ | ^ Standard | false | | ||
+ | ^ Empfehlung | false | | ||
+ | ---- | ||
+ | ==== random ==== | ||
+ | Zufallsgenerator | ||
+ | |||
+ | ---- | ||
+ | ==== file ==== | ||
+ | Auswerten einer bestehenden Datei, wird mittels '' | ||
+ | |||
+ | ---- | ||
+ | ==== exec ==== | ||
+ | |||
+ | In einem exec-Kanal wird für jede Abfrage das im Parameter '' | ||
+ | |||
+ | * exec-Kanäle sind nicht möglich, wenn der vzlogger als '' | ||
+ | * 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; | ||
+ | |||
+ | ^ Typ | string | | ||
+ | ^ Wert | Shell-Kommando | | ||
+ | ^ Beispiel | Siehe Wikiseiten zum [[hardware: | ||
+ | |||
+ | === format === | ||
+ | |||
+ | Jede Zeile der Ausgabe des '' | ||
+ | |||
+ | ^ Typ | string | | ||
+ | ^ Wert | Formatstring | | ||
+ | ^ Beispiel | '$t: $i = $v' für Ausgaben wie ' | ||
+ | |||
+ | * $t: timestamp (in Sekunden) | ||
+ | * $i: identifier (beliebiger String, taucht im Channel unter '' | ||
+ | * $v: value | ||
+ | |||
+ | Werte ohne identifier-Angabe landen beim Channel mit '" | ||
+ | |||
+ | Weitere Dokumentation könnte man in den Mailinglistenarchiven, | ||
+ | |||
+ | ---- | ||
+ | ==== 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/vzlogger_conf_parameter.1559666676.txt.gz · Zuletzt geändert: 2019/06/04 18:44 (Externe Bearbeitung)