### Beschreibung

FHEM (eingetragene Marke) ist ein in Perl geschriebener, GPL lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.Bsp. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren. Für weitere Ideen siehe diesen Link.
Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.
Um es zu verwenden benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem perl Interpreter und angeschlossene Hardware-Komponenten wie CUL, FHZ1300PC, etc. für einen Zugang zu den Aktoren und Sensoren. Siehe den Hardware Abschnitt für mehr.
Ausgesprochen wird es ohne h, wie bei feminin.

### Download

Letzte Version (vom 2017-02-19): fhem-5.8.tar.gz, fhem-5.8.deb,
Siehe auch das manuelle (CHANGED file) oder maschinelle (SVNLOG) Änderungsprotokoll für mehr Details.
Achtung: FHEM wird kontinuierlich weiterentwickelt, und die hier herunterladbaren Versionen sind nur als Startpunkt für den update Prozess gedacht.
Bitte das FHEM update Kommando ausfuehren, um den aktuellen Stand herunterzuladen, insb. bevor man Probleme im Forum meldet.
Nächtlich erstellte Versionen: fhem-cvs.tgz, debian.fhem.de
Verwenden sie bitte den fheminfo Befehl in FHEM, da wir gerne wüssten, welche FHEM Module verwendet werden. Hier sind die Ergebnisse.

### Frontend Screenshots

- Das eingebaute web frontend: Übersicht auf dem Desktop bzw. Smartphones, SVG-plots.
- Das FHEM FLOORPLAN Modul: Beispiel1, Beispiel2, LCars.
- Das InfoPanel Modul, FHEM Tablet UI: Beispiel1, Beispiel2 und SmartVisu
- Charting Frontend und YAF (Yet Another Frontend).
- myHCE: Bilder-Galerie, HomeMini: Screenshot & Download
- iPhone Frontends: Fhemobile (native app), dhs-computertechnik or phyfhem
- Android Frontends: andFHEM (natives App), Fullscreen Browser App, ORCA addition

### Features

- Unterstützung vieler in der Hausautomation üblicher Protokolle, Fernseh- oder Audiogeräte, Wetterdienste, Online-Kalender, und mehr.
- Plug & play: Bei vielen Protokollen werden die FHEM-Einträge automatisch beim Empfang der Funktelegramme angelegt, zusammen mit der Definition der Logdatei und etwaiger Visualisierung. Einfach FHEM mit angeschlossenen USB-Hardware starten, und zusehen, wie die Plots der Sensoren auf der Webseite nacheinander auftauchen.
- Ereignisse in Dateien oder Datenbanken loggen, optionale Filterung mit regexp.
- Beim Auftreten definierbarer Ereignisse externe Programme bzw. Skripte starten.
- Zeitabhängige Befehle (z.Bsp. die Lampe vom Sonnenuntergang bis Mitternacht einschalten).
- Diverse Schnittstellen: ASCII, JSON, XML, jeweils über TCP/IP, SSL, HTTP oder HTTPS.
- Modulare Architektur mit über 150 Modulen für die unterschiedlichen Geräte oder Hilfsdienste.
- Viele Frontends, damit jeder das Passende finden kann.

### Unterstützte Protokolle (Auszug)

- eQ3 spezifisch: FS20, HomeMatic, MAX!, EM1000, FHT80b, HMS, S300, ESA2000
- KNX, ZWave, EnOcean, X10, FRITZ!Dect, Intertechno, HomeEasy, Philipps HUE
- 1Wire, Firmata, webio, panStamp, LIRC, JeeLink, RFXCOM/RFXTRX, TellStick
- Davis VantagePro2, Oregon Scientific, Allnet
- Fernseher von Samsung/Panasonic/LG/Philips, Geräte von Sonos/Squeezebox, Verstärker von YAMAHA/Denon/Onkyo, iTunes/AppleTV, Enigma2, XBMC
Eine detaillierte Beschreibung aller Geräte/Protokolle befindet sich in dem commandref Dokument.

### Dokumentation

Heimautomatisierung-mit-fhem.pdf
commandref_DE.html enthält eine detaillierte Beschreibung aller Module und Features.
Unser Wiki ist erreichbar unter https://wiki.fhem.de
Forum: https://forum.fhem.de
HOWTO_DE.html für eine kurze Installation/Konfiguration.
meintechblog.de: Blog mit HOWTOs über FHEM-Themen</dist>
Das F.A.Q. faq.html (englisch)
contrib/README beschreibt einige nicht aktiv gepflegte Module / Skripte.

### Links

Homepage: http://fhem.de/fhem_DE.html
Quellen: https://svn.fhem.de
Betriebsystem/Gerätspezifisch Dokumentation:

- Anweisungen für den FRITZ!Box (englisch)
- Anweisungen für Nas/Router (NSLU2): http://www.martin-haas.de/fhz/nslu2fhz (english)
- Anweisungen für Synology Diskstation / Rackstation: http://www.fischer-net.de/hausautomation/fhem.html
- Anweisungen für den Allnet all6250: http://wiki.dungeon.de/all6250_opennas_mit_fhem
- Raspberry PI mit EnOcean
- Linux Treiber Installation : http://fhem.de/linux.html(nur im Problemfall, english)
- Diverse USB Probleme: http://fhem.de/USB.html (english)
- Russels Blog for Windows user: http://russellallen.info/category/FHEM.aspx (english)
- Windows driver installation: http://fhz4linux.info/tiki-index.php?page=Driver%20installation
  (english, use "Solution B", only COM1..COM9 is supported)

Kommerzielle Produkte:

- http://www.dhs-computertechnik.de
- CUL/CUNO/COC/EUL/TUL: Hardware shop, firmware homepage, CUL fans google group

### Installation

#### Debian/Ubuntu

- Dieses FHEM Paket (.deb) installieren. Für eine bessere Integration siehe debian.fhem.de.

#### Unix / OSX

- Zuerst sollte sichergestellt werden, dass perl installiert ist. Vermutlich wird das Perl-Modul Device::SerialPort benötigt (falls man mit FHEM USB-Geräte ansprechen möchte), diesen kann man meist mit "sudo cpan Device::SerialPort" oder "apt-get install libdevice-serialport-perl" installieren.
- Dieses FHEM Paket herunterladen, auspacken, und in das neu erstellte Verzeichnis wechseln.
- Starten sie FHEM mit
  `perl fhem.pl fhem.cfg`

#### Windows

- Siehe HOWTO_Windows.html für eine detaillierte Beschreibung.
- Falls Sie FHEM unter cygwin installieren wollen, dann können Sie die Installationsanleitung für UNIX befolgen.

#### Fritz!Box

Seit Fritz!OS 6.20 ist es nicht mehr möglich "fremde" Programme nach einem reboot automatisch zu starten, deswegen empfehle ich den Einsatz dieser Geräte nicht für FHEM, siehe auch diesen Beitrag im Forum. Für die, die es trotzdem versuchen wollen:
- FB7390/FB7490: Folgenden FHEM Image zusätzlich zum normalen oder labor Image von AVM installieren. Beide sind vollkommen unabhängig und deswegen jeweils austauschbar.
- FB7270: Diese zip Datei auf dem USB-Disk auspacken, danach es ans FritzBox anschliessen, per telnet anmelden, ins Verzeichnis wechseln, und FHEM von hier starten.
- Siehe auch die detaillierte Dokumentation hier.

Nach der Installation sollten sie das Dokument HOWTO_DE befolgen, um in FHEM Geräte zu definieren oder die Demo-Konfiguration ausprobieren, indem sie FHEM mit folgenden Befehl starten:

`perl fhem.pl fhem.cfg.demo`

### Lizenz:

Copyright:

- Rudolf Koenig (r punkt koenig at koeniglich punkt de). Achtung: Ich leiste kein FHEM support über Email, bitte verwenden sie das Forum für diesen Zweck.
- Zahlreiche weitere Entwickler, die jeweils zu FHEM beigetragen haben.

License: GPL (v2)
Vielen Dank an TOSTi für die Inspiration.