HM-LGW-O-TW-W-EU Funk-LAN Gateway: Unterschied zwischen den Versionen

Aus FHEMWiki
(HM-IP)
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWProtocol=[[HomeMatic]]
|HWType=Gateway
|HWType=[[Interface]]
|HWCategory=HomeMatic
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWChannels=''n/a''
|HWVoltage=5V DC
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWPoweredBy=externes Netzteil
|HWSize=116x150x34mm
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWDeviceFHEM=[[HMUARTLGW]]
Zeile 15: Zeile 15:
}}
}}


Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).
Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] für [[HomeMatic]]-Geräte, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN-Konfigurationsadapter]]. Es existieren zwei Revisionen dieses Geräts, HM-LGW-O-TW-W-EU und HM-LGW-O-TW-W-EU-2. Die folgende Beschreibung bezieht sich – sofern nicht anders angegeben – auf beide Geräterevisionen.


Das Gateway unterstützt ausschließlich das Homematic Funkprotokoll und kann nicht zur Reichweitenverlängerung von [[Homematic IP]] eingesetzt werden
Das Gateway unterstützt ausschließlich das HomeMatic-Protokoll und kann ''nicht'' mit [[HomeMatic IP|HomeMatic-IP]]-Geräten kommunizieren.


== Features ==
== Features ==
Zeile 32: Zeile 32:
  define meinLGW HMUARTLGW 192.168.42.23
  define meinLGW HMUARTLGW 192.168.42.23
  attr meinLGW lgwPw LGWPasswort
  attr meinLGW lgwPw LGWPasswort
  attr meinLGW hmId xxxxxx
  attr meinLGW hmId C0FFEE


=== Verwendung AES in FHEM===
* <code>192.168.42.23</code> ist die IP-Adresse des LAN-Gateways.
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
* <code>LGWPasswort</code> muss durch das Passwort des LAN-Gateways zu ersetzen ist. Das Default-Passwort ist auf der Rückseite des Geräts aufgedruckt.
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael (Linux Befehl: "sudo apt-get install libcrypt-rijndael-perl" siehe auch unter [[Raspberry Pi]]) benötigt (siehe auch Meldung im Log).
* <code>C0FFEE</code> ist die [[HomeMatic Devices pairen#hmId|Homematic-ID (hmId)]], mit der [[HomeMatic Devices pairen|Homematic-Geräte gepaired]] werden.
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.


=== Firmware ===
=== Verschlüsselung ===


Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.  
Das Modul beherrscht von sich die verschlüsselte Kommunikation mit den Homematic-Geräten. [[AES Encryption]] bietet Informationen zu diesem Thema.


Die Applikationsfirmware kann direkt aus FHEM aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.
Die LAN-Kommunikation ist standardmäßig ebenfalls verschlüsselt. Dazu wird das <code>Crypt::Rijndael</code> Perl-Modul benötigt. Wenn das Modul fehlt, weisen Log-Einträge darauf hin. Unter [[Raspberry Pi]] kann <code>Crypt::Rijndael</code> mit folgendem Befehlt installiert werden: <code>sudo apt-get install libcrypt-rijndael-perl</code>. Anschließend muss FHEM neugestartet werden, um das Modul zu finden. Die LAN-Verschlüsselung kann mit dem "NetFinder"-Tool von eQ-3 aktiviert und deaktiviert werden.


Bekannte Probleme: Nachdem die Firmware 1.1.5 über die Software Netfinder geladen wurde, wird das Gateway automatisch neu gestartet. Nach dem Neustart wird im Netfinder eine ältere Version angezeigt (z.B. vorher 1.1.3 nachher 1.1.1). Am Homatic Gateway muss der Netzstecker gezogen und wieder gesteckt werden. Nach dem Neustart wird dann die richtige Version angezeigt.
== Firmware ==


Das LAN-Gateway hat zwei Firmwares ("Applikations-Firmware" und "LAN-Firmware") die ggf. aktualisiert werden sollten. Frühere Versionen haben Stabilitätsprobleme. Die LAN-Firmware sollte mindestens auf Version 1.1.5 sein, die Applikations-Firmware sollte mindestens auf Version 1.4.1 sein.


(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.
Die Applikations-Firmware kann direkt aus FHEM aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.
 
'''Bekannte Probleme:''' Nachdem die Firmware 1.1.5 über NetFinder geladen wurde, wird das LAN-Gateway automatisch neu gestartet. Nach dem Neustart zeigt NetFinder eine ''ältere'' Version an (zum Beispiel vorher "1.1.3", nachher "1.1.1"). Durch einen erneuten Neustart des LAN-Gateways (durch Ziehen des Netzsteckers) kann das Problem behoben werden und NetFinder zeigt die richtige Version an.


=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===
=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===
Zeile 75: Zeile 76:
Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.
Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.


  $ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
Im Folgenden <code>NEQ0218723</code> durch die Seriennummer des Funk-LAN-Gateway und <code>geheimesLGWPasswort</code> durch das Lan-Gateway-Passwort (steht auf der Rückseite des Geräts) ersetzen. Falls die Verschlüsselung deaktiviert wurde entfällt die <code>-k</code>-Option.
 
  export LD_LIBRARY_PATH='../lib:../../RFD/lib'
LGW_SERIAL='NEQ0218723'
LGW_PASSWD='geheimesLGWPasswort'
./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -s "${LGW_SERIAL}" -k "${LGW_PASSWD}" -console -l 1
  2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...
  2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...
   
   
Zeile 86: Zeile 92:
=== Update der Applikationsfirmware mit FHEM ===
=== Update der Applikationsfirmware mit FHEM ===


1. Firmware herunterladen
# Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry  
## Verbinden Sie sich auf ihren Raspberry<br /><code>ssh pi@$IPADRESSE</code>
    ssh pi@ipadresse
## Wechseln Sie in das Firmware-Verzeichnis von FHEM<br /><code>cd /opt/fhem/FHEM/firmware/</code>
b: Wechseln Sie in das Firmware Verzeichnis von FHEM
## Firmware herunderladen<br /><code>wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3</code>
    cd /opt/fhem/FHEM/firmware/
# Flashen der neuen Firmware über die Befehlszeile in FHEM<br /><code>set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3</code>
c: Firmware Downloaden
    wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in FHEM
    set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3
 
=== Logbeispiel ===


== Bekannte Probleme ==
== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.
eine nach den in der {{Link2CmdRef|Anker=hmId}} definierten Regeln gewählte Id gesetzt werden.


== Links ==
== Links ==
Zeile 111: Zeile 111:
[[Kategorie:HomeMatic Components]]
[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]
[[Kategorie:Interfaces]]
[[Kategorie:868MHz]]

Aktuelle Version vom 31. Dezember 2018, 18:17 Uhr

HM-LGW-O-TW-W-EU Funk-LAN Gateway
HomeMatic Funk-LAN Gateway
Allgemein
Protokoll HomeMatic
Typ Interface
Kategorie HomeMatic
Technische Details
Kommunikation 868,3/869,525 MHz
Kanäle n/a
Betriebsspannung 5V DC
Leistungsaufnahme 0,8W
Versorgung externes Netzteil
Abmessungen 116x150x34mm
Sonstiges
Modulname HMUARTLGW
Hersteller ELV / eQ-3


Das HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway ist ein Interface für HomeMatic-Geräte, ähnlich dem LAN-Konfigurationsadapter. Es existieren zwei Revisionen dieses Geräts, HM-LGW-O-TW-W-EU und HM-LGW-O-TW-W-EU-2. Die folgende Beschreibung bezieht sich – sofern nicht anders angegeben – auf beide Geräterevisionen.

Das Gateway unterstützt ausschließlich das HomeMatic-Protokoll und kann nicht mit HomeMatic-IP-Geräten kommunizieren.

Features

(Noch zu ergänzen)

  • ...

Hinweise zum Betrieb mit FHEM

Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway. Dieses Modul unterstützt gleichzeitig auch das Funkmodul für Raspberry Pi.

Juli 2016: HMUARTLGW wird über FHEM update verteilt, damit ist dieses Funkmodul offiziell unterstützt.

Definition in FHEM

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId C0FFEE
  • 192.168.42.23 ist die IP-Adresse des LAN-Gateways.
  • LGWPasswort muss durch das Passwort des LAN-Gateways zu ersetzen ist. Das Default-Passwort ist auf der Rückseite des Geräts aufgedruckt.
  • C0FFEE ist die Homematic-ID (hmId), mit der Homematic-Geräte gepaired werden.

Verschlüsselung

Das Modul beherrscht von sich die verschlüsselte Kommunikation mit den Homematic-Geräten. AES Encryption bietet Informationen zu diesem Thema.

Die LAN-Kommunikation ist standardmäßig ebenfalls verschlüsselt. Dazu wird das Crypt::Rijndael Perl-Modul benötigt. Wenn das Modul fehlt, weisen Log-Einträge darauf hin. Unter Raspberry Pi kann Crypt::Rijndael mit folgendem Befehlt installiert werden: sudo apt-get install libcrypt-rijndael-perl. Anschließend muss FHEM neugestartet werden, um das Modul zu finden. Die LAN-Verschlüsselung kann mit dem "NetFinder"-Tool von eQ-3 aktiviert und deaktiviert werden.

Firmware

Das LAN-Gateway hat zwei Firmwares ("Applikations-Firmware" und "LAN-Firmware") die ggf. aktualisiert werden sollten. Frühere Versionen haben Stabilitätsprobleme. Die LAN-Firmware sollte mindestens auf Version 1.1.5 sein, die Applikations-Firmware sollte mindestens auf Version 1.4.1 sein.

Die Applikations-Firmware kann direkt aus FHEM aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der HomeMatic Netfinder (Java, läuft unter Linux/OSX/Windows, passendes Firmware-Image v. 1.1.5) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken libc6-i386 und lib32stdc++6 installiert werden müssen.

Bekannte Probleme: Nachdem die Firmware 1.1.5 über NetFinder geladen wurde, wird das LAN-Gateway automatisch neu gestartet. Nach dem Neustart zeigt NetFinder eine ältere Version an (zum Beispiel vorher "1.1.3", nachher "1.1.1"). Durch einen erneuten Neustart des LAN-Gateways (durch Ziehen des Netzsteckers) kann das Problem behoben werden und NetFinder zeigt die richtige Version an.

Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch): 

$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools: 

$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

Update der LAN-Firmware mit den eQ-3 Tools

Um das Update durchzuführen, muss man sich im Verzeichnis occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin bzw. occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin befinden.

Im Folgenden NEQ0218723 durch die Seriennummer des Funk-LAN-Gateway und geheimesLGWPasswort durch das Lan-Gateway-Passwort (steht auf der Rückseite des Geräts) ersetzen. Falls die Verschlüsselung deaktiviert wurde entfällt die -k-Option. 

export LD_LIBRARY_PATH='../lib:../../RFD/lib'
LGW_SERIAL='NEQ0218723'
LGW_PASSWD='geheimesLGWPasswort'
./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -s "${LGW_SERIAL}" -k "${LGW_PASSWD}" -console -l 1
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

Update der Applikationsfirmware mit FHEM

  1. Firmware herunterladen
    1. Verbinden Sie sich auf ihren Raspberry
      ssh pi@$IPADRESSE
    2. Wechseln Sie in das Firmware-Verzeichnis von FHEM
      cd /opt/fhem/FHEM/firmware/
    3. Firmware herunderladen
      wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
  2. Flashen der neuen Firmware über die Befehlszeile in FHEM
    set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

Bekannte Probleme

Das LGW hat (anders als das UART-Modul) keine eigene hmId (das Reading D-HMIdOriginal ist auf FFFFFF gesetzt). Es muss also mit

attr meinLGW hmId xxxxxx

eine nach den in der commandref/hmId definierten Regeln gewählte Id gesetzt werden.

Links

Abgerufen von „http://wiki.fhem.de/w/index.php?title=HM-LGW-O-TW-W-EU_Funk-LAN_Gateway&oldid=28855“