JeeLink: Unterschied zwischen den Versionen

Aus FHEMWiki
Keine Bearbeitungszusammenfassung
KKeine Bearbeitungszusammenfassung
Zeile 18: Zeile 18:


== Beschreibung ==
== 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) welche nicht miteinander kompatibel sind. Damit kann man auch keinen CUL als JeeLink-Ersatz nutzen!
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) welche nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!


Den JeeLink gibt es in einer  
Den JeeLink gibt es in einer  
* 433MHz Version
* 433MHz Version
* 868MHz Version (die Standard Version)
* 868MHz Version (Standard)
* 913MHz Version
* 913MHz Version


Zeile 29: Zeile 29:
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:
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
* 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 Platform (verfügbar sind Windows, Mac OS X und Linux)
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
* Einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE
* Herunterladen des benötigten Sketches  
* Herunterladen des benötigten Sketches  
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
* Start der Arduino Software und Jeelink flashen
* Start der Arduino Software und JeeLink flashen


== JeeLink flashen ==  
== JeeLink flashen ==  
Zeile 40: Zeile 40:
* Start der Arduino Software
* Start der Arduino Software
* Seriellen Port des JeeLink auswählen
* Seriellen Port des JeeLink auswählen
* in den Tools als Board "Arduino Uno" auswählen
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen
* Sketch mit "Datei öffnen" auswählen
* Sketch mit "Datei öffnen" auswählen
* Upload klicken
* Upload klicken
Zeile 46: Zeile 46:
== Hinweise zum Betrieb mit Fhem ==  
== Hinweise zum Betrieb mit Fhem ==  
Um den JeeLink mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.
Um den JeeLink mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.
* JeeLink an den Fhem-Rechner anschließen und
* 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)
* 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 ===
=== Definition in fhem.cfg ===
Erforderliche Definitionen in Fhem:
Erforderliche Definitionen in Fhem:
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code>
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am usb hängt!
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt!
*x=0,1,2, usw
*x=0,1,2, usw


Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse, EC3000 und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.
Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse, 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, keinen Sketch, der mehr als eines der Protokolle abdeckt).
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).


=== PCA301 Sketch ===
=== 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.
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.


Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch warscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man dann keine Steckdose angelernt.
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.
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' würde man dann ermitteln, dass die Funksignale zb. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.
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:
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:


  static uint16_t rf12_center_freq = 0xA70C;
  static uint16_t rf12_center_freq = 0xA70C;

Version vom 3. Mai 2014, 06:53 Uhr

JeeLink ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.

JeeLink
JeeLink mit Drahtantenne
Allgemein
Protokoll PCA301, EC3000, RoomNode oder LaCrosse
Typ Interface
Kategorie
Technische Details
Kommunikation 433/868/913MHz
Kanäle ?
Betriebsspannung 5V
Leistungsaufnahme ?
Versorgung USB
Abmessungen 23*67*9mm
Sonstiges
Modulname 36_JeeLink.pm
Hersteller 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) welche nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!

Den JeeLink gibt es in einer

  • 433MHz Version
  • 868MHz Version (Standard)
  • 913MHz Version

Vorbereitung JeeLink

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 FTDI Treiber installieren, unter Linux ist dieser meist schon vorhanden
  • Installation der Arduino Software für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)
  • Einbinden der Jeelabs Library in die Arduino IDE
  • Herunterladen des benötigten Sketches
  • Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE
  • Start der Arduino Software und JeeLink flashen

JeeLink flashen

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

Hinweise zum Betrieb mit Fhem

Um den JeeLink 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 mknod /dev/ttyUSB0 c 188 0 das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)

Definition in fhem.cfg

Erforderliche Definitionen in Fhem:

define myJeeLink JeeLink /dev/ttyUSBx@57600
  • USBx ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt!
  • x=0,1,2, usw

Die autocreate-Funktion sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse, 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).

PCA301 Sketch

Der Sketch für die Unterstützung der PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung (PCA301-pcaSerial.zip) kann von sourceforge heruntergeladen werden.

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. 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:

static uint16_t rf12_center_freq = 0xA70C;

Anschließend auf den Jeelink neu flashen.

Details zur Benutzung finden sich im Artikel zur PCA301.

Lacrosse Sketch

Der Sketch für die Unterstützung der Lacrosse Temperatursensoren kann von sourceforge heruntergeladen werden.
Zusätzlich muss noch die Jeelib (verfügbar auf Github) in der Arduino IDE installiert werden (unter Umständen muss eine ältere Version der Arduino IDE verwendet werden).

Energy Count 3000 Sketch

Ein Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker ist hier zu finden. Das Fhem Modul dazu (36_EC3000.pm) ist im gleichen Thread angehängt (die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) sind mittlerweile im aktuellen Fhem enthalten).

JeeLabs RoomNode

Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in diesem Forenthread enthalten.

Weitergehende Informationen

Hinweise zum Betrieb eines JeeLink mit Fhem finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:

Bekannte Probleme

  • Beim Betrieb an einer 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 Forenthread).

Weblinks