fhem für Einsteiger - Home

fhem für Einsteiger 


Einleitung und Grundlagen ...................................................................................................................... 2 

Hardware-Systeme .................................................................................................................................. 2 

Welche Hardware wird benötigt? ........................................................................................................... 3 

Die fhem-Oberfläche ............................................................................................................................... 4 

Der Hauscode .......................................................................................................................................... 5 

Sensoren .................................................................................................................................................. 5 

Anlernen von Sensoren in fhem .............................................................................................................. 7 

Anlernen von Aktoren (Pairing) ............................................................................................................... 8 

Dimmer .................................................................................................................................................... 8 

Timer ....................................................................................................................................................... 9 

Schalten zu bestimmten Zeitpunkten ..................................................................................................... 9 

Pairing: Direkt vs. Indirekt ....................................................................................................................... 9 

Ereignis-gesteuerte Schaltungen - notify .............................................................................................. 11 

Geräte-Eigenschaften: Modell und Raum ............................................................................................. 11 

Mehrere Geräte mit einem klick schalten - Strukturen ........................................................................ 12 

Infoquellen ............................................................................................................................................ 12 

Fritzbox .................................................................................................................................................. 13 

Schichtenmodell & Zugänge .............................................................................................................. 13 

Telnet ................................................................................................................................................. 14 

Sammelsurium ....................................................................................................................................... 14 

Fhemupdate .................................................................................................................................. 18 

iPad-Frontend ................................................................................................................................ 18 

fhem für Einsteiger V 1.0 Seite 1


Einleitung und Grundlagen 

Wenn Sie das erste Mal einen Blick auf FHEM werfen, hier ein paar grundsätzliche Erklärungen. 

Das Ziel ist: Wenn ich auf einen Schalter drücke, soll das Licht angehen; Wenn es kalt ist, soll die 

Heizung eingeschaltet werden; Bei Sonnenaufgang soll die Gartenwegbeleuchtung ausgehen; Um 7 

Uhr morgens soll der Rolladen hochfahren, sofern ich nicht in Urlaub bin. Alles das lässt sich mit fhem 

bewerkstelligen. 

In der Welt der Heimautomatisierung gibt es dafür drei Gruppen von Geräten: 

1. Sensoren (also Thermometer, Lichtschalter, Bewegungsmelder, Dimmer etc. - also jedes 

Gerät, das eine Mitteilung an das System erzeugt). 

2. Aktoren (also Steckdosenschalter, Unterputzschalter, Rolladen-Motoren etc. - also jedes 

Gerät, das Befehle vom System entgegennimmt und umsetzt). 

3. Ein Sender&Empfänger, der an einem PC oder einfachen Computer (z.B. einem NAS oder 

einer Fritz!Box) angeschlossen ist. Dieses Gerät heißt ‚CUL‘. 

Die einfachste Version, die Sie daraus gestalten können, ist: Es gibt mehrere Sensoren (z.B. 

Lichtschalter), die Geräte steuern sollen, also z.B. eine Lampe ein- oder ausschalten. Derselbe 

Schalter soll evtl. auch mehrere Geräte (also Aktoren) bedienen. Es sollen evtl. auch mehrere 

Schalter gleichartig funktionieren, z.B. soll im Schlafzimmer das Licht sowohl vom Lichtschalter an der 

Wand als auch von der Fernbedienung am Bett bedienbar sein. Alle Schaltvorgänge sollen auch von 

einem Webfrontend auf einem Computer und vielleicht auch von einer App auf einem mobilen Gerät 

gesteuert möglich sein. Eine solche Konfiguration können Sie ganz ohne Programmieren erreichen, 

es braucht nur einiges technisches Grundverständnis. 

Wenn Sie Aktoren ausschließlich vom Webfrontend (also ohne physischen Schalter) bedienen 

wollen, müssen Sie diese durch wenige einfache Programmzeilen ‚hinzuprogrammieren‘. 

Das Zusammenfassen von mehreren Aktoren in Räumen mit gemeinsamer Schaltung vom 

Webfrontend aus ist ebenfalls mit wenigen Programmzeilen recht einfach (also z.B. alle Lampen im 

Schlafzimmer sollen mit nur einem Tastendruck ausgehen). 

Wenn Sie weitergehende Möglichkeiten nutzen möchten, wie z.B. Zeitsteuerungen wie Laufzeiten, 

Sonnenauf-/-untergang, Ferienkalender, Thermostatgeführte Heizungssteuerung etc., müssen Sie 

zunehmend tief in die fhem-Programmierung einsteigen. 

Fhem ist sehr umfangreich. Es bietet die Möglichkeit, einfache Konfigurationen ohne 

Programmierkenntnisse zu erstellen, wie auch eine komplexe Heimautomatisierung, die eben 

Programmierung benötigt. Diese Beschreibung richtet sich zunächst an die Benutzer, die möglichst 

einfach starten möchten. 

Hardware-Systeme 

Es gibt mehrere unterschiedliche Hardware-Systeme, die mit fhem gesteuert werden können. In 

dieser Beschreibung werden nur zwei erwähnt, das erste heißt FS20. Wenn Sie keine Ahnung haben, 

was das ist, nimmt der Autor an, dass Sie eine Heimautomatisierung mit möglichst geringen 

Hardwarekosten suchen. Das ist FS20 :-) Die Geräte dafür werden im Wesentlichen von den Firmen 



ELV und Conrad vertrieben. Wenn Sie auf deren Webseiten den Suchbegriff ‚FS20‘ eingeben, 

bekommen Sie eine bebilderte Übersicht der anschließbaren Geräte. 

In FS20 können Sensoren ausschließlich senden und Aktoren ausschließlich empfangen (der 

Lichtschalter kann nur senden, die Steckdose nur empfangen). Das ist eigentlich ausreichend – bis 

ein Aktor (Steckdose) z.B. durch eine Funkstörung oder wegen schlechter Laune mal einen Befehl 

verpasst. Das FS20-System geht einfach davon aus, dass der Befehl ausgeführt wurde. In einem 

vergleichbaren System namens HomeMatic hingegen können Aktoren auch senden, sie senden also 

eine Bestätigung, dass sie den Befehl auch wirklich ‚gehört‘ haben. Das ist zwar noch keine absolute 

Garantie, dass der Befehl auch wirklich umgesetzt wurde, aber immerhin gibt es ein feedback. Bleibt 

dieses aus, kann z.B. der Befehl erneut gesendet oder eine Warnmeldung ausgegeben werden. 

HomeMatic-Komponenten sind also etwas zuverlässiger, aber auch teurer (sie kosten etwa da 

Doppelte). Wenn Sie kritische Geräte steuern möchten (wenn also z.B. Ihre Rolladen auch als 

Einbruchsicherung dienen und daher definitiv geschlossen sein sollen), können Sie HomeMatic in 

Erwägung ziehen. Wenn es lediglich um das Ein- oder Ausschalten von Lampen u.ä. geht, oder Sie für 

gewöhnlich zuhause sind und die Schaltergebnisse selbst sehen, ist FS20 wahrscheinlich ausreichend. 

Die Erfolgsquote beim Schalten von FS20-Geräten liegt bei mittleren Entfernungen, mittleren 

Eigenschaften der Wände und gutem Batterie-Ladestand der Sensoren (=Sender) bei gefühlten 95- 

98%. 

Sowohl HomeMatic als auch FS20-Systeme lassen sich mit fhem ("Freundliche Hausautomation und 

Energie-Messung") steuern. Eine Mischung beider Systeme ist möglich – allerdings benötigen Sie 

dann ein CUL je System -also einen für FS20, einen für HM. 

Im Weiteren wird zunächst nur auf FS20 eingegangen. 

Welche Hardware wird benötigt? 

Sie benötigen den Sender&Empfänger. Die unterschiedlichen Systeme bedienen sich 

unterschiedlicher Sender. Für FS20 wie HM ist neben anderen auch ein gemeinsamer Sender 

verfügbar. Sieht aus wie ein USB-Stick, kann in einen PC, einen NAS oder eine Fritz!Box gesteckt 

werden und nennt sich CUL. Zu beziehen z.B. von busware.de . Eine Alternative bildet der CUNO: 

Ebenfalls von busware zu beziehen, wird jedoch nicht über USB, sondern über LAN angebunden. Von 

demselben Anbieter gibt es auch die Geräte TuxRadio und TuxRail – beide bieten nicht nur die Sende- 

Funktionalität, sondern haben auch einen Prozessor und RAM – sie sind also ein Mini-Computer incl. 

Linux und fhem, es wird also kein weiteres Gerät (wie z.B. eine Fritz!Box) benötigt. Der CUL ist jedoch 

das am weitesten verbreitetste und damit am besten getestete Gerät und wird daher empfohlen. Im 

weiteren Text wird nur CUL erwähnt, der dann synonym für „CUL, CUNO‚Tuxradio oder Tuxrail“ 

steht. 

Das CUL von busware kann leider nur ohne Firmware bestellt werden. Daher müssen Sie zunächst die 

fhem-kompatible Firmware selbst auf den CUL brennen (‚flashen‘). Seit fhem 5.1 gibt es den fhem- 

Befehl CULflash – bitte in der commandref nachschauen. 

Sie müssen den Sender betreiben. Es gibt unterschiedliche Geräte, an denen der Sender betrieben 

werden kann: Ein PC mit Windows oder Linux, einige NAS-Geräte oder auch eine Fritz!Box. Da es in 

vielen Haushalten auch um das Sparen von Strom geht, nutzen Sie am besten ein Gerät, das ohnehin 

ständig eingeschaltet ist. 



Da ich meine Telefonanlage und Heimnetzwerk mit einer Fritz!Box 7390 betreibe, ist dies in meinem 

Haushalt das ideale Gerät: Es ist ständig eingeschaltet, es stellt eine CPU und Speicher zur Verfügung 

und ist im Heimnetzwerk eingebunden. Außerdem gibt es auf der Hersteller-Webseite einen 

download für eine Fritz!Box-Firmware inklusive fhem. Man kann also einfach diese (Labor-) Firmware 

herunterladen, den CUL einstecken und das fhem-System funktioniert. Einfach so. Hinweise zur 

Einrichtung der Fritz!Box 7390 mit fhem gibt es hier: Fehler! Verweisquelle konnte nicht gefunden 

werden. ; zum besseren Grundverständnis dient auch das Schichtenmodell. 

Sie benötigen die Sensoren und Aktoren. Im Weiteren werden als Beispiel eine funkgesteuerte 

Steckdose (FS20-ST) und ein Lichtschalter (FS20-S4A) betrachtet. Andere Geräte funktionieren 

ähnlich: die Zwischen-Steckdose funktioniert ebenso wie ein Unterputzschalter (FS20-SU), ein Wand- 

Lichtschalter mit vier Knöpfen funktioniert genauso wie eine Fernbedienung mit vier Knöpfen (FS20 

S4). 

Wenn Sie starten möchten, bestellen Sie den Sender&Empfänger (CUL) zuerst, da er ein paar Tage 

Lieferzeit hat. Zum Testen können Sie sich außerdem z.B. zunächst 2 Steckdosen (fs20-st) und einen 

Lichtschalter (fs20-s4a) besorgen. Bevor Sie alle Ihre Sensoren und Aktoren bestellen, machen Sie 

sich einen Plan, wie Ihre Heimsteuerung aussehen soll. Im Weiteren werden wir nach und nach ein 

Beispiel aufbauen, das Ihnen Denkanstöße und Tipps zum Einreichten Ihrer eigenen Konfiguration 

gibt. 

Die fhem-Oberfläche 

Sie erreichen fhem über Ihren Browser unter der Adresse http://:8083/fhem 

Hier eine kurze Erklärung zum Bildschirmaufbau: 

� 

� 

� Liste der Räume – zu Beginn der Einrichtung erscheinen nur ‚Unsorted‘ und ‚All together‘. 

Räume werden den Geräten in der Konfiguration mittels attrib room 

zugeordnet. 

� Links auf Hilfetexte, die fhem-Doku und zur Konfigurationsseite ‚Edit files‘ 

� 

� 

� 



� Eingabefeld zum direkten Ausführen von fhem-Befehlen 

� Nach der Einrichtung erscheinen hier Ihre Geräte mit der Darstellung des Schaltzustands und 

einem on/off-Schalter 

� Geräte können auch Strukturen zugewiesen werden. Sie erlauben das gesammelte Schalten 

aller zugeordneten Geräte. 

Der Hauscode 

Das FS20-System arbeitet mit Funk im 868 Megahertz-Band. Alle FS20-Geräte bedienen sich dieser 

Frequenzen. Um die Geräte sowohl innerhalb Ihres Haushalts als auch von denen Ihrer Nachbarn zu 

unterscheiden, wird der sogenannte Hauscode verwendet. Da das FS20-System auch ohne CUL 

betrieben und programmiert werden kann, gibt es zusätzlich zum Hauscode auch drei weitere 

Parameter (Funktionsgruppen, Lokale Master, Globale Master). Da diese in fhem keine Rolle spielen, 

werden diese Werte generell auf der Werkseinstellung belassen – wir beschränken uns auf den 

Hauscode. 

Hinweis: Die Nutzung und Funktionsweise von Funktionsgruppen, Lokaler Master und 

Globaler Master sind in dem Handbuch beschrieben, das mit jedem Sensor ausgeliefert wird. 

Diese Handbücher sind auch online einzusehen. 

Wenn ein weiterer gleichartiger Schalter alternativ verwendet können werden soll, geben Sie ihm 

einfach denselben Hauscode. Dadurch erzeugt z.B. der 4-knöpfige Lichtschalter an der Wand 

dieselben Funksequenzen wie Ihre 4-knöpfige Fernbedienung. Da der Aktor (Steckdose) im 

Wesentlichen Hauscodes unterscheidet, ist für ihn das Signal vom Lichtschalter dasselbe wie das der 

Fernbedienung – und das des CUL. 

Wenn Sie in Ihrer Wohnung mehrere z.B. 4-knöpfige Schalter verwenden möchten, die 

unterschiedliche Aktoren schalten sollen, geben Sie diesen Schaltern einfach unterschiedliche 

Hauscodes. 

Sensoren 

Ein Sensor wird ab Werk mit einem zufällig eingestellten Hauscode geliefert. Bei Sensoren mit 

Eingabemöglichkeiten (z.B. Lichtschalter und Fernbedienungen, die Tasten haben, aber nicht 

Helligkeitssensoren, Bewegungsmelder o.ä. ohne Tasten) kann der Hauscode umgestellt werden. Das 

kann recht wichtig sein, falls z.B. auch Ihr Nachbar ein FS20-System betreibt – er soll ja nicht plötzlich 

Ihre Wohnzimmerbeleuchtung einschalten. 

Das einfachste Setup wird im weiteren Verlauf erklärt, für gewöhnlich erhält jedoch jeder Schalter 

einen eigenen Hauscode. 

Als ersten Sensor betrachten wir einen Lichtschalter fs20-s4a mit vier Knöpfen, genaugenommen vier 

Tastern. Ab Werk sind diese Schalter mit einem zufälligen Hauscode belegt und als 2-Kanal-Schalter 

eingestellt, d.h. dass sie wie zwei Tastenpaare bedient werden können – für zwei Geräte jeweils 

einen An- und Aus-Taster. Wenn Sie diese Einstellung beibehalten, ist die weitere Konfiguration am 

einfachsten. 


1 2 

Aus 

An 

Aus An 

3 4 


FS20-S4A 

1 2 

An/Aus 

An/Aus 

3 4 

An/Aus An/Aus 

2-Kanal = 2 Tastenpaare 4-Kanal = 4 Taster 

Sie können mit den vier Tastern aber auch vier unterschiedlich Geräte jeweils ein- und ausschalten, 

jede einzelne Taste verhält sich dann wie ein Ein-Ausschalter für ein Gerät. 

Details zur Einstellung stehen im jeweiligen Handbuch. Für einen fs20-s4a gilt: 

- Hauscode einstellen: Tasten 1+3 für 5 Sekunden halten bis die LED blinkt. Dann den 

Hauscode als beliebige 8-stellige Zahl festlegen (Aufschreiben!), dabei kann jede der acht 

Stellen einen Wert zwischen 1 und 4 haben, entsprechend der 4 Tasten. Ein Hauscode wäre 

also z.B. 12341234. 

Hinweis: Setzen Sie bei diesen Schritten den Deckel auf den Schalter – eintippen 

direkt auf den Kontakten der Platine funktioniert nicht! 

- Tasten-Benutzung: Für 2 Tastenpaare mit jeweils „aus“ und „an“ halten Sie die Tasten 2+3 für 

5 Sekunden, bis die LED kurz blinkt. Wenn Sie 4 einzelne Taster jeweils zum Ein- und 

Ausschalten nutzen möchten (Achtung – die Einrichtung ist später komplizierter!) halten Sie 

die Tasten 1+4 für 5 Sekunden, bis die LED kurz blinkt. 

Der Lichtschalter ist nun entsprechend Ihren Vorgaben konfiguriert. 

Hinweis: Wenn Ihr fhem bereits läuft, wird jede Taste, die Sie drücken, sofort ‚angelernt‘. Auch 

wenn’s schwerfällt – bitte erst lesen, dann drücken :-) 

Bevor der Sensor in fhem eingebunden wird, hier noch kurz die ‚Technische Sicht‘ auf den Schalter. 



FS20-S4A – Technische Sicht 

00 

off 

off 

01 

on 

on 

00 

toggle 

toggle toggle 

02 03 

Hauscode Hauscode 

2-Kanal 4-Kanal 

01 toggle 

An fhem werden beim Betätigen einer Taste genau drei Informationen übermittelt: 

- Der Hauscode 

- Der Tastencode 

- Der Zielzustand 

Wenn Sie Ihren Schalter also als 2-Kanal konfiguriert haben und Sie drücken den Taster oben rechts, 

sendet dieser 00 on. Drücken Sie unten links, sendet er 01 off. 

Hinweis: Sollte Ihnen die Belegung ‚links off, rechts on‘ „unnatürlich“ erscheinen, können Sie diese 

Funktion vertauschen: attr exchange_on_off – diese ‚Programmierung‘ wird später nochmals 

erwähnt. 

Haben Sie Ihren Schalter als 4-Kanal konfiguriert, sendet dieser statt on/off lediglich die Information 

‚umschalten‘, englisch ‚toggle‘. Drücken Sie die Taste oben rechts, sendet der Schalter 

01 toggle. Je nachdem, ob das zu schaltende Gerät also zuvor an oder aus war, wird es durch 

toggle in den entgegengesetzten Zustand versetzt. Ein unschöner Nebeneffekt ist die Darstellung auf 

dem Web-Interface: während passend zu den Zuständen on und off eine hübsche ‚leuchtende‘ oder 

‚graue‘ Glühbirne erscheint, wird bei Vier-Kanal-Tastern lediglich das Wort toggle angezeigt. Wie man 

das ‚ausbügeln‘ kann, wird später erklärt – es erfordert Programmierung (siehe Toggeln). 

Hinweis: Wenn Sie einen Taster länger als 0,4 Sekunden drücken, werden statt on/off/toggle Befehle 

zum Dimmen gesendet. Auf diese gehen wir erst später ein. 

Anlernen von Sensoren in fhem 

Um den Sensor mit fhem zu koppeln, drücken Sie die erste zu ‚lernende‘ Taste auf dem Schalter. Auf 

dem fhem webfrontend (mit F5 den Web-Browser refreshen!) erscheint dieser nun mit einem 

zufälligen Namen in fhem, er heißt dort z.B. FS20_602b01. Es wurde von fhem also ein Schalter mit 



dem vorläufigen Namen FS20_602b01, also dem (hexadezimal dargestellten) Hauscode 602b und 

dem Tastencode 01 erkannt. Notieren Sie sich auch diese vierstellig hexadezimale Version des 

Hauscodes – ich habe mir dafür eine Excel-Tabelle angelegt. Auf Ihrer fhem-Webseite finden Sie im 

oberen Bereich ein weißes Feld, über das Sie direkt getippte fhem-Befehle absetzen können. Der 

erste Befehl soll dem Umbenennen des Schalters dienen. Überlegen Sie sich die Bezeichnung Ihres 

Schalters gut, denn unter diesem Namen wird er fortan überall angezeigt. Ich habe mich dafür 

entschieden, die ersten zwei Stellen für das Zimmer zu verwenden (also wz=Wohnzimmer, 

ez=Esszimmer, sz=Schlafzimmer) und dann eine Beschreibung anzuhängen. Meine Sensor-Tasten 

heißen daher so, wie die Geräte, die geschaltet werden sollen, also z.B. wz_LampeSofa, 

sz_LeseLampe, ez_LichtRegal. Man kann sich ein beliebiges Namenssystem überlegen, jedoch 

müssen die Namen eindeutig sein. (In der App fhemobile wird der Teil vor dem Unterstrich nicht 

angezeigt, aus wz_LampeSofa wird in der Anzeige für das Wohnzimmer also LampeSofa). Namen 

dürfen keine Leerstellen enthalten. Angenommen Sie möchten wz_LampeSofa schalten: Tippen Sie 

im weißen Feld rename , in unserem Beispiel also rename FS20_602b01 

wz_LampeSofa. Das ist nun also der neue Name des gedrückten Tasters bzw. Taster-Paars. Auf der 

fhem-Webpage erscheint nun wz_LampeSofa mit den klickbaren Links für ON und OFF. 

Anlernen von Aktoren (Pairing) 

Um nun einen Aktor (also z.B. eine Steckdose) mit einem Schalter bzw. fhem zu koppeln, versetzt 

man den Aktor durch 5-sekündiges Festhalten des Knopfes (bis der blinkt) in den Lernmodus, und 

sendet dann einen Befehl – durch drücken des entsprechenden Tasters, oder durch anklicken von on 

oder off im fhem-webfrontend. Fertig! Der Aktor hat nun den Hauscode und Tastencode des 

Sensors/Lichtschalters ‚gelernt‘ und reagiert nur noch auf Befehle mit diesen Parametern. 

Damit ist das erste Schalterpaar erstellt. Sie können diese Steckdose nun vom Schalter und vom 

Webfrontend steuern. 

Versuchen Sie im Webfrontend das klicken auf ON und OFF. Schalten Sie die Steckdose mit dem 

Schalter ein und aus – wenn Sie dabei die Änderung auch im Web-Frontend sehen möchten, 

aktualisieren Sie die Darstellung in Ihrem Browser mit F5. Sie können diese Schritte auch durch 

getippte Befehle erreichen: in dem weißen Feld im oberen Bereich der fhem-Seite können direkte 

Befehle eingegeben werden. Probieren Sie set on und set off, also z.B. set 

wz_Lampe on 

Wenn derselbe Schalter mehrere Aktoren schalten soll, lernen Sie die weiteren Aktoren einfach 

genauso wie den ersten an demselben Sensor (Schalter) an. 

Mit den bisher beschriebenen Schritten lässt sich bereits eine recht umfangreiche Konfiguration 

erreichen. 

Dimmer 

Als speziellen Aktor gibt es auch Dimmer, z.B. fs20-di. Diese lassen sich wie Schalter mit 

on/off/toggle bedienen, beherrschen aber einige zusätzliche Befehle: dimup, dimdown sowie die 

Einstellung auf vorgegebene Dimmstufen, z.B. dim50%. Die vollständige Liste der 16 Dimmstufen 

finden Sie in der fhem-Referenz. 



Wenn Sie an einem Sensor (Schalter) den Taster länger als 0,4 Sekunden gedrückt halten, sendet 

dieser statt on/off/toggle den Befehl dimup bzw. dimdown. So lassen sich wiederum ohne 

programmierung auch Dimmvorgänge erreichen. Ein Dimmern aus dem fhem-Webfrontend ist 

hingegen nur über eingetippte Befehle möglich, Sie können also z.B. set lampe1 dimup oder set 

lampe1 dim50% eingeben. 

Timer 

Viele Aktoren beherrschen auch eine timer-Funktion, so z.B. die Funksteckdose fs20-st oder der 

Dimmer fs20-di, ebenso ihre äquivalenten Unterputz-Modelle. 

Um den Timer vom Schalter aus zu aktivieren… 

In fhem stehen hierfür mehrere Befehle zur Verfügung. Ein Beispiel ist set lamp1 on-for-timer 

10 (die Lampe für 10 Sekunden einschalten). 

Details und weitere Beispiele sind in der fhem-Referenz beschrieben. 

Schalten zu bestimmten Zeitpunkten 

Hierfür steht in fhem der Befehl define…at zur Verfügung: define LampeAnUm1700 at 

17:00:00 set lamp on 

LampeAnUm1700 ist hierbei lediglich ein Name/Platzhalter, der verwendet wird, um den define- 

Befehl einheitlich zu verwenden. 

Der at-Befehl erlaubt nicht nur die absolute Angabe von Schaltzeiten (um 17:00), sondern auch 

relative Angaben (in 10 Minuten): define a5 at +00:10:00 set lamp on 

In der fhem-Referenz sind hierzu viele Beispiele genannt, die auch Wiederholungen aufzeigen sowie 

Abhängigkeiten von Wochenenden, Sonnenauf- und Untergängen etc. 

Pairing: Direkt vs. Indirekt 

In der bisher beschriebenen Konfiguration ist jeder Aktor direkt mit einem Sensor gekoppelt. Das hat 

den Vorteil, dass die Steuerung der Aktoren direkt vom Sensor vorgenommen wird und fhem zumeist 

nur ‚mitlauscht‘. Sobald also auf dem Sensor eine Taste gedrückt wird, wird der Aktor direkt und 

damit sofort angesteuert. Eine Zeitverzögerung z.B. wegen Auslastung des fhem-Systems tritt nicht 

auf – eine Zeitverzögerung von 2 Sekunden zwischen Drücken des Lichtschalters und einschalten des 

Lichts kann sehr irritierend wirken. 

Es gibt auch die Alternative, die Aktoren separat in fhem zu konfigurieren. Ein Sensor (Lichtschalter) 

steuert dann also nicht den Aktor, sondern CUL+fhem. fhem setzt seinerseits den Befehl um und 

schaltet den Aktor. Ähnliches gilt, wenn ein Aktor gar nicht von einem physischen Schalter, sondern 



ausschließlich aus dem Web-Frontend getriggert werden soll. 

a 

Direkt vs. Indirekt 

C 

U 

L 

Direkt: Der Aktor ist direkt an den Sensor 

gekoppelt, Schaltbefehle werden sofort 

ausgeführt (a). Der CUL ‚lauscht dabei mit‘ 

(a) und wird nur bei Nutzung des 

Webinterfaces ein Schaltsignal senden (b). 

Der Aktor erhält den Hauscode des Sensors, 

CUL sendet ebenfalls mit diesem Hauscode. 

b 

fhem für Einsteiger V 1.0 Seite 10 

C 

U 

L 

Indirekt: Der Sensor sendet an den CUL (1), 

fhem reagiert und sendet daraufhin einen 

Schaltbefehl an den Aktor (2), ebenso bei 

Nutzung des Webinterfaces (2). Hauscode 

von Sensor und Aktor sind unterschiedlich: 

Der Sensor hat einen eigenen Hauscode, der 

Aktor erhält den Hauscode des CUL. 

In diesen Fällen muss ein Aktor ‚manuell‘ in fhem eingerichtet werden. Außerdem ist eine ‚Kopplung‘ 

zwischen Sensor und Aktor erforderlich, da fhem zunächst nicht wissen kann, welcher Sensor 

welchen Aktor schalten soll. 

Sämtliche Konfigurationen werden in der datei fhem.cfg vorgenommen. Sie kann bequem aus dem 

fhem-frontend heraus verändert werden. Wählen Sie dazu am linken Bildschirmrand den Menüpunkt 

‚Edit Files‘ und auf dem nächsten Bildschirm ‚fhem.cfg‘. Sie sehen nun nach ein paar 

Grundeinstellungen eine Auflistung aller bereits definierten Sensoren. 

Zunächst finden Sie hier den Hauscode des CUL, z.B. 6523. Diesen benötigen Sie eigentlich nur zur 

Steuerung bestimmter Geräte, der Einfachheit halber benutze ich ihn aber bei allen Definitionen für 

Aktoren, die ausschließlich vom CUL gesteuert werden sollen. Auch der Hauscode des CUL ist ab 

Werk zufällig vergeben, Sie können den vierstelligen CUL-Hauscode nun auch verändern. 

Wenn Sie einen Aktor (Steckdose) direkt am CUL/fhem anlernen wollen, tragen Sie in Ihrer fhem.cfg 

folgendes ein: 

define , also z.B. 

define wz_MediaServer 6523 52 

Die laufende Nummer unterscheidet innerhalb desselben CUL-Hauscodes die einzelnen Geräte (das 

gibt es bei den Schaltern ebenso, wir haben es aber bisher nicht betrachtet). Da die Nummern bis 44 

von den Schaltern belegt sein können, starten Sie bei 50. 

Klicken Sie anschließend oben auf den button ‚Speichern ..../fhem.cfg‘. Tippen Sie dann im oberen 

weißen Feld zum Neuladen der Konfiguration den Befehl rereadcfg ein und bestätigen Sie mit 

1 

2


. Wenn Sie danach links auf ‚All Together‘ klicken, erscheint der Name Ihres neuen Aktors 

im Webfrontend. Bringen Sie den Aktor in den Lernmodus und führen Sie am Webfrontend von fhem 

einen Schaltvorgang für diesen Aktor aus – schon ist dieser gekoppelt (paired). 

Ereignis-gesteuerte Schaltungen - notify 

Vor allem bei indirekten Schaltungen möchten Sie erreichen, dass ein Ereignis (z.B. Drücken einer 

Taste) das Schalten eines Aktors nach sich zieht. Die Kopplung erfolgt so: 

define Schalter1Notify notify Schalter1 set wz_MediaServer on 

Der bei define…notify angegebene Name bezeichnet den ‚Event-Handler‘. Die besondere 

Eigenschaft dieser notify-Anweisungen ist, dass sie nicht zum Zeitpunkt ihrer Eingabe ausgeführt 

werden, sondern ab sofort im Hintergrund ‚mitlauschen‘. Sobald der nach notify angegebene Sensor 

einen Befehl übermittelt, wird der im notify beschriebene Befehl ausgeführt. Die oben dargestellte 

Zeile schaltet also wz_MediaServer an, sobald der Taster Schalter1 betätigt wird. Allerdings ist das so 

wie es da steht ein seltener Anwendungsfall: das Gerät soll ja nicht immer an-, sondern auch 

ausgeschaltet werden. Der Befehl, den der Sensor gesendet hat, muss also an den Aktor 

‚weitergereicht‘ werden. Dafür wird die Variable % verwendet: 

Define Schalter1Notify notify Schalter1 set wz_MediaServer % 

Dabei hat % genau den Wert, der vom abgefragten Sensor (also Schalter1) gesendet wurde. Sendet 

also Schalter1 den Wert on, so wird der Befehl set wz_MediaServer on ausgeführt. Sendet der 

Schalter1 den Befehl off, so wird set wz_MediaServer off ausgeführt. Analog funktioniert das 

für jeden Befehl des Sensors, also auch toggle, dimup, dimdown etc. 

Geräte-Eigenschaften: Modell und Raum 

Die in fhem angelernten bzw. manuell angelegten Geräte können weitere Informationen mit sich 

führen. So können Sie z.B. hinterlegen, um welchen Gerätetyp es sich handelt: 

attr wz_MediaServer model fs20-st 

Definieren Sie auch die bereits in der fhem.cfg vorhandenen Schalter als Steckdosen (denn diese 

steuern Sie ja damit): 

attr wz_Lampe model fs20-st 

Die Angabe des Modells erlaubt eine passendere Darstellung in den fhem-frontends, z.B. werden für 

Schalter keine Dimm-Befehle angeboten etc. 

Auch können Sie nun jeden Sensor und Aktor einem Raum in Ihrer Wohnung zuordnen: 

attr wz_MediaServer room Wohnzimmer 

attr wz_Lampe room Wohnzimmer 



Nach Speichern der fhem.cfg und rereadcfg sehen Sie nun im linken Bereich einen neuen Eintrag 

‚Wohnzimmer‘. Wenn Sie dort klicken, werden alle Geräte angezeigt, die diesem Raum zugeordnet 

wurden. 

Alternativ zur fhem.cfg können Attribute auch direkt im Webfrontend ändern. Klicken Sie dazu auf 

den Namen des Geräts. In dem dann angezeigten Bildschirm können Sie mit einem dropdown 

Attribute auswählen und diesen auch Werte zuweisen. 

Mehrere Geräte mit einem klick schalten - Strukturen 

Um alle Geräte einer Gruppe (also z.B. alle Geräte im Wohnzimmer) mit nur einem Klick gemeinsam 

schalten können zu können, legen Sie in der fhem.cfg die Gruppe fest: 

define wz_Alle structure room wz_Lampe wz_MediaServer 

Nach Speichern, rereadcfg und klick auf ‘All Together’ wird nun auch die Struktur wz_Alle mit ihren 

ON und OFF-Schaltern angezeigt und ist bedienbar. Wenn Sie auch diese Struktur dem Wohnzimmer 

zuweisen, wird die Struktur auch in diesem Raum angezeigt: 

attr wz_Alle room Wohnzimmer 

Dabei wird diese Festlegung nun auf alle der Struktur zugehörigen Objekte vererbt (also wz_Lampe 

und wz_MediaServer). 

Infoquellen 

Mit den bisher dargestellten Möglichkeiten, sollten Sie die Grundlage haben, um Ihre eigene 

Anwendung in fhem abzubilden. 

Weitere hilfreiche Informationsquellen sind 

- Die fhem-Doku unter http://www.fhem.de 

- Die Befehlsreferenz unter http://fhem.de/commandref.html 

- Das fhem-wiki unter http://fhemwiki.de/index.php/FHEM 

- Das fhem-Forum unter http://groups.google.com/group/fhem-users 

Im Weiteren sind einige Sonder-Anwendungen dargestellt, die möglicherweise auch für Sie 

interessant sind. 

Bei der weiteren Arbeit mit fhem wünsche ich viel Spaß und Erfolg! 


Fritzbox 

Schichtenmodell & Zugänge 

Fritz! 

Oberfläche 

Fritz! 

Firmware 

http://fritz.box:80 

https://:553 

telnet://fritz.box:21 

Linux 

BIOS 

fhem 

Perl 


Schichtenmodell FB7390 

fhemweb GUI 

Anwendung 

Firmware 

Fritz!Box Hardware 

CUL 

Fritz! 

Oberfläche 

Fritz! 

Firmware 

Zugänge 

Linux 

BIOS 

Fritz!Box 

fhemweb 

fhem 

Perl 

fhem für Einsteiger V 1.0 Seite 13 

culfw 

http://fritz.box:8083/fhem 

http://fritz.box:8084/fhem 

telnet://fritz.box:7072


Telnet 

Telnet-Client herunterladen und installieren, zB PUTTY (install als Admin starten!) 

PuTTY verwenden: 

Am DECT-Telefon kann man den Telnet-Zugang der Fritzbox 7390 ein- oder ausschalten: 

#96*7* Telnet an 

#96*8* Telnet aus 

Siehe Schichtenmodell – erreichen von: 

fhem: fritz.box port 7072, Protocol RAW (nicht telnet), "Terminal:Implicit CR in every LF" 

Linux: fritz.box port 21, Protocol telnet 

http://fhemwiki.de/index.php/AVM_Fritz!Box 

Sammelsurium 

Flashen der Firmware an einem PC: 

1. FLIP runterladen (Programm zum flashen des ROMs auf dem CUL) von 

http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3886 

2. CUL in den Rechner stecken (beim einstecken Mikroschalter gedrückt halten!), dann zum 

installieren des USB-Treibers: Im Windows Gerätemanager den device ATMEL xxxx anklicken, 

Eigenschaften, Gerätetreiber aktualisieren, von Festplatte, Verzeichnis 

c:\Programme\Flip\\USB auswählen und Treiber installieren lassen. 

http://code.google.com/p/micropendous/wiki/ProgramAndTestWindows 

FHEM 

3. CUL-Firmware (Hex) für FHEM runterladen von http://cvs.berlios.de/cgibin/viewvc.cgi/culfw/culfw/Devices/CUL/ 

(Version passend zur CUL-Hardware-Version 

auswählen, bei mir CUL-Hardware-Version V3.2, also hex V3) 

4. Flip starten, unter ‚select device‘ exakt den Chip auswählen, der als Name des CUL im Geräte- 

Manager angezeigt wird (je nach Modell, zB ATU822U4), danach in der Flip Symbolleiste auf 

den 2. Button von links klicken (auch wenn der grau sein sollte – funktioniert trotzdem) und 

‚USB‘ auswählen. Sollte hier eine Fehlermeldung auftauchen, hat Schritt 2 nicht geklappt 

oder es wurde der falsche Chip ausgewählt. 

Dann mittels Menü Datei das bei Schritt 3 geladene hex-file nach Flip einlesen und mit 

button unten links auf den CUL flashen 

5. Wenn der CUL nach Abziehen und erneut in den Rechner stecken langsam grün blinkt, hat’s 

wohl geklappt. 

Monitoring 

First learn what are the trigger messages: telnet to your fhem (e.g. telnet localhost 7072) and issue 

the command "inform on". -> lässt alle CUL-Aktivitäten im telnet-fenster durchlaufen 


Fehlermeldungen 


LOVF 

If too many messages for FHT devices are queued in CUL, the fht buffer subsystem of CUL overflows. 

You get EOB (end of buffer) messages and likely LOVF (limit overflow) messages, too. define attr 

CUL fhtsoftbuffer 1 to activate a quasi unlimited software buffer in fhem itself to avoid this 

behavior. 

Pairing - Aktoren 

1. In fhem.cfg device definieren mit 

define Schalter1 FS20 2323 54 (2323=Hauscode des CUL, 54 = laufende 

Nummer, beginnend bei 50 (bis 44 ist wohl von Sensoren belegt) 

attr Schalter1 model fs20st 

2. Rereadcfg 

3. Steckdose in Lernmodus bringen durch halten der Taste für 5sec 

4. Schalter1 am Webfrontend ein/ausschalten -> Pairing ok 

Sensoren 

Programmierung 

Vor dem Pairen müssen die Sensoren FS20-S4A eingestellt werden. 

Achtung: Der Deckel muss auf den Schalter aufgesetzt sein – nicht mit blanken Fingern direkt auf den 

Tastern auf der Platine arbeiten – bei mir hat dabei das Umstellen in 4-Kanal nicht funktioniert! 

Einstellen Hauscode: Halten 1+3, achtstelligen Hauscode eingeben (nur Ziffern 1-4 gemäß Tasten) 

a) 2-Kanal (2 Tastenpaare) durch halten der Tasten1+4 

b) 4-Kanal (4 einzelne Tasten) durch halten der Tasten 2+3 

Bei dem hier beschriebenen setup nicht benötigt: Bei FS20-S4A bei 4-Kanal einstellen von 

Addressgruppe und Unteradresse: Zu programmierende Taste halten, dann zusätzlich die 

danebenliegende – 5 Sekunden beide. Dann 4stellig die Addressgruppe+Untergruppe eingeben. Siehe 

Handbuch zum S4A. 

Sensor in FHEM anlernen 

Telnet fritz.box:7072 (siehe auch Telnet oben) 

Dann tippen: inform on 

Bei erstmaligem drücken einer Taste erscheint diese auch unter telnet im log. Wenn autocreate 

eingeschaltet ist, wird diese außerdem automatisch in der fhem.cfg eingetragen und erscheint damit 

auch im FHEM webfrontend. Sie bekomm hier einen ‚zufälligen‘ Namen – man möchte sie also 

umbenennen. 

Ich habe mich entschieden, die Taster so zu benennen, wie der zu schaltende Gegenstand heißt. Da 

die Geräte später mit diesem Namen auf dem Webfrontend erscheinen, ist es sinnvoll, sich eine 

einheitliche Namensgebung zu überlegen. 



Bei mir nenne ich die Räume: Esszimmer (ez), Wohnzimmer (wz), Schlafzimmer (sz) usw. 

Meine Taster heissen nun: ezLichtRegal, wzLicht, wzLichtWand, wzLampeKlein, szLichtRegal, 

szStehlampe, szLeselampe 

Aus der fhem.cfg kann man sich den Namen des Tasters kopieren, zB FS20_696902. Diesen nun 

zum gewünschten Namen umbenennen, also zB 

rename FS20_696902 ezLichtRegal 

Pairing 

Nun die Aktoren wie gewünscht an den Tasten anlernen: Am Aktor (zB Steckdose) den Knopf 5sec 

gedrückt halten bis die Lampe blinkt, dann den zugeordneten Taster drücken – fertig. 

Diese Steckdose lässt sich nun sowohl über den Taster ein- und ausschalten, wie auch über das 

webfrontent. 

Einzige Unschönheit: Beim Schalten mit dem Taster schaltet zwar der Aktor (Steckdose), jedoch 

bleibt das icon (das Glühbirnchen) auf dem webfrontend unverändert. 

Um das zu beheben: 

Toggeln 

Um bei 4-Kanal mittels Taster ‚togglen‘ zu können, benötigt man folgenden code: 

Bei separat an den CUL gepairten Schaltern und Steckdosen: 

Für passende Variante zu Direktschalten Fred gepostet: 

http://groups.google.com/group/fhem-users/browse_thread/thread/b79e29fb2bd5722b 

Dort auch Installationsanleitung. 

Mit neuen Routinen Value() und OldValue() statt $value{} und $oldvalue{}{VAL} 

define ezLichtRegalSwitch notify ezLichtRegal { \ 

if ("%" eq "toggle"){ \ 

{Log 1, 'Vorher : Value() ist '.Value("ezLichtRegal")} \ 

{Log 1, 'Vorher : OldValue() ist '.OldValue("ezLichtRegal")}\ 

if (OldValue("ezLichtRegal") eq "off") { \ 

{fhem "setstate ezLichtRegal on"}\ 

{Log 1, "Change : setstate ezLichtRegal on"}\ 

}\ 

else { \ 

{fhem "setstate ezLichtRegal off"} \ 

{Log 1, "Change : setstate ezLichtRegal off"}\ 

} \ 

} \ 

else { \ 

{fhem "setstate ezLichtRegal %"} \ 

} \ 

{Log 1, 'Nachher: Value() ist '.Value("ezLichtRegal")} \ 

{Log 1, 'Nachher: OldValue() ist '.OldValue("ezLichtRegal")}\ 

} 

Gruppen und Strukturen 

http://groups.google.com/group/fhem-users/browse_thread/thread/1ffda243511bb5c4 


define EG structure Geschoss Lampe1 Lampe2 

define OG structure Geschoss Lampe3 Lampe4 

define Zuhause structure Haus EG OG 


wuerde Lampe1 zusaetzlich die Attribute Geschoss=EG und Haus=Zuhause bekommen. 

Und mit "set Zuhause off" koennte man die Lampen 1 bis 4 ausschalten 

Manueller restart 

Manuelles Stoppen des FHEM-Servers mit shutdown; manuelles starten mit: 

cd /var/InternerSpeicher/fhem 

sh startfhem 

Automatisches restart 

http://groups.google.com/group/fhemusers/browse_thread/thread/d3962e2a4adf0687/020a95e98d741dd6?lnk=gst&q=toggle+#020a95e 

98d741dd6 

Führe nachts automatisch shutdown (define 

fhemshutdown at 01:00:00 shutdown) und Neustart via daemon durch 

Vertauschen on/off-Taster 

Es wird mit "attr exchange_on_off" aktiviert. 

Includes 

Lastinclude 

Alternativ packt man solche Sachen in das lastinclude 

(http://fhem.de/commandref.html#lastinclude) File rein. 

Von ausserhalb des Home-Netzwerks zugreifen 

http://www.avm.de/de/Service/FAQs/FAQ_Sammlung/images/FRITZBOX_iPhone... 

Putty-Modus 

putty verwenden: Protocol RAW, "Terminal:Implicit CR in every LF" 

Umbenennen von on/off 

attr store eventMap on:open off:closed 

set store open 



FB7390: Ein/Ausschalten des WLAN aus fhem 

http://groups.google.com/group/fhem-users/browse_thread/thread/535114ca833e65ef 

Siehe auch: 

http://groups.google.com/group/fhemusers/browse_thread/thread/02b7260a52da0021/07a056be133db46f#07a056be133db46f 

Ausgabe auf Bildschirm 

define a3 at 17:00:00 "/bin/echo "Teatime" > /dev/console" 

Basics 

http://www.domoticaforum.eu/viewtopic.php?f=66&t=5841 

Schaltsequenzen 

http://groups.google.com/group/fhemusers/browse_thread/thread/e39b0594cb8620fe/2b016e5715f66a06?lnk=gst&q=harmony#2b016e5 

715f66a06 

Fhemupdate 

Da meiner Ansicht nach die CVS Version von fhem zuverlaessig laeuft, 

habe ich ein neues Kommando (in einem neuen Modul) hinzugefuegt: 

updatefhem prueft die naechtlich aus dem CVS auf fhem.de/fhemupdate 

hochgeladene Dateien, laedt die geaenderten herunter, und falls 

geaenderte Module verwendet werden, fuehrt automatisch ein reload 

durch. D.h. fuer Benutzer sollte ein update auf dem aktuellen Code 

sehr bequem durchfuehrbar sein. 

Zu beachten: 

- Lokale Aenderungen (99_Util.pm) sollte man in umgenannten Dateien 

realisieren sonst werden die evtl. ueberschrieben. 

- Falls fhem.pl sich geaendert hat, dann ist ein manueller Neustart 

notwendig, in diesem Fall werden geaenderte Module nicht automatisch 

neu-geladen. 

http://groups.google.com/group/fhem-users/browse_thread/thread/690d5f20deab0dc4 

iPad-Frontend 

attr touchpad 1 

Hab fuer FHEMWEB ein neues Attribut eingefuegt (touchpad), wodurch die 

Anzeige auf Tablets wie der iPad meiner Ansicht nach etwas passender 

ist. Ich haette gerne feedback von (Anderen-Tablet)-Besitzer :) 



http://groups.google.com/group/fhem-users/browse_thread/thread/b22fac17ecbd23e8#

fhem für Einsteiger - Home

Erfolgreiche ePaper selbst erstellen

Template löschen?

Als Template speichern?