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

Aus FHEMWiki
Keine Bearbeitungszusammenfassung
 
(20 dazwischenliegende Versionen von 5 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-Protokoll und kann ''nicht'' mit [[HomeMatic IP|HomeMatic-IP]]-Geräten kommunizieren.


== Features ==
== Features ==
Zeile 30: 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
 
* <code>192.168.42.23</code> ist die IP-Adresse des LAN-Gateways.
* <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.
* <code>C0FFEE</code> ist die [[HomeMatic Devices pairen#hmId|Homematic-ID (hmId)]], mit der [[HomeMatic Devices pairen|Homematic-Geräte gepaired]] werden.


=== Verwendung AES in FHEM===
=== Verschlüsselung ===
{{Hinweis|Vor einem Pairing mit Homematic-Geräten (z.B. dem [[HM-CC-RT-DN_Funk-Heizkörperthermostat|HM-CC-RT-DN Funk-Heizkörperthermostat]]), die eine Verschlüsslung benötigen, '''muss''' im Betriebssystem der FHEM-Installation die AES-Bibliothek ''libcrypt-rijndael-perl'' für Perl nachinstalliert werden.}}


Folgende Zeile muss dazu auf der Kommandozeile ausgeführt werden
Das Modul beherrscht von sich die verschlüsselte Kommunikation mit den Homematic-Geräten. [[AES Encryption]] bietet Informationen zu diesem Thema.
$ sudo apt-get install libcrypt-rijndael-perl


Danach sollte FHEM neu gestartet werden, um die Bibliothek einzubinden.
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.


Weitere Informationen zum Thema Verschlüsselung bietet der Eintrag [[AES Encryption]].
== Firmware ==
=== Firmware ===


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


(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.
'''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 73: 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 82: Zeile 90:
  2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.
  2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.


=== Update der Applikationsfirmware mit Fhem ===
=== Update der Applikationsfirmware mit FHEM ===
 
1. Firmware herunterladen
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware aus Fhem
fhem> set meinLGW updateCoPro /path/to/coprocessor_update_hm_only.eq3


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


== 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 104: 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“