Sachsen Pegel

Custom Integration fuer Home Assistant zum Abruf aktueller Pegelstaende aus Sachsen.

Die Integration wird vollstaendig ueber die Home-Assistant-Oberflaeche eingerichtet. Es ist keine YAML-Konfiguration erforderlich.

Datenquellen

Verwendete offizielle Quellen:

• Aktuelle Wasserstaende des Landeshochwasserzentrums Sachsen: https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/wasserstand-uebersicht
• Detailseiten einzelner Pegel, z. B. Dresden: https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/wasserstand-pegel-501060
• Download- und Webservice-Hinweis des LHWZ: https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/download-von-messwerten
• SOAP-WSDL fuer Spurwerte: https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/webservices/spurwerte-ws?wsdl
• Messnetze und Pegelliste: https://www.umwelt.sachsen.de/umwelt/infosysteme/lhwz/messnetze.html

Die oeffentlichen aktuellen Werte werden aus der offiziellen LHWZ-Portalansicht gelesen. Der ebenfalls offizielle SOAP-Webservice ist dokumentiert, setzt laut LHWZ-Dokumentation aber HTTP Basic Authentication und ein Nutzerkonto voraus. Diese Integration funktioniert deshalb ohne Zugangsdaten ueber die oeffentliche Portalansicht.

Installation manuell

1. Kopiere den Ordner custom_components/sachsen_pegel in den custom_components-Ordner deiner Home-Assistant-Konfiguration.
2. Starte Home Assistant neu.
3. Gehe zu Einstellungen -> Geraete & Dienste -> Integration hinzufuegen.
4. Suche nach Sachsen Pegel.

Installation mit HACS

1. Oeffne HACS.
2. Fuege dieses Repository als benutzerdefiniertes Repository hinzu.
3. Kategorie: Integration.
4. Installiere Sachsen Pegel.
5. Starte Home Assistant neu.
6. Fuege die Integration ueber Einstellungen -> Geraete & Dienste hinzu.

Einrichtung

Beim Einrichten laedt die Integration die verfuegbaren Messstellen aus der offiziellen aktuellen Wasserstandsuebersicht des LHWZ. Die Auswahlliste zeigt Eintraege im Format:

Dresden - Elbe - Messstellen-ID 501060

Nach der Auswahl wird die Messstelle validiert. Dieselbe Messstelle kann nicht mehrfach eingerichtet werden.

Benutzername und Passwort bleiben leer, wenn du kein LHWZ-Systemnutzerkonto hast. Sie sind nur fuer optionalen SOAP-Zugriff vorgesehen.

Optionen

Das Aktualisierungsintervall kann im Options Flow geaendert werden.

• Standard: 15 Minuten
• Minimum: 5 Minuten

Kuerzere Intervalle werden nicht akzeptiert, um den offiziellen Dienst nicht unnoetig zu belasten.

Sensoren

Pro Messstelle werden Sensoren in einem Home-Assistant-Geraet zusammengefasst.

• Wasserstand: Wasserstand in cm, numerischer Messwert.
• Durchfluss: Durchfluss in m³/s, nur wenn fuer die Messstelle ein aktueller Durchflusswert geliefert wird.
• Letzter Messzeitpunkt: Zeitstempel des aktuell verwendeten Messwerts.

Attribute der Sensoren:

• station_id
• station_name
• water_body
• operator
• status
• trend
• last_measurement
• source

Hinweise zu Messwerten

Aktuelle Echtzeitwerte koennen ungepruefte Rohdaten sein. Fehlende Werte oder k.A.-Angaben werden nicht als 0 interpretiert, sondern als nicht verfuegbar behandelt. Dezimalwerte mit deutschem Komma werden in numerische Werte mit Punkt umgewandelt. Zeitstempel werden intern als zeitzonenbewusste Werte fuer Europe/Berlin verarbeitet.

Datenschutz

Die Integration ruft regelmaessig die offiziellen LHWZ-Seiten ab. Ohne eingetragene Zugangsdaten werden keine personenbezogenen Daten an den Dienst gesendet. Falls Benutzername und Passwort eingetragen werden, werden sie in Home Assistant als Config-Entry-Daten gespeichert und nicht geloggt.

Fehlerbehebung

• Verbindung fehlgeschlagen: Internetverbindung und Erreichbarkeit von www.umwelt.sachsen.de pruefen.
• Zeitueberschreitung: Spaeter erneut versuchen oder Intervall erhoehen.
• Messstelle nicht gefunden: Pruefen, ob die Messstelle noch in der LHWZ-Uebersicht veroeffentlicht wird.
• Keine aktuellen Daten: Die Messstelle meldet momentan keinen aktuellen Wasserstand.
• Antwort konnte nicht ausgewertet werden: Die offizielle Portalstruktur hat sich vermutlich geaendert.