Quelltext der Seite EnOcean Starter Guide

{{Baustelle}}
== EnOcean ==
[http://www.enocean.com/de/ EnOcean] ist 
* ein [http://www.enocean.com/de/enocean-wireless-standard/ ISO ratifizierter Funkstandard], ausgelegt für Funksensoren und Funksensornetze mit besonders niedrigem Energieverbrauch
* ein Anbieter batterieloser Funksensoren
EnOcean-Endgeräte mit dem von der EnOcean Alliance zur Verfügung gestellten EnOcean-Funkprotokoll werden von [http://www.enocean-alliance.org/de/hiererhaeltlich/ zahlreichen Hardware-Herstellern] angeboten. 

Abhängig von den Funktionen des EnOcean-Endgerätes werden bestimmte Anwendungs-Profile/Funk-Telegramme, die sogenannten EnOcean Equipment Profiles (EEPs), zur Funkkommunikation genutzt. Technische Details zum EnOcean-Funkprotokoll und insbesondere zu den [http://www.enocean-alliance.org/eep/ EnOcean Equipment Profiles (EEPs)] sind auf der Internetseite der [http://www.enocean-alliance.org EnOcean Alliance] zu finden.

EnOcean bietet -neben den veröffentlichten Standard-Enocean-Profilen- die Möglichkeit für die Nutzung von herstellerspezifischen Funk-Profilen/Telegrammen (MSC = Manufacturer Specific Communication). Falls die Herstellerfirmen den Inhalt dieser MSC-Telegramme nicht veröffentlichen, ist eine Unterstützung durch Fhem grds. nicht möglich. Teilweise werden die Produkte sowohl mit MSC- als auch mit Standard-Enocean-Profilen vertrieben [http://forum.fhem.de/index.php/topic,19544.msg132240.html#msg132240]. Angaben zu den verwendeten Profilen/Telegrammen sind regelmäßig den Bedienungsanleitungen der Produkte zu entnehmen.

EnOcean-Endgeräte gibt es sowohl in uni- als auch in bidirektionalen Ausführungen. Bei '''unidirektionalen Endgeräten''' erfolgt die Funk-Kommunikation nur in eine Richtung. Einem Aktor, der Licht schaltet, kann zwar der Befehl zum An- bzw. Ausschalten gegeben werden. Er liefert aber keine Rückinformation über die erfolgreiche Ausführung des Befehls. Bei '''bidirektionalen Endgeräten''' erfolgt die Funk-Kommunikation hingegen in zwei Richtungen; sie bieten Sende- und Empfangsmöglichkeiten. Der bidirektionale Aktor kann somit unter anderem die erfolgreiche Ausführung eines empfangenen Befehls zurückmelden.

Damit EnOcean Funk-Aktoren (z.B. Relais, Dimmer, Heizungsventil...) auf EnOcean Sensoren (z.B. Taster, Temperatursensor, Fensterkontakt, Energieverbrauchsmesser...) reagieren können, werden die Sensoren bei den Aktoren eingelernt (Teach-in). So wird festgelegt, dass z.B. "Funktaster 1" den "Dimmer 1" steuert. Alle EnOcean Geräte mit Sendefunktion haben eine eindeutige, unabänderliche 8-stellige Hex-SenderID (z.B. ffc54500; teilweise auch dargestellt mit Punkten oder Doppelpunkten dazwischen). Die SenderID ist auf den EnOcean Geräten aufgedruckt oder liegt der Verpackung des Endgerätes bei. Beim Anlernvorgang wird die eindeutige SenderID des Sensors in der Empfängertabelle des Aktors gespeichert.
 
== EnOcean in Fhem ==
=== Allgemein ===
Fhem wird regelmäßig weiterentwickelt und verbessert. Daher ist es zwingend notwendig, dass Fhem auf dem aktuellsten Stand ist. Bitte nach Fhem-Installation den Befehl <code>update</code> ausführen und anschließend <code>shutdown restart</code> durchführen. Genauso auch bei Anfragen im Forum die Aktualität von Fhem überprüfen.

Die Nutzung von EnOcean in Fhem ist für den Anfänger nur mit der standardmäßig eingeschalteten [http://fhem.de/commandref.html#autocreate autocreate-Funktion] einfach umsetzbar. Die Kenntnis der Fhem-Grundlagen und Durcharbeitung der Anfänger-Lektüren wird im Folgenden vorausgesetzt. Insbesondere ist [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit Fhem] zu empfehlen, auch wenn es nicht speziell EnOcean behandelt, so werden doch wesentliche Punkte für ein Verständnis von Fhem vermittelt.

Im Folgendem und auf den [[:Kategorie:EnOcean Components|Wiki-Seiten der Einzelgeräte]] werden immer wieder Auszüge aus der [[Konfiguration|fhem.cfg]] dargestellt. Diese dienen zur Erläuterung und Veranschaulichung. Die Bearbeitung der [[Konfiguration|fhem.cfg]] sollte -zur Verhinderung von Anfängerfehlern- nach Möglichkeit immer über das "Befehl-Eingabefeld" und die "Objektdetails" erfolgen.

=== Vorbereitung ===
Die SenderIDs der EnOcean-Geräte haben eine zentrale Bedeutung in Fhem. Sie sind eindeutiges Unterscheidungsmerkmal und werden von Fhem im Rahmen der Funkkommunikation genutzt und in der Definition der Geräte bzw. den Attributen des Geräte hinterlegt. Es empfiehlt sich daher, eine Tabelle aufzubauen mit folgender oder ähnlicher Struktur:

<table class="wikitable" border="1">
<tr>
<th> A
</th>
<th> B
</th>
<th> C
</th>
<th> D
</th>
<th> E
</th></tr>
<tr>
<th> Nr.
</th>
<th> Name EnOcean
</th>
<th> Name in Fhem
</th>
<th> HEX (Sender-ID)
</th>
<th> Zimmer
</th></tr>
<tr>
<td>
</td>
<td> &lt;Name Hardwareschalter&gt;
</td>
<td> &lt;Name in Fhem&gt;
</td>
<td> &lt;HEX Code&gt;
</td>
<td> &lt;Raumname&gt;
</td></tr>
<tr>
<td>
</td>
<td> TCM 310_0
</td>
<td> TCM 310_0
</td>
<td> AABBCC00
</td>
<td>
</td></tr>
<tr>
<td> 1
</td>
<td> EnO_switch_123456
</td>
<td> eg_fl_Licht
</td>
<td> AABBCC01
</td>
<td> EG_Flur
</td></tr>
<tr>
<td> ...
</td>
<td>
</td>
<td>
</td>
<td>
</td>
<td>
</td></tr>
<tr>
<td> 128
</td>
<td>
</td>
<td>
</td>
<td>
</td>
<td>
</td></tr></table>

== Definition von TCM / Gateway ==
Fhem kann mit einem Funkgateway, das auf einem TCM-Modul basiert, EnOcean-Funk empfangen und senden. 
Bisher gibt es zwei Transceiver Chips von EnOcean: 
* TCM120 (ausgelaufen)
** für den USB-Port: [https://embedded-intelligence.de/de/products/hardware/bsc-bor.html BSC BOR] 
* TCM310 
** als USB-Stick: [http://www.enocean.com/de/enocean_module/usb-300-oem/ USB 300] und [http://busware.de/tiki-index.php?page=EUL Busware EUL]
** als Aufsteckmodul für Raspberry Pi: [http://www.enocean.com/de/enocean-pi/ EnOceanPi]

Zudem existiert eine [http://forum.fhem.de/index.php/topic,22635.msg160582.html#msg160582 Lösung zur kabelgebundenen Anbindung] des FHEM-Rechners mittels Eltako FGW14 an den [[EnOcean-Eltako-RS485-Bus|Eltako RS485-Bus]], über die sowohl Busaktoren als auch Enocean Funkaktoren gesteuert werden können und auch Enocean Funktelegramme über das [[EnOcean-Eltako-RS485-Bus|FAM14 Funkantennenmodel]] am RS485-Bus empfangen werden können.

Das TCM-basierte Gateway wird nach dem Anschluss an den Fhem-Rechner beim Fhem-Start automatisch erkannt und grundlegend durch entsprechende Einträge in der fhem.cfg definiert. Ein manuelles Anlegen des TCM-Moduls oder Eingriff in die fhem.cfg ist regelmäßig nicht notwendig und auch nicht ratsam. Eine Ausnahme bilden RS485-basierte Gateways (bspw. FGW14) bei denen manuell das Attribut <code>comType</code> auf <code>RS485</code> in der [[Konfiguration|fhem.cfg]] gesetzt werden muss, da ansonsten Fhem nicht mehr startet. 

Beispiele der automatisch erzeugten define-Zeile in der fhem.cfg:

TCM120/BSCBor an Rapberry Pi:
 define BscBor TCM ESP2 /dev/ttyACM0@9600

TCM310/EnOceanPi an Raspberry Pi:
 define TCM310_0 TCM ESP3 /dev/ttyACM0@57600

TCM310/USB300 an Fritzbox
 define TCM310_0 TCM ESP3 /dev/ttyUSB3@57600

Hier Beispiel der define-Zeile in der fhem.cfg für kabelgebundene Anbindung mit FGW14 über serielle Schnittstelle
 define TCM120 TCM ESP2 /dev/ttyS3@57600
 attr TCM120 comType RS485                    <---- Manuell zu setzen; zwingend, sonst startet Fhem nicht!!

Nach erfolgreicher Definition ist das Gateway im Raum "Everything" in der Gruppe "TCM" zu finden. Wenn neben dem Gatewaynamen "initialized" oder "opened" angezeigt wird, ist Fhem in der Lage mit den EnOcean-Geräten zu kommunizieren.

Wie im Einführungsabschnitt bereits erläutert hat jedes sendende EnOcean-Endgeräte eine eindeutige SenderID. Diese SenderID kann aus Sicherheitsgründen nicht vom EnOcean-Gateway simuliert werden. Vielmehr hat das Gateway eigene SenderIDs, die auch separat in die Endgeräte angelernt werden müssen. Das Gateway stellt 128 verschiedene SenderIDs zur Verfügung. Ausgehend von der baseID, die bei jedem Gateway grds. anders ist, werden die SenderIDs fortlaufend hochgezählt:
* Fhem stehen 127 fortlaufende eigene SenderID/DestinationID zur Verfügung
* beginnend mit der baseID des TCM + 1

Die baseID des TCM erhält man durch Eingabe von
 get TCM310_0 baseID 
in das Befehl-Eingabefeld.

Das Webfrontend zeigt dann:
 BaseID=AABBCC00,RemainingWriteCycles=0A
Die niedrigste SenderID/DestinationID in diesem Beispiel ist AABBCC0'''1''' (BaseID=AABBCC00 +1 HEX!!!)

Nach der Definition des Gateways und Ermittlung der baseID des Gateways kann nun der nächste Schritt, die Definition der EnOcean-Geräte in Fhem, erfolgen.

Mehr Details in der [http://fhem.de/commandref.html#TCM commandref] zu TCM

== Definition von Geräten ==


=== Definition / Anlernvorgang (Teach-In) ===
Damit Fhem und EnOcean-Geräte miteinander kommunizieren können, müssen sie untereinander bekannt gemacht werden. Dies geschieht durch Definition des Gerätes in Fhem und den Anlernvorgang. Dazu muss sich Fhem im [http://fhem.de/commandref.html#TCM_learningMode learningMode] befinden. Viele Geräte werden von Fhem während des Anlernvorgangs automatisch erkannt und definiert. Dennoch ist ein grundlegendes Verständnis der Anlernvorgänge und Unterscheidungsprinzipen in Fhem und EnOcean notwendig. Sofern das Gerät Bestätigungstelegramme verschicken kann, sind diese zwingend '''vorher''' am Gerät einzuschalten (u.a. Eltako). 

Fhem entnimmt die Angaben, wie ein Funk-Telegramm für ein bestimmtes Gerät aufgebaut ist, im Wesentlichen aus den Attributen <code>subType</code>, <code>manufID</code> und/oder <code>model</code> der Definition des Gerätes:
*<code>subtype</code>: genutztes EEP-Profil des Gerätes (steht in der Bedienungsanleitung des Gerätes)
*<code>manufID</code>: Hersteller des Gerätes
*<code>model</code>: Modell des Gerätes
Während des Anlernvorgangs werden diese Angaben von Fhem soweit wie möglich automatisch in der Definition vorbelegt. Hinweise zu den Besonderheiten von bestimmten Geräten und EEP-Profilen finden sich oft in der [http://fhem.de/commandref.html#EnOcean commandref] zu EnOcean. Darum bitte immer in der commandref zunächst nach dem speziellen Gerät (Modellbezeichnung) suchen, wenn dies keinen Treffer liefert nach dem verwendeten EEP suchen. Die gegebenen Hinweise und Erläuterungen dort beachten.
 
Die Definition und der Anlernvorgang unterscheidet sich je nach Gerätetyp:
* Sensoren:
** Schalter (EEP RPS): werden automatisch beim ersten empfangenen Funktelegramm in Fhem mit den notwendigen Attributen angelegt.
** Kontakte (EEP 1BS): werden automatisch beim ersten empfangenen Funktelegramm in Fhem mit den notwendigen Attributen angelegt.
** Sonstige Sensoren (EEP 4BS): Durch Versand eines speziellen Anlern-Funktelegramms, können sie in Fhem automatisch mit den notwendigen Attributen angelegt werden. Im Anlerntelegramm übermittelt der Sensor Fhem die EEP-Profilangabe und die Hersteller-ID. Aufgrund dieser Angaben kann Fhem das Gerät eindeutig erkennen und die richtigen Attribute in Fhem setzen. Einige wenige Sensoren verschicken leider ein Anlerntelegramm ohne EEP-Profilangabe und/oder Herstellerangabe (Bsp: Omnio Ratio eagle-PM101). Bei diesen Sensoren müssen die Attribute subType, manufID und/oder model manuell in Fhem gesetzt werden, damit eine richtige Auswertung der Funktelegramme erfolgt.
* Aktoren (4BS, VLD/UTE, MSC): Bei den Aktoren gibt es je nach Gerätetyp verschiedene Anlernvorgänge, die unterschiedlich in Fhem ausgeführt werden. Einige Aktoren unterstützen auch mehrere Anlernvorgänge.

In den nachfolgenden Gliederungspunkten wird beispielhaft für ein Gerät aus den obigen Gerätetypen die Einbindung in Fhem erläutert.

Grundlegend gilt immer:
Fhem legt sendende, noch nicht definierte EnOcean Geräte selbst an, wenn
* in fhem.cfg autocreate aktiviert ist:
** <code>[http://fhem.de/commandref_DE.html#autocreate define autocreate autocreate]</code>
* Fhem/das TCM-Modul sich im <code>learningMode</code> befindet und
* Fhem eine Nachricht vom noch nicht definierten EnOcean Gerät empfängt
Im Webfrontend werden neue Geräte im Raum EnOcean angezeigt.

=== Sensoren ===
'''Sensoren Beispiele:'''

==== Schalter/Switch ====
PTM 210 - Schaltermodul [http://www.enocean.com/de/enocean_module/ptm-210-data-sheet-pdf/ Datenblatt]

EEP: F6-02-xx

Fhem in den learingMode (<code>set <IODev> teach <time/s></code>) versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Dann einen beliebigen Taster des Moduls drücken (und loslassen). Beim Drücken des Tasters wird vom Taster eine Nachricht ausgesendet, die von Fhem empfangen wird. Daraufhin definiert Fhem automatisch den Taster und der Taster ist in Fhem angelernt. Fhem fügt dazu folgenden Code zur fhem.cfg hinzu:
* exemplarischer Auszug aus fhem.cfg
 define EnO_switch_FFC54500 EnOcean FFC54500                    <-- "FFC54500" ist die 8-stellige Hex-SenderID des Tasters
 attr EnO_switch_FFC54500 IODev TCM310_0
 attr EnO_switch_FFC54500 room EnOcean
 attr EnO_switch_FFC54500 subType switch                        <-- handelt sich um einen Schalter
 # attr EnO_switch_FFC54500 eventMap AI:off A0:on BI:an B0:aus  <-- bei Bedarf ... die gemapten Werte (hier: off, on, an, aus) sollen eindeutig sein
 define FileLog_EnO_switch_FFC54500 FileLog ./log/EnO_switch_FFC54500-%Y.log EnO_switch_FFC54500
 attr FileLog_EnO_switch_FFC54500 logtype text

Ein Schalter (hier: FT55) hat vier Taster:
{|
| '''Taster''' || '''in Fhem'''
|-
| links oben || A0
|-
| links unten || AI (nicht "eins" sondern "i"!)
|-
| rechts oben || B0
|-
| rechts unten || BI
|}

Das Log FileLog_EnO_switch_FFC54500 zeichnet beim einmaligen Drücken des linken unteren Tasters ("AI") folgendes auf:
 2014-01-01_07:00:01 EnO_switch_FFC54500 buttons: pressed
 2014-01-01_07:00:01 EnO_switch_FFC54500 channelA: AI
 2014-01-01_07:00:01 EnO_switch_FFC54500 AI
 2014-01-01_07:00:02 EnO_switch_FFC54500 buttons: released

Der angelegte Sensor repräsentiert im Webfrontend den physischen Schalter (bspw. an der Wand). Ein Druck auf den physischen Taster ändert den Zustand im Webfrontend. Jedoch führt ein Schalten des Repräsentanten im Webfrontend nicht zu einer Schaltung des Aktors.

Fhem kann sich '''nicht''' als einer der vorhandenen (automatisch angelegten) physischen Sensoren ausgeben (um z.B. das Licht zu schalten) sondern verwendet eigene SenderID/DestinationID's - [[#Schalter - physisch und virtuell in Fhem|siehe unten]]. Diese Fhem-eigenen SenderIDs können mit Hilfe eines virtuellen Fhem-Schalters in EnOcean Aktoren eingelernt werden, damit die Aktoren auf Fhem reagieren [[#Aktoren|siehe unten]].

==== Kontakte ====
STM 320 Batterieloses Magnetkontakt-Funkmodul ([http://www.enocean.com/de/enocean_module/stm-320-data-sheet-pdf/ Datenblatt])

EEP: D5-00-01

Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Anlerntelegramm laut Anleitung verschicken oder Magnetkontakt öffnen und schließen.

Der Kontakt wird automatisch in Fhem definiert und ist angelernt.

* exemplarischer Auszug aus fhem.cfg
 define EnO_contact_0000FF53 EnOcean 0000FF53
 attr EnO_contact_0000FF53 IODev TCM310_0
 attr EnO_contact_0000FF53 room EnOcean
 attr EnO_contact_0000FF53 subType contact
 define FileLog_EnO_contact_0000FF53 FileLog ./log/EnO_contact_0000FF53-%Y.log EnO_contact_0000FF53
 attr FileLog_EnO_contact_0000FF53 logtype text
 attr FileLog_EnO_contact_0000FF53 room EnOcean

==== Sonstige Sensoren ====
===== 4BS-Teach-In =====
Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600
Dann Anlerntelegramm laut Bedienungsanleitung am Sensor auslösen. Der Sensor wird dann wird automatisch in Fhem definiert und ist angelernt.

===== Profilloses 4BS-Teach-In =====
Omnio Ratio eagle-PM101 Licht- und Anwesenheitssensor ([http://www.omnio.ch/content-en/downloads/Betriebsanleitungen/2902000_Betriebsanleitung_ea.pdf Betriebsanleitung])

Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Lerntelegramm vom Omnio Ratio eagle-PM101 verschicken (MÖGLICH??)

Im angelegten Fhem-Device manuell das Attribut <code>subType</code> auf <code>PM101</code> setzen.

=== Aktoren ===
Die Bedienungsanleitungen und die commandref liefern Informationen, welche Anlernvorgänge der Aktor unterstützt. Finden sich keine Hinweise auf besondere PC- oder Gateway-Anlernvorgänge, so kann Fhem immmer als virtueller Fhem-Schalter (Tasteremulation) eingelernt werden. Einige Aktoren unterstützen mehrere Arten von Anlernvorgängen. Hier ist der mit den meisten/besten Steuerungsmöglichkeiten zu bevorzugen.
 
'''Aktoren Beispiele:'''

==== unidirektionale Aktoren ====
Eine SenderID des TCM-Gateways muss bei unidirektionalen Aktoren immer im <code>define</code> des Devices stehen.

===== Teach-In als Tasteremulation =====
PEHA 451 FU-EP o.T. (Schaltaktor unidirektional) 

Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Eine frei SenderID des TCM-basierten Gateways heraussuchen und diese als EnOcean-Gerät in Fhem definieren, dazu im Befehl-Eingabefeld eingeben:
 define eg_fl_Licht EnOcean AABBCC01

Hierdurch wird in Fhem ein EnOcean-Gerät definiert, das standardmäßig das Attribut auf <code>subType</code> auf <code>switch</code> gesetzt hat. Fhem emuliert mit diesem EnOcean-Gerät einen EnOcean-Schalter (virtueller Fhem-Schalter).

Dieser virtuelle Fhem-Schalter wird in den Aktor wie ein physischer Schalter eingelernt. Den Aktor in den Anlernmodus bringen (Taste LRN/SET drücken) und den virtuellen Fhem-Schalter betätigen, indem im Befehl-Eingabefeld eingeben wird:
 set eg_fl_Licht B0
Wenn der Aktor den erfolgreichen Anlernvorgang signalisiert, den Anlermodos am Aktor ausschalten.

* exemplarischer Auszug aus fhem.cfg
 define eg_fl_Licht EnOcean AABBCC01        <--- AABBCC01 ist eine der 127 SenderID's des TCM mit der Fhem sendet 
 attr eg_fl_Licht room EG_Flur
 attr eg_fl_Licht eventMap BI:off B0:on
 attr eg_fl_Licht subType switch
 define FileLog_eg_fl_Licht FileLog ./log/ eg_fl_Licht-%Y.log eg_fl_Licht
 attr FileLog_eg_fl_Licht logtype text

Der Status des Devices im Webfrontend stimmt bei unidirektionalen Aktoren nur, wenn die Steuerung des Aktor ausschließlich über Fhem erfolgt. Wird der Aktor sowohl über einen physischen Schalter als auch über Fhem gesteuert, so müssen die Stati der beiden Devices für physischen und virtuellen Schalter im Webfrontend verknüpft werden, damit der richtige Status des Aktors angezeigt wird. ([[#Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen |siehe unten]])

===== Teach-In als Gateway/PC-Steuerung =====
"ältere" Eltako FSB61 [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FSB61NP_30200420-3_dtsch.pdf Bedienungsanleitung]
EEP: EEP A5-3F-7F 

Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Eine frei SenderID des TCM-basierten Gateways heraussuchen und diese als EnOcean-Gerät in Fhem definieren, dazu im Befehl-Eingabefeld eingeben:
 define eg_fl_Rollo EnOcean AABBCC02

Hierdurch wird in Fhem ein EnOcean-Gerät definiert, das standardmäßig das Attribut auf <code>subType</code> auf <code>switch</code> gesetzt hat. Das Attribut <code>subType</code> muss auf <code>manufProfile</code> geändert werden. Die Attribute <code>manufID</code> und <code>model</code> müssen auf die unten in der fhem.cfg gezeigten Werte gesetzt werden.

Dieser virtuelle Fhem-Schalter wird in den Aktor als PC/Szenentaster eingelernt indem im Befehl-Eingabefeld eingeben wird:
 set eg_fl_Rollo teach
Wenn der Aktor den erfolgreichen Anlernvorgang signalisiert, den Anlermodos am Aktor ausschalten.

* exemplarischer Auszug aus fhem.cfg
 define eg_fl_Rollo EnOcean AABBCC02        <--- AABBCC02 ist eine der 127 SenderID's des TCM mit der Fhem sendet 
 attr eg_fl_Rollo room EG_Flur
 attr eg_fl_Rollo subType manufProfile
 attr eg_fl_Rollo manufID 00D
 attr eg_fl_Rollo model FSB61

==== bidirektionale Aktoren ====
Eine SenderID des TCM-Gateways muss bei bidirektionalen Aktoren immer im Attribut <code>subDef</code> des Devices stehen.

===== Unidirektionales 4BS-Teach-In =====
RS485-Bus-Aktor 4-Kanal-Stromstoß-Schaltrelais FSR14
Schaltrelais (bidirektional)

Fhem in den learingMode versetzen, dazu im Befehl-Eingabefeld eingeben:
 set TCM310_0 teach 600

Die SenderID des Aktors heraussuchen und diese als EnOcean-Gerät in Fhem definieren, dazu im Befehl-Eingabefeld eingeben:
 define EnOcean_switch_FEFF4AF8 EnOcean FEFF4AF8

Eine frei SenderID des TCM-basierten Gateways heraussuchen und diese im Attribut <code>subDef</code> des angelegten Device hinterlegen.

Anschließend die Attribute <code>subType</code> und <code>gwCmd</code> wie im unten wiedergegebenen exemplarischen Auszug aus der fhem.cfg anlegen.

Jetzt den Aktor in den Lernmodus versetzen und dann von Fhem das Lerntelegramm verschicken:
 set EnOcean_switch_FEFF4AF8 teach
Lernmodus am Aktor ausschalten

* exemplarischer Auszug aus fhem.cfg
 define EnOcean_switch_FEFF4AF8 EnOcean FEFF4AF8  <- SenderID eines FSR14-Kanals (Aktor)
 attr EnOcean_switch_FEFF4AF8 subDef FF834381      <--- FF834381 ist eine der 127 SenderID's des TCM mit der Fhem sendet [[#Taster - physisch und in Fhem|(siehe unten)]]
 attr EnOcean_switch_FEFF4AF8 room EnOcean        # Der Raum kann angepasst werden
 attr EnOcean_switch_FEFF4AF8 gwCmd switching     # Wichtig für FSR14
 attr EnOcean_switch_FEFF4AF8 subType gateway     # Wichtig für FSR14
 define FileLog_EnOcean_switch_FEFF4AF8 FileLog ./log/EnOcean_switch_FEFF4AF8-%Y.log EnOcean_switch_FEFF4AF8
 attr FileLog_EnOcean_switch_FEFF4AF8 logtype text

(entnommen Forenbeitrag [http://forum.fhem.de/index.php/topic,25068.msg181966.html#msg181966], der weitere Erläuterungen enthält.)

===== Bidirektionales 4BS-Teach-In =====
Kleinstellantrieb MD15-FTL-xx 
Funkgesteuerter, batteriegespeister Kleinstellantrieb für Raumtemperaturregelung. (bidirektional)

4BS-Bidirektionales-Teach-In:

#Aktor möglicht komplett zurücksetzen, sofern nicht mehr im Original-Auslieferzustand
#falls vorhanden, alle bisherigen Fhem Devices des Aktors löschen
#Fhem in Lernmodus schalten: <code>set <IODev> teach <time/s></code>
#Taster am MD15-FTL-xx so lange drücken, bis ein Signalton ertönt. MD15 bestätigt erfolgreichen Anlernvorgang durch Aufleuchten Status-LED und 2 Signaltöne
#Aktor wird in Fhem automatisch mit allen notwendigen Parametern angelegt.

* exemplarischer Auszug aus fhem.cfg
 define EnO_sensor_01000EFA EnOcean 01000EFA
 attr EnO_sensor_01000EFA IODev TCM310_0
 attr EnO_sensor_01000EFA comMode biDir
 attr EnO_sensor_01000EFA destinationID unicast
 attr EnO_sensor_01000EFA manufID 00A
 attr EnO_sensor_01000EFA room EnOcean
 attr EnO_sensor_01000EFA subDef 00000000
 attr EnO_sensor_01000EFA subType hvac.01
 define FileLog_EnO_sensor_01000EFA FileLog ./log/EnO_sensor_01000EFA-%Y.log EnO_sensor_01000EFA
 attr FileLog_EnO_sensor_01000EFA logtype text
 attr FileLog_EnO_sensor_01000EFA room EnOcean

===== UTE-Teach-In =====
Einbau-Aktor 452 FU-EBIM o.T.
2-Kanal-Multifunktionsaktor (bidirektional) mit Energiemessfunktion

UTE-Teach-In:

#Aktor möglicht komplett zurücksetzen, sofern nicht mehr im Original-Auslieferzustand
#falls vorhanden, alle bisherigen Fhem Devices des Aktors löschen
#Fhem in Lernmodus schalten: <code>set <IODev> teach <time/s></code>
#Aktor-Kanal 0 oder 1 in Lernmodus versetzen (immer nur einen Kanal)
#Aktor-Kanal 0 oder 1 wird in Fhem automatisch mit allen notwendigen Parametern angelegt.
#Anlernen für 2. Kanal wie nach 3. bis 5. beschrieben wiederholen

Die Kanäle können jetzt geschaltet werden mit:

*Fhem Device für Kanal 0: set <Name_0> on|off 0
*Fhem Device für Kanal 1: set <Name_1> on|off 1

Falls gewünscht, kann der Kanal mit dem Attribut attr <Name_0|1> defaultChannel 0|1 voreingestellt werden. Dann entfällt die Angabe des Kanals im set-Befehl.

Die Statusrückmeldungen mit den aktuellen Werten des Energieverbrauches und der Leistung werden vom Aktor automatisch gesendet. Sie werden sowohl als Telegramme nach EEP D2-01-08 als auch nach EEP A5-11-04 mit unterschiedlichen Absenderadressen (vgl. Etikett in Original-Verpackung) gesendet.
Die Rückmeldungen nach EEP D2-01-08 werden von Fhem im Aktor-Device subType actuator.01 berücksichtigt. Die Rückmeldungen nach EEP A5-11-04 werden von Fhem in einem senor-device subType lightCtrlState.02 berücksichtigt. 

(entnommen [http://forum.fhem.de/index.php/topic,22527.msg161008.html#msg161008 Forenbeitrag], der weitere Erläuterungen enthält.)


=== Schalter - physisch und virtuell in Fhem ===

Fhem kann sich '''nicht''' als einer der vorhandenen (automatisch angelegten) Sensoren ausgeben (um z.B. das Licht zu schalten) sondern verwendet eigene SenderID/DestinationID's. 
* Fhem stehen 127 fortlaufende eigene SenderID/DestinationID zur Verfügung
* beginnend mit der baseID des TCM + 1

Die baseID des TCM erhält man mit dem Befehl
 get TCM310_0 baseID 
im Eingabefenster (gefolgt vom drücken der "Eingabe"-Taste ;-) )
Das Webfrontend zeigt dann:
 BaseID=AABBCC00,RemainingWriteCycles=0A
Die niedrigste SenderID/DestinationID in diesem Beispiel ist AABBCC0'''1''' (BaseID=AABBCC00 +1 HEX!!!)

==== Definition eines virtuellen Fhem Schalters zum Steuern von EnOcean Aktoren ====
 define fhemSchalter EnOcean AABBCC01              <--- AABBCC01 ist eine der 127 SenderID's des TCM mit der Fhem sendet
 attr fhemSchalter subType switch

Durch diese Definition wird ein 8-fach Taster (4 Kanälen (A,B,C,D) zu je 2 Tasten (0,I)) erzeugt (all diese 8 Taster senden mit der gleichen SenderID des TCM). Entspricht einem Gerät mit 4 Schaltwippen die jeweils "oben" '''oder''' "unten" gedrückt sein können. 

Der Taster 0 des Kanal A wird "gedrückt" mit
 set fhemSchalter A0

==== Aufteilung der Kanäle in unabhängige Devices ====
Um die 4 Kanäle jeweils einzeln als Schalter (einzelne Schaltwippe) im WebFrontend abzubilden dient folgende Konstruktion: 
siehe auch [[ReadingsProxy]]
 #Kanal A zur Steuerung mit on und off
 define fhemSchalterKanalA readingsProxy fhemSchalter:state
 attr fhemSchalterKanalA setFn {($CMD eq "on")?"AI":"A0";;}
 attr fhemSchalterKanalA setList on off
 attr fhemSchalterKanalA valueFn {$LASTCMD}
 attr fhemSchalterKanalA webCmd on:off

 #Kanal B zur Steuerung mit on und off
 define fhemSchalterKanalB readingsProxy fhemSchalter:state
 attr fhemSchalterKanalB setFn {($CMD eq "on")?"BI":"B0";;}
 attr fhemSchalterKanalB setList on off
 attr fhemSchalterKanalB valueFn {$LASTCMD}
 attr fhemSchalterKanalB webCmd on:off

 #Kanal C zur Steuerung mit on und off
 define fhemSchalterKanalC readingsProxy fhemSchalter:state
 attr fhemSchalterKanalC setFn {($CMD eq "on")?"CI":"C0";;}
 attr fhemSchalterKanalC setList on off
 attr fhemSchalterKanalC valueFn {$LASTCMD}
 attr fhemSchalterKanalC webCmd on:off

 #Kanal D zur Steuerung mit on und off
 define fhemSchalterKanalD readingsProxy fhemSchalter:state
 attr fhemSchalteKanalD setFn {($CMD eq "on")?"DI":"D0";;}
 attr fhemSchalterKanalD setList on off
 attr fhemSchalterKanalD valueFn {$LASTCMD}
 attr fhemSchalterKanalD webCmd on:off

Werden diese Fhem Taster (und etwaige physische Taster) in EnOcean Aktoren eingelernt (siehe Anleitung des Aktors), so können nun die EnOcean Aktoren mit physischen Tastern (sendet mit der 8-stelligen SenderID des Tasters) und mit Fhem devices (sendet mit einer der 127 eigenen SenderIDs) bedient werden.

==== Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen ====
Um im Webfrontend die Aktionen beider Schalter in einem Element zusammengefasst und damit den realen Zustand bei '''unidirektionalen''' Aktoren zu sehen, dient folgendes Konstrukt mit einer <code>structure</code>:
(Bei bidirektionalen Aktoren ist dies aufgrund der Statusrückmeldungen nicht notwendig. Achtung: Teilweise müssen Statusrückmeldungen/Bestätigungstelegramme erst am Aktor eingeschaltet werden)

 #Definition des Fhem Schalters
 define fhemSchalter EnOcean AABBCC01              <--- AABBCC01 ist eine der 127 SenderID's des TCM mit der Fhem sendet
 attr fhemSchalter eventMap BI:off B0:on
 attr fhemSchalter icon icoBELEUCHTUNG.png
 attr fhemSchalter subType switch
 
 #Definition des physischen Tasters (z.B. durch autocreate erzeugt)
 define EnO_switch_0021E4BB EnOcean 0021E4BB      <--- 0021E4BB ist die (aufgedruckte) 8-stellige SenderID des physischen Tasters
 attr EnO_switch_0021E4BB eventMap BI:off B0:on
 attr EnO_switch_0021E4BB room EnOcean
 attr EnO_switch_0021E4BB subType switch
 attr EnO_switch_0021E4BB dummy
 
 #fhemSchalter ist der Fhem Schalter
 #EnO_switch_0021E4BB ist der (z.B. per autocreate erstellte) Fhem-Taster
 define Gruppe_test_notify structure room fhemSchalter EnO_switch_0021E4BB
 attr Gruppe_test_notify eventMap BI:off B0:on
 attr Gruppe_test_notify room Gaestezimmer
 attr Gruppe_test_notify clientstate_behavior last

Alternativ kann man für diesen Zweck auch ein <code>notify</code> in Verbindung mit <code>setreading <device> state <state>)</code> nutzen:

 define nAbgleich notify EnO_switch_0021E4BB:(on|off) setreading fhemSchalter state $EVENT

== FAQ ==
=== Warum schaltet mein Aktor nicht, wenn ich im WebFrontend auf das Icon für den physischen Taster/Schalter klicke bzw. mit <code>set <device> <command></code> ansteuere? ===
:Aus Sicherheitsgründen können bei EnOcean keine physischen Geräte(-adressen) durch Fhem bzw. das TCM-Gateway emuliert werden. Fhem muss zur Steuerung separat an den Aktor angelernt werden. Dazu eine der TCM-Adressen an den Aktor anlernen.
=== Wie ermittelt man freie Sender-IDs des TCM-basierten Funkgateways? ===
* Aus der oben [[EnOcean_Starter_Guide#Vorbereitung|gezeigten Tabelle]] oder hilfsweise mit den nachfolgenden Befehlen
* Anzeige der nächsten freien Sender-ID: <pre>{EnOcean_CheckSenderID("getNextID", "<TCM-device>", "0000000")}&#13; </pre>
* Auflistung der bereits vergebenen Sender-IDs: <pre>{EnOcean_CheckSenderID("getUsedID", "<TCM-device>", "0000000")}&#13; </pre>
* Auflistung der noch nicht vergebenen Sender-IDs: <pre>{EnOcean_CheckSenderID("getFreeID", "<TCM-device>", "0000000")}&#13; </pre>
=== Welche Infos sollten Anfragen im EnOcean-Forum enthalten? ===
* detaillierte Beschreibung des Problems
* beteiligte Komponenten (genaue Bezeichnung und evtl. Link auf Hersteller-Dokumentation)
* Config-Auszug (fhem.cfg)
* list des jeweiligen devices (<code>list <device></code>)
* logs mit verbose 5 (<code>attr <device> verbose 5</code>)
=== Wie kann ich zur Fortentwicklung der EnOcean-Module beitragen? ===
* Erfolgreichen Einsatz von neuen/bisher nicht gemeldeten EnOcean-Geräten im Forum mitteilen
* In der Commandref als [untested] markierte EEPs bei erfolgreichen Tests im Forum als getestet melden
* Codeschnipsel und Ideen im Forum posten
* Fehler und Probleme im Forum melden
* Wiki: Neue Geräte ins Wiki aufnehmen; Codeschnipsel und Beispiele einpflegen
=== Für mein EnOcean-Gerät gibt es keine spezielle Wiki-Seite; wo finde ich dann Informationen? ===
* In der commandref nach dem Gerät suchen
* In der commandref nach dem verwendeten EEP suchen
* Im wiki nach einem Gerät mit einer ähnlichen EEP suchen
* Im EnOcean-Forum nach Threads zum Gerät/EEP suchen
=== Warum funktioniert mein Eltako-Gerät nicht wie in commandref/Wiki beschrieben? ===
* Eltako-Geräte haben bei gleicher Produktbezeichnung teilweise je nach Produktionswoche unterschiedliche Funktionen/Eigenschaften
* die Produktionswoche ist auf dem Gerät angegeben
* in den nach Produktionswoche untergliederten [http://www.eltako.com/de/bedienungsanleitungen/der-gebaeudefunk.html Bedienungsanleitungen] stehen genauere Angaben
* Angaben in commandref/Wiki analog für die Angaben laut Bedienungsanleitung für den speziellen Produktionszeitraum umsetzen
* bei gravierenden Abweichungen und Neuerungen Info im Forum/Wiki 
 


[[Kategorie:HOWTOS]]
[[Kategorie:EnOcean Components]]