This python program connects your Smart Meter from Netz Burgenland to Home Assistant via MQTT. It has been developed for the Landis+Gyr E450 Smartmeter. It has been tested with a Raspberry Pi Zero 2 W as a standalone device and with a Raspberry Pi 4 as Home Assistant Addon.
The addon uses Mosquitto MQTT server to manage the connection from the addon to HomeAssistant. You need to install the addon first.
To use this program on the homeassistant raspberry pi as addon follow this steps:
- Request the activation of the customer interface and select IR as transport.
- Connect the IR reader to the smart meter
- Connect the IR reader to your raspberry pi
- Open homeassistant web ui and go to Settings -> Add-ons -> Add-on Store
- Install and start
Mosquitto brokerto setup the MQTT server. - Go to Settings > Devices > Integrations and add the Mosquitto MQTT integration
- Go back to the Addon store
- Click on the 3 dots on the top right and click on Repositories
- Add
https://github.com/r00tat/smartmeter_homeassistant_burgenlandas a repository. - Reload the page
- Install the Smartmeter Burgenland MQTT Addon
- Configure the smartmeter connection. As hostname use the homeassistant address. As username / password use a normal home assistant user or configure credentials in the Mosquitto broker.
- start the addon
To use this program on an external raspberry pi follow this steps:
- Request the activation of the customer interface and select IR as transport.
- Connect the IR reader to the smart meter
- Connect the IR reader to your raspberry pi
- Clone the repo with
git clone https://github.com/r00tat/smartmeter_homeassistant_burgenland.git smartmeter - Setup your config in
config.yaml - Install the service with
sudo ln -s "$(pwd)/smartmeter.service" /etc/systemd/system/smartmeter.service && sudo systemctl enable smartmeter && sudo systemctl start smartmeter
This are the commands to get started:
git clone https://github.com/r00tat/smartmeter_homeassistant_burgenland.git smartmeter
cd smartmeter
cp config-template.yaml config.yaml
# now edit the config
sudo ln -s "$(pwd)/smartmeter.service" /etc/systemd/system/smartmeter.service && sudo systemctl enable smartmeter && sudo systemctl start smartmeterTo view the status of the service you can use sudo systemctl status smartmeter and to restart it sudo systemctl restart smartmeter
To follow the output of the program you can use tail -f /var/log/daemon.log.
Initialize virtual environment:
python3 -m venv .
source bin/activate
pip3 install -r requirements.txtIf you install additional pacakges, save the current installed dependencies to requirements.txt with:
pip freeze -l | grep -v flake8 > requirements.txt
Building a version and pushing to docker hub:
ARCH=$(uname -m)
if [[ "$ARCH" =~ "armv7.*" ]]; then
ARCH="armv7"
elif [[ "$ARCH" == "x86_64" ]]; then
ARCH="amd64"
fi
VERSION=$(yq -r '.version' config.yaml)
docker build -t paulwoelfel/smartmeter_homeassistant_burgenland_${ARCH}:$VERSION --build-arg BUILD_FROM=homeassistant/${ARCH}-base-python:latest .
docker tag paulwoelfel/smartmeter_homeassistant_burgenland_${ARCH}:$VERSION paulwoelfel/smartmeter_homeassistant_burgenland_${ARCH}:latest
docker push paulwoelfel/smartmeter_homeassistant_burgenland_${ARCH}:$VERSION
docker push paulwoelfel/smartmeter_homeassistant_burgenland_${ARCH}:latest
The programm has been tested with the Landis+Gyr E450 Smart Meter, but not with the wired connection, but with the IR interface. If you order the customer interface, you can select the optical interface as the desired option.
Source: Spezifikation Kundenschnittstelle L+G E450
Die Datenausgabe und das Zeitintervall sind durch den Netzbetreiber festgelegt. Entsprechend der vorliegenden Konfiguration des Zählers werden die nachstehen Daten in einem periodischen Zeitintervall von 5sek ausgegeben:
- Zeitstempel
- Momentanspannung L1
- Momentanspannung L2
- Momentanspannung L3
- Momentanstrom L1
- Momentanstrom L2
- Momentanstrom L3
- Wirkleistung +P
- Wirkleistung –P
- Wirkenergietotal +A
- Wirkenergietotal –A
- Zähleridentifikationsnummern des Netzbetreibers Verschlüsselung und Authentifizierung Die Datenausgabe wird mit individuellen kundenbezogenen Schlüsseln verschlüsselt und authentisiert. Zur Anwendung kommt dabei die dlms/COSEM Security Suite 0, die entsprechend dem Datenmodel durch die IEC 62056 Normenreihe spezifiziert ist.
The KAIFA interface defines how the IR interface transmission is defined. The format of the message is different in KAIFA dann in Landis+Gyr.
Source: Optische Schnittstelle
Als Kundenschnittstelle wird die optische Schnittstelle des Zählers verwendet. Es wird alle 15 Sekunden eine Nachricht dieser optischen Schnittstelle ausgegeben. Der Aufbau sowie der Inhalt der Nachricht wird in den nachfolgenden Kapiteln beschrieben. Die Implementierung erfolgt gemäß IDIS CII.
Die Ausgabe der Push-Nachrichten erfolgt auf der optischen Schnittstelle, welche nach DIN EN 62056-21 ausgeführt ist.
Jede Push-Nachricht enthält die unten angeführten Daten (in dieser Reihenfolge). Das Push-Intervall beträgt 15 Sekunden. Es werden immer die aktuellsten Daten ausgegeben.
Attention: this format is not for Ladis+Gyr, but for KAIFA
- Datum/Uhrzeit,
- Logical Device Number,
- +A: Wirkenergie Bezug,
- –A: Wirkenergie Lieferung,
- +P: momentane Wirkleistung Bezug,
- –P: momentane Wirkleistung Lieferung,
- +R Blindleistung Bezug,
- –R Blindleistung Lieferung
Jede Push-Nachricht ist mit einem individuellen Schlüssel verschlüsselt. Der Schlüssel kann aus der Ferne geändert werden. Die Verschlüsselung basiert auf DLMS/COSEM Security Suite 0 nach HLS5.
Port Einstellungen Mit einem beliebigen seriellen Terminal Programm, kann der Datenstrom der PushNachrichten aufgezeichnet werden. Nachfolgend sind die Einstellungen angeführt, mit denen sich die Daten auslesen lassen.
- COM-Port: je nach lokaler Einstellung
- Baud Rate: 9600
- Parity: None
- Data Bits: 8 Bits
- Stop Bits: 1
- Hardware Flow Control: None
- Anzeige der Daten im hexadezimalen Format