FHEMWiki - Benutzerbeiträge [de]

JeeLink

2019-01-14T09:43:11Z

Maxmax: Erweiterung im Bereich JeeLink aus FHEM flashen

'''JeeLink''' ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.
{{Infobox Hardware
|Bild=JeeLink.jpg
|Bildbeschreibung=JeeLink mit Drahtantenne
|HWProtocol=PCA301, EC3000, RoomNode oder LaCrosse und EMT7110
|HWType=[[Interface]]
|HWCategory=
|HWComm=433/868/913 MHz
|HWChannels=?
|HWVoltage=5 V
|HWPowerConsumption=ca. 90 mA
|HWPoweredBy=USB
|HWSize=23*67*9mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#JeeLink 36_JeeLink.pm]
|ModOwner={{Link2FU|430|Andre / justme1968}}
|HWManufacturer=JeeLabs
}}

== Beschreibung ==
Vergleichbar mit dem [[CUL]] von Busware, ist der JeeLink ein USB-Stick, mit dem Funk-Hausautomations-Komponenten angebunden werden können. CUL und JeeLink unterscheiden sich im Funkmodul (CUL -> CC1101; JeeLink -> RF12B), die nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!

Den JeeLink gibt es in einer
* 433 MHz Version
* 868 MHz Version (Standard)
* 915 MHz Version (Betrieb in Europa nicht zugelassen)

== Vorbereitung JeeLink ==
Um mit dem JeeLink die jeweils gewünschten Signale empfangen zu können, ist er zunächst mit der passenden Firmware zu versorgen. Dies kann auf zwei Arten geschehen. Entweder durch das selber kompilieren der Software und das Flashen aus der Arduino IDE oder aus FHEM heraus mit einem aktuellen Firmwareimage das per update mit ausgeliefert wird.

=== Selber Kompilieren ===
[[Datei:JeeLink_flashen_1.jpg|mini|100px|rechts|Vorbereitung: Arduino einrichten]]
Um den JeeLink mit FHEM benutzen zu können, muss (mit der Arduino Software / Entwicklungsumgebung (IDE)) eine spezifische "Firmware" (ein Sketch) auf dem JeeLink installiert werden. Die generelle Vorbereitung für diese Aktion ist unabhängig vom benötigten Sketch und besteht aus den folgenden Schritten:
* Für Windows oder Mac OS X den passenden [http://www.ftdichip.com/Drivers/VCP.htm FTDI Treiber] installieren, unter Linux ist dieser meist schon vorhanden
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
* Je nach Sketch einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Herunterladen des benötigten Sketches (aus [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino FHEM/contrib])
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software und JeeLink flashen

=== JeeLink aus Arduino flashen ===
[[Datei:JeeLink_flashen_2.jpg|mini|100px|rechts|JeeLink Flashen]]
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software
* Seriellen Port des JeeLink auswählen
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen
* Sketch mit "Datei öffnen" auswählen
* Upload klicken

=== JeeLink aus FHEM flashen ===
* Auf dem FHEM System muss "avrdude" installiert sein. Das kann z.B. über die "normale" Linux Paketverwaltung geschehen.
** Auf dem Paspberry (Raspbian Linux) funktioniert die Installation von "avrdude" mit <code>sudo apt-get update</code> und dannach <code>sudo apt-get install avrdude</code>
* mit <code>set <JeeLinkDevice> flash [firmware]</code> wird das Flashen angestossen <code>firmware</code> kann LaCrosse, PCA301 oder EC3000 sein. Wenn <code>firmware</code> nicht angegeben wird versucht FHEM den Namen der zu flashenden Firmware aus der zur Zeit installierten Firmware abzuleiten.
* im FHEM Log kann der Ausgang des Flashvorgangs kontrolliert werden
* über das <code>flashCommand</code> Attribut lässt sich das Kommando zum Flashen an besondere Anforderungen anpassen

'''Vorsicht bei Jeelink Clones!'''

Jeelink Clones basierend auf dem Arduino Nano haben normalerweise keinen Optibootloader drauf im Gegensatz zum Original JeeLink und JeeNode.

Konsequenz:

Beim "Nano Clone" und ähnliches muß man zum flashen in FHEM die Baudrate setzen mit "-b 57600"

Original JeeLink, original JeeNode, und alle Arduinos, die einen Optibootloader drauf haben flashen in FHEM ohne "-b 57600"

== Hinweise zum Betrieb mit FHEM ==
Um den JeeLink (erstmalig) mit FHEM benutzen zu können, muss dieser erfolgreich geflasht worden sein.
* JeeLink an den FHEM-Rechner anschließen
* Auf Linux Systemen kann es notwendig sein, mit <code>mknod /dev/ttyUSB0 c 188 0</code> das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)

=== Definition in fhem.cfg ===
Erforderliche Definitionen in FHEM:
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt
*x=0,1,2, usw.

Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse Sensoren incl. IT+ Wetterstation WS1600, EMT7110, EC3000, und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.

Pro Geräte-Art/Protokoll muss ein eigener JeeLink mit dem passenden Sketch zum Empfang dieser Daten vorhanden sein (es kann jeweils nur ein Sketch im JeeLink aktiv sein und es gibt (zumindest derzeit (04/2014)) keinen Sketch, der mehr als eines der Protokolle abdeckt).

'''Anmerkung:''' Der LaCrosse Sketch deckt sowohl die LaCrosse Temperatursensoren, die IT+ Wetterstation WS1600 als auch den Energieverbrauchssensor EMT7110 ab.

=== PCA301 Sketch ===
Der Sketch für die Unterstützung der ''PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung'' (PCA301-pcaSerial.zip) kann aus dem [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ FHEM-Repository] heruntergeladen werden. Details zur Benutzung finden sich im Artikel zur [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]].

Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch wahrscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man in diesem Fall keine Steckdose angelernt.

==== Frequenzanpassung über modifizierten Sketch ====
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' kann man dann ermitteln, ob die Funksignale z.B. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:
:<code>static uint16_t rf12_center_freq = 0xA70C;</code>
Anschließend auf den JeeLink neu flashen.

==== Frequenzanpassung über Attribut initCommands ====
Über das <code>initCommands</code> lässt sich die gefundene Frequenz einstellen, ohne dass die Firmware verändert werden muss.
:<code>attr <JeeLinkDevice> initCommands <hhhh>h</code>

=== LaCrosse Sketch ===
Der Sketch für die Unterstützung der LaCrosse Temperatursensoren, der IT+ Wetterstation WS1600 und des Energieverbrauchssensors EMT7110 so wie auch TechnoLine Sensoren (Temperatur, Luftfeuchte,...). 

* Er kann aus dem [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino FHEM-Repository] heruntergeladen werden.
* Alternative ist den Sketch direkt über FHEM zu flashen <code>set <JeeLinkDevice> flash LaCrosse</code> z.B.: <code>set myJeeLink flash LaCrosse</code> zuvor sollte aber ein FHEM update mit <code>update</code> durchgeführt werden.
 

'''Sensoren anlernen:
Mit folgenden Befehl hat man die Möglichkeit 60 Sekunden ein Gerät anzulernen. Das Gerät erscheint dann unter der Rubrik LaCrosse. <code>set <JeeLinkDevice> LaCrossePairForSec 60</code> zum Beispiel: <code>set myJeeLink LaCrossePairForSec 60</code>.

'''In der neuesten Version unterstützt er auch den SuperJee''' (siehe auch diesen {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}}) mit folgenden Optionen:

* Option 1 (Dual RFM):
:Es kann ein zweiter RFM12B oder RFM69CW angeschlossen werden. Somit können zwei data rates (z.B. 17241 für TX29DTH und 8842 für WS 1600) gleichzeitig empfangen werden. Das geht natürlich auch mit dem toggle mode, nur ist es bei der Wetterstation ärgerlich, wenn man 30 Sekunden lang nichts empfängt und dadurch die alles entscheidende Windböe verpasst.
* Option 2 (BMP180):
:Da der Luftdruck in den Basisstationen gemessen wird, steht er für FHEM nicht zur Verfügung.
Deshalb kann nun optional ein BMP180 oder BMP085 angeschlossen werden. Auch hier wird automatisch erkannt, ob er vorhanden ist.
:Der BMP180 wird mit 3,3V versorgt und SDA mit PC4 und SCL mit PC5 verbunden (siehe die in diesem {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}} angehängte SuperJee-CL.png)

==== Übersicht Kommandos ====
<n>a set to 0 if the blue LED bothers
<n>f initial frequency in kHz (5 kHz steps, 860480 ... 879515) (for RFM #1)
<n>F initial frequency in kHz (5 kHz steps, 860480 ... 879515) (for RFM #2)
<n>h altituide above sea level
<n>m bits 1: 17.241 kbps, 2 : 9.579 kbps, 4 : 8.842 kbps (for RFM #1)
<n>M bits 1: 17.241 kbps, 2 : 9.579 kbps, 4 : 8.842 kbps (for RFM #2)
<n>r use one of the possible data rates (for RFM #1)
<n>R use one of the possible data rates (for RFM #2)
<n>t 0=no toggle, else interval in seconds (for RFM #1)
<n>T 0=no toggle, else interval in seconds (for RFM #2)
v show version
<n>y if 1 all received packets will be retransmitted (Relay mode)

==== Relay-Betrieb ====
Der LaCrosse Sketch ermöglicht auch den Relay-Betrieb zur Reichweitenverbesserung. Er funktioniert damit ähnlich wie z. B. ein WLAN Range Extender. Wenn der Sketch für den Relay-Betrieb konfiguriert ist, wird jedes empfangene IT+ Datenpaket, das eine gültige Prüfsumme hat, direkt nach dem Empfang wieder gesendet.

Das Prinzip ist generell recht einfach:
# JeeLink im Sketch als Relais konfigurieren und flashen.
# Auf "halber Strecke" (d.h. irgendwo zwischen dem primären Sender und dem entfernten Empfänger) auf ein USB-Steckernetzteil stecken. Der JeeLink arbeitet in diesem Modus "autonom", er benötigt also lediglich einen Spannungsversorgung.

Der JeeLink empfängt und decodiert alle Protokolle, die er auch für FHEM unterstützt. Wenn er ein Paket empfangen hat (egal von welchem Sensor) und CRC OK war, dann sendet er es wieder aus. Der JeeLink am FHEM merkt keinen Unterschied. Falls ein Paket es doch bis zum FHEM direkt geschafft hat, kommt es dort zweimal an. Diese Situation muss in FHEM behandelt werden.

Details zu diesem Betriebsmodus sind in diesen Forenbeiträgen ({{Link2Forum|Topic=14786|Message=165153|LinkText=LaCrosse}} bzw. {{Link2Forum|Topic=26494|Message=196648|LinkText=EMT7110}}) zu finden.

==== Frequenzanpassung ====
Ab Version LaCrosseITPlusReader.10.1e wurde der Sketch so erweitert, dass man von FHEM aus die Frequenz setzen kann. Dazu versteht der Sketch das neue Kommando "f":
:<code>set myJeeLink raw 868295f</code>
setzt die Frequenz auf 868295 kHz.

Die Frequenz kann im Bereich von 860480 kHz bis 879515 kHz in 5kHz -Schritten eingestellt werden.
Details dazu in diesem {{Link2Forum|Topic=14786|Message=222541}} im Forum. Die Frequenzanpassung ist insbesondere beim 30.3155.WD häufig erforderlich, weshalb er als kritisch einzustufen und nicht zu empfehlen ist (siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}).

==== Toggle und Datenrate ====
Toggle
t: toggle time
20t = alle 20 Sekunden die Datenrate wechseln

Datenrate
m: toggle mode
bits: 1= 17.241 kbps, 2= 9.579 kbps, 4= 8.842 kbps
3m ist 17.241 kbps (TX29) und 9.579 kbps (TX35)

Beispiel initCommands
6m 30t v
Zwischen 8.842 kbps und 9.579 kbps wechseln (4+2=6), alle 30 Sekunden

==== Unterstützte Sensoren und Aktoren incl. Wetterstation WS 1600 ====
{{Randnotiz|RNTyp=y|RNText=Die Ausführungen in diesem Abschnitt gelten ab der Version 10.1q auch für die Wetterstation WS1080.

'''Wichtig WS1800''': die WS1080 gibt es (unter gleichem Namen) in einer "OOK"- und in einer "FSK"-Version.
* Der LaCrosse Sketch und das LaCrosseGateway können nur die FSK-Version empfangen, die OOK-Version wird nicht unterstützt.
* Die FSK-Version ist zu erkennen an einem runden grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS 7". Details dazu in {{Link2Forum|Topic=14786|Message=363766|LinkText=diesem Forenbeitrag}}
}}

Die in der folgenden Liste (Quelle: {{Link2Forum|Topic=14786|Message=164801|LinkText=FHEM Forum}}) aufgeführten Sensoren wurden bisher erfolgreich getestet:

{| class="wikitable"
!Bezeichnung !! Datenrate !! Link / Hinweise
|-
| TX21IT || 17.241 kbps ||
|-
| TX25-IT || 17.241 kbps ||
|-
| TX27-IT || 17.241 kbps ||
|-
| TX29-IT || 17.241 kbps ||
|-
| TX29DTH-IT || 17.241 kbps ||
|-
| TX37 || 17.241 kbps ||
|-
| TX35TH-IT || 9.579 kbps ||
|-
| TX35DTH-IT || 9.579 kbps ||
|-
| 30.3143.IT || 17.241 kbps ||
|-
| 30.3144.IT || 17.241 kbps || ({{Link2Forum|Topic=17662|LinkText=Forenthread}})
|-
| 30.3147.IT || 17.241 kbps ||
|-
| 30.3155WD || 9.579 kbps || kritisch; nicht zu empfehlen; siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}
|-
| 30.3156WD || 9.579 kbps || Batterie-kritisch. Funktioniert schlecht mit Akkus!
|-
| 30.3187.IT || 17.241 kbps || haben alle die gleiche ID, daher nur einzeln verwendbar ({{Link2Forum|Topic=64636|LinkText=Forenthread}})
|-
| WT440XH || 17.241 kbps ||
|-
| WS 1600 (TX22) || 8.842 kbps || ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})
|-
| WS 1080 || 17.241 kbps || Bitte Hinweise beachten! ({{Link2Forum|Topic=14786|Message=363766|LinkText=Forenbeitrag}})
|-
| [[EMT7110]] || 9.579 kbps || ({{Link2Forum|Topic=26494|LinkText=Forenthread}})
|-
| LevelSender || 17.241 kbps || ({{Link2Forum|Topic=23217|LinkText=Forenthread}})

|}

Werden Sensoren mit unterschiedlichen Datenraten gleichzeitig betrieben, ist der Toggle Modus einzustellen, z.B. mit dem Befehl
:<code>initCommands 6m 30t v </code>
wobei ''30t'' für "Toggle Modus, alle 30 Sekunden" steht.

=== Energy Count 3000 Sketch ===
Der Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker kann aus dem [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ FHEM-Repository] heruntergeladen werden.

Das FHEM Modul dazu (36_EC3000.pm) ist genau wie die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) mittlerweile im aktuellen FHEM enthalten.

=== JeeLabs RoomNode ===
Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in {{Link2Forum|Topic=11648|Message=92037|LinkText=diesem Forenbeitrag}} enthalten.

=== JeeLink LED deaktivieren ===
Ein "dauerhaftes" Deaktivieren der LED des JeeLink ist möglich mit
:<code>define not.global notify global:INITIALIZED set myJeeLink led off</code>
damit wird, sobald FHEM komplett gestartet ist, von FHEM der Befehl zum Ausschalten der LED gesendet. Alternativ kann mit
:<code>attr myJeeLink initCommands 0a v</code>
dem Sketch die Anweisung gegeben werden, bei der Initialisierung die LED zu deaktivieren.
''Quelle: dieser {{Link2Forum|Topic=27161|LinkText=Forenthread}}''

=== Weitergehende Informationen ===
Hinweise zum Betrieb eines JeeLink mit FHEM finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:
* {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301}} - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in FHEM.
* {{Link2Forum|Topic=14786|LinkText=JeeLink / LaCrosse}} - JeeLink Modul zur Einbindung von La Crosse
* {{Link2Forum|Topic=11648|Message=92019|LinkText=JeeLink / EC3000}} - Anfänge der Entstehung der EC3000 Unterstützung in FHEM.
* Hinweise zu {{Link2Forum|Topic=11648|Message=92037|LinkText=JeeLabs RoomNode}} und anderen JeeLab Nodes
* {{Link2Forum|Topic=25399|Message=183910|LinkText=JeeLink mit FHEM2FHEM nutzen}}

== Bekannte Probleme ==
* Beim Betrieb an einer [[AVM Fritz!Box|FritzBox]] wird der JeeLink unter Umständen als ''Für die Nutzung mit dem USB-Fernanschluss reserviert'' angezeigt. In diesem Fall muss die Reservierung deaktiviert/aufgehoben werden (Details dazu in diesem {{Link2Forum|Topic=16579|LinkText=Forenthread}}).
* Die Version ''v3c'' des JeeLink funktioniert (Stand 06/2015) nur mit dem LaCrosse Sketch. PCA301 und EC3000 Sketch sind auf den JeeLink Classic beschränkt (siehe unter anderem Diskussion im Forum, startend {{Link2Forum|Topic=11648|Message=308267|LinkText=hier}}).

== Weblinks ==
* [http://jeelabs.com/products/jeelink JeeLabs], JeeLink Hersteller
* [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ PCA301 Sketch] im SVN
* [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ LaCrosse Sketch] im SVN
* [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ EC3000 Sketch] im SVN
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von LaCrosse Temperatursensoren an FHEM
* {{Link2Forum|Topic=23217|LinkText=LevelSender}} Tankfüllstand mit JeeLink empfangen

[[Kategorie:Interfaces]]
[[Kategorie:Other Components]]
[[Kategorie:868MHz]]
[[Kategorie:433MHz]]

PushNotifier

2018-12-26T10:19:49Z

Maxmax: Ergänzung im Bereich <appname>

{{Infobox Modul
|ModPurpose=Senden von Push-Nachrichten auf Tablets oder Smartphones
|ModType=d
|ModForumArea=Unterstützende Dienste
|ModTechName=70_PushNotifier.pm
|ModOwner={{Link2FU|5244|xusader}}
}}

[[PushNotifier]] ist ein Dienst, mit dem es möglich ist, sogenannte "Push" Nachrichten auf ein Apple oder Android Gerät zu schicken [http://pushnotifier.de/push/]. Der Dienst sowie die Apps sind kostenlos. Um die Pushnachrichten zu empfangen muss die dazu passende App installiert werden. [http://pushnotifier.de/apps/]

== Installation ==
Es muss zwingend ein [http://gidix.de/register/ PushNotifier Account] erstellt werden. Ist der Account angelegt, muss auf der [http://gidix.de/settings/api/ Api Settings Seite] eine Application angelegt werden. Die Application dient dazu, die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. Auf dem Endgerät muss die Applikation "PushNotifier" installiert werden. Dies geschieht z.B. bei Apple-Geräten mit Hilfe des AppStores. Danach müssen (nach erfolgter Registrierung auf der Webseite) die einzelnen Geräte, auf denen Nachrichten gesendet werden sollen, registriert werden. Die Registrierung der Geräte erfolgt nach Anmelden in der App auf dem Endgerät automatisch.

* Apple Geräte: [https://itunes.apple.com/de/app/pushnotifier/id791683557?mt=8 PushNotifier App im Apple Store]
* Android Geräte: [https://play.google.com/store/apps/details?id=com.gidix.pushNotifier&hl=DE PushNotifier App im Google Playstore]

Benötigt wird das Perlmodul Try::Tiny. Dieses mit "cpan -i Try::Tiny" nachinstallieren.

== Einbinden des Dienstes in FHEM ==
Das Modul wird mit dem folgenden Befehl in fhem definiert:
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> <RegEx> </nowiki></code>

'''Beispiele:'''
* für alle registrierten Geräte
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> .* </nowiki></code>
* für eine Gerätegruppe
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> iPhone.* </nowiki></code>
* für ein bestimmtes Gerät
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> iPhone5 </nowiki></code> 

Das <apiToken> und <appname> erhält man [http://gidix.de/settings/api/ hier]:' 
'''<apiToken>''' wird angezeigt wenn man auf den Button "Enable" klickt (unter "API settings", Überschrft "PushNotifier API") 
'''<appname>''' muss selbst definiert werden und darf nicht doppelt vorkommen.
* Man klickt unter "API Applications" auf "+ Create Application"
* Title und Description kann beliebig gewählt werden und hat keine Auswirkung auf die Funktion
* Unter Package wird nun der <appname> gewählt. Es funktioniert nur folgende schreibweise "com.EinBeliebigerText.app". Der <appname> muss mit "com." beginnen und mit ".app" enden. 
''Hier noch eine andere Erklärung da es hier oft Probleme gibt: Er muss die folgende Form haben: "com.<appBezeichnung>.app", wobei <appBezeichnung> eine beliebige Bezeichnung sein kann, die aber noch nicht verwendet sein darf. (Anscheinend darf sie auch nicht von anderen Nutzern verwendet werden.) Beispiel: "com.fhem_xyz.app"'' 

Die deviceIDs werden in den Internals des Moduls angezeigt. 
Zum Testen empfielt sich das Modul: "für alle registrierten Geräte" siehe oben zu erstellen.

== Senden einer Nachricht mit FHEM ==
Syntax:
:<code><nowiki>set <PushNotifier_device> message <message> </nowiki></code>

Beispiel:
:<code><nowiki>fhem("set pushmsg message Das Fenster wurde geschlossen!"); </nowiki></code>

Mehrzeilige Nachricht:
:<code><nowiki>fhem("set pushmsg message Das Fenster wurde geschlossen!_Zweite Zeile._Dritte Zeile."); </nowiki></code>

Nachricht, sobald FHEM neu geladen wurde, mit Hilfe eines "notify":
:<code><nowiki>define notify_fhem_reload notify global:INITIALIZED set pushmsg message Ich wurde neu geladen! </nowiki></code>

== Links ==
* Thread über das Modul im {{Link2Forum|Topic=25440|LinkText=FHEM Forum}}
* PushNotifier [http://a.gidix.de/v1/pushnotifier/sending/ API]

[[Kategorie: Code Snippets]]

PushNotifier

2018-12-26T09:49:15Z

Maxmax: Genauere Beschreibung zur Einrichtung

{{Infobox Modul
|ModPurpose=Senden von Push-Nachrichten auf Tablets oder Smartphones
|ModType=d
|ModForumArea=Unterstützende Dienste
|ModTechName=70_PushNotifier.pm
|ModOwner={{Link2FU|5244|xusader}}
}}

[[PushNotifier]] ist ein Dienst, mit dem es möglich ist, sogenannte "Push" Nachrichten auf ein Apple oder Android Gerät zu schicken [http://pushnotifier.de/push/]. Der Dienst sowie die Apps sind kostenlos. Um die Pushnachrichten zu empfangen muss die dazu passende App installiert werden. [http://pushnotifier.de/apps/]

== Installation ==
Es muss zwingend ein [http://gidix.de/register/ PushNotifier Account] erstellt werden. Ist der Account angelegt, muss auf der [http://gidix.de/settings/api/ Api Settings Seite] eine Application angelegt werden. Die Application dient dazu, die Nachrichten FHEM zuzuweisen und sie leichter erkennbar zu machen. Auf dem Endgerät muss die Applikation "PushNotifier" installiert werden. Dies geschieht z.B. bei Apple-Geräten mit Hilfe des AppStores. Danach müssen (nach erfolgter Registrierung auf der Webseite) die einzelnen Geräte, auf denen Nachrichten gesendet werden sollen, registriert werden. Die Registrierung der Geräte erfolgt nach Anmelden in der App auf dem Endgerät automatisch.

* Apple Geräte: [https://itunes.apple.com/de/app/pushnotifier/id791683557?mt=8 PushNotifier App im Apple Store]
* Android Geräte: [https://play.google.com/store/apps/details?id=com.gidix.pushNotifier&hl=DE PushNotifier App im Google Playstore]

Benötigt wird das Perlmodul Try::Tiny. Dieses mit "cpan -i Try::Tiny" nachinstallieren.

== Einbinden des Dienstes in FHEM ==
Das Modul wird mit dem folgenden Befehl in fhem definiert:
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> <RegEx> </nowiki></code>

'''Beispiele:'''
* für alle registrierten Geräte
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> .* </nowiki></code>
* für eine Gerätegruppe
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> iPhone.* </nowiki></code>
* für ein bestimmtes Gerät
:<code><nowiki>define pushmsg PushNotifier <apiToken> <appname> <user> <password> iPhone5 </nowiki></code> 

Das <apiToken> und <appname> erhält man [http://gidix.de/settings/api/ hier]:' 
'''<apiToken>''' wird angezeigt wenn man auf den Button "Enable" klickt (unter "API settings", Überschrft "PushNotifier API") 
'''<appname>''' muss selbst definiert werden und darf nicht doppelt vorkommen.
* Man klickt unter "API Applications" auf "+ Create Application"
* Title und Description kann beliebig gewählt werden und hat keine Auswirkung auf die Funktion
* Unter Package wird nun der <appname> gewählt. Es funktioniert nur folgende schreibweise "com.EinBeliebigerText.app". Der <appname> muss mit "com." beginnen und mit ".app" enden. 

Die deviceIDs werden in den Internals des Moduls angezeigt. 
Zum Testen empfielt sich das Modul: "für alle registrierten Geräte" siehe oben zu erstellen.

== Senden einer Nachricht mit FHEM ==
Syntax:
:<code><nowiki>set <PushNotifier_device> message <message> </nowiki></code>

Beispiel:
:<code><nowiki>fhem("set pushmsg message Das Fenster wurde geschlossen!"); </nowiki></code>

Mehrzeilige Nachricht:
:<code><nowiki>fhem("set pushmsg message Das Fenster wurde geschlossen!_Zweite Zeile._Dritte Zeile."); </nowiki></code>

Nachricht, sobald FHEM neu geladen wurde, mit Hilfe eines "notify":
:<code><nowiki>define notify_fhem_reload notify global:INITIALIZED set pushmsg message Ich wurde neu geladen! </nowiki></code>

== Links ==
* Thread über das Modul im {{Link2Forum|Topic=25440|LinkText=FHEM Forum}}
* PushNotifier [http://a.gidix.de/v1/pushnotifier/sending/ API]

[[Kategorie: Code Snippets]]

Raspberry Pi: GPIOs schalten

2016-08-11T20:40:54Z

Maxmax:

Mit FHEM lassen sich auch die '''GPIOs''' des [[Raspberry Pi]] steuern. Generell gibt es einige Möglichkeiten, eine entsprechende Steuerung zu verwirklichen. Als Informationsquelle empfiehlt sich hier die [http://elinux.org/RPi_Low-level_peripherals Low-Level Peripherals Seite des Embedded Linux Wiki]

== Bash Script ==
Zum schalten der GPIOs via Bash kann folgendes Script (fhem-gpio.sh) verwendet werden:

<source lang="bash">#!/bin/bash
PORT=$1;
if ! [ -d /sys/class/gpio/gpio$PORT ]
then
echo "$PORT" > /sys/class/gpio/export
echo "out" > /sys/class/gpio/gpio$PORT/direction
fi
STATE=$2;
if [ $STATE -ge 1 ]
then
STATE=1
fi
echo "$STATE" > /sys/class/gpio/gpio$PORT/value
</source>

Der Aufruf des Scripts erfolgt dann mit Angabe der Pinnummer sowie des Zustands des Pins, z. B.:

<source lang="bash">fhem-gpio.sh 17 1 # Pin 17 in High-Zustand versetzen
fhem-gpio.sh 17 0 # Pin 17 in Low-Zustand versetzen
</source>
Wichtig: Das Script muss leider unter root (z.B. per sudo) aufgerufen werden.
Der Einfachheithalber kann das Script unter /usr/sbin kopiert werden.

== Perl-Modul ==
Das Modul '''RPI_GPIO''' für den Zugriff auf die GPIO Pins des Raspberry wird bereits mit FHEM mitgeliefert.
Es setzt die [http://wiringpi.com/download-and-install/ WiringPi] Bibliothek voraus.
Installationsschritte sind in der Commandref zu finden. [http://forum.fhem.de/index.php/topic,16519.0.html Diskussions Thread im Forum]

In Arbeit: Perl-Modul basierend auf [http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm BCM2835-Modul]

'''Installation'''

Der Benutzer „fhem“ muss der Gruppe „gpio“ hinzugefügt werden, damit FHEM später auch Zugriff auf die GPIO Ports hat.

<code>sudo adduser fhem gpio</code>

'''WiringPi installieren:'''

<code>sudo apt-get install git-core</code> 
<code>git clone git://git.drogon.net/wiringPi</code> 
<code>cd wiringPi</code> 
<code>./build</code> 
<code>sudo reboot</code>

'''FHEM - RPI_GPIO Device erstellen'''

<code>define [Name] RPI_GPIO [port]</code> z.B.: <code>define GPIO17 RPI_GPIO 17</code>

Um den Port schalten zu könenn ist es nötig den RPI_GPIO als output zu definieren.
<code>attr GPIO17 direction output</code>

<source lang="text">"set GPIO17 on" # Pin 17 in High-Zustand versetzen
"set GPIO17 off" # Pin 17 in Low-Zustand versetzen
</source>

== Dummy-Schalter ==
Über einen Dummy-Schalter kann das Bash-Script dann getriggert werden.

Im Fall von [[FS20 Allgemein|FS20]] sähe eine entsprechende Schalter-Definition beispielsweise so aus:

<source lang="perl">define gpio_17 FS20 [Hauscode] [Devicecode]
attr gpio_17 dummy 1
define act_on_gpio_17 notify gpio_17 {\
if ("$EVENT" ne "off") {\
system("sudo fhem-gpio.sh 17 1 &")\
} else {\
system("sudo fhem-gpio.sh 17 0 &")\
}\
}
</source>

== Externe Links ==
* [http://elinux.org/RPi_Low-level_peripherals http://elinux.org/RPi_Low-level_peripherals]
* [http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm]
* [http://wiringpi.com/download-and-install/ http://wiringpi.com/download-and-install/]

{{SORTIERUNG:GPIOs schalten}}
[[Kategorie:Raspberry Pi]]

Raspberry Pi: GPIOs schalten

2016-08-11T20:24:47Z

Maxmax: /* Perl-Modul */

Mit FHEM lassen sich auch die '''GPIOs''' des [[Raspberry Pi]] steuern. Generell gibt es einige Möglichkeiten, eine entsprechende Steuerung zu verwirklichen. Als Informationsquelle empfiehlt sich hier die [http://elinux.org/RPi_Low-level_peripherals Low-Level Peripherals Seite des Embedded Linux Wiki]

== Bash Script ==
Zum schalten der GPIOs via Bash kann folgendes Script (fhem-gpio.sh) verwendet werden:

<source lang="bash">#!/bin/bash
PORT=$1;
if ! [ -d /sys/class/gpio/gpio$PORT ]
then
echo "$PORT" > /sys/class/gpio/export
echo "out" > /sys/class/gpio/gpio$PORT/direction
fi
STATE=$2;
if [ $STATE -ge 1 ]
then
STATE=1
fi
echo "$STATE" > /sys/class/gpio/gpio$PORT/value
</source>

Der Aufruf des Scripts erfolgt dann mit Angabe der Pinnummer sowie des Zustands des Pins, z. B.:

<source lang="bash">fhem-gpio.sh 17 1 # Pin 17 in High-Zustand versetzen
fhem-gpio.sh 17 0 # Pin 17 in Low-Zustand versetzen
</source>
Wichtig: Das Script muss leider unter root (z.B. per sudo) aufgerufen werden.
Der Einfachheithalber kann das Script unter /usr/sbin kopiert werden.

== Perl-Modul ==
Das Modul '''RPI_GPIO''' für den Zugriff auf die GPIO Pins des Raspberry wird bereits mit FHEM mitgeliefert.
Es setzt die [http://wiringpi.com/download-and-install/ WiringPi] Bibliothek voraus.
Installationsschritte sind in der Commandref zu finden. [http://forum.fhem.de/index.php/topic,16519.0.html Diskussions Thread im Forum]

In Arbeit: Perl-Modul basierend auf [http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm BCM2835-Modul]

'''Installation'''

Der Benutzer „fhem“ muss der Gruppe „gpio“ hinzugefügt werden, damit FHEM später auch Zugriff auf die GPIO Ports hat.

<code>sudo adduser fhem gpio</code>

'''WiringPi installieren:'''

<code>sudo apt-get install git-core</code> 
<code>git clone git://git.drogon.net/wiringPi</code> 
<code>cd wiringPi</code> 
<code>./build</code> 
<code>sudo reboot</code>

'''FHEM - RPI_GPIO Device erstellen'''

<code>define [Name] RPI_GPIO [port]</code> z.B.: <code>define GPIO17 RPI_GPIO 17</code>

Um den Port schalten zu könenn ist es nötig den RPI_GPIO als output zu definieren.
<code>attr GPIO17 direction output</code>

== Dummy-Schalter ==
Über einen Dummy-Schalter kann das Bash-Script dann getriggert werden.

Im Fall von [[FS20 Allgemein|FS20]] sähe eine entsprechende Schalter-Definition beispielsweise so aus:

<source lang="perl">define gpio_17 FS20 [Hauscode] [Devicecode]
attr gpio_17 dummy 1
define act_on_gpio_17 notify gpio_17 {\
if ("$EVENT" ne "off") {\
system("sudo fhem-gpio.sh 17 1 &")\
} else {\
system("sudo fhem-gpio.sh 17 0 &")\
}\
}
</source>

== Externe Links ==
* [http://elinux.org/RPi_Low-level_peripherals http://elinux.org/RPi_Low-level_peripherals]
* [http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm http://search.cpan.org/~mikem/Device-BCM2835-1.0/lib/Device/BCM2835.pm]
* [http://wiringpi.com/download-and-install/ http://wiringpi.com/download-and-install/]

{{SORTIERUNG:GPIOs schalten}}
[[Kategorie:Raspberry Pi]]

JeeLink

2016-08-11T19:44:41Z

Maxmax: /* LaCrosse Sketch */

'''JeeLink''' ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.
{{Infobox Hardware
|Bild=JeeLink.jpg
|Bildbeschreibung=JeeLink mit Drahtantenne
|HWProtocol=PCA301, EC3000, RoomNode oder LaCrosse und EMT7110
|HWType=[[Interface]]
|HWCategory=
|HWComm=433/868/913 MHz
|HWChannels=?
|HWVoltage=5 V
|HWPowerConsumption=ca. 90 mA
|HWPoweredBy=USB
|HWSize=23*67*9mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#JeeLink 36_JeeLink.pm]
|ModOwner={{Link2FU|430|Andre / justme1968}}
|HWManufacturer=JeeLabs
}}

== Beschreibung ==
Vergleichbar mit dem [[CUL]] von Busware, ist der JeeLink ein USB-Stick, mit dem Funk-Hausautomations-Komponenten angebunden werden können. CUL und JeeLink unterscheiden sich im Funkmodul (CUL -> CC1101; JeeLink -> RF12B), die nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!

Den JeeLink gibt es in einer
* 433 MHz Version
* 868 MHz Version (Standard)
* 915 MHz Version (Betrieb in Europa nicht zugelassen)

== Vorbereitung JeeLink ==
Um mit dem JeeLink die jeweils gewünschten Signale empfangen zu können, ist er zunächst mit der passenden Firmware zu versorgen. Dies kann auf zwei Arten geschehen. Entweder durch das selber kompilieren der Software und das Flashen aus der Arduino IDE oder aus Fhem heraus mit einem aktuellen Firmwareimage das per update mit ausgeliefert wird.

=== Selber Kompilieren ===
[[Datei:JeeLink_flashen_1.jpg|mini|100px|rechts|Vorbereitung: Arduino einrichten]]
Um den JeeLink mit Fhem benutzen zu können, muss (mit der Arduino Software / Entwicklungsumgebung (IDE)) eine spezifische "Firmware" (ein Sketch) auf dem JeeLink installiert werden. Die generelle Vorbereitung für diese Aktion ist unabhängig vom benötigten Sketch und besteht aus den folgenden Schritten:
* Für Windows oder Mac OS X den passenden [http://www.ftdichip.com/Drivers/VCP.htm FTDI Treiber] installieren, unter Linux ist dieser meist schon vorhanden
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
* Je nach Sketch einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Herunterladen des benötigten Sketches (aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ FHEM/contrib])
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software und JeeLink flashen

=== JeeLink aus Arduino flashen ===
[[Datei:JeeLink_flashen_2.jpg|mini|100px|rechts|JeeLink Flashen]]
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software
* Seriellen Port des JeeLink auswählen
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen
* Sketch mit "Datei öffnen" auswählen
* Upload klicken

=== JeeLink aus Fhem flashen ===
* Auf dem Fhem System muss <code>avrdude</code> installiert sein. Das kann z.B. über die "normale" Linux Paketverwaltung geschehen.
* mit <code>set <JeeLinkDevice> flash [firmware]</code> wird das Flashen angestossen <code>firmware</code> kann LaCrosse, PCA301 oder EC3000 sein. Wenn <code>firmware</code> nicht angegeben wird versucht FHEM den Namen der zu flashenden Firmware aus der zur Zeit installierten Firmware abzuleiten.
* im Fhem Log kann der Ausgang des Flashvorgangs kontrolliert werden
* über das <code>flashCommand</code> Attribut lässt sich das Kommando zum Flashen an besondere Anforderungen anpassen

'''Vorsicht bei Jeelink Clones!'''

Jeelink Clones basierend auf dem Arduino Nano haben normalerweise keinen Optibootloader drauf im Gegensatz zum Original JeeLink und JeeNode.

Konsequenz:

Beim "Nano Clone" und ähnliches muß man zum flashen in FHEM die Baudrate setzen mit "-b 57600"

Original JeeLink, original JeeNode, und alle Arduinos, die einen Optibootloader drauf haben flashen in FHEM ohne "-b 57600"

== Hinweise zum Betrieb mit Fhem ==
Um den JeeLink (erstmalig) mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.
* JeeLink an den Fhem-Rechner anschließen
* Auf Linux Systemen kann es notwendig sein, mit <code>mknod /dev/ttyUSB0 c 188 0</code> das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)

=== Definition in fhem.cfg ===
Erforderliche Definitionen in Fhem:
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt
*x=0,1,2, usw.

Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse Sensoren incl. IT+ Wetterstation WS1600, EMT7110, EC3000, und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.

Pro Geräte-Art/Protokoll muss ein eigener JeeLink mit dem passenden Sketch zum Empfang dieser Daten vorhanden sein (es kann jeweils nur ein Sketch im JeeLink aktiv sein und es gibt (zumindest derzeit (04/2014)) keinen Sketch, der mehr als eines der Protokolle abdeckt).

'''Anmerkung:''' Der LaCrosse Sketch deckt sowohl die LaCrosse Temperatursensoren, die IT+ Wetterstation WS1600 als auch den Energieverbrauchssensor EMT7110 ab.

=== PCA301 Sketch ===
Der Sketch für die Unterstützung der ''PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung'' (PCA301-pcaSerial.zip) kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Details zur Benutzung finden sich im Artikel zur [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]].

Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch wahrscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man in diesem Fall keine Steckdose angelernt.

==== Frequenzanpassung über modifizierten Sketch ====
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' kann man dann ermitteln, ob die Funksignale z.B. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:
:<code>static uint16_t rf12_center_freq = 0xA70C;</code>
Anschließend auf den JeeLink neu flashen.

==== Frequenzanpassung über Attribut initCommands ====
Über das <code>initCommands</code> lässt sich die gefundene Frequenz einstellen, ohne dass die Firmware verändert werden muss.
:<code>attr <JeeLinkDevice> initCommands <hhhh>h</code>

=== LaCrosse Sketch ===
Der Sketch für die Unterstützung der LaCrosse Temperatursensoren, der IT+ Wetterstation WS1600 und des Energieverbrauchssensors EMT7110 so wie auch TechnoLine Sensoren (Temperatur, Luftfeuchte,...). 

* Er kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.
* Alternative ist den Sketch direkt über Fhem zu flashen <code>set <JeeLinkDevice> flash LaCrosse</code> z.B.: <code>set myJeeLink flash LaCrosse</code> zuvor sollte aber ein Fhem update mit <code>update</code> durchgeführt werden.
 

'''Sensoren anlernen:
Mit folgenden Befehl hat man die Möglichkeit 60 Sekunden ein Gerät anzulernen. Das Gerät erscheint dann unter der Rubrik LaCrosse. <code>set <JeeLinkDevice> LaCrossePairForSec 60</code> zum Beispiel: <code>set myJeeLink LaCrossePairForSec 60</code>.

'''In der neuesten Version unterstützt er auch den SuperJee''' (siehe auch diesen {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}}) mit folgenden Optionen:

* Option 1 (Dual RFM):
:Es kann ein zweiter RFM12B oder RFM69CW angeschlossen werden. Somit können zwei data rates (z.B. 17241 für TX29DTH und 8842 für WS 1600) gleichzeitig empfangen werden. Das geht natürlich auch mit dem toggle mode, nur ist es bei der Wetterstation ärgerlich, wenn man 30 Sekunden lang nichts empfängt und dadurch die alles entscheidende Windböe verpasst.
* Option 2 (BMP180):
:Da der Luftdruck in den Basisstationen gemessen wird, steht er für FHEM nicht zur Verfügung.
Deshalb kann nun optional ein BMP180 oder BMP085 angeschlossen werden. Auch hier wird automatisch erkannt, ob er vorhanden ist.
:Der BMP180 wird mit 3,3V versorgt und SDA mit PC4 und SCL mit PC5 verbunden (siehe die in diesem {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}} angehängte SuperJee-CL.png)

==== Relay-Betrieb ====
Der LaCrosse Sketch ermöglicht auch den Relay-Betrieb zur Reichweitenverbesserung. Er funktioniert damit ähnlich wie z. B. ein WLAN Range Extender. Wenn der Sketch für den Relay-Betrieb konfiguriert ist, wird jedes empfangene IT+ Datenpaket, das eine gültige Prüfsumme hat, direkt nach dem Empfang wieder gesendet.

Das Prinzip ist generell recht einfach:
# JeeLink im Sketch als Relais konfigurieren und flashen.
# Auf "halber Strecke" (d.h. irgendwo zwischen dem primären Sender und dem entfernten Empfänger) auf ein USB-Steckernetzteil stecken. Der JeeLink arbeitet in diesem Modus "autonom", er benötigt also lediglich einen Spannungsversorgung.

Der JeeLink empfängt und decodiert alle Protokolle, die er auch für FHEM unterstützt. Wenn er ein Paket empfangen hat (egal von welchem Sensor) und CRC OK war, dann sendet er es wieder aus. Der JeeLink am FHEM merkt keinen Unterschied. Falls ein Paket es doch bis zum FHEM direkt geschafft hat, kommt es dort zweimal an. Diese Situation muss in Fhem behandelt werden.

Details zu diesem Betriebsmodus sind in diesen Forenbeiträgen ({{Link2Forum|Topic=14786|Message=165153|LinkText=LaCrosse}} bzw. {{Link2Forum|Topic=26494|Message=196648|LinkText=EMT7110}}) zu finden.

==== Frequenzanpassung ====
Ab Version LaCrosseITPlusReader.10.1e wurde der Sketch so erweitert, dass man von FHEM aus die Frequenz setzen kann. Dazu versteht der Sketch das neue Kommando "f":
:<code>set myJeeLink raw 868295f</code>
setzt die Frequenz auf 868295 kHz.

Die Frequenz kann im Bereich von 860480 kHz bis 879515 kHz in 5kHz -Schritten eingestellt werden.
Details dazu in diesem {{Link2Forum|Topic=14786|Message=222541}} im Forum. Die Frequenzanpassung ist insbesondere beim 30.3155.WD häufig erforderlich, weshalb er als kritisch einzustufen und nicht zu empfehlen ist (siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}).

==== Getestete iT+ Sensoren incl. Wetterstation WS 1600 ====
{{Randnotiz|RNTyp=y|RNText=Die Ausführungen in diesem Abschnitt gelten ab der Version 10.1q auch für die Wetterstation WS1080.

'''Vorsicht''': die WS1080 gibt es (unter gleichem Namen) in einer "OOK"- und in einer "FSK"-Version.
* Der LaCrosse Sketch und das LaCrosseGateway können nur die FSK-Version empfangen, die OOK-Version wird nicht unterstützt.
* Die FSK-Version ist zu erkennen an einem runden grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS 7". Details dazu in {{Link2Forum|Topic=14786|Message=363766|LinkText=diesem Forenbeitrag}}
}}
Die in der folgenden Liste (Quelle: {{Link2Forum|Topic=14786|Message=164801|LinkText=Fhem Forum}}) aufgeführten Sensoren wurden bisher erfolgreich getestet:

{| class="wikitable"
!Bezeichnung !! Datenrate !! Link
|-
| TX21IT || 17.241 kbps
|-
| TX25-IT || 17.241 kbps
|-
| TX27-IT || 17.241 kbps
|-
| TX29-IT || 17.241 kbps
|-
| TX29DTH-IT || 17.241 kbps
|-
| TX37 || 17.241 kbps
|-
| TX35TH-IT || 9.579 kbps
|-
| TX35DTH-IT || 9.579 kbps
|-
| 30.3143.IT || 17.241 kbps
|-
| 30.3144.IT || 17.241 kbps || ({{Link2Forum|Topic=17662|LinkText=Forenthread}})
|-
| 30.3147.IT || 17.241 kbps
|-
| 30.3155WD || 9.579 kbps || kritisch; nicht zu empfehlen; siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}
|-
| 30.3156WD || 9.579 kbps || Batterie-kritisch. Funktioniert schlecht mit Akkus!
|-
| 30.3187.IT || 17.241 kbps
|-
|| WS 1600 || 8.842 kbps || ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})
|-
|| WS 1080 || 17.241 kbps || ({{Link2Forum|Topic=14786|Message=363766|LinkText=Forenbeitrag}})
|}

==== EMT7110 ====
Der [[EMT7110]] läuft mit einer Datenrate von 9.579 kbps (Details dazu in diesem {{Link2Forum|Topic=26494|LinkText=Forenthread}}).

Werden Sensoren mit unterschiedlichen Datenraten gleichzeitig betrieben, ist der Toggle Modus einzustellen, z.B. mit dem Befehl
:<code>initCommands 30t v </code>
wobei ''30t'' für "Toggle Modus, alle 30 Sekunden" steht.

=== Energy Count 3000 Sketch ===
Der Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.

Das Fhem Modul dazu (36_EC3000.pm) ist genau wie die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) mittlerweile im aktuellen Fhem enthalten.

=== JeeLabs RoomNode ===
Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in {{Link2Forum|Topic=11648|Message=92037|LinkText=diesem Forenbeitrag}} enthalten.

=== JeeLink LED deaktivieren ===
Ein "dauerhaftes" Deaktivieren der LED des JeeLink ist möglich mit
:<code>define not.global notify global:INITIALIZED set myJeeLink led off</code>
damit wird, sobald Fhem komplett gestartet ist, von Fhem der Befehl zum Ausschalten der LED gesendet. Alternativ kann mit
:<code>attr myJeeLink initCommands 0a v</code>
dem Sketch die Anweisung gegeben werden, bei der Initialisierung die LED zu deaktivieren.
''Quelle: dieser {{Link2Forum|Topic=27161|LinkText=Forenthread}}''

=== Weitergehende Informationen ===
Hinweise zum Betrieb eines JeeLink mit Fhem finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:
* {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301}} - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in Fhem.
* {{Link2Forum|Topic=14786|LinkText=JeeLink / LaCrosse}} - JeeLink Modul zur Einbindung von La Crosse
* {{Link2Forum|Topic=11648|Message=92019|LinkText=JeeLink / EC3000}} - Anfänge der Entstehung der EC3000 Unterstützung in Fhem.
* Hinweise zu {{Link2Forum|Topic=11648|Message=92037|LinkText=JeeLabs RoomNode}} und anderen JeeLab Nodes
* {{Link2Forum|Topic=25399|Message=183910|LinkText=JeeLink mit FHEM2FHEM nutzen}}

== Bekannte Probleme ==
* Beim Betrieb an einer [[AVM Fritz!Box|FritzBox]] wird der JeeLink unter Umständen als ''Für die Nutzung mit dem USB-Fernanschluss reserviert'' angezeigt. In diesem Fall muss die Reservierung deaktiviert/aufgehoben werden (Details dazu in diesem {{Link2Forum|Topic=16579|LinkText=Forenthread}}).
* Die Version ''v3c'' des JeeLink funktioniert (Stand 06/2015) nur mit dem LaCrosse Sketch. PCA301 und EC3000 Sketch sind auf den JeeLink Classic beschränkt (siehe unter anderem Diskussion im Forum, startend {{Link2Forum|Topic=11648|Message=308267|LinkText=hier}}).

== Weblinks ==
* [http://jeelabs.com/products/jeelink JeeLabs], JeeLink Hersteller
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ PCA301 Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ LaCrosse Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ EC3000 Sketch] auf sourceforge
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von LaCrosse Temperatursensoren an Fhem
* {{Link2Forum|Topic=23217|LinkText=LevelSender}} Tankfüllstand mit JeeLink empfangen

[[Kategorie:Interfaces]]
[[Kategorie:Other Components]]

JeeLink

2016-08-11T19:35:45Z

Maxmax: /* LaCrosse Sketch */

'''JeeLink''' ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.
{{Infobox Hardware
|Bild=JeeLink.jpg
|Bildbeschreibung=JeeLink mit Drahtantenne
|HWProtocol=PCA301, EC3000, RoomNode oder LaCrosse und EMT7110
|HWType=[[Interface]]
|HWCategory=
|HWComm=433/868/913 MHz
|HWChannels=?
|HWVoltage=5 V
|HWPowerConsumption=ca. 90 mA
|HWPoweredBy=USB
|HWSize=23*67*9mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#JeeLink 36_JeeLink.pm]
|ModOwner={{Link2FU|430|Andre / justme1968}}
|HWManufacturer=JeeLabs
}}

== Beschreibung ==
Vergleichbar mit dem [[CUL]] von Busware, ist der JeeLink ein USB-Stick, mit dem Funk-Hausautomations-Komponenten angebunden werden können. CUL und JeeLink unterscheiden sich im Funkmodul (CUL -> CC1101; JeeLink -> RF12B), die nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!

Den JeeLink gibt es in einer
* 433 MHz Version
* 868 MHz Version (Standard)
* 915 MHz Version (Betrieb in Europa nicht zugelassen)

== Vorbereitung JeeLink ==
Um mit dem JeeLink die jeweils gewünschten Signale empfangen zu können, ist er zunächst mit der passenden Firmware zu versorgen. Dies kann auf zwei Arten geschehen. Entweder durch das selber kompilieren der Software und das Flashen aus der Arduino IDE oder aus Fhem heraus mit einem aktuellen Firmwareimage das per update mit ausgeliefert wird.

=== Selber Kompilieren ===
[[Datei:JeeLink_flashen_1.jpg|mini|100px|rechts|Vorbereitung: Arduino einrichten]]
Um den JeeLink mit Fhem benutzen zu können, muss (mit der Arduino Software / Entwicklungsumgebung (IDE)) eine spezifische "Firmware" (ein Sketch) auf dem JeeLink installiert werden. Die generelle Vorbereitung für diese Aktion ist unabhängig vom benötigten Sketch und besteht aus den folgenden Schritten:
* Für Windows oder Mac OS X den passenden [http://www.ftdichip.com/Drivers/VCP.htm FTDI Treiber] installieren, unter Linux ist dieser meist schon vorhanden
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
* Je nach Sketch einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Herunterladen des benötigten Sketches (aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ FHEM/contrib])
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software und JeeLink flashen

=== JeeLink aus Arduino flashen ===
[[Datei:JeeLink_flashen_2.jpg|mini|100px|rechts|JeeLink Flashen]]
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software
* Seriellen Port des JeeLink auswählen
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen
* Sketch mit "Datei öffnen" auswählen
* Upload klicken

=== JeeLink aus Fhem flashen ===
* Auf dem Fhem System muss <code>avrdude</code> installiert sein. Das kann z.B. über die "normale" Linux Paketverwaltung geschehen.
* mit <code>set <JeeLinkDevice> flash [firmware]</code> wird das Flashen angestossen <code>firmware</code> kann LaCrosse, PCA301 oder EC3000 sein. Wenn <code>firmware</code> nicht angegeben wird versucht FHEM den Namen der zu flashenden Firmware aus der zur Zeit installierten Firmware abzuleiten.
* im Fhem Log kann der Ausgang des Flashvorgangs kontrolliert werden
* über das <code>flashCommand</code> Attribut lässt sich das Kommando zum Flashen an besondere Anforderungen anpassen

'''Vorsicht bei Jeelink Clones!'''

Jeelink Clones basierend auf dem Arduino Nano haben normalerweise keinen Optibootloader drauf im Gegensatz zum Original JeeLink und JeeNode.

Konsequenz:

Beim "Nano Clone" und ähnliches muß man zum flashen in FHEM die Baudrate setzen mit "-b 57600"

Original JeeLink, original JeeNode, und alle Arduinos, die einen Optibootloader drauf haben flashen in FHEM ohne "-b 57600"

== Hinweise zum Betrieb mit Fhem ==
Um den JeeLink (erstmalig) mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.
* JeeLink an den Fhem-Rechner anschließen
* Auf Linux Systemen kann es notwendig sein, mit <code>mknod /dev/ttyUSB0 c 188 0</code> das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)

=== Definition in fhem.cfg ===
Erforderliche Definitionen in Fhem:
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt
*x=0,1,2, usw.

Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse Sensoren incl. IT+ Wetterstation WS1600, EMT7110, EC3000, und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.

Pro Geräte-Art/Protokoll muss ein eigener JeeLink mit dem passenden Sketch zum Empfang dieser Daten vorhanden sein (es kann jeweils nur ein Sketch im JeeLink aktiv sein und es gibt (zumindest derzeit (04/2014)) keinen Sketch, der mehr als eines der Protokolle abdeckt).

'''Anmerkung:''' Der LaCrosse Sketch deckt sowohl die LaCrosse Temperatursensoren, die IT+ Wetterstation WS1600 als auch den Energieverbrauchssensor EMT7110 ab.

=== PCA301 Sketch ===
Der Sketch für die Unterstützung der ''PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung'' (PCA301-pcaSerial.zip) kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Details zur Benutzung finden sich im Artikel zur [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]].

Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch wahrscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man in diesem Fall keine Steckdose angelernt.

==== Frequenzanpassung über modifizierten Sketch ====
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' kann man dann ermitteln, ob die Funksignale z.B. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:
:<code>static uint16_t rf12_center_freq = 0xA70C;</code>
Anschließend auf den JeeLink neu flashen.

==== Frequenzanpassung über Attribut initCommands ====
Über das <code>initCommands</code> lässt sich die gefundene Frequenz einstellen, ohne dass die Firmware verändert werden muss.
:<code>attr <JeeLinkDevice> initCommands <hhhh>h</code>

=== LaCrosse Sketch ===
Der Sketch für die Unterstützung der LaCrosse Temperatursensoren, der IT+ Wetterstation WS1600 und des Energieverbrauchssensors EMT7110 so wie auch TechnoLine Sensoren (Temperatur, Luftfeuchte,...). 

* Er kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.
* Alternative ist den Sketch direkt über Fhem zu flashen <code>set myJeeLink flash LaCrosse</code> zuvor sollte aber ein Fhem update mit <code>update</code> durchgeführt werden.
 

'''In der neuesten Version unterstützt er auch den SuperJee''' (siehe auch diesen {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}}) mit folgenden Optionen:

* Option 1 (Dual RFM):
:Es kann ein zweiter RFM12B oder RFM69CW angeschlossen werden. Somit können zwei data rates (z.B. 17241 für TX29DTH und 8842 für WS 1600) gleichzeitig empfangen werden. Das geht natürlich auch mit dem toggle mode, nur ist es bei der Wetterstation ärgerlich, wenn man 30 Sekunden lang nichts empfängt und dadurch die alles entscheidende Windböe verpasst.
* Option 2 (BMP180):
:Da der Luftdruck in den Basisstationen gemessen wird, steht er für FHEM nicht zur Verfügung.
Deshalb kann nun optional ein BMP180 oder BMP085 angeschlossen werden. Auch hier wird automatisch erkannt, ob er vorhanden ist.
:Der BMP180 wird mit 3,3V versorgt und SDA mit PC4 und SCL mit PC5 verbunden (siehe die in diesem {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}} angehängte SuperJee-CL.png)

==== Relay-Betrieb ====
Der LaCrosse Sketch ermöglicht auch den Relay-Betrieb zur Reichweitenverbesserung. Er funktioniert damit ähnlich wie z. B. ein WLAN Range Extender. Wenn der Sketch für den Relay-Betrieb konfiguriert ist, wird jedes empfangene IT+ Datenpaket, das eine gültige Prüfsumme hat, direkt nach dem Empfang wieder gesendet.

Das Prinzip ist generell recht einfach:
# JeeLink im Sketch als Relais konfigurieren und flashen.
# Auf "halber Strecke" (d.h. irgendwo zwischen dem primären Sender und dem entfernten Empfänger) auf ein USB-Steckernetzteil stecken. Der JeeLink arbeitet in diesem Modus "autonom", er benötigt also lediglich einen Spannungsversorgung.

Der JeeLink empfängt und decodiert alle Protokolle, die er auch für FHEM unterstützt. Wenn er ein Paket empfangen hat (egal von welchem Sensor) und CRC OK war, dann sendet er es wieder aus. Der JeeLink am FHEM merkt keinen Unterschied. Falls ein Paket es doch bis zum FHEM direkt geschafft hat, kommt es dort zweimal an. Diese Situation muss in Fhem behandelt werden.

Details zu diesem Betriebsmodus sind in diesen Forenbeiträgen ({{Link2Forum|Topic=14786|Message=165153|LinkText=LaCrosse}} bzw. {{Link2Forum|Topic=26494|Message=196648|LinkText=EMT7110}}) zu finden.

==== Frequenzanpassung ====
Ab Version LaCrosseITPlusReader.10.1e wurde der Sketch so erweitert, dass man von FHEM aus die Frequenz setzen kann. Dazu versteht der Sketch das neue Kommando "f":
:<code>set myJeeLink raw 868295f</code>
setzt die Frequenz auf 868295 kHz.

Die Frequenz kann im Bereich von 860480 kHz bis 879515 kHz in 5kHz -Schritten eingestellt werden.
Details dazu in diesem {{Link2Forum|Topic=14786|Message=222541}} im Forum. Die Frequenzanpassung ist insbesondere beim 30.3155.WD häufig erforderlich, weshalb er als kritisch einzustufen und nicht zu empfehlen ist (siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}).

==== Getestete iT+ Sensoren incl. Wetterstation WS 1600 ====
{{Randnotiz|RNTyp=y|RNText=Die Ausführungen in diesem Abschnitt gelten ab der Version 10.1q auch für die Wetterstation WS1080.

'''Vorsicht''': die WS1080 gibt es (unter gleichem Namen) in einer "OOK"- und in einer "FSK"-Version.
* Der LaCrosse Sketch und das LaCrosseGateway können nur die FSK-Version empfangen, die OOK-Version wird nicht unterstützt.
* Die FSK-Version ist zu erkennen an einem runden grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS 7". Details dazu in {{Link2Forum|Topic=14786|Message=363766|LinkText=diesem Forenbeitrag}}
}}
Die in der folgenden Liste (Quelle: {{Link2Forum|Topic=14786|Message=164801|LinkText=Fhem Forum}}) aufgeführten Sensoren wurden bisher erfolgreich getestet:

{| class="wikitable"
!Bezeichnung !! Datenrate !! Link
|-
| TX21IT || 17.241 kbps
|-
| TX25-IT || 17.241 kbps
|-
| TX27-IT || 17.241 kbps
|-
| TX29-IT || 17.241 kbps
|-
| TX29DTH-IT || 17.241 kbps
|-
| TX37 || 17.241 kbps
|-
| TX35TH-IT || 9.579 kbps
|-
| TX35DTH-IT || 9.579 kbps
|-
| 30.3143.IT || 17.241 kbps
|-
| 30.3144.IT || 17.241 kbps || ({{Link2Forum|Topic=17662|LinkText=Forenthread}})
|-
| 30.3147.IT || 17.241 kbps
|-
| 30.3155WD || 9.579 kbps || kritisch; nicht zu empfehlen; siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}
|-
| 30.3156WD || 9.579 kbps || Batterie-kritisch. Funktioniert schlecht mit Akkus!
|-
| 30.3187.IT || 17.241 kbps
|-
|| WS 1600 || 8.842 kbps || ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})
|-
|| WS 1080 || 17.241 kbps || ({{Link2Forum|Topic=14786|Message=363766|LinkText=Forenbeitrag}})
|}

==== EMT7110 ====
Der [[EMT7110]] läuft mit einer Datenrate von 9.579 kbps (Details dazu in diesem {{Link2Forum|Topic=26494|LinkText=Forenthread}}).

Werden Sensoren mit unterschiedlichen Datenraten gleichzeitig betrieben, ist der Toggle Modus einzustellen, z.B. mit dem Befehl
:<code>initCommands 30t v </code>
wobei ''30t'' für "Toggle Modus, alle 30 Sekunden" steht.

=== Energy Count 3000 Sketch ===
Der Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.

Das Fhem Modul dazu (36_EC3000.pm) ist genau wie die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) mittlerweile im aktuellen Fhem enthalten.

=== JeeLabs RoomNode ===
Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in {{Link2Forum|Topic=11648|Message=92037|LinkText=diesem Forenbeitrag}} enthalten.

=== JeeLink LED deaktivieren ===
Ein "dauerhaftes" Deaktivieren der LED des JeeLink ist möglich mit
:<code>define not.global notify global:INITIALIZED set myJeeLink led off</code>
damit wird, sobald Fhem komplett gestartet ist, von Fhem der Befehl zum Ausschalten der LED gesendet. Alternativ kann mit
:<code>attr myJeeLink initCommands 0a v</code>
dem Sketch die Anweisung gegeben werden, bei der Initialisierung die LED zu deaktivieren.
''Quelle: dieser {{Link2Forum|Topic=27161|LinkText=Forenthread}}''

=== Weitergehende Informationen ===
Hinweise zum Betrieb eines JeeLink mit Fhem finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:
* {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301}} - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in Fhem.
* {{Link2Forum|Topic=14786|LinkText=JeeLink / LaCrosse}} - JeeLink Modul zur Einbindung von La Crosse
* {{Link2Forum|Topic=11648|Message=92019|LinkText=JeeLink / EC3000}} - Anfänge der Entstehung der EC3000 Unterstützung in Fhem.
* Hinweise zu {{Link2Forum|Topic=11648|Message=92037|LinkText=JeeLabs RoomNode}} und anderen JeeLab Nodes
* {{Link2Forum|Topic=25399|Message=183910|LinkText=JeeLink mit FHEM2FHEM nutzen}}

== Bekannte Probleme ==
* Beim Betrieb an einer [[AVM Fritz!Box|FritzBox]] wird der JeeLink unter Umständen als ''Für die Nutzung mit dem USB-Fernanschluss reserviert'' angezeigt. In diesem Fall muss die Reservierung deaktiviert/aufgehoben werden (Details dazu in diesem {{Link2Forum|Topic=16579|LinkText=Forenthread}}).
* Die Version ''v3c'' des JeeLink funktioniert (Stand 06/2015) nur mit dem LaCrosse Sketch. PCA301 und EC3000 Sketch sind auf den JeeLink Classic beschränkt (siehe unter anderem Diskussion im Forum, startend {{Link2Forum|Topic=11648|Message=308267|LinkText=hier}}).

== Weblinks ==
* [http://jeelabs.com/products/jeelink JeeLabs], JeeLink Hersteller
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ PCA301 Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ LaCrosse Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ EC3000 Sketch] auf sourceforge
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von LaCrosse Temperatursensoren an Fhem
* {{Link2Forum|Topic=23217|LinkText=LevelSender}} Tankfüllstand mit JeeLink empfangen

[[Kategorie:Interfaces]]
[[Kategorie:Other Components]]

JeeLink

2016-08-11T19:33:37Z

Maxmax:

'''JeeLink''' ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.
{{Infobox Hardware
|Bild=JeeLink.jpg
|Bildbeschreibung=JeeLink mit Drahtantenne
|HWProtocol=PCA301, EC3000, RoomNode oder LaCrosse und EMT7110
|HWType=[[Interface]]
|HWCategory=
|HWComm=433/868/913 MHz
|HWChannels=?
|HWVoltage=5 V
|HWPowerConsumption=ca. 90 mA
|HWPoweredBy=USB
|HWSize=23*67*9mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#JeeLink 36_JeeLink.pm]
|ModOwner={{Link2FU|430|Andre / justme1968}}
|HWManufacturer=JeeLabs
}}

== Beschreibung ==
Vergleichbar mit dem [[CUL]] von Busware, ist der JeeLink ein USB-Stick, mit dem Funk-Hausautomations-Komponenten angebunden werden können. CUL und JeeLink unterscheiden sich im Funkmodul (CUL -> CC1101; JeeLink -> RF12B), die nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!

Den JeeLink gibt es in einer
* 433 MHz Version
* 868 MHz Version (Standard)
* 915 MHz Version (Betrieb in Europa nicht zugelassen)

== Vorbereitung JeeLink ==
Um mit dem JeeLink die jeweils gewünschten Signale empfangen zu können, ist er zunächst mit der passenden Firmware zu versorgen. Dies kann auf zwei Arten geschehen. Entweder durch das selber kompilieren der Software und das Flashen aus der Arduino IDE oder aus Fhem heraus mit einem aktuellen Firmwareimage das per update mit ausgeliefert wird.

=== Selber Kompilieren ===
[[Datei:JeeLink_flashen_1.jpg|mini|100px|rechts|Vorbereitung: Arduino einrichten]]
Um den JeeLink mit Fhem benutzen zu können, muss (mit der Arduino Software / Entwicklungsumgebung (IDE)) eine spezifische "Firmware" (ein Sketch) auf dem JeeLink installiert werden. Die generelle Vorbereitung für diese Aktion ist unabhängig vom benötigten Sketch und besteht aus den folgenden Schritten:
* Für Windows oder Mac OS X den passenden [http://www.ftdichip.com/Drivers/VCP.htm FTDI Treiber] installieren, unter Linux ist dieser meist schon vorhanden
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
* Je nach Sketch einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Herunterladen des benötigten Sketches (aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ FHEM/contrib])
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software und JeeLink flashen

=== JeeLink aus Arduino flashen ===
[[Datei:JeeLink_flashen_2.jpg|mini|100px|rechts|JeeLink Flashen]]
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software
* Seriellen Port des JeeLink auswählen
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen
* Sketch mit "Datei öffnen" auswählen
* Upload klicken

=== JeeLink aus Fhem flashen ===
* Auf dem Fhem System muss <code>avrdude</code> installiert sein. Das kann z.B. über die "normale" Linux Paketverwaltung geschehen.
* mit <code>set <JeeLinkDevice> flash [firmware]</code> wird das Flashen angestossen <code>firmware</code> kann LaCrosse, PCA301 oder EC3000 sein. Wenn <code>firmware</code> nicht angegeben wird versucht FHEM den Namen der zu flashenden Firmware aus der zur Zeit installierten Firmware abzuleiten.
* im Fhem Log kann der Ausgang des Flashvorgangs kontrolliert werden
* über das <code>flashCommand</code> Attribut lässt sich das Kommando zum Flashen an besondere Anforderungen anpassen

'''Vorsicht bei Jeelink Clones!'''

Jeelink Clones basierend auf dem Arduino Nano haben normalerweise keinen Optibootloader drauf im Gegensatz zum Original JeeLink und JeeNode.

Konsequenz:

Beim "Nano Clone" und ähnliches muß man zum flashen in FHEM die Baudrate setzen mit "-b 57600"

Original JeeLink, original JeeNode, und alle Arduinos, die einen Optibootloader drauf haben flashen in FHEM ohne "-b 57600"

== Hinweise zum Betrieb mit Fhem ==
Um den JeeLink (erstmalig) mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.
* JeeLink an den Fhem-Rechner anschließen
* Auf Linux Systemen kann es notwendig sein, mit <code>mknod /dev/ttyUSB0 c 188 0</code> das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)

=== Definition in fhem.cfg ===
Erforderliche Definitionen in Fhem:
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt
*x=0,1,2, usw.

Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse Sensoren incl. IT+ Wetterstation WS1600, EMT7110, EC3000, und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.

Pro Geräte-Art/Protokoll muss ein eigener JeeLink mit dem passenden Sketch zum Empfang dieser Daten vorhanden sein (es kann jeweils nur ein Sketch im JeeLink aktiv sein und es gibt (zumindest derzeit (04/2014)) keinen Sketch, der mehr als eines der Protokolle abdeckt).

'''Anmerkung:''' Der LaCrosse Sketch deckt sowohl die LaCrosse Temperatursensoren, die IT+ Wetterstation WS1600 als auch den Energieverbrauchssensor EMT7110 ab.

=== PCA301 Sketch ===
Der Sketch für die Unterstützung der ''PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung'' (PCA301-pcaSerial.zip) kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Details zur Benutzung finden sich im Artikel zur [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]].

Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch wahrscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man in diesem Fall keine Steckdose angelernt.

==== Frequenzanpassung über modifizierten Sketch ====
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' kann man dann ermitteln, ob die Funksignale z.B. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:
:<code>static uint16_t rf12_center_freq = 0xA70C;</code>
Anschließend auf den JeeLink neu flashen.

==== Frequenzanpassung über Attribut initCommands ====
Über das <code>initCommands</code> lässt sich die gefundene Frequenz einstellen, ohne dass die Firmware verändert werden muss.
:<code>attr <JeeLinkDevice> initCommands <hhhh>h</code>

=== LaCrosse Sketch ===
Der Sketch für die Unterstützung der LaCrosse Temperatursensoren, der IT+ Wetterstation WS1600 und des Energieverbrauchssensors EMT7110. 

* Er kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.
* Alternative ist den Sketch direkt über Fhem zu flashen <code>set myJeeLink flash LaCrosse</code> zuvor sollte aber ein Fhem update mit <code>update</code> durchgeführt werden.
 

'''In der neuesten Version unterstützt er auch den SuperJee''' (siehe auch diesen {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}}) mit folgenden Optionen:

* Option 1 (Dual RFM):
:Es kann ein zweiter RFM12B oder RFM69CW angeschlossen werden. Somit können zwei data rates (z.B. 17241 für TX29DTH und 8842 für WS 1600) gleichzeitig empfangen werden. Das geht natürlich auch mit dem toggle mode, nur ist es bei der Wetterstation ärgerlich, wenn man 30 Sekunden lang nichts empfängt und dadurch die alles entscheidende Windböe verpasst.
* Option 2 (BMP180):
:Da der Luftdruck in den Basisstationen gemessen wird, steht er für FHEM nicht zur Verfügung.
Deshalb kann nun optional ein BMP180 oder BMP085 angeschlossen werden. Auch hier wird automatisch erkannt, ob er vorhanden ist.
:Der BMP180 wird mit 3,3V versorgt und SDA mit PC4 und SCL mit PC5 verbunden (siehe die in diesem {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}} angehängte SuperJee-CL.png)

==== Relay-Betrieb ====
Der LaCrosse Sketch ermöglicht auch den Relay-Betrieb zur Reichweitenverbesserung. Er funktioniert damit ähnlich wie z. B. ein WLAN Range Extender. Wenn der Sketch für den Relay-Betrieb konfiguriert ist, wird jedes empfangene IT+ Datenpaket, das eine gültige Prüfsumme hat, direkt nach dem Empfang wieder gesendet.

Das Prinzip ist generell recht einfach:
# JeeLink im Sketch als Relais konfigurieren und flashen.
# Auf "halber Strecke" (d.h. irgendwo zwischen dem primären Sender und dem entfernten Empfänger) auf ein USB-Steckernetzteil stecken. Der JeeLink arbeitet in diesem Modus "autonom", er benötigt also lediglich einen Spannungsversorgung.

Der JeeLink empfängt und decodiert alle Protokolle, die er auch für FHEM unterstützt. Wenn er ein Paket empfangen hat (egal von welchem Sensor) und CRC OK war, dann sendet er es wieder aus. Der JeeLink am FHEM merkt keinen Unterschied. Falls ein Paket es doch bis zum FHEM direkt geschafft hat, kommt es dort zweimal an. Diese Situation muss in Fhem behandelt werden.

Details zu diesem Betriebsmodus sind in diesen Forenbeiträgen ({{Link2Forum|Topic=14786|Message=165153|LinkText=LaCrosse}} bzw. {{Link2Forum|Topic=26494|Message=196648|LinkText=EMT7110}}) zu finden.

==== Frequenzanpassung ====
Ab Version LaCrosseITPlusReader.10.1e wurde der Sketch so erweitert, dass man von FHEM aus die Frequenz setzen kann. Dazu versteht der Sketch das neue Kommando "f":
:<code>set myJeeLink raw 868295f</code>
setzt die Frequenz auf 868295 kHz.

Die Frequenz kann im Bereich von 860480 kHz bis 879515 kHz in 5kHz -Schritten eingestellt werden.
Details dazu in diesem {{Link2Forum|Topic=14786|Message=222541}} im Forum. Die Frequenzanpassung ist insbesondere beim 30.3155.WD häufig erforderlich, weshalb er als kritisch einzustufen und nicht zu empfehlen ist (siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}).

==== Getestete iT+ Sensoren incl. Wetterstation WS 1600 ====
{{Randnotiz|RNTyp=y|RNText=Die Ausführungen in diesem Abschnitt gelten ab der Version 10.1q auch für die Wetterstation WS1080.

'''Vorsicht''': die WS1080 gibt es (unter gleichem Namen) in einer "OOK"- und in einer "FSK"-Version.
* Der LaCrosse Sketch und das LaCrosseGateway können nur die FSK-Version empfangen, die OOK-Version wird nicht unterstützt.
* Die FSK-Version ist zu erkennen an einem runden grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS 7". Details dazu in {{Link2Forum|Topic=14786|Message=363766|LinkText=diesem Forenbeitrag}}
}}
Die in der folgenden Liste (Quelle: {{Link2Forum|Topic=14786|Message=164801|LinkText=Fhem Forum}}) aufgeführten Sensoren wurden bisher erfolgreich getestet:

{| class="wikitable"
!Bezeichnung !! Datenrate !! Link
|-
| TX21IT || 17.241 kbps
|-
| TX25-IT || 17.241 kbps
|-
| TX27-IT || 17.241 kbps
|-
| TX29-IT || 17.241 kbps
|-
| TX29DTH-IT || 17.241 kbps
|-
| TX37 || 17.241 kbps
|-
| TX35TH-IT || 9.579 kbps
|-
| TX35DTH-IT || 9.579 kbps
|-
| 30.3143.IT || 17.241 kbps
|-
| 30.3144.IT || 17.241 kbps || ({{Link2Forum|Topic=17662|LinkText=Forenthread}})
|-
| 30.3147.IT || 17.241 kbps
|-
| 30.3155WD || 9.579 kbps || kritisch; nicht zu empfehlen; siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}
|-
| 30.3156WD || 9.579 kbps || Batterie-kritisch. Funktioniert schlecht mit Akkus!
|-
| 30.3187.IT || 17.241 kbps
|-
|| WS 1600 || 8.842 kbps || ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})
|-
|| WS 1080 || 17.241 kbps || ({{Link2Forum|Topic=14786|Message=363766|LinkText=Forenbeitrag}})
|}

==== EMT7110 ====
Der [[EMT7110]] läuft mit einer Datenrate von 9.579 kbps (Details dazu in diesem {{Link2Forum|Topic=26494|LinkText=Forenthread}}).

Werden Sensoren mit unterschiedlichen Datenraten gleichzeitig betrieben, ist der Toggle Modus einzustellen, z.B. mit dem Befehl
:<code>initCommands 30t v </code>
wobei ''30t'' für "Toggle Modus, alle 30 Sekunden" steht.

=== Energy Count 3000 Sketch ===
Der Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.

Das Fhem Modul dazu (36_EC3000.pm) ist genau wie die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) mittlerweile im aktuellen Fhem enthalten.

=== JeeLabs RoomNode ===
Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in {{Link2Forum|Topic=11648|Message=92037|LinkText=diesem Forenbeitrag}} enthalten.

=== JeeLink LED deaktivieren ===
Ein "dauerhaftes" Deaktivieren der LED des JeeLink ist möglich mit
:<code>define not.global notify global:INITIALIZED set myJeeLink led off</code>
damit wird, sobald Fhem komplett gestartet ist, von Fhem der Befehl zum Ausschalten der LED gesendet. Alternativ kann mit
:<code>attr myJeeLink initCommands 0a v</code>
dem Sketch die Anweisung gegeben werden, bei der Initialisierung die LED zu deaktivieren.
''Quelle: dieser {{Link2Forum|Topic=27161|LinkText=Forenthread}}''

=== Weitergehende Informationen ===
Hinweise zum Betrieb eines JeeLink mit Fhem finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:
* {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301}} - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in Fhem.
* {{Link2Forum|Topic=14786|LinkText=JeeLink / LaCrosse}} - JeeLink Modul zur Einbindung von La Crosse
* {{Link2Forum|Topic=11648|Message=92019|LinkText=JeeLink / EC3000}} - Anfänge der Entstehung der EC3000 Unterstützung in Fhem.
* Hinweise zu {{Link2Forum|Topic=11648|Message=92037|LinkText=JeeLabs RoomNode}} und anderen JeeLab Nodes
* {{Link2Forum|Topic=25399|Message=183910|LinkText=JeeLink mit FHEM2FHEM nutzen}}

== Bekannte Probleme ==
* Beim Betrieb an einer [[AVM Fritz!Box|FritzBox]] wird der JeeLink unter Umständen als ''Für die Nutzung mit dem USB-Fernanschluss reserviert'' angezeigt. In diesem Fall muss die Reservierung deaktiviert/aufgehoben werden (Details dazu in diesem {{Link2Forum|Topic=16579|LinkText=Forenthread}}).
* Die Version ''v3c'' des JeeLink funktioniert (Stand 06/2015) nur mit dem LaCrosse Sketch. PCA301 und EC3000 Sketch sind auf den JeeLink Classic beschränkt (siehe unter anderem Diskussion im Forum, startend {{Link2Forum|Topic=11648|Message=308267|LinkText=hier}}).

== Weblinks ==
* [http://jeelabs.com/products/jeelink JeeLabs], JeeLink Hersteller
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ PCA301 Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ LaCrosse Sketch] auf sourceforge
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ EC3000 Sketch] auf sourceforge
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von LaCrosse Temperatursensoren an Fhem
* {{Link2Forum|Topic=23217|LinkText=LevelSender}} Tankfüllstand mit JeeLink empfangen

[[Kategorie:Interfaces]]
[[Kategorie:Other Components]]