- 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 ;)
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
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.
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.
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.
If you have questions, contact the volkszaehler mailing lists:
- Users mailing list: https://demo.volkszaehler.org/mailman/listinfo/volkszaehler-users
- Developers mailing list: https://demo.volkszaehler.org/mailman/listinfo/volkszaehler-dev
More information is available in our wiki: http://wiki.volkszaehler.org/software/controller/vzlogger