DSMR Reader
The dsmr_reader sensor integration allows you to easily add all sensors that DSMR Reader (Dutch Smart Meter Requirements Reader) exposes to MQTT. It adds a separate sensor for every field in the MQTT topics which is named sensor_dsmr_<mqtt_topic>.
Prerequisites
To use this DSMR Reader sensor integration, you need to have a DSMR Reader instance running and an MQTT broker to send sensor data through.
- Add the MQTT broker integration in Home Assistant, if you haven’t done so already
- Configure the MQTT broker in the DSMR Reader application
- Enable the following data sources in the DSMR Reader administration pages with the default mappings:
- Day consumption: Split topic
- Gas consumption: Split topic
- Meter Statistics: Split topic
- Quarter-hour peak consumption: Split topic
- Telegram: Split topic
Configuration
Adding DSMR Reader to your Home Assistant instance can be done via the user interface, by using this My button:
DSMR Reader can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the sidebar, select Settings.
-
From the configuration menu, select Devices & Services.
-
In the bottom right, select the Add Integration button.
-
From the list, search and select DSMR Reader.
-
Follow the instructions on screen to complete the setup.
Configuring the Energy Dashboard
It is most advisable to not use the “total” and “daily” sources. The regular “reading” sensors provide the most stable source of data for Home Assistant to use. These MQTT values are part of the “Telegram: Split topic” MQTT values within DSMR Reader, so make sure to enable them.
| Section | Sensors to configure |
|---|---|
| Grid consumption | Low tariff usage, High tariff usage |
| Return to grid | Low tariff returned, High tariff returned |
| Gas consumption | Gas meter usage |
Difference with the DSMR integration
This integration relies on the presence of an existing DSMR Reader application setup. It processes the events triggered by the MQTT publishing feature to create sensor entities within Home Assistant. This integration uses the data published on the MQTT broker, no matter how or where the application is installed. By comparison, the DSMR integration connects directly to the smart meter within Home Assistant and doesn’t use the DSMR Reader application.