Copyright © 2018-2026 Erik Baauw. All rights reserved.
This repository provides a standalone installation of the command-line utilities from Homebridge P1:
| Tool | Description |
|---|---|
p1 |
Logger for data received from the smart meter. |
Each command-line tool takes a -h or --help argument to provide a brief overview of its functionality and command-line arguments.
This repository uses the end-consumer (P1) interface of the Dutch Smart Meter Requirements (DSMR) to connect to a smart meter.
The smart meter sends a push notification ("telegram" in DSMR speak), every second, updating the electricity consumption almost in real time. Older versions of DSMR might send notifications less frequently. Gas consumption is updated every 5 minutes.
You need a smart meter that provides a P1 port that complies to DSMR (currently DSMR 5.0, DSMR 4.2, and DSMR 2.2+ are tested).
The companies maintaining the electricity and natural gas networks in the Netherlands, united in Netbeer Nederland are replacing existing electricity and gas meters with smart meters.
In my home, they installed a Landys +Gyr E350 (ZCF1100).
Smart meters in Flandres (Belgium), Luxembourg, and Sweden might provide a P1 port as well.
I don't know about the rollout plans in those countries.
One Flandres installation is reported working, see #47; one Swedish installation is reported not working, see #50.
You need a cable to connect the smart meter's P1 port to a USB port.
I got mine here, but you could also make one yourself, as described here.
The cable is quite short (~1m) but you can extend it using a regular USB extension cable (female-A to A).
The cable provides a serial port device to the system.
Preferably, ser2net is used to expose serial port device over a network socket.
See the Wiki
for an example configuration.
Alternatively, this repository can use the serialport package to connect directly to the serial port device.
This package uses some non-JavasScript addons, that need to be compiled on installation.
The server running this repository needs to have the appropriate development tools installed.
The user running p1 needs privileges to list the serial port devices and to open the serial port device for the P1 cable.
Under Raspbian, user pi has these privileges by default.
If you run Homebridge under a different user, make sure it's member of the dialout group, and, for Buster, of the gpio group.