/vzlogger

Logging utility for various meters & sensors

Primary LanguageC++GNU General Public License v3.0GPL-3.0

vzlogger

  • is a part of the volkszaehler.org smart meter
  • is a tool to read and log measurements of a wide variety of smart meters and sensors to the volkszaehler.org middleware
  • can run as a daemon or via cron
  • includes a tiny onboard http daemon to serve realtime readings
  • is written in C++ and should run on most embedded devices which conform to the POSIX standard

Feel free to implement support your own hardware ;)

Installation

To install, follow the detailed installation instructions at http://wiki.volkszaehler.org/software/controller/vzlogger/installation_cpp-version

If you're impatient you can quickstart using (Debian Bullseye or Ubuntu 18.04 LTS):

sudo apt-get install build-essential git-core cmake pkg-config subversion libcurl3-dev \
  libgnutls-dev libsasl2-dev uuid-dev uuid-runtime libtool dh-autoreconf libunistring-dev

If you want to use MQTT support:

sudo apt-get install libmosquitto-dev

Then run the installation:

wget https://raw.github.com/volkszaehler/vzlogger/master/install.sh
sudo bash install.sh

Docker

You can also build a docker image:

 docker build -t vzlogger .

Note, that this will use the newest vzlogger from volkszaehler github (not your local clone). You can start it:

 docker run --restart=always -v /home/pi/projects/vzlogger-docker:/cfg \
 --device=/dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_D30A9U5N-if00-port0 \
 --name vzlogger -d vzlogger

where /home/pi/projects/vzlogger-docker is the path to the directory containing the vzlogger.conf file and /dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_D30A8U6N-if00-port0 is your device. You can pass several devices if you have them.

Debian and Raspberry Pi OS Packages

Hosted By: Cloudsmith

We now build Debian packages for amd64, armhf and arm64. Armel, which would be needed for Debian on RPi 1 hardware, is not supported.

Raspberry Pi OS packages for armhf are also part of our releases. Unfortunately Debian armhf packages do not run on Raspberry Pi 1 although the architecture has been named armhf in Raspbian. Using "Raspbian armhf" packages fixes that. For RPi 2 and above Debian packages run on Raspberry Pi OS.

Our packages are built with MQTT support. The package that is in Debian is built without OMS support while starting with 0.8.7 ours is.

The packages attached to the release are meant for Debian trixie. The full set of packages is provided through a repository graciously provided by Cloudsmith.

The setup of the repository is also explained by Cloudsmith. The easy way to do it is running

curl -1sLf \
  'https://dl.cloudsmith.io/public/volkszaehler/volkszaehler-org-project/setup.deb.sh' \
  | sudo -E bash

If you do it the easy way you should however be aware of the high amount of trust you put into cloudsmith not beeing compromised. As an alternative there is the manual way to achive the same result. That starts with adding a file to /etc/apt/sources.list.d/ containing

deb [signed-by=/usr/share/keyrings/volkszaehler-volkszaehler-org-project-archive-keyring.gpg] https://dl.cloudsmith.io/public/volkszaehler/volkszaehler-org-project/deb/debian bookworm main
deb-src [signed-by=/usr/share/keyrings/volkszaehler-volkszaehler-org-project-archive-keyring.gpg] https://dl.cloudsmith.io/public/volkszaehler/volkszaehler-org-project/deb/debian bookworm main

You need to replace bookworm with your distro and debian with raspbian in case you are using an RPi 1. You also need to retrieve our repository key as a trusted one.

curl -1sLf "https://dl.cloudsmith.io/public/volkszaehler/volkszaehler-org-project/gpg.21DBDAC56DF44DA1.key" | \
	gpg --dearmor > /usr/share/keyrings/volkszaehler-volkszaehler-org-project-archive-keyring.gpg

After that you can do the usual

apt update
apt install vzlogger

An official Debian vzlogger package is currently in unstable.

OMS Support

We have packaged libmbus and are building our package with OMS support since 0.8.7. Since we have no idea about usage and usability of our OMS support we wold appreciate a short note from anyone using it or trying to use it in our Future of OMS support issue.

Mailing List

If you have questions, contact the volkszaehler mailing lists:

More information is available in our wiki: http://wiki.volkszaehler.org/software/controller/vzlogger