FHEMWiki - Benutzerbeiträge [de]

Systemübersicht

2014-01-29T17:47:20Z

Elmar: HM links hinzugefuegt

Ein Fhem '''System''' besteht im Prinzip aus den in der nachfolgenden '''Übersicht''' aufgeführten Bestandteilen.
[[Datei:Systemübersicht.png]]

<div style="float: right;">__TOC__</div>

== Server ==
Bei der Komponente '''Server''' muss unterschieden werden zwischen dem eigentlichen '''Fhem''' Hausautomations-Server (implementiert in der Perl-Datei fhem.pl) und der Hardware, auf der dieser Server ausgeführt wird.

Als Server '''Hardware''' sind (z. B.) möglich:
* Windows Rechner
* Linux Rechner
* OS X Rechner
* Router (z. B. [[AVM Fritz!Box|FritzBox]])
* Einplatinencomputer, wie [[:Kategorie:Raspberry Pi|Raspberry Pi]], BeagleBone
* DockStar, PogoPlug, etc.
* diverse NAS Systeme wie Buffalo Linkstation, Synology Diskstation
(Diese Aufstellung ist nur eine unvollständige Auswahl; Details zu unterstützten Server Systemen finden sich in der Kategorie [[:Kategorie:Server Hardware|Server Hardware]]).

== Konfiguration ==
Das Hausautomations-System wird definiert über die [[Konfiguration]], die im Regelfall besteht aus der
* Datei <code>fhem.cfg</code> und
* eventuell weiteren, eigenen Dateien (<code>*.cfg</code>), die mittels <code>include</code> Anweisungen eingebettet werden.

Die Konfiguration enthält Definitionen für die Bestandteile (Geräte) und Funktionen des jeweiligen Hausautomations-Systems. Die verfügbaren Befehle und deren Syntax sind in der Befehlsreferenz ([http://fhem.de/commandref.html commandref]) aufgeführt und beschrieben. Zu einigen Hilfsmodulen gibt es [[:Kategorie:Hilfsmodul|detaillierte Beschreibungen]] mit Beispielen.

== Frontends ==
Der Zugriff auf FHEM erfolgt mittels Webbrowser oder App über die verfügbaren '''[[:Kategorie:FHEM Frontends|Fhem Frontends]]'''.

In den Fhem Server integriert ist ein Webserver ([[PGM2]]), der im Prinzip immer zur Verfügung steht. Abhängig vom benutzten Klienten ist PGM2 über <code>serverhostnameoderIP:8083/fhem</code> (oder Port 8084 (Smartphone) oder Port 8085 (Tablet)) erreichbar.

Eine Auswahl der Interfaces:
* PGM2 - das Standardinterface
* [[AndFHEM]] - eine Android App
* [[Fhemobile]] - iPhone App

== Module ==
Die Funktionalität von Fhem kann über '''Module''' erweitert werden. Beispiele für Module:
* 00_CUL.pm - Implementierung der Unterstützung für den [[CUL]]
* 11_FHT.pm - Unterstützung der [[:Kategorie:FHT Components|FHT]] Heizungssteuerung
* 95_FLOORPLAN.pm - Grundriss (oder Ähnliches) als Benutzeroberfläche
* ...

== Interfaces ==
Die Verbindung zu den angeschlossenen '''Geräten''' der Hausautomation wird im Allgemeinen - geräteabhängig - über [[Interface|Interfaces]] (manchmal auch als '''Gateway''' bezeichnet) hergestellt. Das kann z. B. im Falle von [[HomeMatic]] ein [[HMLAN Konfigurator]] sein, ein mittels LAN mit dem Fhem Server verbundenes Gerät, das die Fhem Steuerbefehle in das HomeMatic Funkprotokoll umsetzt - und auch die Funktelegramme der HomeMatic Komponenten an Fhem zurückgibt. Entsprechende Interfaces gibt es auch für andere Funkprotokolle und für die drahtgebundenen Systeme.

Eine (unvollständige) Liste solcher Interfaces:
* [[CUL]] - je nach Einstellung für die Kommunikation mit [[:Kategorie:FS20 Components|FS20]], [[:Kategorie:FHT Components|FHT]] und andere [[SlowRF]] Protokolle, [[MAX]]! Heizungssteuerung oder [[:Kategorie:HomeMatic Components|HomeMatic]] und, mit Einschränkungen, InterTechno (nur senden)
* [[CUNO]], ähnlich CUL, jedoch nicht per USB sondern per IP angebunden (z.Zt. -Stand Januar 2014 - nicht für HomeMatic empfohlen)
* [[HMLAN Konfigurator|HomeMatic LAN Konfigurations-Adapter]] - HomeMatic
* Schnittstellen(karten) für [[:Kategorie:1-Wire|1-Wire]]
* TCM(120/130) zur Anbindung von [[:Kategorie:EnOcean|EnOcean]]
* [[Arduino]] mit Firmata über USB oder Netzwerk
* [[panStamp]] als Möglichkeit arduinos mit diversen Sensor- und I/O- Boards per 868MHz Funk anzubinden
* [[Jeelink]], ein weiteres USB-Stick Interface (ebenfalls arduino basiert) für diverse 433MHz und 868MHz Komponenten
* [[RFXtrx]] für InterTechno, RSL, ELRO etc., Wetter-Sensoren (Oregon-Scientific, Cresta, La Crosse, TFA, UPM) und andere 433 Mhz Geräte.
* manche Komponenten ([[:Kategorie:IP Components|IP Komponenten]]) können über TCP/IP (LAN) direkt vom Fhem Server aus angesprochen werden; hier ist dann kein weiteres Interface im eigentlichen Sinne erforderlich.

== Protokolle ==
Der Kommunikation zwischen Interfaces und Geräten liegt jeweils ein bestimmtes Protokoll zugrunde. Unterstützte Protokolle mit ihren Eigenschaften sind in der folgenden Tabelle aufgelistet.


{| class="wikitable sortable"
|+ Übersicht über unterstützte Funkprotokolle
|-
! Name !! rfMode !! Frequenz !! Modulation !! Datenrate !! class="unsortable" | Interfaces !! class="unsortable" | Modul !! class="unsortable" | Geräte (Beispiel) !! class="unsortable" | Bemerkungen
|-
| FS20 || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#FS20 FS20] || - || -
|-
| FHT || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_FHTTK FHTTK], [http://fhem.de/commandref.html#FHT FHT] || Heizungsregelung || -
|-
| S300 || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_WS CUL_WS] || Temperatur-/Feuchtesensoren || -
|-
| HMS || SlowRF || 868,35MHz || AM || 1kHz || CU*O, FHZ || - || ?? || -
|-
| EM || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_EM CUL_EM] || Energiemonitore (Strom, Gas) || -
|-
| [[HomeMatic ]]|| HomeMatic || 868,35MHz || FM || 20kHz || CU*, [[HM-CFG-LAN_LAN_Konfigurations-Adapter|HMLan]], [[HM-CFG-USB_USB_Konfigurations-Adapter|HMUsb]] || [http://fhem.de/commandref.html#CUL_HM CUL_HM] || [[:Kategorie:HomeMatic_Components|diverse]] || -
|-
| MAX! || MAX || 868,35MHz || FM || 20kHz || CU*, || - || - || -
|-
| IT || - || 433MHz || AM? || 1kHz || CU*433, || - || - || -
|-
| FRM || - || ?? || ?? || ?? || ?? || - || ?? || -
|-
| SWAP || - || 868 (433/915) MHz || GFSK || 38.3835 Kbps || panStamp (+panStick) || [http://fhem.de/commandref.html#SWAP SWAP] || RGB LED Driver, diverse Sensoren und Aktoren || -
|-
| EnOcean || - || 315 / 868 / 902 / 928MHz || ASK || 125 kbit/s || TCM || [http://fhem.de/commandref.html#TCM TCM] || Batterielose Funksensoren, diverse Aktoren || -
|-
| PCA || - || 868,35MHz || ?? || ?? || [[Jeelink]] || [http://fhem.de/commandref.html#PCA301 36_PCA301.pm] || [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] || -
|-
| LaCrosse || - || 868,35MHz || ?? || ?? || [[Jeelink]] || [http://fhem.de/commandref.html#LaCrosse 36_LaCrosse.pm] || LaCrosse IT+ (Technoline) Sensoren || -
|-
| colspan="9" | ''Tabelle muss noch vervollständigt werden''
|-
| colspan="2" | '''Legende:'''
| colspan="7" | CU* = CUL, CUN, CUNO /
|}

== Komponenten ==
Der eigentliche Zweck eines Hausautomatisierungs-Projekts sind dann letztendlich die '''Geräte''' (Komponenten / Aktoren / [[:Kategorie:Schalter (Empfänger)|Empfänger]]), die automatisch gesteuert werden sollen, bzw. auch Auslöser für Aktionen ([[:Kategorie:Schalter (Sender)|Sender]]) und Lieferant von Datenmaterial ([[:Kategorie:Temperatursensor|Sensoren]]) sind.

Diese Geräte sind, sofern es eine detaillierte Beschreibung dazu gibt, in den jeweiligen Unterseiten der [[:Kategorie:Hardware|Hardwareliste]] aufgeführt.

== Weblinks ==
* [http://www.enocean.com/de/home/ EnOcean] Homepage
* [http://www.elv.de ELV], (Haupt-)Lieferant von FS20, FHT, HomeMatic
* [http://www.panstamp.com panStamp], panStamp Hersteller
* [http://jeelabs.com/products/jeelink Jeelabs], Jeelink Hersteller

[[Kategorie:FHEM]]

HM-CFG-USB USB Konfigurations-Adapter

2014-01-28T16:25:13Z

Elmar: /* Einrichtung unter Linux */

Der [[HomeMatic]] '''USB Konfigurations-Adapter''' ist ein USB-Stick, der außer zur Konfiguration von HomeMatic Komponenten auch als [[Interface]] zwischen Fhem und HomeMatic Geräten benutzt werden kann.

== Einbindung in FHEM ==
Im Fhem-Forum wird das Thema diskutiert unter dem Titel [http://forum.fhem.de/index.php/topic,13071.msg86075.html#msg86075 HomeMatic USB Konfigurations-Adapter (HM-CFG-USB) in Fhem nutzen]. Teile der Informationen sind hier zusammengefasst.

=== Einrichtung unter Linux ===
Es gibt einen gut funktionierenden Daemon um den USB Stick mit Fhem zum laufen zu bekommen. Dabei wird zuerst der [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb hmland] installiert und danach das Gerät (üblicherweise auf localhost) genau wie [[HM-CFG-LAN LAN Konfigurations-Adapter|HMLAN]] in Fhem eingebunden.

Zunächst muss der Daemon "gebaut" werden. Analog zu [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb dieser Beschreibung] ist die Vorgehensweise die folgende (in Debian/Ubuntu/Raspbian):
cd /opt/
apt-get install build-essentials libusb-1.0-0-dev make gcc git-core
git clone git://git.zerfleddert.de/hmcfgusb
cd hmcfgusb
make

(Unter xbian ist "build-essentials" nicht als Paket vorhanden. Einfach weglassen.)

Danach kann der Dienst zu Testzwecken gestartet werden (in /opt/hmcfgusb):
:<code>./hmland -p 1234 -D</code>

Um den Deamon permanent laufen zu lassen, kann ein init script wie das Folgende verwendet werden:
<pre>
# simple init for hmland

pidfile=/var/run/hmland.pid
port=1234

case "$1" in
start|"")
chrt 50 /opt/hmcfgusb/hmland -r 03:30 -d -P -l 127.0.0.1 -p $port 2>&1 | perl -ne '$|=1; print localtime . ": [hmland] $_"' >> /var/log/hmland.log &
;;
restart|reload|force-reload)
echo "Error: argument '$1' not supported" >&2
exit 3
;;
stop)
killall hmland
;;
status)
if [ ! -e $pidfile ]; then
echo "No pid"
exit 1
fi
pid=`cat $pidfile`
if kill -0 $pid &>1 > /dev/null; then
echo "Running"
exit 0
else
rm $pidfile
echo "Not running"
exit 1
fi

;;
*)
echo "Usage: hmland [start|stop|status]" >&2
exit 3
;;
esac
</pre>

Bei Distributionen die Upstart einsetzen (z.B. xbian) kann folgendes Konfigurationsfile verwendet werden:
<pre>
# HMLAND

description "hmland"

start on starting fhem
stop on stopped fhem

respawn
expect fork

chdir /opt/hmcfgusb
exec /opt/hmcfgusb/hmland -d -l 127.0.0.1 -p 1234
</pre>

Die Datei sollte als "/etc/init/hmland.conf" angelegt werden. Mit dem Befehl
initctl reload-configuration
wird Upstart angewiesen, seine Konfiguration erneut einzulesen. Danach kann der neue Dienst
mit
service hmland start
gestartet werden. <code>hmland</code> wird jetzt immer vor FHEM gestartet und nach FHEM beendet.

=== Einrichtung unter Windows ===
< Todo >

== Bekannte Probleme ==

=== Raspberry Pi ===
Der Raspberry Pi hat leider einen recht schlechten USB Treiber für USB 2.0. Daher sieht man dort öfter Fehlermeldungen:
usb-transfer took more than 100ms (1039ms), this may lead to timing problems!

Da das Timing bei Homematic wichtig ist führt das zu vielen Retransmits und zu unzuverlässigen Aktoren. Als Workaround kann man den USB auf 1.1 stellen. Dazu führt man folgenden Text am Anfang der /boot/cmdline.txt ein:
dwc_otg.speed=1

Danach sieht sie dann in etwa so aus:
dwc_otg.speed=1 dwc_otg.lpm_enable=0 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 elevator=deadline rootwait

== Weitergehende Informationen ==
Es sind zwei Versionen des HM-CFG-USB im Umlauf:
* HM-CFG-USB-2: die aktuelle Version; Dokumentation derzeit (12/2013) nicht über die ELV-Artikelseite verfügbar, alternativ jedoch bei [http://files.voelkner.de/625000-649999/640558-an-01-ml-USB_FUNK_KONFIGURATIONSADAPTER_de_en.pdf Völkner]; Kennzeichen dieser Version:
** Größe: 28 x 84 x 11,5 mm
** Gewicht: 18 g
** Antenne innenliegend
* HM-CFG-USB: Vorgängerversion; Stand 12/2013 noch Restbestände im Handel verfügbar. Dokumentation ([http://files.voelkner.de/625000-649999/646462-an-01-ml-HM_Konfigurationsadapter_CFG_USB_de_en.pdf Völkner]); Kennzeichen:
** Anschluss per separatem USB-Kabel
** abstehende Stabantenne
** Größe: 40 x 90 x 25 mm
** Gewicht: 45 g

== Links ==
* [http://forum.fhem.de/index.php/topic,13071.msg86075.html#msg86075 FHEM Forum: HomeMatic USB Konfigurations-Adapter (HM-CFG-USB) in Fhem nutzen]
* [http://www.elv.de/homematic-usb-konfigurations-adapter-1.html ELV- / Herstellerinformationen] zum HM-CFG-USB

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HM-CFG-USB USB Konfigurations-Adapter

2014-01-28T16:23:39Z

Elmar: Konfiguration als Daemon mit Upstart

Der [[HomeMatic]] '''USB Konfigurations-Adapter''' ist ein USB-Stick, der außer zur Konfiguration von HomeMatic Komponenten auch als [[Interface]] zwischen Fhem und HomeMatic Geräten benutzt werden kann.

== Einbindung in FHEM ==
Im Fhem-Forum wird das Thema diskutiert unter dem Titel [http://forum.fhem.de/index.php/topic,13071.msg86075.html#msg86075 HomeMatic USB Konfigurations-Adapter (HM-CFG-USB) in Fhem nutzen]. Teile der Informationen sind hier zusammengefasst.

=== Einrichtung unter Linux ===
Es gibt einen gut funktionierenden Daemon um den USB Stick mit Fhem zum laufen zu bekommen. Dabei wird zuerst der [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb hmland] installiert und danach das Gerät (üblicherweise auf localhost) genau wie [[HM-CFG-LAN LAN Konfigurations-Adapter|HMLAN]] in Fhem eingebunden.

Zunächst muss der Daemon "gebaut" werden. Analog zu [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb dieser Beschreibung] ist die Vorgehensweise die folgende (in Debian/Ubuntu/Raspbian):
cd /opt/
apt-get install build-essentials libusb-1.0-0-dev make gcc git-core
git clone git://git.zerfleddert.de/hmcfgusb
cd hmcfgusb
make

Danach kann der Dienst zu Testzwecken gestartet werden (in /opt/hmcfgusb):
:<code>./hmland -p 1234 -D</code>

Um den Deamon permanent laufen zu lassen, kann ein init script wie das Folgende verwendet werden:
<pre>
# simple init for hmland

pidfile=/var/run/hmland.pid
port=1234

case "$1" in
start|"")
chrt 50 /opt/hmcfgusb/hmland -r 03:30 -d -P -l 127.0.0.1 -p $port 2>&1 | perl -ne '$|=1; print localtime . ": [hmland] $_"' >> /var/log/hmland.log &
;;
restart|reload|force-reload)
echo "Error: argument '$1' not supported" >&2
exit 3
;;
stop)
killall hmland
;;
status)
if [ ! -e $pidfile ]; then
echo "No pid"
exit 1
fi
pid=`cat $pidfile`
if kill -0 $pid &>1 > /dev/null; then
echo "Running"
exit 0
else
rm $pidfile
echo "Not running"
exit 1
fi

;;
*)
echo "Usage: hmland [start|stop|status]" >&2
exit 3
;;
esac
</pre>

Bei Distributionen die Upstart einsetzen (z.B. xbian) kann folgendes Konfigurationsfile verwendet werden:
<pre>
# HMLAND

description "hmland"

start on starting fhem
stop on stopped fhem

respawn
expect fork

chdir /opt/hmcfgusb
exec /opt/hmcfgusb/hmland -d -l 127.0.0.1 -p 1234
</pre>

Die Datei sollte als "/etc/init/hmland.conf" angelegt werden. Mit dem Befehl
initctl reload-configuration
wird Upstart angewiesen, seine Konfiguration erneut einzulesen. Danach kann der neue Dienst
mit
service hmland start
gestartet werden. <code>hmland</code> wird jetzt immer vor FHEM gestartet und nach FHEM beendet.

=== Einrichtung unter Windows ===
< Todo >

== Bekannte Probleme ==

=== Raspberry Pi ===
Der Raspberry Pi hat leider einen recht schlechten USB Treiber für USB 2.0. Daher sieht man dort öfter Fehlermeldungen:
usb-transfer took more than 100ms (1039ms), this may lead to timing problems!

Da das Timing bei Homematic wichtig ist führt das zu vielen Retransmits und zu unzuverlässigen Aktoren. Als Workaround kann man den USB auf 1.1 stellen. Dazu führt man folgenden Text am Anfang der /boot/cmdline.txt ein:
dwc_otg.speed=1

Danach sieht sie dann in etwa so aus:
dwc_otg.speed=1 dwc_otg.lpm_enable=0 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 elevator=deadline rootwait

== Weitergehende Informationen ==
Es sind zwei Versionen des HM-CFG-USB im Umlauf:
* HM-CFG-USB-2: die aktuelle Version; Dokumentation derzeit (12/2013) nicht über die ELV-Artikelseite verfügbar, alternativ jedoch bei [http://files.voelkner.de/625000-649999/640558-an-01-ml-USB_FUNK_KONFIGURATIONSADAPTER_de_en.pdf Völkner]; Kennzeichen dieser Version:
** Größe: 28 x 84 x 11,5 mm
** Gewicht: 18 g
** Antenne innenliegend
* HM-CFG-USB: Vorgängerversion; Stand 12/2013 noch Restbestände im Handel verfügbar. Dokumentation ([http://files.voelkner.de/625000-649999/646462-an-01-ml-HM_Konfigurationsadapter_CFG_USB_de_en.pdf Völkner]); Kennzeichen:
** Anschluss per separatem USB-Kabel
** abstehende Stabantenne
** Größe: 40 x 90 x 25 mm
** Gewicht: 45 g

== Links ==
* [http://forum.fhem.de/index.php/topic,13071.msg86075.html#msg86075 FHEM Forum: HomeMatic USB Konfigurations-Adapter (HM-CFG-USB) in Fhem nutzen]
* [http://www.elv.de/homematic-usb-konfigurations-adapter-1.html ELV- / Herstellerinformationen] zum HM-CFG-USB

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]