Übersicht Home Connect / BSH



Mit diesem Funktionsbaustein werden Hausgeräte von Bosch, Siemens, NEFF und Gaggenau über die Home Connect Cloud-API eingebunden (Waschmaschine, Trockner, Geschirrspüler, Backofen, Kaffeemaschine, Kühlgerät, Dunstabzug u. a.).

Die Verbindung läuft ausschließlich über die Home-Connect-Cloud (HTTPS); eine lokale Anbindung der Geräte ist herstellerseitig nicht vorgesehen. Die Steuerung benötigt daher eine Internetverbindung. Ein Baustein repräsentiert ein Home-Connect-Konto, die Geräte des Kontos werden als Adressen generiert.

Voraussetzung: Der Kunde besitzt ein Home-Connect-Konto (in der Home-Connect-App angelegt) und seine Hausgeräte sind in diesem Konto angemeldet. Die Steuerung muss mit dem Internet verbunden und im Studio mit der Steuerung verbunden sein.

Anmeldung und Verknüpfung des Kundenkontos — Schritt für Schritt:
  1. Baustein einfügen und die Eigenschaften öffnen. Auf die Schaltfläche Anmelden / Geräte suchen klicken — der Anmeldedialog öffnet sich.
  2. Im Dialog auf Anmelden klicken. Die Steuerung fordert bei Home Connect einen Anmeldecode an; nach wenigen Sekunden erscheinen im Dialog eine Internetadresse (Link) und ein Code.
  3. Den Link anklicken (er öffnet den Browser) — oder die Adresse am Handy/PC des Kunden öffnen. Mit Code kopieren lässt sich der Code in die Zwischenablage übernehmen.
  4. Im Browser mit dem Home-Connect-Konto des Kunden anmelden (E-Mail und Passwort des Kunden).
  5. Den angezeigten Code eingeben (falls nicht bereits vorausgefüllt) und den Zugriff bestätigen/erlauben.
  6. Sobald die Bestätigung im Browser abgeschlossen ist, wechselt der Dialog automatisch auf Angemeldet und startet die Gerätesuche. Der Code ist zeitlich begrenzt gültig; bei Ablauf einfach erneut Anmelden.
  7. Die gefundenen Hausgeräte werden in der Liste angezeigt. Mit Übernehmen werden sie in den Baustein übernommen und die Adressen automatisch erzeugt.
Die Anmeldung bleibt in der Steuerung dauerhaft gespeichert (auch nach einem Neustart) — der Vorgang muss also nur einmal durchgeführt werden. Über Abmelden im Dialog wird die Verknüpfung zurückgesetzt; danach ist eine erneute Anmeldung erforderlich.

Kein Kunden-PC/-Handy zur Hand? Der Link mit Code kann auch auf einem beliebigen Gerät geöffnet werden — entscheidend ist nur, dass man sich dort mit dem Home-Connect-Konto des Kunden anmeldet.

Je Gerät werden folgende Adressen erzeugt:
  • Ein/Aus (Eingang): schaltet das Gerät ein bzw. aus. Der passende Aus-Wert (Aus oder Bereitschaft) wird automatisch ermittelt. Manche Geräte (z. B. Waschmaschine, Trockner) können über die API grundsätzlich nicht ausgeschaltet werden — nur direkt am Gerät.
  • Programm Start/Stopp (Eingang): 1 startet das am Gerät vorgewählte Programm, 0 stoppt das laufende Programm.
  • Betriebszustand (Ausgang): 0=Inaktiv, 1=Bereit, 2=Startverzögerung, 3=Läuft, 4=Pause, 5=Aktion nötig, 6=Fertig, 7=Fehler, 8=Abbruch.
  • Türstatus (Ausgang): 0=Zu, 1=Offen, 2=Verriegelt.
  • Restzeit (Ausgang): verbleibende Programmlaufzeit in Sekunden.
  • Fortschritt (Ausgang, 0..100 %): Programmfortschritt.
  • Verbunden (Ausgang): Gerät ist mit der Cloud verbunden.
Wichtig: Für den Programmstart muss am Gerät der Fernstart freigegeben und ein Programm vorgewählt sein. Die Home-Connect-Nutzungsbedingungen verlangen, dass der Anwender über automatisch gestartete Programme informiert wird.

Hinweis: Statusänderungen werden über einen dauerhaften Ereignis-Datenstrom der Cloud empfangen und stehen ohne zyklische Abfrage sofort zur Verfügung. Für Tests kann als Server simulator.home-connect.com mit einem Entwicklerkonto verwendet werden; die Anmeldung erfolgt dort automatisch ohne Code-Eingabe.

Ausgänge
ER
 Fehlercounter
 Anzahl Kommunikationsfehler (-1 = Software ohne SSL-Unterstützung)
ST
 Status
 0 = nicht angemeldet, 1 = angemeldet, 2 = angemeldet und Ereignis-Datenstrom aktiv

Parameter
Server
 Home-Connect-Server (Standard: api.home-connect.com; für Tests: simulator.home-connect.com)
Client-ID / Client-Secret
 Zugangsdaten der API-Applikation. Leer lassen = eingebaute uni-PRO-Zugangsdaten verwenden; nur für eigene Entwicklerkonten (z. B. Simulator) ausfüllen.
Timeout (ms)
 Verbindungs-Timeout in Millisekunden
Anzahl Geräte
 Anzahl der eingebundenen Hausgeräte (bestimmt die Anzahl der generierten Adressen)
Geräteliste
 Zuordnung der Geräte (Geräte-ID/Name/Typ). Wird über die Suche automatisch gefüllt.
Debug
 Zusätzliche Diagnoseausgaben im Fehlerprotokoll

Siehe auch allgemeine Parameter aller Funktionsbausteine.