HomeConnect - HowTo

[Pf@nne]

Moin,

für die Anbindung der BSH Hausgeräte (ehemals BSH Bosch Siemens Hausgeräte) hat Stefan (swhome) bereits fertige FHEM-Module zur Verfügung gestellt.

     48_HomeConnectConnection.pm
     48_HomeConnect.pm

Hierfür erstmal ein großes DANKE! 

Die Home Connect GmbH hat eigens für die Anbindung eigener Applikationen ein Application Programming Interface (API) zur Verfügung gestellt.
Über dieses API kann auf die eigenen, bereits bei der Home Connect GmbH angemeldeten, Hausgeräte zugegriffen werden.

Auch die FHEM-Wiki für diese Module ist bereits von Stefan fertiggestellt worden:
https://wiki.fhem.de/wiki/HomeConnect

Alle notwendigen Schritte für die Installation der beiden Module sind der Wiki zu entnehmen.

Wer die Module eigenständig modifiziert muss zwingend die Verbindungsrestriktionen einhalten.
Die Nichteinhaltung der von der Home Connect GmbH auferlegten Restriktionen bzw. RateLimits kann zur Sperrung des Developer-Accounts führen.

https://developer.home-connect.com/?q=docs/api/general/bestpractices
https://developer.home-connect.com/?q=support/developer_guidelines


Aktueller Entwicklungsstand:

Momentan befindet sich das Modul noch in der Betatestphase und kann nur mit einem eigenen Developer-Account bei Home Connect GmbH genutzt werden. Es ist keine explizite Freischaltung der einzelnen Developer-Accounts mehr notwendig.

Die Module laufen zur Zeit stabil, jedoch gibt es seitens der Home Connect GmbH noch kleinere Probleme:

• Von Zeit zu Zeit wird die Serververbindung seitens BSH blockiert, im FHEM-LOG wird dies durch folgenden Fehler angezeigt 

  2017.10.31 05:55:06 2: WTYH7780 event channel received an http error: HTTP/1.1 429 Too Many Requests

  gefixt
• Bei laufendem Programm hat die Serverabfrage eine erhebliche Zeitverzögerung - 13.05.2018 - gefixt
• Client Secret nicht mehr optional - 22.08.2018 - gefixt

Ansprechpartner:

Um die Anfragen an die Home Connect GmbH möglichst zu kanalisieren sollten alle Anfragen  über mich laufen.
Hierzu sollte möglichst ein neuer Beitag aufgemacht werden, damit haben dann alle etwas davon.


Viel Spaß mit den Modulen...

[Pf@nne]

Updates:

Da sich die Module aktuell noch in der Testphase befinden sind regelmäßige Updates unverzichtbar!
HomeConnect möchte einen zu hohen Traffic auf ihren Server zwingend vermeiden.
Sollte das Modul Probleme bereiten wird uns HC darauf hinweisen.
Stafan ist dann bemüht die Probleme schnellstmöglich abzustellen.

Es besteht weiterhin die Möglichkeit, dass User mit veralteten Modulen bis zum Update vorübergehend geperrt werden.

Daher schaut bitte regelmäßg nach Updates, nur so können wir unnötige Komplikationen mit der HC-Crew vermeiden.

Danke für euer Verständnis....
Pf@nne

Letzes Update:

• xx.01.2018 - BugFix - json error
• 25.01.2018 - Fix - token Refresh
• 13.05.2018 - Fix - Crash

[Pf@nne]

13.05.2018 - BugFix - Crash

[swhome]

22.08.2018  Support new client secret API feature and stateFormat attribute

[Florian_GT]

Du könntest im Wiki nochmal die Beschriftung der Variabeln korrigieren. Client ID und Client Secret (optional) statt  API Key und das Client Secret. Und ein Beispiel ohne Simulator wäre super.

[hoppel118]

Du könntest im Wiki nochmal die Beschriftung der Variabeln korrigieren. Client ID und Client Secret (optional) statt  API Key und das Client Secret. Und ein Beispiel ohne Simulator wäre super.

Ok, das im Wiki zu hinterlegen, kann ich bei Gelegenheit gerne machen. Die Fragen hatte ich mir auch bei der Ersteinrichtung gestellt. Mir sind da aber auch noch ein paar weitere Fragen aufgekommen.

1. Brauche ich wirklich einen Advanced Account? Wenn ja, wo kann ich das einstellen? Bei "Additional Information" kann ich unter "Account Type" --> "Corporate", "(Open Source) Community" oder "Individual" auswählen, siehe Screenshot. Ich habe mich jetzt mal für "(Open Source) Community" entschieden, oder sollte ich besser "Corporate" verwenden?
2. Wen trage ich unter "Community Contact" ein? Habe mich erstmal selbst hinterlegt. Oder sollte dort der Modulentwickler Pf@nne angegeben werden?

Wie dem auch sei, so wie ich es jetzt konfiguriert habe, funktioniert mein Kühlschrank in FHEM.

Danke für das tolle Modul und viele Grüße Hoppel

[Florian_GT]

Ok, das im Wiki zu hinterlegen, kann ich bei Gelegenheit gerne machen. Die Fragen hatte ich mir auch bei der Ersteinrichtung gestellt. Mir sind da aber auch noch ein paar weitere Fragen aufgekommen.

1. Brauche ich wirklich einen Advanced Account? Wenn ja, wo kann ich das einstellen? Bei "Additional Information" kann ich unter "Account Type" --> "Corporate", "(Open Source) Community" oder "Individual" auswählen, siehe Screenshot. Ich habe mich jetzt mal für "(Open Source) Community" entschieden, oder sollte ich besser "Corporate" verwenden?
2. Wen trage ich unter "Community Contact" ein? Habe mich erstmal selbst hinterlegt. Oder sollte dort der Modulentwickler Pf@nne angegeben werden?

Wie dem auch sei, so wie ich es jetzt konfiguriert habe, funktioniert mein Kühlschrank in FHEM.

Danke für das tolle Modul und viele Grüße Hoppel

Interessant, Kühlschrank mit welchen Daten?

[hoppel118]

Interessant, Kühlschrank mit welchen Daten?

Das ist hier offtopic. Aber schau mal hier: https://forum.fhem.de/index.php?topic=104754.msg986626#msg986626

2 Kameras hat das Teil auch noch. Die Bilder können aber anscheinend bisher nicht über die API abgerufen werden. Ich weiß nicht genau, ob ich ihn nochmal kaufen würde. Auch wenn es ein Schnapper war, kommt er mir tlws. ziemlich laut vor.

Gruß Hoppel

[Pauli29]

Ich kann mich mit dem Link im Modul erfolgreich einloggen.
Aber sobald ich auf der darauffolgenden Seite dann auf "Zulassen" klicke bekomme ich ein "connection refused" :-(

Was mache ich hier falsch?

[Zitze]

Ich habe die Einrichtung nach entsprechend dem WIKI durchgeführt.
Das Device hat bei mir den state Connected.
Laut WIKI soll man dann im hcconn-Device noch scanDevices ausführen. Wo findet man das?

[hoppel118]

Das Device hcconn anklicken und dort folgendes setzen:

Code: [Auswählen]

set hcconn scanDevices
Oder du gibst letztes einfach in die FHEM Command Line ein.

Gruß Hoppel

[Rumbel]

Hi,

danke für das super Modul.

Wollte direkt versuchen, meine Kaffeemaschine zu steuern um mir die extrem langen Alexa Befehle zu sparen.

Allerdings passiert bei mir nach dem set hcconn scanDevices genau gar nichts. :-(

Angemeldet bin ich wohl, meine Kaffeemaschine finde ich aber noch nicht


edit: habs gelöst.
Ich hatte beim accessScope nur CoffeeMaker-Control drin.
nicht aber accessScope
IdentifyAppliance Monitor Settings

--> steuern wäre gegangen, nicht aber das finden der Geräte :-D

[zwehn]

Hi, bin super happy mit der hommeconnect implementierung. Wenn unsere bosch waschmaschine fertig ist sagt uns alexa dass wir die Wäsche aufhängen können.
Nun haben wir den Bosch cookit dazubekommen. Der cookit is vergleichbar mit einem Thermomix. 1 Woche auf dem Markt.
Hommeconnect ist dabei eine zentrale schnittstelle.
In der heutigen homeconnect fhem Version  wird das geraet auch gefunden, aber auch nicht wirklich viel mehr. An init habe ich mich bisher nicht getraut.

[swhome]

Mach ruhig, kann nix passieren. Geschieht auch bei jedem FHEM Start

[hauwech]

Hallo zusammen,
ich versuche gerade unsere neue Spülmaschine einzubinden.
Wenn ich im Developer account "Register application" (unter HomeConnect -> Applications) aufrufe, ist da nix, wo ich wie beschrieben, den "Fhem Betatester" als "Company Name" eingeben kann.
Die verfügbaren Felder lauten:
- Application ID *
- OAuth Flow * -> "Authorization code gran flow" oder "device flow"
- Home Connect User Account for Testing
- Redirect URI *

Dann noch zwei Checkboxen:
- Add additional redirect URIs
- Enable One Time Token Mode

Hat sich da was geändert, oder bin ich nur falsch?

Gruß Roland