### 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-, EnOcean-, Z-Wave-USB-Stick, etc. für einen Zugang zu den Aktoren und Sensoren.
Ausgesprochen wird es ohne h, wie bei feminin.

### 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 430 Modulen für die unterschiedlichen Geräte oder Hilfsdienste.
- Viele Frontends, damit jeder das Passende finden kann.

### Unterstützte Protokolle (Auszug)

- eQ3 spezifisch: HomeMatic, MAX!, FS20, EM1000, FHT80b, HMS, S300, ESA2000
- KNX, ZWave, EnOcean, Philipps HUE, FRITZ!Dect, Intertechno, HomeEasy, X10
- 1Wire, Firmata, webio, panStamp, LIRC, JeeLink, RFXCOM/RFXTRX, Wireless M-Bus
- Davis VantagePro2, Oregon Scientific, Allnet
- Fernseher von LG, Panasonic, Philips, Samsung, Sony
- Geräte von Bose, Sonos, Squeezebox
- Verstärker von Denon, Onkyo, Pioneer, YAMAHA
- iTunes/AppleTV, Enigma2, XBMC/Kodi, MediaPortal, Plex
- Alexa, HomeKit, HomeBridge, MQTT (interner oder externer Server)
Eine detaillierte Beschreibung aller Geräte/Protokolle befindet sich in dem commandref Dokument.

### 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
- smartVISU: Beispiel
- Charting Frontend und YAF (Yet Another Frontend).
- Mobile Apps: Das eingebaute Web-Frontend hat eine spezielle Smartphone-Ansicht (siehe oben). Mobile Apps für Android, iOS, Windows und andere existieren von diversen Drittanbietern. Mehr Infos im Forum, Wiki und den entsprechenden App-Stores.

### Dokumentation

####
Befehlsreferenz (commandref):

commandref_DE.html enthält eine detaillierte Beschreibung aller Module und Features. DIE offizielle von den Entwicklern gepflegte, tagesaktuelle Dokumentation.

####
Ergänzende Informationsquellen:

Wiki: https://wiki.fhem.de
Forum: https://forum.fhem.de

####
Nicht nur für den FHEM-Einstieg:

Ein kleiner FHEM-Kurs (benötigt keine Hardware): Erste Schritte in FHEM
Das Einsteiger-PDF (Pflichtlektüre): Heimautomatisierung mit FHEM
Quick-Start für eine kurze Installation/Konfiguration.

### Download

Letzte Version (vom 2018-10-07): fhem-5.9.tar.gz, fhem-5.9.zip, fhem-5.9.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: 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.

### Installation

#### Debian/Ubuntu/Raspbian

- 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: Folgendes 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 einem USB-Stick auspacken, danach diesen an die 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 Quick-Start 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`

### Links

Forum: https://forum.fhem.de
Quellen: https://svn.fhem.de
Wiki: https://wiki.fhem.de
FHEM e.V.: https://verein.fhem.de
CUL/CUNO/COC/EUL/TUL-Firmware Homepage: http://culfw.de

### Lizenz:

Copyright:

- Rudolf Koenig (rudolf punkt koenig at fhem punkt de). Achtung: Ich leiste keinen 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)