Integration of smart meter for electricity into Home Assistant. Component to integrate with a Austrian smart meter using its wired M-BUS interface. EVN, SALZBURGNETZ and TINETZ are supported.
This component will set up the following platform.
| Platform | Description |
|---|---|
sensor |
Show information from the Smartmeter Austria smart meter. |
- If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledsmartmeter_austria. - Download all the files from the
custom_components/smartmeter_austria/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Smart Meter Austria"
- Select the COM port of your M-BUS to USB converter: eg. /dev/ttyUSB0
- You can configure the default poll interval (30s) using the configuration link of the integration. It can be set between 10 and 3600 seconds.
If you want to contribute to this please read the Contribution guidelines
You should use Visual Studio Code to develop in a container. In this container you
will have all the tools to ease your python development and a dedicated Home
Assistant core instance to run your integration. See .devcontainer/README.md for more information.
Run the appropriate requirement task to install the requirements for development or test.
This integration is under construction. Some functions are missing yet.
The smart meter uses DLMS/COSEM and the OBIS naming model in its protocol. DLMS OBIS codes
Following OBIS codes are provided:
| OBIS-Code | Attribute | German description | Unit |
|---|---|---|---|
| 0-0:1.0.0.255,1 | Clock Attribute 1 | ||
| 0-0:1.0.0.255,2 | Clock attribute 2 | ||
| 0-0:96.1.0.255 | Device number | Zählernummer | |
| 0-0:42.0.0.255 | COSEM logical device name | logische Zählernummer (COSEM) | |
| 1-0:32.7.0.255 | Voltage L1 | Spannung L1 | V |
| 1-0:52.7.0.255 | Voltage L2 | Spannung L2 | V* |
| 1-0:72.7.0.255 | Voltage L3 | Spannung L3 | V* |
| 1-0:31.7.0.255 | Current L1 | Strom L1 | A |
| 1-0:51.7.0.255 | Current L2 | Strom L2 | A* |
| 1-0:71.7.0.255 | Current L3 | Strom L3 | A* |
| 1-0:1.7.0.255 | Effective Power consumed +P | Wirkleistung Bezug +P | W |
| 1-0:2.7.0.255 | Effective Power retured -P | Wirkleistung Lieferung -P | W |
| 1-0:1.8.0.255 | Active Energy consumed +A | Wirkenergie Bezug +A | Wh |
| 1-0:2.8.0.255 | Active Energy retured -A | Wirkendergie Lieferung -A | Wh |
| 1-0:3.8.0.255 | Reactive energy consumed +R | Blindenergie Bezug +R | varh |
| 1-0:4.8.0.255 | Reactive energy returned -R | Blindenergie Lieferung -R | varh |
- Values are available only on three-phase meters
SALZBURGNETZ Kundenschnittstelle
The integration is done using the poll method. Perhaps it would be better to switch to push but I didn't want to float Home Assistant by its values (every 5 s).
Special thanks to Stefan (@tirolerstefan) who did an excellent work to read out the Kaifa MA300 smart meters used by TINETZ and EVN. I've used some parts of his code (mainly decrypt) as starting point here. tirolerstefan/kaifa repository