HM-CFG-USB USB Konfigurations-Adapter
Der HomeMatic USB Konfigurations-Adapter ist ein USB-Stick, der außer zur Konfiguration von HomeMatic Komponenten auch als Interface zwischen Fhem und HomeMatic Geräten benutzt werden kann.
Einbindung in FHEM
Im FHEM-Forum wird das Thema diskutiert unter dem Titel HomeMatic USB Konfigurations-Adapter (HM-CFG-USB) in Fhem nutzen. Teile der Informationen sind hier zusammengefasst.
Einrichtung unter Linux
Es gibt einen gut funktionierenden Dämon, um den USB Stick mit FHEM zum Laufen zu bekommen. Dabei wird zuerst der Dämon hmland installiert und danach das Gerät (üblicherweise auf localhost) genau wie HMLAN in FHEM eingebunden.
Zunächst muss der Dämon compiliert werden. Analog zu dieser Beschreibung ist die Vorgehensweise die folgende (in Debian/Ubuntu/Raspbian):
cd /opt/ apt-get install build-essential libusb-1.0-0-dev make gcc git-core git clone git://git.zerfleddert.de/hmcfgusb cd hmcfgusb make
(Unter Debian ist "build-essentials" nicht als Paket vorhanden, dieser Schritt kann entfallen.)
Danach kann der Dienst zu Testzwecken gestartet werden (in /opt/hmcfgusb):
./hmland -p 1234 -D
Um den Dämon nach einem Neustart automatisiert zu starten, kann ein init-script wie das Folgende verwendet werden:
# simple init for hmland pidfile=/var/run/hmland.pid port=1234 case "$1" in start|"") chrt 50 /opt/hmcfgusb/hmland -r 03:30 -d -P -l 127.0.0.1 -p $port 2>&1 | perl -ne '$|=1; print localtime . ": [hmland] $_"' >> /var/log/hmland.log & ;; restart|reload|force-reload) echo "Error: argument '$1' not supported" >&2 exit 3 ;; stop) killall hmland ;; status) if [ ! -e $pidfile ]; then echo "No pid" exit 1 fi pid=`cat $pidfile` if kill -0 $pid &>1 > /dev/null; then echo "Running" exit 0 else rm $pidfile echo "Not running" exit 1 fi ;; *) echo "Usage: hmland [start|stop|status]" >&2 exit 3 ;; esac
Bei Distributionen, die Upstart einsetzen (z.B. xbian) kann folgendes Konfigurationsfile verwendet werden:
# HMLAND description "hmland" start on starting fhem stop on stopped fhem respawn expect fork chdir /opt/hmcfgusb exec /opt/hmcfgusb/hmland -d -l 127.0.0.1 -p 1234
Die Datei sollte als "/etc/init/hmland.conf" angelegt werden. Mit dem Befehl
initctl reload-configuration
wird Upstart angewiesen, seine Konfiguration erneut einzulesen. Danach kann der neue Dienst mit
service hmland start
gestartet werden. hmland wird jetzt immer vor FHEM gestartet und nach FHEM beendet.
Alternative Einrichtung, Start über fhem Startskript
Ausprobiert auf einem BBB mit Debian, eigentlich ist das alles von Betateilchen:
Zunächst hmland kompilieren wie oben beschrieben, bis zum make. Das muss erfolgreich durchgelaufen sein.
Dann geht es weiter:
sudo cp hmcfgusb.rules /etc/udev/rules.d/
Jetzt das fhem Startskript anpassen (in den Blöcken 'start' und 'stop' muss quasi nur jeweils 1 Zeile eingefügt werden:
Damit editiert man das fhem Startskript:
sudo nano /etc/init.d/fhem
Und so sollten die Blöcke anschließend aussehen (bitte nur jeweils die Zeile mit hmland einfügen)
'start')
echo "Starting fhem..."
/opt/hmcfgusb/hmland -d -p 1234
perl fhem.pl fhem.cfg
RETVAL=$?
;;
'stop')
echo "Stopping fhem..."
perl fhem.pl $port "shutdown"
RETVAL=$?
pkill hmland
So wird hmland vor fhem gestartet und nach fhem beendet. Letztlich erspart es das Hantieren mit den diversen Startskripten und ihren Rechten.
Es dauert nach dem Start von fhem noch einige Sekunden, bis hmland fertig geladen ist. In dieser Zeit kann es zu fehlerhaften Einträgen im Logfile kommen.
Einrichtung unter Mac OS X
Wie unter Linux braucht man den Dämon hmland, den man aus Quelltexten erstellen muss. Dazu muss man die Bibliothek libusb installieren, entweder mit einem der Paketmanager wie Fink, MacPorts oder Homebrew oder direkt aus den Quellentexten (Beispiel: "fink install libusb1-shlibs libusb1"). Hat man wie bei Linux das Quelltextarchiv für hmland heruntergeladen und ausgepackt, müssen die Dateien Makefile und hmcfgusb.c angepasst werden.
Im Makefile muss man den Pfad zur libusb anpassen. Hat man libusb mit fink installiert muss man, "/opt/local/" durch "/sw/" bei den CFLAGS und den LDFLAGS ersetzen und das "-lrt" aus den LDLIBS entfernen. Die Library librt gibt es bei Mac OS X nicht und wird anscheinend auch nicht gebraucht. (Stimmt das eigentlich?)
In der Datei hmcfgusb.c muss man die Zeilen 130-134 mit dem Aufruf libusb_detach_kernel_driver auskommentieren oder löschen. Der geht nicht auf Mac OS X.
Nach den Änderungen in den zwei Dateien, kann man wie bei Linux den Dämon hmland mit dem Kommando "make" erzeugen und mit "./hmland" ausführen. Automatisches Starten beim Booten mit launchd ist noch nicht probiert.
Beim Start von hmland sollte man folgende Fehlermeldung in einer Endlos-Schleife erhalten:
Datum Zeit: Client 127.0.0.1 connected!
Can't claim interface: Access denied (insufficient permissions)
Can't find/open hmcfgusb!
Datum Zeit: Connection to 127.0.0.1 closed!
Auch ein Start von hmland mit Superuser-Rechten ändert daran nichts. Damit das claim interface klappt, muss man eine codeless kext in den Ordner /Library/Extensions legen. Ich habe dieses (http://mspdebug.sourceforge.net/misc/ex430rf2500-kext.zip) herunter geladen. Damit es funktioniert, muss man aber in der Datei Info.plist des Bündle die Properties idProduct und idVendor ändern, entweder mit dem Property List Editor oder einem anderen Texteditor. Die beiden Properties sind etwas versteckt bei Information Property List → IOKitPersonalities → ComIntf. Bei DebugIntf und DeviceDriver scheint man es nicht ändern zu müssen, aber schaden kann es nicht.
idProduct: 49167
idVendor: 6943
Die Rechte des kext-Bundles müssen auch noch gesetzt werden:
chmod -R 755 ex430rf2500.kext chown -R root:wheel ex430rf2500.kext
Danach die Datei ex430rf2500.kext in den Ordner /Library/Extensions legen und hmland sollte dann funktionieren.
Es kann sein, dass ab Mac OS X 10.9 der Trick mit dem codeless kext nicht mehr funktioniert, aber noch ist das nicht getestet oder bestätigt. Langfristig kann man vielleicht auch eine kext mit einem Treiber für den HM-CFG-USB USB erstellen
Einrichtung unter Windows
< Todo >
Bekannte Probleme
Raspberry Pi
Der USB-Stack am Raspberry Pi ist für viele Probleme verantwortlich. Daher sieht man öfter Fehlermeldungen:
usb-transfer took more than 100ms (1039ms), this may lead to timing problems!
Da das Timing bei Homematic wichtig ist führt das zu vielen Retransmits und zu unzuverlässigen Aktoren. Als Workaround kann man den USB-Stack auf die deutlich langsamere Version 1.1 stellen. Dazu fügt man folgenden Text am Anfang der Datei /boot/cmdline.txt ein:
dwc_otg.speed=1
Weitergehende Informationen
Es sind zwei Versionen des HM-CFG-USB im Umlauf:
- HM-CFG-USB-2: die aktuelle Version; Dokumentation derzeit (12/2013) nicht über die ELV-Artikelseite verfügbar, alternativ jedoch bei Völkner; Kennzeichen dieser Version:
- Größe: 28 x 84 x 11,5 mm
- Gewicht: 18 g
- Antenne innenliegend
- HM-CFG-USB: Vorgängerversion; Stand 12/2013 noch Restbestände im Handel verfügbar. Dokumentation (Völkner); Kennzeichen:
- Anschluss per separatem USB-Kabel
- abstehende Stabantenne
- Größe: 40 x 90 x 25 mm
- Gewicht: 45 g