From d3e782e304e6308eb7d1c8462c57135999ba12c0 Mon Sep 17 00:00:00 2001 From: Tom Puttemans Date: Mon, 26 Sep 2022 18:56:26 +0200 Subject: [PATCH] Update dsmr_reader config flow and autodiscovery (#23939) Co-authored-by: Franck Nijhof --- source/_includes/integrations/config_flow.md | 4 ++-- source/_integrations/dsmr_reader.markdown | 23 +++++++++----------- 2 files changed, 12 insertions(+), 15 deletions(-) diff --git a/source/_includes/integrations/config_flow.md b/source/_includes/integrations/config_flow.md index 7b44475ace4..3d0c39967a5 100644 --- a/source/_includes/integrations/config_flow.md +++ b/source/_includes/integrations/config_flow.md @@ -8,14 +8,14 @@ interface, by using this My button: {% my config_flow_start badge domain=domain %} -{% if include.discovery or page.ha_dhcp or page.ha_homekit or page.ha_ssdp or page.ha_zeroconf %} +{% if include.discovery or page.ha_dhcp or page.ha_homekit or page.ha_ssdp or page.ha_zeroconf or page.ha_mqtt %} {{ name }} can be auto-discovered by Home Assistant. If an instance was found, it will be shown as _"Discovered"_, which you can select to set it up right away. {% endif %} {% details "Manual configuration steps" %} -{% if include.discovery or page.ha_dhcp or page.ha_homekit or page.ha_ssdp or page.ha_zeroconf %} +{% if include.discovery or page.ha_dhcp or page.ha_homekit or page.ha_ssdp or page.ha_zeroconf or page.ha_mqtt %} If there wasn't any discovered automatically, don't worry! You can set up a manual integration entry: {% else %} diff --git a/source/_integrations/dsmr_reader.markdown b/source/_integrations/dsmr_reader.markdown index 4fb0e38d954..15a200173ec 100644 --- a/source/_integrations/dsmr_reader.markdown +++ b/source/_integrations/dsmr_reader.markdown @@ -5,9 +5,12 @@ ha_category: - Energy - Sensor ha_iot_class: Local Push +ha_config_flow: true +ha_mqtt: true ha_release: 0.103 ha_codeowners: - '@depl0y' + - '@glodenox' ha_domain: dsmr_reader ha_platforms: - sensor @@ -18,24 +21,18 @@ The `dsmr_reader` sensor integration allows you to easily add all sensors that [ ## Prerequisites -- DSMR Reader -- MQTT broker +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. -## Setup - -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: +1. Add the MQTT broker integration in Home Assistant, if you haven't done so already +2. Configure the MQTT broker in the DSMR Reader application +3. 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 - Telegram: Split topic -## Configuration +{% include integrations/config_flow.md %} -To use this integration in your installation, add the following to your `configuration.yaml` file: +## Difference with the DSMR integration -```yaml -# Example configuration.yaml entry -sensor: - - platform: dsmr_reader -``` +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](/integrations/dsmr/) integration adds a full instance of the DSMR Reader application within Home Assistant. It is possible to have both integrations installed at the same time and working together, but this is not required.