DSMR Smart Meter MQTT Client

Lightweight containerized Dutch Smart Meter (Slimme Meter) to MQTT daemon, with automatic Home Assistant integration.

Uses paho-mqtt and ndokter/dsmr_parser to do the heavy lifting.

Is this you?

You've been running Home Assistant on a Raspberry Pi in the meterkast for a while. You've hooked it up directly to your Smart Meter's P1 port with a USB cable, and you're happily using the built-in DSMR Slimme Meter integration.

But now you want to move Home Assistant to a server in the attic, without physical access to your Smart Meter. You want to keep using your Raspberry Pi to read the Smart Meter, and want to use the MQTT protocol to send the data upstairs. You want a turn-key, easy to configure, well-engineered application for the job.

In that case mqtt4dsmr is right for you!

Usage

Trying it out

The example uses podman since I'm more familiar with it than docker, but they should be relatively interchangeable.

When using rootless containers, make sure your user has the right group membership to access serial ports (this is why the --group-add option is there). On Fedora Linux this group is called dialout.

podman run -d                                             \
    --name mqtt4dsmr                                      \
    --group-add keep-groups                               \
    --tz=local                                            \
    --env MQTT_HOST=mqtt.home.example.org                 \
    --env MQTT_PORT=1883                                  \
    --env MQTT_USERNAME=my_user                           \
    --env MQTT_PASSWORD=my_password                       \
    --device /dev/serial/by-id/usb-MY_DEVICE:/dev/ttyDSMR \
    ghcr.io/antonijn/mqtt4dsmr

Automated execution (docker-compose)

If you have little experience with containers and/or are running on Raspberry Pi OS, this is the recommended method.

Example compose.yaml:

version: "3"

services:
  mqtt4dsmr:
    image: "ghcr.io/antonijn/mqtt4dsmr:latest"
    environment:
      MQTT_HOST: "mqtt.home.example.org"
      MQTT_PORT: "1883"
      MQTT_USERNAME: "my_user"
      MQTT_PASSWORD: "my_password"
    devices:
      - "/dev/serial/by-id/usb-MY_DEVICE:/dev/ttyDSMR"
    restart: always

Use additional environment variables as required, per the documentation below.

Run docker compose up -d to start the application. There are multiple ways to enable docker compose at system start-up. One method is to place the above configuration in /etc/docker/compose/mqtt4dsmr/docker-compose.yml, and follow this guide. Running systemctl enable --now docker-compose@mqtt4dsmr should then do the trick.

Automated execution (Quadlet)

Put the following in ~/.config/containers/systemd/mqtt4dsmr.container:

[Unit]
Description=De Slimme Meter MQTT Client
After=network-online.target

[Container]
ContainerName=mqtt4dsmr
Image=ghcr.io/antonijn/mqtt4dsmr:latest
Annotation=run.oci.keep_original_groups=1
Environment=MQTT_HOST=mqtt.home.example.org
Environment=MQTT_PORT=1883
Environment=MQTT_USERNAME=my_user
Environment=MQTT_PASSWORD=my_password
AddDevice=/dev/serial/by-id/usb-MY_DEVICE:/dev/ttyDSMR
Timezone=local

[Service]
Restart=always

[Install]
WantedBy=default.target

Use additional environment variables as required, per the documentation below.

Enable the container using systemctl --user start mqtt4dsmr. To automatically start the daemon at system start-up while using rootless containers, enable lingering for your user: loginctl enable-linger <my-user>.

Options

Options must be given to the container as environment variables.

Hardware support

Automated builds are available for AMD64, ARM64 and ARMv7. This means mqtt4dsmr should run on any x86-based personal computer, all second generation (or newer) Raspberry Pis and all second generation (or newer) Raspberry Pi Zeros.

First generation Raspberry Pis are not supported at the moment, since ARMv6 builds are currently not possible. This is because recent versions of the cryptography package (required by dlms-cosem, in turn required by dsmr-parser) are broken on ARMv6.