Home Connect Local Fork (Profil-Download ohne Desktop-Tool)

Integrationen
1

Hinweis vorab: Das ist ein privater Fork der Integration chris-mc1/homeconnect_local_hass. Er liegt nicht im HACS-Store und ist keine Konkurrenz zum Original. Wer mit dem Upstream zufrieden ist, braucht ihn nicht.

Vorgeschichte

Ausführlicher hatte ich das im Sammel-Thread beschrieben: Beitrag #121. Hier als eigenes Thema und zusammengefasst.

Angefangen hat es aus Spielerei. Ich nutze die Integration lokal für zwei Geräte: einen Bosch-Geschirrspüler (Verbindung über TLS/PSK) und ein Siemens-Kochfeld (Verbindung über AES).

Interessant fand ich vor allem den offenen Upstream-PR #405 von SamJongenelen: ein in den HA-Einrichtungsdialog integrierter Profil-Downloader, sodass das separate Desktop-Tool (bruestel) entfällt. Dazu kam, dass im Upstream offene Fehler und fertige PRs über längere Phasen ohne sichtbaren Fortschritt liegen blieben.

Also habe ich den PR-Stand genommen, für meine beiden Geräte geradegezogen und als eigene HACS-Integration installierbar gemacht. Kernpunkte: Anmeldung mit Home-Connect-Konto direkt im Einrichtungsdialog (kein Desktop-Tool, auch von Android und iOS nutzbar), alle Profil-Entitäten standardmäßig aktiv, deutscher Einrichtungsdialog. Das war Anfang Juli 2026, Version 1.0.6.

Aus der Spielerei wurde mehr: Bugs aus dem Upstream fixen oder es versuchen, teils von meinen Geräten, teils aus fremden Fehlerberichten, teils aus offenen Upstream-PRs portiert. Seit Ende August 2026 sollen auch fremde Gerätetypen profitieren, nicht nur meine zwei.

Was seit 1.0.6 passiert ist

Setup, Login, Übersetzung (1.0.7 bis 1.0.9)

  • Der über Zeroconf erkannte Host wird jetzt auch im Login-Pfad übernommen, nicht nur beim manuellen ZIP-Upload.
  • AES-Profile ohne IV brachen die Einrichtung mit irreführender Meldung ab, jetzt sauber abgefangen.
  • 60-Sekunden-Timeouts auf beiden Cloud-Sessions, damit ein hängender Request die Einrichtung nicht blockiert.
  • Konkrete Download-Fehlermeldungen (zum Beispiel falsche Region) statt “Unknown error”, in acht Sprachen.
  • Keine Geräteschlüssel mehr im Debug-Log.
  • Einrichtungsdialog auf Deutsch.
  • GitHub-Actions-CI mit HA-Versionsmatrix (2026.3 bis aktuell), damit Regressionen vor einem Release auffallen.

Config-Flow und Verbindung

  • AuthenticationError, HCHandshakeError und WSServerHandshakeError führen jetzt zum Host-Eingabeformular statt zu “Unknown error”. Betrifft TLS- und AES-Geräte.
  • Der erste Verbindungsaufbau läuft als Hintergrund-Task und blockiert das Setup nicht mehr.
  • homeconnect-websocket von 1.5.3 auf 1.5.4: .lower() auf execution (eine Großschreibung in einer Nachricht brach vorher den ganzen Update-Batch ab), ein Fehlercode auf /ni/info bricht den Handshake nicht mehr ab, Fix für Link-Local-IPv6 mit Zone-ID. Nutzen vor allem für fremde Gerätetypen.

Entitäten, Absturz- und Verhaltensfixe

  • Licht: color_temp_kelvin liefert None statt einen TypeError zu werfen (Absturz im Entity-Callback, mehrfach gemeldet). Der Farbmodus wird zur Laufzeit aus der Verfügbarkeit des Farbtemperatur-Settings abgeleitet.
  • Backofen-Wassertank-Sensor: war als falscher Sensor-Typ angelegt und stürzte beim Setup und bei jedem Auslesen ab. Behoben.
  • Entität blieb nach einem einzelnen fehlgeschlagenen State-Write dauerhaft eingefroren (kein Log-Hinweis, half nur ein HA-Neustart). Behoben.
  • Start-Button: aktualisiert sich jetzt bei Auswahl- und Reset-Events und wird auch dann angelegt, wenn das Profil beim Start noch kein startfähiges Programm meldet.
  • Programm-Auswahl: bei Geräten, die SelectedProgram read-only melden und ihre Programme als START_ONLY fahren, blieb die Auswahl dauerhaft unbenutzbar. Fällt jetzt auf ActiveProgram zurück.
  • Waschmaschinen mit beiden SpeedPerfect-Optionen gleichzeitig: kollidierende unique_id, die zweite Entität wurde still verworfen. Behoben, ohne die entity_id bestehender Geräte zu ändern.

Dunstabzugshauben (1.11.4)

  • Lüfter zeigte “an”, obwohl die Haube ausgeschaltet war: blieb bei der letzten Lüfterstufe hängen. Prüft jetzt zusätzlich den Betriebszustand des Geräts.
  • Ausschalten schlug bei manchen Modellen fehl, weil der bisherige Weg (Lüfterstufe auf 0 schreiben) von einigen Geräten abgelehnt wird. Läuft jetzt über den Ein/Aus-Schalter des Geräts, mit Rückfallebene auf den alten Weg für Geräte ohne schaltbaren Ein/Aus-Schalter.
  • Einschalten bzw. Lüfterstufe ändern konnte mit einem Fehler abbrechen, wenn gerade kein Programm aktiv war. Läuft jetzt über den korrekten Programmstart-Mechanismus.

Neue Entitäten (additiv, teils aus Upstream-PRs portiert)

  • Kühlgerät-Entitäten und Icons.
  • Geschirrspüler: eco_dry-Schalter, Silence-on-Demand-Dauer und Restzeit, Vorspül-Schalter mit vier zugehörigen Binärsensoren, Machine-Care-Diagnosesensor, WLAN-Signal mit Fallback.
  • Dunstabzug: Kohlefilter-Typ, Arbeitslicht-Start- und Abschaltverhalten.
  • Kochfeld: nicht verfügbare Extension-Zonen und read-only Power/Start-Controls standardmäßig deaktiviert.
  • Host bzw. IP in der Geräteinfo.

Vollständige Liste in den Release Notes.

Mittesten

Ich entwickle an zwei Geräten. Fehler auf anderer Hardware kann ich nur beheben, wenn sie jemand meldet, am besten mit Debug-Log und Diagnose-Export. Wer testet und Rückmeldung gibt, hilft also direkt mit.

Fehler und Wünsche in den Fork-Issue-Tracker.

Demnächst kommt ein Siemens-Gerät der iQ700-Serie dazu, das erweitert mein Setup und die lokalen Testmöglichkeiten.

Dank an chris-mc1 (Integration und homeconnect-websocket-Library), bruestel (Profile Downloader, PKCE-Flow) und SamJongenelen (PR #405).

Links

Installation (Kurzform)

  1. In HACS als benutzerdefiniertes Repository hinzufügen: https://github.com/Asmir1975/homeconnect_local_hass-UI (Typ Integration), herunterladen, HA neu starten.
  2. Einstellungen, Geräte und Dienste, Integration hinzufügen, “Home Connect Local”.
  3. Einrichtungsmethode wählen: Anmeldung mit Home-Connect-Konto, oder vorhandene Profil-ZIP hochladen.
  4. Gerät auswählen. Schlägt der Verbindungstest fehl, IP von Hand eintragen.
1 „Gefällt mir“
Wie man Home Connect Geräte mit Home Assistant steuern kann
2

Läuft super! Habe jetzt 4 Neff-Geräte problemlos verbinden können.

Werde mir die nächsten Tage ansehen, was die so für Informationen bieten. Einen Stromverbrauch für Geschirrspüler, Backrohr oder Kochfeld gibt es nicht?

1 „Gefällt mir“
3

Hi aleksanda, das freut mich zu hören. Ich habe ziemlich genau die gleichen Geräte von Siemens im
Haushalt: einen IQ300 Geschirrspüler, ein IQ700 Kochfeld und heute kam noch ein IQ700 Backofen dazu.
Habe eben aus meinem Profil die Übersetzungen für DE und EN ergänzt und aufeinander abgestimmt.
Kommt mit der nächsten Version mit.

Mein Geschirrspüler zeigt nur in der iOS-App Strom- und Wasserverbrauch an. Das in der Integration
umzusetzen ist aktuell nicht möglich. Das erledige ich mit Zigbee-Steckdosen für meine Dashboards.

VG
Asko

4

Update auf 1.11.5 ist da.

Was sich geändert hat:

  • Optionen, die während eines laufenden Programms gesperrt sind, verschwinden nicht mehr
    komplett. Sie werden jetzt sichtbar, aber deaktiviert angezeigt.
  • Übersetzungen komplett abgeglichen: Deutsch und Englisch sind jetzt auf demselben Stand,
    quer über Backofen-, Kochfeld- und Waschmaschinen-Programme. Vorher fehlten in der deutschen Datei einige hundert Einträge, jetzt sind beide Sprachen deckungsgleich.
  • Kühllüfterlaufzeit beim Backofen zeigt jetzt korrekt “Empfohlen” an statt auf Englisch
    zurückzufallen (war ein falscher interner Schlüssel).
  • Im Hintergrund: ein Absturz behoben, der bei manchen Geräten mit älterem Profil auftreten
    konnte, wenn ein Programm gemeldet wurde, das im Profil nicht mehr bekannt war. Läuft jetzt
    einfach als “unbekannt” weiter statt die Integration zu crashen.
  • Die automatische Wartezeit beim Wiederverbinden nach einem Verbindungsabbruch war seit einem früheren Umbau kaputt (kein Backoff mehr, sofortige Wiederholungsversuche). Ist jetzt wieder wie vorgesehen.

Release-Notes:

VG
Asko

5

Update auf 1.11.6 ist da.
Was sich geändert hat:

  • Neuer Schalter fürs Ofenlicht im Garraum: Licht lässt sich jetzt manuell ein-/ausschalten, statt nur passiv anzuzeigen ob es an ist.
  • Neuer Schalter für die Energieverbrauchsanzeige am Kochfeld-Display.
  • Fortschrittsanzeige beim Backofen (Programmfortschritt, verbleibende/verstrichene Zeit) blieb nach Programmende manchmal dauerhaft auf dem letzten Wert hängen, wenn man die Abfrage am Display nicht bestätigt hat. Springt jetzt zuverlässig auf 0 zurück, sobald das Programm fertig ist.
  • Im Hintergrund: Abbrechen/Pause-Knopf konnte bei manchen Geräten mit einem rohen Fehler abstürzen statt die vorhandene, übersetzte Fehlermeldung zu zeigen.
  • Im Hintergrund: das “readonly”-Attribut bei gesperrten Optionen blieb nicht immer zuverlässig gesetzt; Einrichtung über einen hochgeladenen Diagnose-Dump vergab bisher keine eindeutige Geräte-ID.

Release-Notes:

Release 1.11.6

VG
Asko

1 „Gefällt mir“
6

Update auf 1.11.7 ist da.
Was sich geändert hat:

  • Manche Geräte (bestimmte Backöfen, Kaffeevollautomaten) lehnten einen Programmstart ab, wenn nicht alle Programmeinstellungen auf einmal mitgeschickt wurden. Start-Knopf und Programmauswahl füllen jetzt bei solchen Geräten automatisch alle übrigen Einstellungen mit dem aktuellen Wert auf. Betrifft nur Geräte, die das ausdrücklich verlangen, keines meiner eigenen.Falls euer Gerät sowas mal abgelehnt hat, testet gerne und meldet euch, ob’s jetzt sauber startet.
  • Im Hintergrund: die Verbindung zum Gerät wird jetzt auch beim Neustart/Herunterfahren von Home Assistant sauber geschlossen, nicht nur beim Deaktivieren der Integration.

Release-Notes:

Release 1.11.7

VG
Asko

7

1.11.8 ist da:

  • Ofen: Fortschritt/Verstrichene Zeit resetten jetzt auch im Zustand “Bereit” sauber auf 0
  • Kochfeld: doppeltes Leerzeichen im Namen der Zonen-Sensoren entfernt
  • Ein paar fehlende Icons ergänzt
  • Ofen-Garraumlicht ist jetzt eine Licht-Entität statt eines Schalters
  • Mindest-Python-Version auf 3.14 angehoben (läuft schon seit HA 2026.3.0)

Release-Notes:

Release 1.11.8

VG
Asko

8

Kurzes Update zu meinem Home Connect Local Fork (Home Connect Local with built-in Profile Downloader): Version 1.11.9 ist raus.

In den letzten Versionen habe ich neben eigenen Features auch gezielt Bugs angegangen, die im Upstream-Projekt (chris-mc1/homeconnect_local_hass) noch offen sind oder dort schon länger als Issue liegen. Ein paar Beispiele aus den letzten Runden:

  • Fix: set_start_in/set_finish_in-Services haben den Wert tatsächlich nie geschrieben (fehlendes await), ist jetzt behoben
  • Fix: Programmwahl bleibt bei aktivem Delayed Start sichtbar und read-only, statt komplett zu verschwinden
  • Fix: Fallback für Geräte, die einen reinen “Fertig in”-Write ablehnen, jetzt kombiniert mit Programmstart
  • Fix: Hauben-Lüfter (Start/Stopp, Geschwindigkeit, PowerState) läuft jetzt über die richtigen Protokollpfade
  • Fix: read-only Options bleiben sichtbar, statt ausgeblendet zu werden, wenn ein Programm läuft
  • Neu: Kühlschrank-Türassistent-Entities (Schalter, Force-Select, Tür-öffnen-Button)
  • Diverse Übersetzungsfehler und Lücken, Icon-Fixes und Stale-Progress-Fixes für Backofen-Anzeigen

Der Fork deckt inzwischen deutlich mehr ab als nur mein eigenes Setup aus Kochfeld, Geschirrspüler und Backofen. Vieles davon konnte ich nur anhand von Diagnose-Logs und Community-Berichten umsetzen, nicht an eigener Hardware. Deshalb an alle, die den Fork nutzen oder ausprobieren wollen: Tester und Issue-Melder sind immer willkommen, egal welches Gerät ihr habt, auch Kochfeld, Backofen oder Geschirrspüler. Besonders freuen würde ich mich über Rückmeldungen zu Geräten, bei denen ich selbst nicht testen kann:

  • Waschmaschine/Trockner: Code-Basis ist da, aber es gibt noch offene Fremd-Reports zu Delayed Start, Programmstart und Optionen
  • Kaffeevollautomat: ebenfalls vorhanden, bei mir aber ungetestet, auch dort gibt es offene Reports zum Programmstart
  • Dunstabzugshaube: schon mehrfach gefixt, einzelne Modelle melden aber noch Probleme mit Lüfter, Lichtfarbe oder Programmwahl
  • Kühlschrank/Gefrierschrank: frisch dazugekommen mit den Türassistent-Entities, technisch sauber gebaut, aber ohne eigenes Gerät nie live getestet

PRs sind ebenso willkommen, wenn jemand selbst was beitragen will. Und falls euch das Projekt was bringt, wäre ein Stern auf GitHub für mich ein echter Ansporn, dranzubleiben.

Repo: homeconnect_local_hass-UI

Release:1.11.9

VG Asko