From fb481cd2f0fd97e906daf1e1af3ea3b94c9677a5 Mon Sep 17 00:00:00 2001 From: Gerard Date: Mon, 5 Oct 2020 09:56:18 +0200 Subject: [PATCH] Update DSMR Reader documentation (#14912) Add some additional information and steps how to setup up the MQTT topics. --- source/_integrations/dsmr_reader.markdown | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/source/_integrations/dsmr_reader.markdown b/source/_integrations/dsmr_reader.markdown index e27100c403d..f249a103673 100644 --- a/source/_integrations/dsmr_reader.markdown +++ b/source/_integrations/dsmr_reader.markdown @@ -3,6 +3,7 @@ title: DSMR Reader description: Instructions on how to integrate DSMR Reader. ha_category: - Energy + - Sensor ha_iot_class: Cloud Polling ha_release: 0.103 ha_codeowners: @@ -10,15 +11,25 @@ ha_codeowners: ha_domain: dsmr_reader --- -The `dsmr_reader` sensor platform allows you to easily add all sensors that [DSMR Reader](https://dsmr-reader.readthedocs.io/en/latest/) exposes to MQTT. It adds a separate sensor for every field in the MQTT topics. +The `dsmr_reader` sensor integration allows you to easily add all sensors that [DSMR Reader](https://dsmr-reader.readthedocs.io/en/latest/) (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_`. + +## Prerequisites + +- DSMR Reader +- MQTT broker ## Setup -To use this component, you will need DSMR Reader to be set up to publish to the MQTT server, that Home Assistant also uses. It is important that you setup DSMR Reader to publish to MQTT using "Split Topic" and that you use the default mappings. +1. Configure the MQTT broker in DSMR Reader which Home Assistant also connects to +2. Enable the following data sources in DSMR Reader with the default mapping: + - Day consumption: Split topic + - Gas consumption: Split topic + - Meter Statistics: Split topic + - Telegram: Split topic ## Configuration -To use this sensor in your installation, add the following to your `configuration.yaml` file: +To use this integration in your installation, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry