Dieses kleine AddOn bietet direkten Zugriff auf die internen Datenpunkte und Systemvariablen eines HomeMatic-Systems und ist in der Lage, Werte eines Objektes zu lesen als auch zu schreiben. Der Aufruf geschieht durch einfache HTTP-Anweisungen - es kommen keinerlei HTML-Header oder ähnliches zurück, sodass das Ergebnis in Bash- oder CMD-Skripten direkt weiterverarbeitet werden kann.

Installation/Deinstallation

Das Paket kann wie jedes andere Add-on über das WebUI installiert werden. Dazu wechselt man in den Bereich "System-Konfiguration > Systemsteuerung > Zusatzsoftware", wählt das entsprechende Paket aus und klickt auf Installieren. Nach einem Neustart der Zentrale sollte die Software im Bereich Zusatzsoftware aufgelistet werden.

Aufruf

Das Aufrufen eines Befehls erfolgt durch eine einfache URL nach folgendem Schema:

http://<ip-der-ccu>/addons/db/<script>.cgi

Als <ip-der-ccu> ist die IP-Adresse der HomeMatic-Zentrale (CCU) einzutragen. Über <script> wählt man eines der folgendenen Namen:

table	Liefert eine Liste aller Datenpunkte und Systemvariablen mit ID, Name, Datenpunkt und aktuellem Wert. Die Felder sind mit Tabulatoren getrennt, das Ergebnis kann dann weiterbearbeitet und z.B. am Stück in MySQL eingelesen werden. Achtung: Je nach Anzahl angelernter Komponenten kann die Abfrage durchaus einige Minuten dauern!
state	Liefert den Wert eines Objekts zurück und kann auch neue Werte setzen.

Beispiele

http://192.168.178.20/addons/db/state.cgi?item=Anwesenheit

Liefert entweder "true" oder "false" je nachdem, welchen Wert die Systemvariable gerade hat.


http://192.168.178.20/addons/db/state.cgi?item=Kombisensor&dp=TEMPERATURE

Liefert die aktuelle Temperatur zurück.


http://192.168.178.20/addons/db/state.cgi?item=Lichtaktor&dp=STATE&value=true&force=1

Schaltet das Licht ein, auch wenn es schon eingeschaltet war, und liefert "true" zurück.