PROPLANTA: Unterschied zwischen den Versionen

PROPLANTA
Zweck / Funktion
	Auslesen von Wetterdaten der Webseite proplanta.de
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Unterstützende Dienste/Wettermodule
Modulname	59_PROPLANTA.pm
Ersteller	tupol (Forum /Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 30. Dezember 2019, 21:06 Uhr

Modul zum Auslesen der Wetterdaten von www.proplanta.de

Voraussetzungen

Anwendung

Bekannte Probleme / Hilfe bei der Fehlersuche

Die korrekte Darstellung des weblink htmlCode braucht evtl. etwas Zeit (lange Abrufzyklen).

Fehler: Could not capture all data. Please check URL or city name.

Bei mehrdeutigen Wohnort hilft es statt nur den Ort oder nur die Postleitzahl einfach beides zu verwenden, verbunden mit einem +. (XXXXX+Stadt)

Bei einer Stadt mit Umlauten wie "Hinterwürfelhäusen (Oberflössen)" muss PROPLANTA wie folgt definiert werden

define myProPlanta PROPLANTA Hinterw%FCrfelh%E4usen+(Oberfl%F6ssen) de

Ä %C4
Ö %D6
Ü %DC
ä %E4
ö %F6
ü %FC

Fehler: 500 Can't connect to www.proplanta.de:443 (certificate verify failed)

Das PROPLANTA-Modul nutzt https - also einen verschlüsselten Zugang zu www.proplanta.de. Wie https genau funktioniert, steht hier.

Bei einer https-Verbindung schickt der Webserver zuerst einen zertifizierten öffentlichen Schlüssel, mit dem die Daten an ihn verschlüsselt werden. Dessen Zertifikat muss von einer Zertifizierungsstelle (engl. Certificate Authority oder kurz CA) digital signiert sein, um sicherzustellen, das Schlüssel und Webadresse zusammengehören. Der FHEM-Rechner prüft diese Signierung mit Hilfe von auf dem Rechner gespeicherten Stammzertifikaten (engl. Root Certificates oder CA Certificates). Details dazu hier und hier.

Der Fehler tritt auf, wenn das verwendete Stammzertifikat auf dem FHEM-Rechner fehlt (nicht gefunden wird) oder abgelaufen ist. Das Zertifikat von www.proplanta.de kann dann nicht verifiziert werden. Der Herausgeber gilt als unbekannt und nicht vertrauenswürdig.

Die Fehlerbehebung hängt vom Rechner und vom Betriebssystem ab. Hier hilft nur eine Internetrecherche.

Standard-Lösung:

Stammzertifikate aktualisieren (z.B. bei Debian mit sudo dpkg-reconfigure ca-certificates)

oder über eine manuelle Installation:

aktuelle Stammzertifikate herunterladen
ins richtige Verzeichnis kopieren (z. B. in /usr/share/ca-certificates)
Achtung!! Manchmal ist im Betriebssytem der falsche Speicherort deklariert.
neue Stammzertifikate (und evtl. das Verzeichnis) dem Betriebsystem bekannt machen (z. B. mit sudo update-ca-certificates)

Anwendungsbeispiel(e)

# erzeugt den Proplanta-Datenabruf
define WetterProplanta PROPLANTA Siegen de
attr WetterProplanta DbLogExclude .*
attr WetterProplanta group Wettervorhersage (Proplanta)
attr WetterProplanta room Wetter-vorhersage

# erzeugt die Anzeige zum Datenabruf
define VorschauProplanta weblink htmlCode {PROPLANTA_Html("WetterProplanta")}
attr VorschauProplanta DbLogExclude .*
attr VorschauProplanta group Wettervorhersage (Proplanta)
attr VorschauProplanta room Wetter-vorhersage

Erläuterung: DbLogExclude .* die Daten sollen nicht ins Log geschrieben werden (hier DbLog) und es nicht "zumüllen"

# erzeugt Ansicht im Querformat 
defmod weblink_meinwetter weblink htmlCode {PROPLANTA_Html_Landscape("<Proplanta-device, anpassen!>",4)}
attr weblink_meinwetter group <anpassen>
attr weblink_meinwetter room <anpassen>

Liste der Wetterbedingungen bei Proplanta

Hier gibt es eine Liste der Wetterbedingungen bei Proplanta:

https://www.proplanta.de/Wetter/Legende/
https://forum.fhem.de/index.php/topic,87753.msg801635.html#msg801635/

@@ Zeile 2: / Zeile 2: @@
 |ModPurpose=Auslesen von Wetterdaten der Webseite proplanta.de
 |ModType=d
-|ModForumArea=Wettermodule
+|ModForumArea=Unterstützende Dienste/Wettermodule
 |ModTechName=59_PROPLANTA.pm
 |ModOwner=tupol ({{Link2FU|5432|Forum}}/[[Benutzer Diskussion:Topos|Wiki]])
@@ Zeile 8: / Zeile 8: @@
 Modul zum Auslesen der Wetterdaten von www.proplanta.de
+== Voraussetzungen ==
+== Anwendung ==
+== Bekannte Probleme / Hilfe bei der Fehlersuche ==
+Die korrekte Darstellung des <code>weblink htmlCode</code> braucht evtl. etwas Zeit (lange Abrufzyklen).
+=== Fehler: Could not capture all data. Please check URL or city name. ===
+Bei mehrdeutigen Wohnort hilft es statt nur den Ort oder nur die Postleitzahl einfach beides zu verwenden, verbunden mit einem +. (XXXXX+Stadt)
+Bei einer Stadt mit Umlauten wie "Hinterwürfelhäusen (Oberflössen)" muss PROPLANTA wie folgt definiert werden
+<pre>define myProPlanta PROPLANTA Hinterw%FCrfelh%E4usen+(Oberfl%F6ssen) de</pre>
+*Ä    %C4
+*Ö    %D6
+*Ü    %DC
+*ä    %E4
+*ö    %F6
+*ü    %FC
+=== Fehler: 500 Can't connect to www.proplanta.de:443 (certificate verify failed) ===
+Das PROPLANTA-Modul nutzt ''https'' - also einen verschlüsselten Zugang zu www.proplanta.de. Wie ''https'' genau funktioniert, steht [https://de.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure hier].
+Bei einer https-Verbindung schickt der Webserver zuerst einen zertifizierten öffentlichen Schlüssel, mit dem die Daten an ihn verschlüsselt werden. Dessen Zertifikat muss von einer Zertifizierungsstelle (engl. Certificate Authority oder kurz CA) digital signiert sein, um sicherzustellen, das Schlüssel und Webadresse zusammengehören. Der FHEM-Rechner prüft diese Signierung mit Hilfe von auf dem Rechner gespeicherten Stammzertifikaten (engl. Root Certificates oder CA Certificates). Details dazu [https://de.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure#Vorinstallierte_Zertifikate hier] und [https://wiki.ubuntuusers.de/CA/ hier].
+Der Fehler tritt auf, wenn das verwendete Stammzertifikat auf dem FHEM-Rechner fehlt (nicht gefunden wird) oder abgelaufen ist. Das Zertifikat von www.proplanta.de kann dann nicht verifiziert werden. Der Herausgeber gilt als unbekannt und nicht vertrauenswürdig.
+Die Fehlerbehebung hängt vom Rechner und vom Betriebssystem ab. Hier hilft nur eine Internetrecherche.
+Standard-Lösung:
+*Stammzertifikate aktualisieren (z.B. bei Debian mit ''sudo dpkg-reconfigure ca-certificates'')
+oder über eine manuelle Installation:<br>
+*aktuelle Stammzertifikate herunterladen
+*ins '''richtige''' Verzeichnis kopieren (z. B. in ''/usr/share/ca-certificates'')<br>Achtung!! Manchmal ist im Betriebssytem der falsche Speicherort deklariert.
+*neue Stammzertifikate (und evtl. das Verzeichnis) dem Betriebsystem bekannt machen (z. B. mit ''sudo update-ca-certificates'')
+== Anwendungsbeispiel(e) ==
+[[Datei:Screenshot_Proplanta.png|600px]]
+<pre>
+# erzeugt den Proplanta-Datenabruf
+define WetterProplanta PROPLANTA Siegen de
+attr WetterProplanta DbLogExclude .*
+attr WetterProplanta group Wettervorhersage (Proplanta)
+attr WetterProplanta room Wetter-vorhersage
+# erzeugt die Anzeige zum Datenabruf
+define VorschauProplanta weblink htmlCode {PROPLANTA_Html("WetterProplanta")}
+attr VorschauProplanta DbLogExclude .*
+attr VorschauProplanta group Wettervorhersage (Proplanta)
+attr VorschauProplanta room Wetter-vorhersage
+</pre>
+; Erläuterung:
+: <code>DbLogExclude .*</code> die Daten sollen nicht ins Log geschrieben werden (hier [[DbLog]]) und es nicht "zumüllen"
+[[Datei:ProplantaQuerformat.png|600px]]
+<pre>
+# erzeugt Ansicht im Querformat
+defmod weblink_meinwetter weblink htmlCode {PROPLANTA_Html_Landscape("<Proplanta-device, anpassen!>",4)}
+attr weblink_meinwetter group <anpassen>
+attr weblink_meinwetter room <anpassen></pre>
+== Liste der Wetterbedingungen bei Proplanta ==
+Hier gibt es eine Liste der Wetterbedingungen bei Proplanta:
+https://www.proplanta.de/Wetter/Legende/ </br>
+https://forum.fhem.de/index.php/topic,87753.msg801635.html#msg801635/ </br></br>
 [[Kategorie:Gerätemodul]]