In diesem Artikel geht es um das auswerten von Verbrauchsdaten aus der HomematicIP Schalt-Mess-Steckdose am eigenen Webserver. Dazu wird auf der Zentrale ein Skript erstellt, welches die Daten vom Zwischenstecker ausliest und anschließend über das HTTP-Protokoll an einen Webserver überträgt.

Voraussetzungen

Für dieses Projekt wird eine Homematic-IP Schalt-Mess-Steckdose benötigt, welche an einer CCU3 Zentrale angelernt ist. Zusätzlich zu den HomematicIP Produkten wird noch ein Webserver mit MySQL und PHP benötigt.

Rohdaten auslesen via Homematic Script

Zuerst kann man sich mit einem einfachen Skript alle verfügbaren Parameter von einem Gerät anzeigen lassen. So kann mit dem folgenden Skript nicht nur die Parameter von einer Schalt-Mess-Steckdose ermittelt werden, sondern auch Parameter von anderen Geräten wie Temperatursensoren, Rauchmelder, Bewegungsmelder und vielen weiteren Geräten. In der HomematicIP CCU3 Weboberfläche gibt es unter dem Menüpunkt "Programme & Zentralenverknüpfung" einen Button mit "Skript testen", wo folgender Skript eingefügt wird:

Der String "0000AAAA0000AA" muss durch die Seriennummer vom gewünschten Gerät ersetzt werden. Klickt man auf Ausführen, so sollten alle verfügbaren Parameter aufgelistet werden:

PHP-Skript zum Datenempfang

Auf den Webserver wird zuerst ein PHP-Script hochgeladen, welches die empfangenen Daten in eine Textdatei schreibt. Damit kann sehr einfach überprüft werden, ob die HTTP-Verbindung zum Webserver von der CCU aus funktioniert. Folgendes PHP-Skript (receiver.php) wird auf den Webserver geladen:

Homematic Skript für eine HTTP-Verbindung

Das folgende Skript wird sowohl für einen Verbindungstest als auch später für die kontinuierliche Datenübermittlung verwendet werden. Dieses Skript holt sich die Daten vom Smartmeter (Schalt-Mess-Steckdose HmIP-PSM-2) und startet via Exec im Betriebssystem auf der Homematic CCU3 einen HTTP-Request und übermittelt die Daten via HTTP-GET. Zu beachten ist, dass folgende Variablen am Anfang vom Codebeispiel entsprechend angepasst sind:

• debug:
  Während Verbindungstests durchgeführt werden, sollte die Variable auf "true" gestellt sein. Dadurch werden Fehlermeldungen und weitere Details beim manuellen Aufruf dieses Skripts angezeigt. Nach erfolgreicher Einrichtung sollte debug auf "false" gestellt werden.
• deviceid:
  Das ist die Seriennummer vom auszulesenden Zwischenstecker. Die Variable beginnt immer mit HmIP-RF.SERIENNUMMER
• server:
  Hinter der Variable server befindet sich die vollständige URL zum PHP-Skript. Nach dem letzten Slash wird automatisch noch die Datei receiver.php weiter unten im Code angefügt.

Konnte das Skript eine Verbindung zum Server herstellen und die Daten übertragen, sollte die Ausgabe ungefähr wie folgt aussehen:

Wenn die Variable "debug" auf "true" gesetzt ist, dann wird auch im Fehlerfall (Beispiel fehlerhaften URL) eine entsprechende Ausgabe erzeugt:

Textdatei überprüfen

Wenn das Homematic-Skript eine Verbindung zum PHP-Skript herstellen konnte, dann sollte am Webserver nun eine Textdatei (data.txt) mit folgendem Inhalt vorhanden sein:

Programm auf der CCU3 einrichten

Sobald vom Smartmeter neue Daten eintreffen, sollen diese auch direkt zum Webserver weitergeleitet werden. Dazu muss in der Weboberfläche unter "Programme & Zentralenverknüpfung" ein neues Programm erstellt werden. Als Gerät wird die gewünschte Schalt-Mess-Steckdose ausgewählt und bei einer Frequenz größer 45 Hz soll das Skript aufgerufen werden. Da die Netzfrequenz in der Regel 50 Hz beträgt, wird mit diesem Trick bei jedem Dateneingang das Skript ausgeführt. Die Regel sieht wie folgt aus:

PHP Dashboard einrichten

Das Dashboard dient zur detaillierten Aufzeichnung von den Verbrauchsdaten eines Gerätes, welches an das Smartmeter angeschlossen ist. Die Messdaten werden in einer MySQL-Datenbank gespeichert. Zuerst wird der ZIP-Ordner HmIP PHP Dashboard heruntergeladen, extrahiert und die vier PHP-Dateien auf das gewünschte Verzeichnis vom Webserver hochgeladen. In der Datei config.php müssen die Zugangsdaten, der Datenbankname und die Serveradresse zum Datenbankserver angepasst werden. Der Inhalt dieser Datei sieht wie folgt aus:

<?php
// MySQL-Zugangsdaten
define('DB_SERVER', 'localhost');	// Datenbank-Server
define('DB_USERNAME', 'username'); 	// Benutzername
define('DB_PASSWORD', 'password');	// Passwort
define('DB_NAME', 'db-name');	// Name der Datenbank

$conn = new mysqli(DB_SERVER, DB_USERNAME, DB_PASSWORD, DB_NAME);

if ($conn->connect_error) {
    die("Verbindung zur Datenbank fehlgeschlagen: " . $conn->connect_error);
}
?>

Die vier Variablen müssen auf den eigenen MySQL-Datenbankserver angepasst werden!

Setup ausführen

Nachdem die Datei config.php angepasst wurde, kann die Datei setup.php über den Browser aufgerufen werden. Dieses Skript erstellt am Datenbankserver zwei Tabellen, wo die Aufzeichnungsdaten und Einstellungen gespeichert werden. Wenn die Datenbank korrekt vom PHP-Skript eingerichtet werden konnte, werden folgende Meldungen ausgegeben:

Hinweis: Die Datei setup.php sollte nach erfolgreicher Einrichtung unbedingt vom Webserver gelöscht werden!

Dashboard aufrufen

Über den Browser wird das Dashboard aufgerufen. Wenn noch keine Daten aufgezeichnet wurden, sieht das Dashboard wie folgt aus:

Anschließend wird die Aufzeichnung gestartet und das gewünschte Gerät an das Smartmeter angeschlossen. Nach einigen Minuten kann die Seite aktualisiert werden und es sollten die aufgezeichneten Daten angezeigt werden:

Hinweis: Wird eine neue Aufzeichnung gestartet, werden die Daten von der vorherigen Aufzeichnung gelöscht.