Home Connect Integration in Home Assistant: Ihre smarten Haushaltsgeräte einfach steuern

Die Home Connect Integration ermöglicht es Nutzern von Home Assistant, ihre smarten Haushaltsgeräte von Bosch und Siemens, die den Home Connect Standard unterstützen, über die offizielle Cloud-API zu integrieren. Dies eröffnet eine Welt der Automatisierung und komfortablen Steuerung direkt von Ihrem Smart Home Dashboard aus.

Diese Integration ist ideal für alle, die das Potenzial ihrer vernetzten Küchen- und Haushaltsgeräte voll ausschöpfen und ihren Alltag effizienter gestalten möchten. Von der Überwachung des Programmstatus bis hin zur Fernsteuerung – Home Connect in Home Assistant macht es möglich.

Anwendungsfälle für Home Connect in Home Assistant

Die Integration Ihrer Home Connect Geräte in Home Assistant bietet vielfältige Möglichkeiten, Ihren Haushalt zu optimieren:

• Überwachung und Automatisierung: Nutzen Sie die zahlreichen Sensoren Ihrer Geräte, um Automatisierungen auszulösen. Zum Beispiel eine Benachrichtigung, wenn der Geschirrspüler fertig ist.
• Programmstart per Dashboard: Starten Sie Programme auf Ihren Geräten direkt über Ihr Home Assistant Dashboard.
• Programmstatus-Überwachung: Behalten Sie den Status Ihrer laufenden Programme im Blick.
• Beleuchtungssteuerung: Regeln Sie die Beleuchtung Ihrer Geräte, etwa die Innenbeleuchtung von Kühlgeräten oder die Funktionsbeleuchtung Ihrer Dunstabzugshaube.
• Geräteeinstellungen anpassen: Ändern Sie spezifische Einstellungen Ihrer Geräte bequem von überall.

Bitte beachten Sie, dass der Funktionsumfang von den spezifischen Geräten und den API-Berechtigungen abhängt.

Unterstützte Geräte

Informationen zu den unterstützten Geräten finden Sie auf der Home Connect Website. Die Palette reicht von Geschirrspülern und Waschmaschinen über Öfen und Kaffeemaschinen bis hin zu Kühlschränken und Saugrobotern.

Voraussetzungen für die Einrichtung

Bevor Sie mit der Integration beginnen, müssen Sie einige Schritte im Home Connect Developer Portal durchführen:

1. Besuchen Sie https://developer.home-connect.com und registrieren Sie sich für ein Entwicklerkonto.
2. Geben Sie die E-Mail-Adresse Ihres ursprünglichen Home Connect App-Logins (Bosch/Siemens) unter „Default Home Connect User Account for Testing“ während des Registrierungsprozesses an.
3. Gehen Sie zur Seite Applications und wählen Sie Register Application:
   • Application ID: Home Assistant (oder ein Name Ihrer Wahl)
   • OAuth Flow: Authorization Code Grant Flow
   • Redirect URI: https://my.home-assistant.io/redirect/oauth
   • Stellen Sie sicher, dass Ihre Home Assistant URL unter https://my.home-assistant.io/ korrekt eingestellt ist, z.B. http://homeassistant:8123/ oder http://homeassistant.local:8123.
4. Nach erfolgreicher Registrierung werden Sie zur Seite Applications weitergeleitet. Wählen Sie Details für Ihre App aus. Notieren Sie sich die Client ID und das Client Secret – diese benötigen Sie für den nächsten Schritt. Melden Sie sich anschließend vom Home Connect Entwicklerportal ab.
5. Suchen Sie in Home Assistant die Home Connect Integration und starten Sie diese. Sie werden aufgefordert, einen Application Credential zu erstellen. Geben Sie einen beliebigen Namen sowie die Client ID und das Secret aus dem vorherigen Schritt ein. Befolgen Sie dann die Schritte in der Benutzeroberfläche, um die Einrichtung abzuschließen.

Wichtige Hinweise:

• Um die Liste der Geräteprogramme zu aktualisieren, können Sie die Home Connect Integration neu laden, wenn ein Gerät eingeschaltet ist. Wenn der Re-Initialisierungsprozess durch Neuladen nicht ausgelöst wird, starten Sie Home Assistant neu, während ein Gerät eingeschaltet ist.
• Melden Sie sich nach den oben genannten Schritten von Ihrem Home Connect Entwicklerkonto ab. Andernfalls schlagen die Konfigurationsschritte während der OAuth-Authentifizierung mit der Meldung „error“: „unauthorized_client“ fehl.
• Die angegebene E-Mail-Adresse des Home Connect Benutzerkontos muss vollständig kleingeschrieben sein, da es sonst zu Authentifizierungsfehlern kommen kann.
• Alle Änderungen im Entwicklerportal benötigen 15 Minuten, bis sie wirksam werden.
• Falls Sie My Home Assistant auf Ihrer Installation manuell deaktiviert haben, können Sie <home_assistant_url>/auth/external/callback</home_assistant_url> als Redirect URI verwenden.

Konfiguration der Home Connect Integration

Um den Home Connect Hub zu Ihrer Home Assistant Instanz hinzuzufügen, nutzen Sie diesen My-Button:

[

Home Connect kann von Home Assistant automatisch erkannt werden. Wenn eine Instanz gefunden wird, wird sie als Entdeckt angezeigt und Sie können sie sofort einrichten.

Manuelle Konfigurationsschritte

Falls die Integration nicht automatisch entdeckt wurde, können Sie sie manuell hinzufügen:

• Navigieren Sie zu Ihrer Home Assistant Instanz.
• Gehen Sie zu Einstellungen > Geräte & Dienste.
• Wählen Sie in der unteren rechten Ecke die Schaltfläche Integration hinzufügen.
• Wählen Sie aus der Liste Home Connect aus.
• Befolgen Sie die Anweisungen auf dem Bildschirm, um die Einrichtung abzuschließen.

Die Konfiguration der Integration fragt nach der oben erstellten Client ID und dem Client Secret. Weitere Details finden Sie unter Anmeldeinformationen für Anwendungen. Für die optimale Gestaltung Ihrer Küche, in der diese smarten Geräte zum Einsatz kommen, sollten Sie auch praktische Lösungen wie küchentheke in Betracht ziehen, die Funktionalität und Design verbinden.

Unterstützte Funktionen der Home Connect Integration

Die Home Connect Integration bietet eine breite Palette an Funktionen, die je nach Gerätetyp und API-Berechtigungen variieren können.

Hinweis:

• Die Verfügbarkeit der Entitäten hängt vom Gerätetyp ab, aber das Gerät unterstützt möglicherweise nicht alle Entitäten für seinen Typ.
• Programmoptions-Entitäten werden erst von der Integration bereitgestellt, wenn sie im ausgewählten oder aktiven Programm verfügbar sind.
• Einige Geräte melden keine Daten, wenn sie ausgeschaltet sind. Entsprechende Entitäten erscheinen daher nach dem Laden der Home Connect Integration erst, wenn die Geräte eingeschaltet werden.

Binäre Sensoren

Eine Liste der binären Sensoren:

• Konnektivität: Zeigt den Verbindungsstatus des Geräts an. (Alle Geräte)
• Fernsteuerung: Zeigt an, ob die Fernsteuerung aktiviert ist. (Kochfeld, Dunstabzugshaube, Backofen, Wärmeschublade, Geschirrspüler, Waschmaschine, Trockner, Waschtrockner)
• Fernstart: Zeigt an, ob ein Programm ferngestartet werden kann. (Kaffeemaschine, Dunstabzugshaube, Backofen, Wärmeschublade, Geschirrspüler, Waschmaschine, Trockner, Waschtrockner)
• Lokale Steuerung: Zeigt an, ob das Gerät gerade manuell vom Benutzer gesteuert wird. (Kaffeemaschine, Kochfeld, Dunstabzugshaube, Backofen, Wärmeschublade, Waschmaschine, Trockner, Waschtrockner)
• Türsensoren: Zahlreiche Türsensoren für Kühlschrank, Gefrierfach, Weinkühler usw. (Kühl-Gefrierkombination, Kühlschrank, Gefrierschrank, Weinkühler)
• Batterieladestatus: Beschreibt, ob der Saugroboter lädt oder entlädt. (Saugroboter)
• Ladeverbindung: Zeigt an, ob der Saugroboter verbunden oder getrennt ist. (Saugroboter)

Tasten (Buttons)

Eine Liste der verfügbaren Tasten:

• Programm stoppen: Stoppt das aktive Programm. (Alle programmfähigen Geräte)
• Programm pausieren: Pausiert das aktive Programm. (Backofen, Saugroboter, Waschmaschine, Trockner, Waschtrockner)
• Programm fortsetzen: Setzt das pausierte Programm fort. (Backofen, Saugroboter, Geschirrspüler, Waschmaschine, Trockner, Waschtrockner)
• Tür öffnen: Öffnet die Gerätetür. (Backofen, Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank)
• Tür teilweise öffnen: Öffnet die Gerätetür teilweise. (Backofen)

Beleuchtung

Eine Liste der Beleuchtungsentitäten:

• Innenbeleuchtung: Steuert die Innenbeleuchtung von Kühlgeräten. (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank, Weinkühler) – Steuert Ein/Aus, Helligkeit.
• Außenbeleuchtung: Steuert die Außenbeleuchtung von Kühlgeräten. (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank, Weinkühler) – Steuert Ein/Aus, Helligkeit.
• Funktionsbeleuchtung: Steuert die Funktionsbeleuchtung einer Dunstabzugshaube. (Dunstabzugshaube) – Steuert Ein/Aus, Helligkeit.
• Ambientebeleuchtung: Steuert die Ambientebeleuchtung eines Geräts. (Dunstabzugshaube, Geschirrspüler) – Steuert Ein/Aus, Helligkeit, HSV, RGB.

Nummern (Number Entities)

Eine Liste der Nummern-Entitäten:

Einstellungen

• Wecker: Stellt den Wecker. (Kochfeld, Backofen)
• Solltemperatur Kühlschrank/Gefrierschrank/Weinkühler: Legt die Temperatur in verschiedenen Kühlzonen fest. (Kühl-Gefrierkombination, Kühlschrank, Gefrierschrank, Weinkühler)
• Farbtemperatur in Prozent: Stellt die Farbtemperatur der Funktionsbeleuchtung in Prozent ein (warmes Licht: 0 %, kaltes Licht: 100 %). (Dunstabzugshaube)
• i-Dos Füllstand: Stellt die Basisdosierungsmenge für i-Dos-Inhalt 1 oder 2 ein. (Waschmaschine, Waschtrockner)

Programmoptionen

• Dauer: Definiert die Laufzeit des Programms. (Backofen)
• Start in relativ: Definiert, wann das Programm starten soll (in Sekunden). (Backofen, Geschirrspüler)
• Ende in relativ: Definiert, wann das Programm enden soll (in Sekunden). (Trockner, Waschmaschine, Waschtrockner)
• Füllmenge: Beschreibt die Wassermenge (in ml) bei Kaffeemaschinenprogrammen. (Kaffeemaschine)
• Solltemperatur: Definiert die Zieltemperatur des Backofens. (Backofen)

Auswahlen (Select Entities)

Eine Liste der Auswahl-Entitäten:

Programme

• Aktives Programm: Repräsentiert das aktive Programm des Geräts; die Auswahl einer Option startet das Programm. (Alle programmfähigen Geräte)
• Ausgewähltes Programm: Repräsentiert das ausgewählte Programm des Geräts; die Auswahl einer Option wählt das Programm aus. (Alle programmfähigen Geräte)

Hier werden zahlreiche spezifische Programme für Kaffeemaschinen (Ristretto, Espresso, Cappuccino, Heißwasser), Geschirrspüler (Eco, Intensiv, Glas 40°C), Trockner (Baumwolle, Synthetik, Outdoor), Dunstabzugshauben (Automatisch, Lüften) und Waschmaschinen (Baumwolle, Pflegeleicht, Mix, Hygiene) aufgelistet.

Einstellungen

• Aktuelle Karte: Repräsentiert die aktuell ausgewählte Karte des Saugroboters. (Saugroboter)
• Farbtemperatur Funktionslicht/Ambientebeleuchtung: Repräsentiert die Farbtemperatur bzw. Farbe der Beleuchtung. (Dunstabzugshaube, Geschirrspüler)

Programmoptionen

• Referenzkarten-ID, Reinigungsmodus, Saugleistung: Für Saugroboter.
• Bohnenmenge, Kaffeetemperatur, Bohnenbehälter, Durchflussrate, Kaffee-Milch-Verhältnis, Heißwassertemperatur: Für Kaffeemaschinen.
• Trockenziel: Für Trockner.
• Lüftungsstufe, Intensivstufe: Für Dunstabzugshauben.
• Wärmestufe: Für Backöfen (Wärmeschublade).
• Temperatur, Schleuderdrehzahl, VarioPerfect: Für Waschmaschinen und Waschtrockner.

Sensoren

Eine Liste der Sensoren:

• Fertigstellungszeit: Zeigt die voraussichtliche Endzeit des Programms an. (Kaffeemaschine, Dunstabzugshaube, Backofen, Geschirrspüler, Trockner, Waschmaschine, Waschtrockner) – Hinweis: Nur verfügbar, wenn ein Programm läuft.
• Programmfortschritt: Zeigt den Fortschritt des Programms an. (Kaffeemaschine, Dunstabzugshaube, Backofen, Wärmeschublade, Geschirrspüler, Trockner, Waschmaschine, Waschtroschner) – Hinweis: Nur verfügbar, wenn ein Programm läuft.
• Betriebszustand: Repräsentiert den aktuellen Betriebszustand des Geräts (Inaktiv, Bereit, Verzögerter Start, Läuft, Pause, Aktion erforderlich, Beendet, Fehler, Abbruch). (Alle programmfähigen Geräte)
• Türzustand: Repräsentiert den aktuellen Zustand der Tür (Geschlossen, Verriegelt, Offen). (Backofen, Geschirrspüler, Trockner, Waschmaschine, Waschtrockner, Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank, Weinkühler)
• Zähler: Verschiedene Zähler für Kaffeemaschinen (Kaffeezähler, Heißwasserzähler, Milchzähler etc.).
• Batteriestand, Kamerastatus, Zuletzt ausgewählte Karte: Für Saugroboter.
• Aktuelle Innenraumtemperatur: Für Backöfen. Wichtiger Hinweis: Dieser Sensor wird nicht zur Nutzung empfohlen, da die Temperatur möglicherweise nicht die erforderliche Genauigkeit bietet.

Ereignissensoren (Event Sensors)

Ereignissensoren werden erst von der Integration bereitgestellt, wenn das Gerät das Ereignis meldet. Mögliche Werte sind confirmed, present, off.

Beispiele für Ereignisse:

• Programm abgebrochen/beendet: (Kochfeld, Saugroboter, Geschirrspüler, Waschmaschine etc.)
• Wecker abgelaufen: (Kochfeld, Backofen)
• Vorheizen beendet: (Kochfeld, Backofen)
• Trocknungsprozess beendet: (Trockner)
• Salz/Klarspüler fast leer: (Geschirrspüler)
• Bohnenbehälter/Wassertank leer, Tropfschale voll: (Kaffeemaschine)
• Entkalkung/Reinigung erforderlich/überfällig/blockiert: (Kaffeemaschine)
• Türalarm (Gefrierschrank/Kühlschrank): (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank)
• Temperaturalarm Gefrierschrank: (Gefrierschrank, Kühl-Gefrierkombination)
• Staubbehälter leeren/Filter reinigen, Saugroboter steckt fest, Ladestation nicht gefunden: (Saugroboter)
• i-Dos Füllstand niedrig: (Waschmaschine)
• Fettfilter Sättigung fast erreicht/erreicht: (Dunstabzugshaube)

Schalter (Switch Entities)

Eine Liste der Schalter-Entitäten:

• Ein/Aus: Schaltet das Gerät ein/aus oder in den Standby-Modus. (Alle Geräte) – Hinweis: Einige Geräte unterstützen nur den Zustand „Ein“.
• Kindersicherung: Repräsentiert den Zustand der Kindersicherung. (Kaffeemaschine, Kochfeld, Backofen, Wärmeschublade, Geschirrspüler, Trockner, Waschmaschine, Waschtrockner, Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank, Weinkühler)
• Tassenwärmer: Aktiviert/Deaktiviert den Tassenwärmer. (Kaffeemaschine)
• Super-Modus (Gefrierschrank/Kühlschrank): Kühlt das Fach auf die niedrigste Temperatur. (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank)
• Eco-Modus: Aktiviert/Deaktiviert den Eco-Modus. (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank)
• Sabbat-Modus: Aktiviert/Deaktiviert den Sabbat-Modus (deaktiviert Funktionen wie Beleuchtung, akustische Signale). (Backofen, Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank, Weinkühler)
• Urlaubsmodus: Reduziert den Energieverbrauch (Kühlschrank auf +14ºC). (Kühl-Gefrierkombination, Kühlschrank)
• Fresh-Modus: Reduziert die Temperatur im Kühlschrankfach automatisch auf 2ºC. (Kühl-Gefrierkombination, Kühlschrank)
• Spender aktiviert: Aktiviert/Deaktiviert den Eiswasserspender. (Kühl-Gefrierkombination, Kühlschrank)
• Türassistent: Aktiviert/Deaktiviert das automatische Türöffnen. (Gefrierschrank, Kühl-Gefrierkombination, Kühlschrank)

Aktionen in der Home Connect Integration

Die Home Connect Integration stellt verschiedene Aktionen zur Verfügung: set_program_and_options und change_setting.

Aktion: Programm und Optionen einstellen (set_program_and_options)

Die Aktion home_connect.set_program_and_options startet oder wählt ein Programm aus. Ist das Attribut program nicht gesetzt, werden die Optionen für das aktive oder ausgewählte Programm eingestellt.

Datenattribut	Optional	Beschreibung
device_id	nein	ID des Geräts.
affects_to	nein	Wählt aus, ob das Programm durch die Aktion das aktive oder das ausgewählte Programm sein soll.
program	ja	Das zu wählende Programm. Wenn gesetzt, wird ein Programm gestartet oder ausgewählt, je nach affects_to.
…	…	Zahlreiche spezifische Optionen für Klimaanlagen, Saugroboter, Kaffeemaschinen, Geschirrspüler, Trockner, Dunstabzugshauben, Backöfen und Waschmaschinen (z.B. Lüftungsstufen, Bohnenmenge, Start in relativ, Intensivzone, Trockenziel, Temperatur etc.).

Aktion: Einstellung ändern (change_setting)

Die Aktion home_connect.change_setting ändert eine Einstellung.

Datenattribut	Optional	Beschreibung
device_id	nein	ID eines Geräts, das mit dem Haushaltsgerät verbunden ist.
key	nein	Schlüssel der Einstellung.
value	nein	Wert der Einstellung.

Automatisierungsbeispiele

Beginnen Sie mit diesen Automatisierungsbeispielen, um Ihr Smart Home noch effizienter zu gestalten. Für die Einrichtung einer funktionalen und ästhetisch ansprechenden Umgebung, in der Ihre smarten Geräte glänzen können, sind [l küchen mit geräten](https://shocknaue.com/l-k