X1 Logikbaustein: BoschDecrypt - Heizung auslesen

[doenke]

Beschreibung


Mit diesem Baustein kann eine Bosch/Buderus/Junkers Heizung ausgelesen werden. Dazu wird ein KM200 oder ein vergleichbares Interface an der Heizungsanlage verwendet. Ich verwende hier ein MB LANi.

Dieser Baustein wird zusammen mit dem HTTP-Request Baustein von dalbuschat verwendet. Mit dem Baustein wird die Heizung abgefragt, welche ein verschlüsseltes Ergebnis liefert. Dieser Baustein kümmert sich nun um die Entschlüsselung der Daten. Als Ergebnis kann entweder die Value-Eigenschaft direkt ausgewertet werden oder es wird der komplette JSON String an den XML/JSON Parser von hyman übergeben und von dort weiter verarbeitet.

Für die Entschlüsselung wird ein persönlicher Schlüssel benötigt. Dieser Schlüssel kann auf der Seite https://ssl-account.com/km200.andreashahn.info/ generiert werden.

Dazu benötigt Ihr:

• Das persönliche Kennwort, welches bei Anmeldung an der Anlage via Handy-App vergeben wurde
• Das Gerätepasswort, welches sich auf einem Aufkleber am Gerät befindet oder über das Menü am Gerät angezeigt werden kann

Der persönliche Schlüssel hat das Format: 2895fc3a36fcea27e6b5f5c46c20abc869fdec907ef82af51c 67974e005dab9e

Eingänge

BoschMessage	String	Die verschlüsselte Ausgabe des HTTP-Requests
Key	String	Persönlicher Schlüssel

Ausgänge

Value	Any	Der Inhalt des Value Attributs des zurückgegebenen JSON Strings, wenn ein value-Attribut existiert. Üblicherweise ist die das Ergebnis, was man haben möchte. Wenn kein value-Attribut vorhanden ist, wird ein leerer String ausgegeben.
Result	String	Der entschlüsselte JSON String zur weiteren Verarbeitung oder auch zur Ansicht in der Simulation.
Error	Bit	Wird auf 1 gesetzt, wenn die Entschlüsselung fehlschlägt.

Anwendung


BoschCryptExample.png

In diesem Beispiel wird der Abruf von einem Telegrammgenerator alle 5 Minuten getriggert.

Der Webrequest ist folgendermaßen konfiguriert:

• URL: http://192.168.9.10/solarCircuits/sc...torTemperature
• Eigene Header setzen: Anzahl eigene Header: 1
• Header 1: User-Agent:TeleHeater/2.2.3

Die IP Adresse ist entsprechende der IP Adresse der Heizung abzuändern. Der Teil der danach kommt bestimmt die abzurufende Funktion.
Ohne Angabe des User-Agents spuckt die Heizung nur eine nichtssagende Fehlermeldung aus.
Das Ergebnis dieses Web-Requests ist nun die verschlüsselte Antwort von der Heizung.



Der BoschCrypt-Baustein kümmert sich nun um die Entschlüsselung der Antwort der Heizung. Das Ergebnis ist ein JSON String. Wenn dieser JSON String ein Value-Attribut enthält, so wird dieses separat ausgegeben. Bisher haben alle Antworten der Heizung, welche einen Wert zurückgeben, dies mit Hilfe eines solchen Value-Attributs getan.

Funktionen

Es sind die folgenden Hauptfunktionen bekannt:

• /dhwCircuits
• /gateway
• /heatingCircuits
• /heatSources
• /notifications
• /recordings
• /solarCircuits
• /system

Diese liefern als Ergebnis ein JSON, welches die verfügbaren Unterfunktionen enthält. Von hier kann man sich dann durchhangeln, bis man bei dem Attribut gelandet ist, welches man sucht. Ich habe bisher diese Funktionen im Einsatz:

• /system/sensors/temperatures/outdoor_t1
• /heatingCircuits/hc1/holidayMode/activated
• /solarCircuits/sc1/collectorTemperature
• /solarCircuits/sc1/dhwTankTemperature
• /dhwCircuits/dhw1/actualTemp
• /system/sensors/temperatures/hotWater
• /heatingCircuits/hc1/actualSupplyTemperature

Falls jemand in der Lage ist, der Heizung zu entlocken, ob die Automatik sie in den Sommer- oder Wintermodus versetzt hat, darf diese Info gerne mit mir teilen...

Changelog

• 1.0.19
  • erste veröffentlichte Version

http://service.knx-user-forum.de/?co...ad&id=20000031

[doenke]

Hier noch kurz der Hinweis für alle mit Bosch Heizungen:
Dieser Baustein führt bei intensiver Nutzung zu sehr unübersichtlichen Logikblättern. Daher gibt es hier Abhilfe: https://knx-user-forum.de/forum/supp...kers-heizungen

Ich habe das in ein neues Paket gepackt, damit jeder so umstellen kann, wie er meint und die alten Bausteine bei Bedarf gelöscht werden können.