From 649185fca0db32408cb6c9fc768f4adfc3cf0b48 Mon Sep 17 00:00:00 2001 From: bouni Date: Fri, 5 Oct 2018 16:58:40 +0200 Subject: [PATCH 1/4] Update Swiss Hydrological Data documentation --- .../sensor.swiss_hydrological_data.markdown | 60 +++++++++++++------ 1 file changed, 42 insertions(+), 18 deletions(-) diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index c6110b8f7c57..6b175014bc7d 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -2,7 +2,7 @@ layout: page title: "Swiss Hydrological Data" description: "Instructions on how to integrate hydrological data of Swiss waters within Home Assistant." -date: 2016-06-17 17:00 +date: 2018-10-05 12:00 sidebar: true comments: false sharing: true @@ -13,15 +13,15 @@ ha_iot_class: "Cloud Polling" ha_release: 0.22 --- -

- This sensor doesn't work at the moment due to changed by the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) to access the data. +

+ The sensors don't show the latest measurement, but those one hour older due to the source of data.

The `swiss_hydrological_data` sensor will show you details (temperature, level, and discharge) of rivers and lakes in Switzerland. ## {% linkable_title Setup %} -The [station overview](http://www.hydrodaten.admin.ch/en/danger-levels-table.html) contains a list of all available measuring points and will help to determine the ID of station which is needed for the configuration. +The [station overview](https://www.hydrodaten.admin.ch/en/stations-and-data.html) contains a list of all available measuring points and will help to determine the ID of station which is needed for the configuration. ## {% linkable_title Configuration %} @@ -32,6 +32,8 @@ To enable this sensor, add the following lines to your `configuration.yaml` file sensor: - platform: swiss_hydrological_data station: STATION_ID + measurements: + - temperature ``` {% configuration %} @@ -44,24 +46,46 @@ name: required: false type: string default: +measurements: + description: list of measurements you want to use. + required: true + type: list + deafult: {% endconfiguration %} -The hydrological measurings are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated almost in real-time. +Valid measurement values are: -## {% linkable_title Example %} +- temperature + - The last temperature measurement +- level + - The last water level measurement +- discharge + - The last discharge measurement +- min_temperature + - The minimum temperature measurement of the last 24 hours +- min_level + - The minimum water level measurement of the last 24 hours +- min_discharge + - The minimum discharge measurement of the last 24 hours +- max_temperature + - The maximum temperature measurement of the last 24 hours +- max_level + - The maximum water level measurement of the last 24 hours +- max_discharge + - The maximum discharge measurement of the last 24 hours +- mean_temperature + - The mean temperature measurement of the last 24 hours +- mean_level + - The mean water level measurement of the last 24 hours +- mean_discharge + - The mean discharge measurement of the last 24 hours -This sensor contains additional information which an easily accessed by a [template sensor](/components/sensor.template/). +

+ Some stations don't provide data for certain measurements. +

+ + +The hydrological measurings are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated every 10 minutes. -{% raw %} -```yaml -# Example configuration.yaml entry -sensor: - platform: template - sensors: - discharge: - value_template: '{{ states.sensor.aare.attributes.Discharge }}' - friendly_name: 'Discharge' -``` -{% endraw %} From 640aba59819d7aaf149bc6aee05f0dcb30104f1c Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 11 Nov 2018 17:09:56 +0100 Subject: [PATCH 2/4] Update --- .../sensor.swiss_hydrological_data.markdown | 64 ++++++------------- 1 file changed, 19 insertions(+), 45 deletions(-) diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index 6b175014bc7d..11bf875fec22 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -2,7 +2,7 @@ layout: page title: "Swiss Hydrological Data" description: "Instructions on how to integrate hydrological data of Swiss waters within Home Assistant." -date: 2018-10-05 12:00 +2016-06-17 17:00 sidebar: true comments: false sharing: true @@ -13,10 +13,6 @@ ha_iot_class: "Cloud Polling" ha_release: 0.22 --- -

- The sensors don't show the latest measurement, but those one hour older due to the source of data. -

- The `swiss_hydrological_data` sensor will show you details (temperature, level, and discharge) of rivers and lakes in Switzerland. ## {% linkable_title Setup %} @@ -32,8 +28,10 @@ To enable this sensor, add the following lines to your `configuration.yaml` file sensor: - platform: swiss_hydrological_data station: STATION_ID - measurements: + monitored_conditions: - temperature + - level + - discharge ``` {% configuration %} @@ -41,51 +39,27 @@ station: description: The ID of the measurement point. required: true type: string -name: - description: Name to use in the frontend. +monitored_conditions: + description: The list of measurements you want to use. Available is `temperature`, `level` or `discharge`. required: false - type: string - default: -measurements: - description: list of measurements you want to use. - required: true type: list - deafult: + deafult: temperature {% endconfiguration %} -Valid measurement values are: +Sensors are exposing additional values through their attributes for all available conditions: -- temperature - - The last temperature measurement -- level - - The last water level measurement -- discharge - - The last discharge measurement -- min_temperature - - The minimum temperature measurement of the last 24 hours -- min_level - - The minimum water level measurement of the last 24 hours -- min_discharge - - The minimum discharge measurement of the last 24 hours -- max_temperature - - The maximum temperature measurement of the last 24 hours -- max_level - - The maximum water level measurement of the last 24 hours -- max_discharge - - The maximum discharge measurement of the last 24 hours -- mean_temperature - - The mean temperature measurement of the last 24 hours -- mean_level - - The mean water level measurement of the last 24 hours -- mean_discharge - - The mean discharge measurement of the last 24 hours +- 'delta-24h': The delta measurement for the last 24 hours. +- 'max-1h': The maximum measurement for the last hour. +- 'max-24h': The maximum measurement for the last 24 hours. +- 'mean-1h': The mean measurement for the last hour. +- 'mean-24h': The mean measurement for the last 24 hours. +- 'min-1h': The minimum measurement for the last hour. +- 'min-24h': The minimum measurement for the last 24 hours. +- 'previous-24h': The previous measurement for the last 24 hours. +- 'station_update': There is a time span between the sensor update in Home Assistant and the updates from the stations. Include those information if you are building automations based on the discharge of a water body.

- Some stations don't provide data for certain measurements. + The sensors don't show the latest measurement, but those from the last hour due to the source of data. Some stations also don't provide data for certain measurements.

- -The hydrological measurings are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated every 10 minutes. - - - +The hydrological measurements are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated every 10 minutes. From a49a7ee1deda0c7d451706d17444b47ac5645da0 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 11 Nov 2018 17:13:50 +0100 Subject: [PATCH 3/4] Fix typo and style --- .../sensor.swiss_hydrological_data.markdown | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index 11bf875fec22..24f745f2fb74 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -43,20 +43,20 @@ monitored_conditions: description: The list of measurements you want to use. Available is `temperature`, `level` or `discharge`. required: false type: list - deafult: temperature + default: temperature {% endconfiguration %} Sensors are exposing additional values through their attributes for all available conditions: -- 'delta-24h': The delta measurement for the last 24 hours. -- 'max-1h': The maximum measurement for the last hour. -- 'max-24h': The maximum measurement for the last 24 hours. -- 'mean-1h': The mean measurement for the last hour. -- 'mean-24h': The mean measurement for the last 24 hours. -- 'min-1h': The minimum measurement for the last hour. -- 'min-24h': The minimum measurement for the last 24 hours. -- 'previous-24h': The previous measurement for the last 24 hours. -- 'station_update': There is a time span between the sensor update in Home Assistant and the updates from the stations. Include those information if you are building automations based on the discharge of a water body. +- `delta-24h`: The delta measurement for the last 24 hours. +- `max-1h`: The maximum measurement for the last hour. +- `max-24h`: The maximum measurement for the last 24 hours. +- `mean-1h`: The mean measurement for the last hour. +- `mean-24h`: The mean measurement for the last 24 hours. +- `min-1h`: The minimum measurement for the last hour. +- `min-24h`: The minimum measurement for the last 24 hours. +- `previous-24h`: The previous measurement for the last 24 hours. +- `station_update`: There is a time span between the sensor update in Home Assistant and the updates from the stations. Include those information if you are building automations based on the discharge of a water body.

The sensors don't show the latest measurement, but those from the last hour due to the source of data. Some stations also don't provide data for certain measurements. From 9c0b6d83c9b5ed82acb91d08842cdbce92c88d33 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 11 Nov 2018 17:18:30 +0100 Subject: [PATCH 4/4] Fix my copy-&-paste mistake: --- source/_components/sensor.swiss_hydrological_data.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index 24f745f2fb74..03283941fda2 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -2,7 +2,7 @@ layout: page title: "Swiss Hydrological Data" description: "Instructions on how to integrate hydrological data of Swiss waters within Home Assistant." -2016-06-17 17:00 +date: 2016-06-17 17:00 sidebar: true comments: false sharing: true