elv Homematic IP HmIP-RFUSB Bau- Und Bedienungsanleitung Seite 4

4 Bau- und Bedienungsanleitung
Alle notwendigen Tools, Treiber für das eingesetzte
Betriebssystem und Programme, um den HmIP-RFUSB
Stick verwenden zu können, stehen im OCCU-Github-
Repository [2] zur Verfügung und ermöglichen es, den
HmIP-RFUSB Stick in beliebigen eigenen Software-
projekten einsetzen zu können.
Betriebssystemvoraussetzungen
Für Windows steht ein Treiber zur Verfügung, der über
[3] heruntergeladen werden kann. Unter Linux muss
der cp210x-Treiber installiert sein, der über folgende
Befehle geladen und konfiguriert werden muss:
modprobe cp210x
sh -c 'echo 1b1f c020 > /sys/bus/usb-serial/
drivers/cp210x/new _ id'
Mit der ersten Zeile wird der Treiber geladen, die
zweite Zeile sorgt dafür, dass der Treiber die eQ-
3-Vendor-ID (1b1f) und Product-ID (c020) berücksich-
tigt. Nach der Konfiguration steht ein Device z. B.
/dev/ttyUSB0 zur Verfügung.
Softwarekomponenten im OCCU-Projekt
Das OCCU-Projekt stellt verschiedene Softwarekompo-
nenten für Homematic IP/Homematic zur Verfügung,
mit der sich unterschiedliche Lösungen realisieren
lassen.
Die Basis dazu bilden die Schnittstellenprozes-
se, um Homematic IP/Homematic Geräte über eine
Programmierschnittstelle (z. B. XML-RPC) steuern zu
können.
Die Schnittstellenprozesse kommunizieren auf der
einen Seite mit der Funkhardware (HmIP-RFUSB, HM-
MOD-RPI-PCB), auf der anderen Seite stellen Sie eine
Programmierschnittstelle zur Verfügung.
Für den HmIP-RFUSB Stick stehen folgende Program-
me zur Verfügung:
· Java Tool, um administrative Aufgaben wie
Firmware-Update durchführen zu können
Funk-Hardware/Programme
1.) HM-MOD-RPI-PCB: sowohl Homematic IP als auch Homematic Funk
a) Firmware für das Funkmodul: dualcopro_si1002_update_blhm.eq3
b) multimacd-Programm einschl. spezieller Kernelmodule
c) Homematic IP Schnittstellenprozess crRFD
d) Homematic Schnittstellenprozess rfd
2.) HM-MOD-RPI-PCB: nur Homematic Funk
a) Firmware für das Funkmodul: coprocessor_update.eq3
b) Homematic Schnittstellenprozess rfd
3.) HmIP-RFUSB Stick: nur Homematic IP Funk
a) Firmware für den USB-Stick: HMIP-RFUSB-2.8.4.eq3
b) Homematic IP Schnittstellenprozess crRFD
4.) HmIP-RFUSB Stick und LAN-Gateway (HM-LGW-O-TW-W-EU)
a) Firmware für den USB-Stick: HMIP-RFUSB-2.8.4.eq3
b) Homematic IP Schnittstellenprozess crRFD (USB-Stick)
c) Homematic Schnittstellenprozess rfd (LAN-Gateway)
www.elv.com
· Java HmIP Schnittstellenprozess crRFD (analog rfd bei Homematic)
· Speziell für die CCU-Software ein HmIP Server, der eine Kombination
aus dem HM Server (Gruppenverwaltung, Messdatenerfassung) der
CCU2 und dem HmIP Schnittstellenprozess ist.
Das Java Tool besteht aus einem einzigen Jar-Archiv
„hmip-copro-update.jar".
Ruft man
java -jar hmip-copro-update-jar-with-dependencies.jar
ohne weitere Parameter auf, wird ein Hilfetext ausgegeben:
java -jar hmip-copro-update.jar
This is the Homematic IP Coprocessor Updater. Usage:
java -jar hmip-copro-update.jar -p <serial port> [-f <update file>] [-v]
-p <serial port>: Serial port to which the coprocessor is connected
-f <update file>: Update the coprocessor with the given firmware
file
-o : Overwrite the coprocessor firmware even if it already has the
desired version
-v : Print current coprocessor version
-r : Perform coprocessor factory reset
Um zu überprüfen, ob der HmIP-RFUSB Stick richtig funktioniert, kann
zum Beispiel die Versionsnummer abgefragt werden:
java -jar hmip-copro-update.jar -p /dev/ttyUSB0 –v
[INFO] Checking coprocessor firmware version ...
[INFO] Bootloader version = 1.0.11
[INFO] Application version = 2.4.4
Um ein Firmware-Update (Tabelle 1)
folgt aufgerufen werden:
java -jar hmip-copro-update-jar-with-dependencies.jar -p /dev/
ttyUSB0 -f ./HMIP-RFUSB-2.8.4.eq3
Performing update with firmware file ‚/home/user/./
HMIP-RFUSB-2.8.4.eq3' ...
[INFO] Updating coprocessor from version 2.4.4 to version 2.8.4
[INFO] Entering bootloader ...
[INFO] Bootloader version: 1.0.11
[INFO] Starting application ...
[INFO] New application Version: 2.8.4
Eine weitere Softwarekomponente ist der crRFD. Hierbei handelt es sich um
den Homematic IP Schnittstellenprozess analog dem rfd für Homematic.
einzuspielen, muss das Tool wie
Der crRFD wird über eine Konfi-
gurationsdatei konfiguriert. Eine
Liste der Konfigurationsparameter
einschließlich Funktionsbeschrei-
bung und Standardwerte sowie
eine Beispielkonfigurationsdatei
befindet sich im OCCU-Repository
[2].
Der crRFD wird wie folgt gestar-
tet:
java -jar crRFD-local-with-
devices-1.10.0-SNAPSHOT.jar
./crRFD.conf
Einen Überblick, welche Program-
me man für welche Hardware be-
nötigt, liefert die Übersicht in
Tabelle 1.