FHEMWiki - Benutzerbeiträge [de]

Wetter und Wettervorhersagen

2023-06-10T09:15:01Z

Esk: End of support for DarkSky

Wetterdaten und Wettervorhersagen können auf verschiedene Weise in FHEM eingebunden werden.
== Modul Weather ==
Das Modul [[Weather]] extrahiert Wetterdaten via API von den Wetterdatenanbietern
* [https://openweathermap.org/ Openweathermap]
** Vorschauzeitraum: 5 Tage (zeitliche Auflösung: 3 Stunden)
** Aktuelle Daten (minütlich)
** 1000 Abrufe pro Tag mit dem Gratis-API-Key (Stand: Juni 2021)
* [https://www.wunderground.com/ wunderground]
** API-KEY nur für Gerätebesitzer
* [https://darksky.net/ DarkSky]
** Support for the Dark Sky API ended on March 31, 2023, and has been replaced by Apple’s WeatherKit API.
** Es können keine neuen API-Key erstellt werden (Stand: Juni 2021)

Da die Yahoo Weather API zum 03.01.2019 abgeschaltet wurde, kann Weather keine Wetterdaten von Yahoo mehr beziehen.

== Unwetterzentrale ==
Informationen der Seite(n) Unwetterzentrale.de können mit Hilfe des Moduls [[UWZ]] eingebunden werden.

== Modul OPENWEATHER ==
Das Modul [[OPENWEATHER]] extrahiert Wetterdaten über die "openweather"-Schnittstelle (API) von www.wetter.com.
*Vorschau-Zeitraum: 3 Tage
*Vorschau-Interval: 6:00, 11:00, 17:00, 23:00
*Aktuelle Daten: keine

== Modul PROPLANTA ==
Das Modul [[PROPLANTA]] extrahiert Wetterdaten von der Website www.proplanta.de. (keine API)
*Vorschau-Zeitraum: 12 Tage
*Vorschau-Interval: 3 h
*Aktuelle Daten: jede volle Stunde

== Modul WWO ==
Das {{Link2CmdRef|Anker=WWO|Label=Modul WWO}} extrahiert Wetterdaten über die (alte) API von worldweatheronline.com
*Vorschau-Zeitraum: ?? Tage 
*Vorschau-Interval: ?? 
*Aktuelle Daten: ??

== Deutscher Wetterdienst (DWD) ==

=== Modul DWD_OpenData ===
Das Modul [[DWD_OpenData]] stellt einen Teil der frei verfügbaren Daten des Deutschen Wetterdienstes (DWD) bereit, die über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] abgerufen werden können (diverse Datenformate, keine API).
*Vorschau-Zeitraum: 10 Tage
*Vorschau-Interval: datenabhängig, viele mit 3 h
*Vorschau-Orte: national und international (weniger Daten, z.B. keine Radiation)
*Aktuelle Daten: nicht implementiert
*Wetterwarnungen: national für Deutschland für Landkreise und Gemeinden in deutsch oder englisch

Es gibt zum Modul auch einen Weblink für [[FHEMWEB]], der zwei Icons pro Tag in horizontaler Form darstellt. Die Anzahl der insgesamt dargestellten Icons ist konfigurierbar. Liegen Wetterwarnungen vor, wird zusätzlich ein Warnsymbol angezeigt, über das man per Klick weitere Details zur Wetterwarnung abrufen kann.

[[DWD_OpenData|Weitere Details und Installationsbeschreibung]]

=== Wetterwarnungen als Karte ===
Der Deutsche Wetterdienst [http://www.dwd.de DWD] stellt neben diversen Wetterdaten auch Wetterwarnungen in Bildform bereit. Diese können sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden - das ist zwar nicht die schönste Form, aber die schnellste.

Dazu sucht man sich zuerst auf der [http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_pageLabel=_dwdwww_wetter_warnungen_warnungen&T92053gsbDocumentPath=BEA__Navigation%2FWetter__Warnungen%2FWarnungen.html%3F__nnn%3Dtrue&lastPageLabel=dwdwww_wetter_warnungen Warnungsseite des DWD] die eigene Region heraus (in der Karte durchklicken). Die gewünschte URL für Berlin Stadt ist z.B. <code>http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html#WS_ANCHOR_0</code>. Das Anhängsel <code>#WS_ANCHOR_0</code> kann man in der Konfiguration auch weglassen.

Die Einbindung in FHEM sieht dann wie folgt aus:
<pre>
define dwd_warnmeldung weblink iframe http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html
attr dwd_warnmeldung group Wetterwarnungen (DWD)
attr dwd_warnmeldung htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"
attr dwd_warnmeldung room Wettervorhersage,Startseite
</pre>

== Vorhersage-Diagramm von YR ==
[http://www.yr.no YR] ist die Seite des norwegischen Wetterdiensts. Er ist zwar nur in Teilen auf Englisch (und gar nicht auf Deutsch) verfügbar, bietet aber sehr gute Wettervorhersagen - auch mit eigenen Vorhersagen für kleine Dörfer. Neben etlichen Detailinfos bietet YR eine sehr schicke 48h-Vorhersage-Grafik. Diese kann sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden.

Dazu geht man auf die [http://www.yr.no Startseite von YR] und gibt in das Suchfeld den Namen seines Dörfchens ein - die Ergebnissliste kann ziemlich lang werden, sodass man evtl. sehr genau schauen muss, welches das eigene Kaff ist - bei mir war es an 29. Stelle... ;-) Auf der gewünschten Seite gibt es einen Unterpunkt "Forecast as SVG", wo sich die besagte Grafik findet. Hier kopiert man sich einfach die URL der Grafik.

Die Einbindung in FHEM sieht dann bspw. wie folgt aus:
<pre>
define Wetter_yr_Vorhersage weblink iframe https://www.yr.no/en/content/2-2950159/meteogram.svg
attr Wetter_yr_Vorhersage group Wettervorhersage (yr)
attr Wetter_yr_Vorhersage htmlattr width="782" height="391" frameborder="0" marginheight="0" marginwidth="0"
attr Wetter_yr_Vorhersage room Wettervorhersage,Start
</pre>

== Wetter von Weather Underground ==
{{Randnotiz|RNTyp=r|RNText=Das ("offene") API von Weather Underground wird derzeit (März 2019) "retired" = abgestellt, ist also künftig nicht mehr nutzbar! Den benötigten API-Key bekommen "nur noch" Betreiber einer Wetterstation, die diese bei wundergound registrieren und ihre Daten hochladen.}}
'''Hinweis:''' Die hier beschriebene Vorgehensweise ist etwas anspruchsvoller und somit eher für erfahrene FHEM-User geeignet.

[http://www.wunderground.com/ Weather Underground] bietet eine sehr umfassende Sammlung aller möglichen offiziellen und privaten (aber teils sehr professionellen) Wetterstationen weltweit. Es besteht eine recht hohe Wahrscheinlichkeit, dass es in der eigenen Umgebung schon eine Wetterstation gibt. Anstatt nun selbst eine komplette Wetterstation aufzubauen, kann man alternativ auf die Daten der Nachbarstation zugreifen.

{{Randnotiz|RNTyp=y|RNText=Neben dem hier vorgestellten Abruf der Weather Underground-Daten mit [[HTTPMOD]] kann auf Weather Underground-Daten auch mit dem darauf spezialisierten Modul [http://fhem.de/commandref.html#Wunderground Wunderground] zugegriffen werden.}}

Dazu sind grundsätzlich die folgenden Schritte notwendig:
* Finden der geeigneten Station
* Auswerten der XML-Daten
* Erstellen passender gplot-Dateien

=== Finden der geeigneten Station ===
Als erstes geht man auf die [http://www.wunderground.com Startseite von Weather Underground] und gibt in das Suchfeld den Namen seines Dörfchens oder der nächsten Stadt ein - für Berlin landet man bspw. auf Seite für "Berlin Alexanderplatz". Es gibt aber manchmal sehr viele Wetterstationen in der direkten Umgebung. Diese findet man indem am auf "Change Station" klickt und sich eine passende Station aussucht. Nähere Infos (zB. zur verwendeten Hard- und Software) zu der gewählten Wetterstation erhält man, wenn man auf den Namen der Station klickt und dann auf "About this PWS".

Weather Underground stellt die Daten der Wetterstation auch über eine API als XML bereit, die wir auswerten können. Die entsprechende URL findet sich ebenfalls unter "About this PWS" unter "Download current conditions XML". Für Berlin Prenzlauer Berg wäre dies z.B.
<code>http://api.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&format=XML</code>.

Entscheidend für die jeweilige Station ist der Teil nach "?=ID", also in diesem Fall "IBERLIN15". Dieser Teil des Links lässt sich leicht durch die ID einer anderen Station ersetzen und die Suche nach dem entsprechenden Link auf der Seite der Station bleibt erspart.

=== Auswerten der XML-Daten ===
Die Auswertung der XML-Daten erfolgt via [[HTTPMOD]]. Da dies nicht ganz trivial ist, sind im Folgenden zuerst die wesentlichen Konfigurationsschritte exemplarisch beschrieben. Weiter unten findet sich dann die fertige vollständige Konfiguration.

Es erstes wird das Device HTTPMOD definiert (die 600 am Schluss ist der Aktualisierungszyklus in Sekunden, also alle 10 min):
:<code>define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600 </code>

Dann werden Attribute für alle Readings definiert:
:<code>attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date ... </code>

Dann wird jedem Attribut ein Name zugewiesen (unter diesem Namen wird der Wert ins Log geschrieben):
:<code>attr wetter_prenzelberg readingsName_cloudiness cloudiness </code>

Zum Schluss wird das Reading selbst definiert:
:<code>attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+) </code>

Die gesamte Konfiguration für alle von der API angebotenen Wetterwerte sieht dann wie folgt aus:
<pre>
define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600
attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date readingsName_dewpointTemperature readingsName_fog readingsName_heatindex readingsName_humidity readingsName_pressure readingsName_solarRadiation readingsName_solarUV readingsName_temperature readingsName_time readingsName_windChill readingsName_windDegrees readingsName_windDirection readingsName_windGust readingsName_windSpeed readingsRegex_cloudiness readingsRegex_date readingsRegex_dewpointTemperature readingsRegex_fog readingsRegex_heatindex readingsRegex_humidity readingsRegex_pressure readingsRegex_solarRadiation readingsRegex_solarUV readingsRegex_temperature readingsRegex_time readingsRegex_windChill readingsRegex_windDegrees readingsRegex_windDirection readingsRegex_windGust readingsRegex_windSpeed
attr wetter_prenzelberg readingsName_cloudiness cloudiness
attr wetter_prenzelberg readingsName_date date
attr wetter_prenzelberg readingsName_dewpointTemperature dewpointTemperature
attr wetter_prenzelberg readingsName_fog fog
attr wetter_prenzelberg readingsName_heatindex heatindex
attr wetter_prenzelberg readingsName_humidity humidity
attr wetter_prenzelberg readingsName_pressure pressure
attr wetter_prenzelberg readingsName_solarRadiation solarRadiation
attr wetter_prenzelberg readingsName_solarUV solarUV
attr wetter_prenzelberg readingsName_temperature temperature
attr wetter_prenzelberg readingsName_time time
attr wetter_prenzelberg readingsName_windChill windChill
attr wetter_prenzelberg readingsName_windDegrees windDegrees
attr wetter_prenzelberg readingsName_windDirection windDirection
attr wetter_prenzelberg readingsName_windGust windGust
attr wetter_prenzelberg readingsName_windSpeed windSpeed
attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+)
attr wetter_prenzelberg readingsRegex_date date date" content="([\d\.]+)
attr wetter_prenzelberg readingsRegex_dewpointTemperature <dewpoint_c>(\+|-?[\d\.]+)
attr wetter_prenzelberg readingsRegex_fog fog id="FOG" percent="([\d\.]+)
attr wetter_prenzelberg readingsRegex_heatindex <heat_index_c>(\+|-?[\d\.]+)
attr wetter_prenzelberg readingsRegex_humidity <relative_humidity>([\d\.]+)
attr wetter_prenzelberg readingsRegex_pressure <pressure_mb>([\d\.]+)
attr wetter_prenzelberg readingsRegex_solarRadiation <solar_radiation>([\d\.]+)
attr wetter_prenzelberg readingsRegex_solarUV <UV>([\d\.]+)
attr wetter_prenzelberg readingsRegex_temperature <temp_c>(\+|-?[\d\.]+)
attr wetter_prenzelberg readingsRegex_time time Zeit([\d\:]+)
attr wetter_prenzelberg readingsRegex_windChill <windchill_c>(\+|-?[\d\.]+)
attr wetter_prenzelberg readingsRegex_windDegrees <wind_degrees>([\d\.]+)
attr wetter_prenzelberg readingsRegex_windDirection <wind_dir>([\d\.]+)
attr wetter_prenzelberg readingsRegex_windGust <wind_gust_mph>([\d\.]+)
attr wetter_prenzelberg readingsRegex_windSpeed <wind_mph>([\d\.]+)
</pre>
Hinweis: Nicht immer werden alle Werte geliefert (wenn keine Sonne, dann kein UV-Wert...). Im System-Log kann das als Fehler auftauchen, ist aber kein Problem.

=== Erstellen passender gplot-Dateien ===
Um die ausgelesenen Werte als Graphen darstellen zu können müssen eigene gplot-Dateien erstellt werden. Eine grundsätzliche Anleitung dazu findet sich unter [[Creating Plots]]. Deshalb sollen hier nur Beispiele für die eigentlichen gplot-Dateien vorgestellt werden. Beispiele sollten sowohl für [[FileLog]] wie [[DbLog]] funktionieren.

Temperatur und Luftfeuchte:
<pre>
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
#set title '<L1>'
set title ''
set ytics
set y2tics
set grid ytics
set ylabel "Temperature in C"
set y2label "Humidity (%)"

#FileLog 4:temperature\x3a::
#FileLog 4:windChill\x3a::
#FileLog 4:humidity\x3a::

#DbLog <SPEC1>:temperature::
#DbLog <SPEC1>:windChill::
#DbLog <SPEC1>:humidity::

plot "<IN>" using 1:2 axes x1y1 title 'Temperatur (C)' ls l0 lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Gefühlte Temperatur (C)' ls l1 lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Luftfeuchtigkeit (%)' ls l2fill lw 0.2 with lines
</pre>

Wind und Windrichtung:
<pre>
set terminal png transparent size <SIZE> crop

set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "

set ytics
set y2tics ("Nord" 0, "Ost" 80, "Süd" 180, "West" 270, "Nord" 360)

#set title '<L1>'
set title ''

set grid xtics ytics

set yrange [0:20]
set y2range [0:360]

set ylabel "Wind (mph)"
set y2label "Richtung"

#FileLog 4:windSpeed:0:
#FileLog 4:windGust:0:
#FileLog 4:windDegrees:0:

#DbLog <SPEC1>:windSpeed::
#DbLog <SPEC1>:windGust::
#DbLog <SPEC1>:windDegrees::

plot "<IN>" using 1:2 axes x1y1 title 'Wind (mph)' ls l0 lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Böen (mph)' ls l1 lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Windrichtung (°)' ls l2fill lw 0.2 with points
</pre>

Sonnenintensität und UV-Werte:
<pre>
set terminal png transparent size <SIZE> crop

set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "

set ytics
set y2tics

#set title '<L1>'
set title ''

set grid xtics ytics

set ylabel "Sonnenstrahlung (W/qm)"
set y2label "UV"

#FileLog 4:solarRadiation:0:
#FileLog 4:solarUV:0:

#DbLog <SPEC1>:solarRadiation::
#DbLog <SPEC1>:solarUV::

plot "<IN>" using 1:2 axes x1y1 title 'Strahlung' ls l0 lw 1.5 with lines,\
"<IN>" using 1:2 axes x1y1 title 'UV' ls l1 lw 1.5 with lines
</pre>

'''Weitere TBD'''

=== Vergangene Daten abfragen ===
Ein konkretes vergangenes Datum der Wetterstation kann man übrigens auch abrufen - für den 28.11.2014 wäre dies bspw.
<code>http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&day=28&month=11&year=2014&graphspan=day&format=1</code>.

=== Eigene Wetterdaten hochladen ===
{{Randnotiz|RNTyp=g|RNText=Unterstützung für das Modul gibt es im dazugehörigen {{Link2Forum|Topic=65587|LinkText=Forumsthread }}.}}
Wer eigene Wetterdaten hochladen will, kann hierzu das {{Link2CmdRef|Anker=WUup|Label=Modul WUup}} verwenden. Dazu benötigt man die Zugangsdaten (stationID und Paßwort) für eine eigene Wetterstation. Mit dem Modul können die meisten vom [http://web.archive.org/web/20180815041359/http://wiki.wunderground.com/index.php/PWS_-_Upload_Protocol PWS Upload Protocol] unterstützten Daten hochgeladen werden:
* Winddir - [0-360 momentane Windrichtung]
* Windspeedmph - [mph momentane Windgeschwindigkeit]
* Windgustmph - [mph aktuellen Böe, mit Software-spezifischem Zeitraum]
* Windgustdir - [0-360 mit Software-spezifischer Zeit]
* Windspdmph_avg2m - [mph durchschnittliche Windgeschwindigkeit innerhalb 2 Minuten]
* Winddir_avg2m - [0-360 durchschnittliche Windrichtung innerhalb 2 Minuten]
* Windgustmph_10m - [mph Böen der vergangenen 10 Minuten]
* Windgustdir_10m - [0-360 Richtung der Böen der letzten 10 Minuten]
* Feuchtigkeit - [% Außenfeuchtigkeit 0-100%]
* Dewptf- [F Taupunkt im Freien]
* Tempf - [F Außentemperatur]
* Rainin - [in Regen in der vergangenen Stunde]
* Dailyrainin - [in Regenmenge bisher heute]
* Baromin - [inHg barometrischer Druck]
* Soiltempf - [F Bodentemperatur]
* Bodenfeuchtigkeit - [%]
* Solarradiation - [W/m²]
* UV - [Index]
* AqPM2.5 - Feinstaub PM2,5 [µg/m³]
* AqPM10 - Feinstaub PM10 [µg/m³]

Die Werte werden im Modul für Wunderground ins anglo-amerikanische System umgerechnet. Temperaturen werden also automatisch von °Celsius in Fahrenheit, Windgeschwindigkeiten von km/h in mph, mm in Inch und der barometrische Druck von hPa in inHg umgerechnet.

== Wetternetzwerk auf wetter.com ==
Ein vollständiges Beispiel zur Nutzung der Informationen über die Regenmenge (Station 1445, Weinheim) von wetter.com ist in {{Link2Forum|Topic=39600|Message=332837|LinkText=diesem Forenbeitrag}} beschrieben.

== Wetter von netatmo ==
Das FHEM-Modul [[netatmo]] ermöglicht den Datenimport von privaten und öffentlichen netatmo Wetterstationen sowie den Abruf der in der Netatmo App verfügbaren Wettervorhersage. Eine Übersicht über die verfügbaren öffentlichen Stationen findet sich auf der Seite [http://www.netatmo.com/de-DE/weathermap Weathermap]. Die meisten öffentlichen Stationen liefern Temperatur, Luftfeuchte und Luftdruck, einige auch Wind, Regen und Daten zur Luftqualität (CO2).

== Links ==
* {{Link2Forum|Topic=33610|LinkText=Forenthema}} mit Sammlung und Beipielen von Internet-Links für die Anzeige von teilweise animierten Wetterbildern
* [http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]
* [[HTTPMOD]]

[[Kategorie:Code Snippets]]
[[Kategorie:HOWTOS]]
[[Kategorie:Wetterstationen]]

FileLogConvert

2022-03-29T13:29:14Z

Esk: add reload 98_FileLogConvert.pm

{{SEITENTITEL:FileLogConvert}}
{{Infobox Modul
|ModPurpose=einlesen von Filelogs in eine logdb
|ModType=h
|ModCmdRef=FileLogConvert
|ModForumArea=FHEM
|ModTechName=98_FileLogConvert.pm
|ModOwner={{Link2FU|8|DeeSPe}}
}}

Kann dazu verwendet werden, um FileLogs in eine DbLog-Datenbank einzulesen.

== Vorbereitung ==

Zuerst brauchen wir ein DbLog-Device:

[[DbLog|DbLog-Device erstellen]]

dazu könnte ein DbRep-Device helfen:

[[DbRep - Reporting und Management von DbLog-Datenbankinhalten| DbRep-Device erstellen]]

Wenn das soweit erledigt ist, muss das FileLogConvert-Modul aus contrib nach FHEM kopiert werden:

cp /opt/fhem/contrib/98_FileLogConvert.pm /opt/fhem/FHEM

Wenn die Datei nicht vorhanden ist, muss ein [[Cmdalias#svnupdate|update von contrib]] vorgenommen werden:

svn checkout https://svn.fhem.de/fhem/trunk/fhem/contrib/ contrib
Das neue Modul muss in fhem geladen sein:

reload 98_FileLogConvert.pm

dann kann ein FileLogConvert-Device angelegt werden

define flc FileLogConvert <DbLogDevice>

== Arbeiten mit dem FileLogConvert-Device ==

nun können mit
set flc import2DbLog <Filelog-Dateiname.log>

die logdateien importiert werden

== Tipps und Tricks ==

=== Events unterdrücken ===
wenn man bei erstellung des DbLog-Devices ein
attr .* DbLogExclude .*
absetzt, werden keine Events geloggt.
Dadurch kann man hinterher die Zeilen der Datei
wc -l Dateiname
mit den importierten Zeilen
Reading lines-imported
mit den in der Datenbank vorhandenen Zeilen
sqlite3 db.db
select count(*) from history;
vergleichen. Der Count-Befehl gibt die totale anzahl an Zeilen an, so dass hier ggf. eine Verrechnung mit den vorher in der Datenbank vorhandenen Zeilen notwendig ist.
Das ganze funktioniert natürlich nur, wenn man in der Zwischenzeit keine neuen Logeinträge schreiben lässt (durch DbLog).
Abgesehen davon erhöht das ganze noch die Stabilität und Konsistenz der Datenbank

=== Log-Dateien splitten ===

Wenn man größere Logdateien hat, dauert der import unter umständen sehr lange.
Daher besteht die Möglichkeit, die Logdateien in kleinere Stücke zu unterteilen, damit man z.B. zwischendurch unterbrechen kann:
split -C 5m --numeric-suffixes input-file output-prefix
Blöderweise kann man nur Dateien importieren, die mit .log enden.
Deshalb muss man noch eine kleine verrenkung machen:

[[Kategorie:Logging]]

FHEM auf Raspberry PI mit COC betreiben

2016-12-22T16:30:10Z

Esk: COC bei Jessie

Um einen [[COC]] mit einem Raspberry Pi und FHEM zu nutzen sind mehrere Schnitte notwendig. Die folgende Anleitung zeigt diese entsprechend auf.

== Vorausetzung ==
Erforderliche Hardware:
* [[Raspberry Pi]]
* Busware [[COC]]

Erforderliche Software:
* Raspbian OS (Debian Wheezy Version June 2014, oder aktueller)

Notwendige Vorbereitungen:
* Busware [[COC]] ist auf dem [[Raspberry Pi]] montiert
* [[Raspberry Pi]] ist per LAN Kabel an den Router angeschlossen und hat eine IP via DHCP bekommen und kann in das Internet (keine Firewall Restriktion)

== Raspberry Pi Grundinstallation ==
# Die Beschreibung der Installation im nachfolgenden Abschnitt ist veraltet.
# Bitte immer zuerst http://fhem.de/fhem.html#Installation lesen!
# Eine Anleitung zur Grundinstallation des Raspberry Pi findet sich hier http://www.fhemwiki.de/wiki/Raspberry_Pi Die nachfolgenden Installationanleitung für das Grundsystem wird überarbeitet und ist nicht als Standardvariante zu verwenden!

== FHEM Installieren ==
{{Randnotiz|RNTyp=Fehl|RNText=Diese Anleitung zur Installation von FHEM entspricht nicht dem aktuellen Stand. Dieser Abschnitt muss überarbeitet werden.
Hier wird die "manuelle" Installationsvariante von Fhem (11.-13.) angewendet. Mittlerweile ist auch die Installation aus einem [[Raspberry_Pi#Debian-Repository|Debian-Repository ]] möglich.}}
# Raspberry Pi booten
# Einloggen als User: pi mit dem Password: raspberry
# Danach sollte das Raspberry OS upgedatet werden: <code>sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get autoremove -y && sudo reboot</code>
# nach dem neustart sollte auch kurz die Firmware aktuallisiert werden. Das geht wie folgt: <code>sudo apt-get install rpi-update</code> <code>sudo rpi-update</code>
# Anschließend sollte der Raspberry PI neu gestarted werden mittels <code>sudo shutdown -r now</code>
# Danach muss die richtige Zeitzone für unseren RPI eingestellt werden, das geht mittels <code>sudo dpkg-reconfigure tzdata</code>
# Damit der RPI den gesamten Speicherplatz der SD-Karte nutzt, kann man (sofern noch nicht nach dem ersten Start getan) das Filesystem mit folgendem Menü erweitern <code>sudo raspi-config</code>
# Anschließend rebooten wir den RPI mittels <code>sudo shutdown -r now</code>
# Einloggen als User: Pi mit dem Password: Raspberry
# Da wir davon ausgehen das wir FHEM mit Zeitprofilen verwenden werden ist das korrekte Datum sehr wichtig. Daher installieren wir einen NTP Client, der die Zeit aktuell hält und richten ihn für Deutschland ein. Dies geht wie folgt: <code>sudo apt-get install ntpdate</code> <code>sudo ntpdate -u de.pool.ntp.org</code>
# Da der FHEM auf Perl basiert müssen jetzt die notwendigen Packete installiert werden: <code>sudo apt-get -f install && sudo apt-get install perl libdevice-serialport-perl libio-socket-ssl-perl libwww-perl libxml-simple-perl -y</code>
# Jetzt können wir FHEM herunterladen und zwischenspeichern: <code>sudo wget http://fhem.de/fhem-5.6.deb -O /tmp/fhem-5.6.deb</code> Es ist darüber hinaus sinvoll kurz zu kontrollieren, ob die Version aktuell ist. Das kann auf der FHEM Webseite http://fhem.de/fhem.html getan werden.
# Anschließend kann FHEM installiert werden: <code>sudo dpkg -i /tmp/fhem-5.6.deb</code>
# Da FHEM automatisch gestarted hat, müssen wir ihn jetzt kurz beenden via:<code>/etc/init.d/fhem stop</code>
# Jetzt müssen wir noch die Rechte des FHEM Verzeichnisses anpassen. Dafür vergeben wir auf alle Dateien unter /opt/fhem Schreibrechte<code>sudo chmod -R a+w /opt/fhem</code> (Bedenken gegen diese Rechtevergabe und Alternative: {{Link2Forum|Topic=39353|Message=320936}})
# Nun fügen wir die Benutzer pi und fhem der Gruppe tty hinzu (Zugriffsrechte auf Serial- und USB-Ports) <code>sudo usermod -aG tty pi && sudo usermod -aG tty fhem</code>
# Jetzt müssen wir den Speicherort des Logfiles anpassen. Dafür editieren wir die FHEM config via <code>nano /opt/fhem/fhem.cfg</code> und ändern alle einträge der art "./log/" nach "/opt/fhem/log"
# Jetzt starten wir FHEM kurz neu <code>/etc/init.d/fhem stop</code> <code>/etc/init.d/fhem start</code>
# Anschließend können wir uns über <code><nowiki>http://<dieRaspberryIP>:8083/fhem</nowiki></code> am FHEM anmelden. In der Dialogbox oben geben wir nun folgendes ein, um FHEM zu aktualisieren <code>attr global sendStatistics onUpdate</code> <code>update</code> und wenn uns FHEM nach einem Neustart fragt, kommen wir dem mittels <code>shutdown restart</code> nach.

== COC in Betrieb nehmen ==
# Nun muss der serielle Port für den Raspberry freigegeben werden.
#* Dazu muss die Datei /etc/inittab mittels <code>sudo nano /etc/inittab</code> angepasst werden und folgende Zeile löschen <code>T0:23:respawn:/sbin/getty -L ttyAMA0 115200 vt100</code> oder auskommentieren
#* Bei jessie: <code>sudo systemctl stop serial-getty@ttyAMA0.service</code> <code>sudo systemctl disable serial-getty@ttyAMA0.service</code> 
# Anpassen der boot parameter
#* Dazu wird die Datei /boot/cmdline.txt bearbeitet. Sie wird mittels <code>sudo nano /boot/cmdline.txt</code> editiert und Referenzen auf ttyAMA0 entfernt <code>console=ttyAMA0,115200 kgdboc=ttyAMA0,115200</code>
#* Bei jessie: Hier muss in der Datei /boot/config.txt der Wert <code>dtoverlay=pi3-miniuart-bt</code> eingetragen werden. Die Datei /boot/cmdline.txt sollte so aussehen: <code>dwc_otg.lpm_enable=0 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait</code>
# Damit der COC beim Start vom FHEM initialisiert wird, muss die /etc/init.d/fhem editiert werden. Dies machen wir mittels <code>sudo nano /etc/init.d/fhem</code> und fügen unterhalb von "Start)" folgendes in die Datei ein <code>echo "resetting 868MHz extension..." </code> <code> if test ! -d /sys/class/gpio/gpio17; then echo 17 > /sys/class/gpio/export; fi </code> <code> if test ! -d /sys/class/gpio/gpio18; then echo 18 > /sys/class/gpio/export; fi </code> <code> echo out > /sys/class/gpio/gpio17/direction </code> <code> echo out > /sys/class/gpio/gpio18/direction </code> <code> echo 1 > /sys/class/gpio/gpio18/value </code> <code> echo 0 > /sys/class/gpio/gpio17/value </code> <code> sleep 1 </code> <code> echo 1 > /sys/class/gpio/gpio17/value </code> <code> sleep 1 </code> Achtung: Nach einem Update von FHEM könnte diese Datei überschrieben werden. Dann muss die Änderung oben wieder hinzugefügt werden.
# nun wird der COC in die Fhem [[Konfiguration]] eingefügt. Dafür wird (z.B., aber nicht die empfohlene Vorgehensweise) die Konfigurationsdatei editiert: <code>"sudo nano /opt/fhem/fhem.cfg"</code> und ganz zum Schluss folgendes hinzugefügt: <code>"define COC CUL /dev/ttyAMA0@38400 1234"</code>
# Nun wird der Raspberry PI vollständig neu gestarted <code>sudo shutdown -r now</code>
# Der Raspberry PI sollte nun via auto detect die Komponenten auffinden

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

HomeMatic Firmware Update

2014-07-02T19:37:06Z

Esk: Update mit COC

= Varianten für Firmwareupdates =
Seit 2014 ist es möglich bei einige HomeMatic Komponenten selber Firmware Updates durchzuführen. Vorher ging es nur per CCU oder durch einsenden des Gerätes zu ELV.
Dabei gibt es verschiedene Möglichkeiten das Firmware Update durchzuführen. Um in FHEM die aktuelle Firmware nach dem update angezeigt zu bekommen ist ein erneutes Pairen mit FHEM notwendig. Es muss aber nicht gelöscht oder zurückgesetzt werden.

== Firmware Update mit CUL/HM-CFG-USB unter FHEM ==
Noch nicht offiziell implementiert, weiter Infos gibt es im Forum: http://forum.fhem.de/index.php/topic,23329.0.html

== Firmware Update mit CUL/HM-CFG-USB unter Linux ==
Für Linux hat mgernoth eine Updatetool programmiert.

Als erstes müssen wir sicher stellen das alle nötigen Pakete installiert sind um das Tool zu installieren und auszuführen
sudo apt-get install libusb-1.0-0-dev && sudo apt-get install git && sudo apt-get install build-essential

Als nächstes laden wir das Tool
git clone git://git.zerfleddert.de/hmcfgusb

und installieren es
cd hmcfgusb
make

nun Laden wir die nötige Firmware herunter und entpacken diese. Die offiziellen Updates gibt es unter http://www.eq-3.de/downloads.html
z.B. Firmware 1.2 für HM-CC-RT-DN:
wget http://www.eq-3.de/Downloads/Software/Firmware/hm_cc_rt_dn_update_V1_2_007_131202.tar.gz
tar -xvf hm_cc_rt_dn_update_V1_2_007_131202.tar.gz

Nun brauchen wir nur noch das Tool ausführen und die Seriennummer des HomeMatic Devices.

Für ein Update mit einem CUL muss folgendes eingegeben werden (/dev/ttyACM0 ist die Adresse des CULs):
sudo ./flash-ota -c /dev/ttyACM0 -f hm_cc_rt_dn_update_V1_2_007_131202.eq3 -s KEQ1234567

Für ein Update mit einem COC muss folgendes eingegeben werden (/dev/ttyAMA0):
sudo ./flash-ota -c /dev/ttyAMA0 -f hm_cc_rt_dn_update_V1_2_007_131202.eq3 -s KEQ1234567

Für ein Update mit HM-CFG-USB
sudo ./flash-ota -f hm_cc_rt_dn_update_V1_2_007_131202.eq3 -s KEQ1234567

Nun muss nur noch das HomeMatic Gerät in den Updatemodus versetzt werden, wie das geht steht in der Readme zur Firmwaredatei (Ist mit im Archiv)

== Firmware Update mit HM-CFG-USB unter Windows ==

Für ein Firmwareupdate unter Windows wird das "HomeMatic Firmware Update Tool" von eq-3 benötigt: http://www.eq-3.de/downloads.html . Das Update ist damit zur Zeit nur mit dem HM-CFG-USB-2 möglich nicht mit dem HM-CFG-LAN und dem HM-CFG-USB der ersten Generation.

Nach dem Start muss die Seriennummer des HomeMatic Device eingegeben und die Firmware Datei ausgewählt werden. Dann wird das Update Tool durch einen Klick auf den entsprechenden Button in "Bereitschaft" gesetzt und anschließend muss das HomeMatic Device in den Updatemodus versetzte werden.

Falls das Update Tool beim Auswählen der Firmware-Datei abstürzt ("Home Matic Firmware Update Tool funktioniert nicht mehr"), dann stimmt wahrscheinlich etwas mit der Firmware-Datei nicht. Die Datei darf nicht ausgepackt werden, sondern muss als ".tar.gz"-Datei, so wie heruntergeladen, benutzt werden. Außerdem gibt es Probleme, wenn die Datei mit dem Internet Explorer heruntergeladen wurde. Die Datei sollte mit einem anderen Browser heruntergeladen werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

COC am Raspberry Pi flashen

2014-07-02T12:15:25Z

Esk: install avrdude

Um (die aktuelle) [[CUL]] Firmware auf einen [[COC]] zu bringen, kann/muss man den [[COC am Raspberry Pi flashen]].

== Vorausetzung ==
Erforderliche Hardware:
* [[Raspberry Pi]]
* Busware COC

== Aktuelle Firmware kontrollieren ==
Ob ein Flashen überhaupt notwendig ist, lässt sich feststellen indem man das Changelog (http://sourceforge.net/p/culfw/code/HEAD/tree/trunk/culfw/CHANGED) und die momentan installierte Firmware kontrolliert.

An die aktuelle Firmware vom COC kommt man wie folgt:
# Anmelden am Fhem
# Öffnen der Fhem [[Konfiguration]]
# Suchen nach dem COC Namen. In meinem Falle sieht der benötigte Eintrag wie folgt aus: <code>define COC CUL /dev/ttyAMA0@38400 4624</code>
# In das Textfeld im FHEM nun folgendes eingeben <code>get COC raw V</code>

Wenn die angezeigte Firmware älter als im Changelog ist, kann man sie updaten.

== Firmware updaten/flashen ==
Zum flashen der Firmware müssen die folgenden Schritte ausgeführt werden:

# Fhem Server stoppen <code>/etc/init.d/fhem stop</code>
# Flashtool installieren <code>sudo apt-get install -y avrdude</code>
# Eine Sudo session öffnen <code>sudo -s</code>
# Aktuelle Firmware herunterladen. Bei Geräten mit "nur Funk" muss folgendes ausgeführt werden <code>sudo wget http://sourceforge.net/p/culfw/code/HEAD/tree/trunk/culfw/Devices/COC/COC.radio_only.hex?format=raw -O /tmp/COC.hex</code> bei dem anderen COC folgendes: <code>sudo wget http://sourceforge.net/p/culfw/code/HEAD/tree/trunk/culfw/Devices/COC/COC.hex?format=raw -O /tmp/COC.hex</code> Dies läd die aktuelle Flashdatei herunter und speichert sie im Verzeichnis <code>tmp</code>
# Den COC zurücksetzen und folgendes (Zeile für Zeile!) ausführen: <code>if test ! -d /sys/class/gpio/gpio17; then echo 17 > /sys/class/gpio/export; fi </code> <code>if test ! -d /sys/class/gpio/gpio18; then echo 18 > /sys/class/gpio/export; fi </code> <code>echo out > /sys/class/gpio/gpio17/direction </code> <code>echo out > /sys/class/gpio/gpio18/direction </code> <code>echo 0 > /sys/class/gpio/gpio18/value </code> <code>echo 0 > /sys/class/gpio/gpio17/value </code> <code>sleep 1 </code> <code>echo 1 > /sys/class/gpio/gpio17/value </code> <code>sleep 1 </code> <code>echo 1 > /sys/class/gpio/gpio18/value </code> 
# Anschließend kann der COC geflasht werden mit: <code>avrdude -p atmega1284p -P /dev/ttyAMA0 -b 38400 -c avr109 -U flash:w:/tmp/COC.hex</code>

[[Kategorie:HOWTOS]]

Vorlage:FHEMWiki News

2014-04-01T07:19:03Z

Esk: correct date UserTreffen

{|
{{News|02.03.2014|[[UserTreffenSuedMaerz2014|FHEM User Treffen]] in Karlsruhe am 22. März 2014 }}
{{News|29.09.2013|Fhem Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FhemWiki wird neu aufgebaut.}}
{{News|04.05.2013|FhemWiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}

Wetter und Wettervorhersagen

2013-07-18T09:35:59Z

Esk: add link to example in blog

Mit dem [http://fhem.de/commandref.html#Weather Weather command] können Wetter Vorhersagen von der Yahoo Wetterseite abgefragt werden.

Zuerst einmal besuchen wir die [http://weather.yahoo.com Yahoo Wetterseite] und öffnen den Wetterbericht für die jeweilige Stadt (z.B. [http://weather.yahoo.com/germany/berlin/berlin-638242 Berlin]). In der URL des Wetterberichtet findet sich dann die sogenannte WOEID (WHERE-ON-EARTH-ID). Sie bildet die Wetterinfos die FHEM abfragen soll und für Berlin ist dies die Nummer 638242.

In unserer fhem.cfg tragen wir dann folgendes ein:

<pre>
# ————– Wetterdaten erfassen ————-
define MeinWetter Weather 638242 3600 de
attr MeinWetter room Wettervorhersage

# — Logfile alle Wetter Daten —
define FileLog_MeinWetter FileLog ./log/meinwetter-%Y-%m.log MeinWetter
attr FileLog_MeinWetter logtype text
attr FileLog_MeinWetter room Wettervorhersage

# attr MeinWetter localicons 1

# — Wetter Icons hinzufügen —
define weblink_meinwetter weblink htmlCode {WeatherAsHtml("MeinWetter")}
attr weblink_meinwetter room Wettervorhersage
</pre>

Das hat zur folge, das FHEM nun die Wetterdaten für Berlin (638242) jede Stunde (3600) neu abholt.

[http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]

Raspberry Pi: 99 RPiutils.pm

2013-07-15T19:22:18Z

Esk: correct function names RPi* -> Rpi*

Um beim Raspberry Pi wichtige Parameter wie Temperatur, Frequenz (wichtig beim Übertakten), RAM bzw. swap, Dateisystem auf der SD-Karte bzw. dem ggf. angeschlossenen USB Stick sowie den Datentransfer über Ethernet bzw. ggf. WLAN anzuzeigen, gibt es die Routine ''99_RPiUtils.pm''. Zur Installation wird diese vom Verzeichnis .\contrib\RaspberryPi\ in das Verzeichnis .\FHEM kopiert (./ bezeichnet hier das fhem Installationsverzeichnis, beim Raspberry Pi üblicherweise ''/opt/fhem'').

31.05.2013: Solange das Modul noch nicht im SVN eingecheckt ist, kann die Version aus dem [http://forum.fhem.de/index.php?t=getfile&id=3625&rid=309 fhem Forum] verwendet werden.

Für eine Ansicht der Daten im WebFrontend werden folgende Befehle in der ''fhem.cfg'' benötigt:

<nowiki>define <name> weblink htmlCode {ShowRpiValues()}
attr <name> room <name_room></nowiki>

wobei die Parameter ''<name>'' bzw. ''<name_room>'' durch eigene, sinnvolle Namen zu ersetzen sind.

Möchte man Daten mitloggen, erfolgt dies durch folgende Einträge in ''fhem.cfg'':

<nowiki>define <name> dummy
attr <name> room <name_room>
define <name_log> FileLog ./log/<filename>-%Y-%m.log <name>
attr <name_log> room <name_room></nowiki>

<nowiki>define <name_at> at +*00:01 { fhem("set <name> ".RpiTemp(" ")) }</nowiki>
für die Temperatur,
<nowiki> define <name_at> at +*00:01 { fhem("set <name> ".RpiRamSwap("R")) }</nowiki>
für den Hauptspeicher,
<nowiki>define <name_at> at +*00:01 { fhem("set <name> ".RpiRamSwap("S")) }</nowiki>
für die Auslagerungsdatei,
<nowiki>define <name_at> at +*00:01 { fhem("set <name> ".RpiFileSystem("", "/dev/root")) }</nowiki>
für das Dateisystem,
<nowiki>define <name_at> at +*00:01 { fhem("set <name> ".RpiFileSystem("", "/dev/sda1")) }</nowiki>
für den eventuell angeschlossenen USB Stick,
<nowiki>define <name_at> at +*00:01 { fhem("set <name_at> ".RpiNetwork("", "eth0")) }</nowiki>
für den Datentransfer über Ethernet,
<nowiki>define <name_at> at +*00:01 { fhem("set <name_at> ".RpiNetwork("", "wlan0")) }</nowiki>
für die ggf. vorhandene WLAN Verbindung
<nowiki>attr <name_at> room <name_room></nowiki>
einzutragen sind. Auch hier sind die Namen durch eigene (ohne Klammern) zu ersetzen, ./ bezeichnet das Installationsverzeichnis von fhem, der Pfad kann aber durch eine eigene Pfadangabe ersetzt werden.

'''Wichtig:''' Für jeden dieser Parameter ist der komplette Block (mit unterschiedlichen Namen) anzulegen.

Die oben eingestellte Zeit von einer Minute (''00:01'') sollte ebenfalls sinnvoll variiert werden (z.B. für das Dateisystem eher Stunden, für die Temperatur eher Minuten).

Mit Hilfe einer geeigneten .gplot Datei (z.B. temp4.gplot für die Temperatur) können die aufgezeichneten Daten in einem Plot dargestellt werden.

[[Kategorie:HOWTOS]]