Posted

in

,

Updated

Bosch Heizkörper-Thermostat 2 über ZHA mit Home Assistant verbinden

Das Bosch Smart Home Heizkörperthermostat II (2. Generation/Version) ist eine smarte Temperatur-Regelung für Heizkörper und wird auch als „Radiator thermostat II“ oder mit dem Gerätetyp „BTH-RA“ bezeichnet. Das Thermostat unterstützt den Funkstandard Zigbee und kann daher problemlos in Home Assistant eingebunden werden, ohne den Bosch Smart Home Controller (Gateway) kaufen zu müssen. Voraussetzung ist natürlich, dass du deinen Home Assistant mit einem Zigbee-Stick ausgestattet hast. Im Gegensatz zu vielen anderen Zigbee-Geräten wird beim Bosch-Thermostat der 2. Generation sogar die Zigbee-Version 3.0 unterstützt, was die Einrichtung in Home Assistant aufgrund des QR-Codes für die Erstinstallation etwas komplizierter macht, als bei älteren Zigbee-Geräten ohne QR-Code bzw. Install Code. Der folgende Artikel erklärt, wie du das Thermostat mit Home Assistant und ZHA koppeln kannst.

Wenn du Home Assistant mit einem Zigbee-Stick nutzt und das Thermostat damit betreiben möchtest, brauchst du keinen Bosch Smart Home Controller. Achte beim Kauf also darauf, dass du nur das reine Thermostat und kein Bundle kaufst. Bei Amazon gibt es das Bosch Heizkörper-Thermostat II als Einzelgerät oder als 3er-Set, wobei je nach Angebot manchmal drei Einzelgeräte sogar günstiger sind.

×
Produktpreise und -verfügbarkeit sind zum angegebenen Datum / Uhrzeit korrekt und können sich ändern. Alle Preis- und Verfügbarkeitsinformationen auf https://www.amazon.de/ zum Zeitpunkt des Kaufs gelten für den Kauf dieses Produkts.

Variante mit Zigbee und Matter, Farbe: silber

×
Produktpreise und -verfügbarkeit sind zum angegebenen Datum / Uhrzeit korrekt und können sich ändern. Alle Preis- und Verfügbarkeitsinformationen auf https://www.amazon.de/ zum Zeitpunkt des Kaufs gelten für den Kauf dieses Produkts.

Variante mit Zigbee und Matter, Farbe: anthrazit

×
Produktpreise und -verfügbarkeit sind zum angegebenen Datum / Uhrzeit korrekt und können sich ändern. Alle Preis- und Verfügbarkeitsinformationen auf https://www.amazon.de/ zum Zeitpunkt des Kaufs gelten für den Kauf dieses Produkts.

Variante mit Zigbee (ohne Matter)

×
Produktpreise und -verfügbarkeit sind zum angegebenen Datum / Uhrzeit korrekt und können sich ändern. Alle Preis- und Verfügbarkeitsinformationen auf https://www.amazon.de/ zum Zeitpunkt des Kaufs gelten für den Kauf dieses Produkts.

Variante mit Zigbee (ohne Matter), 3er-Set

Die Anleitung des Thermostats, FAQ und weitere Infos für die reine Zigbee-Variante findest du hier und für die Variante mit Zigbee und Matter hier.

Kompatibilität mit Heizkörperventilen

Passt das Bosch Heizkörper-Thermostat II überhaupt an deinen Heizkörper? Nutze unsere Anleitung, um vor dem Kauf die Kompatibilität mit deinem Heizkörper zu checken:

Kompatibilität mit Zigbee-Funkmodul (Stick/Dongle/Adapter)

Da es sich bei dem Bosch-Thermostat um ein Zigbee 3.0-Gerät handelt, muss auch deine Zigbee-Hardware und die entsprechende Firmware neu genug sein, um diesen Standard zu unterstützen. Dieses Funkmodul wird auch als Dongle, Adapter oder Stick bezeichnet und ist meist per USB mit dem Raspberry Pi (oder sonstigem Gerät), auf dem Home Assistant läuft, verbunden.

Die nachfolgend erklärte Kopplung in ZHA via QR-Code oder Installationscode funktioniert (bisher) nur für Zigbee-Chips von Silicon Labs EmberZNet („ezsp“), darunter auch der oben erwähnte Connect ZBT-1, und Texas Instruments („znp“). Die Module von dresden elektronik deCONZ ConBee und RaspBee beispielsweise unterstützen die neue Art der Zigbee-Gerätekopplung nicht. Versucht man es trotzdem mit einem solchen Modul erhält man beim Kopplungsvorgang meist die folgende Fehlermeldung: Failed to call service zha.permit. Unknown error bzw. Fehler beim Aufrufen des Diensts zha.permit. Unknown error.

Zigbee-Stick/Dongle: Damit die Kopplung deines Bosch Heizkörper-Thermostat II funktioniert, muss dein Zigbee-Funkmodul (bzw. die Firmware) sogenannte „Install-Codes“ unterstützen. Konkret funktioniert das aktuell in Zigbee2MQTT ausschließlich mit zstack-basierten Adaptern mit Chips von Texas Instruments (ZNP) und ember-basierten Adaptern mit Chips von Silicon Labs (EmberZNet)1. Unter anderem die hier gezeigten Zigbee-Sticks von Sonoff werden empfohlen und als kompatibel gelistet.
Achtung: Die beliebten Phoscon ConBee-Sticks von Dresden Elektronik unterstützen keine Installcodes2.

„ZBDongle-P“ mit zStack (Texas Instruments)

„ZBDongle-E“ mit EmberZNet (Silicon Labs)

„Dongle Plus MG24“ mit EmberZNet (Silicon Labs)

Alternativ gibt es noch die „offizielle“ Hardware namens Home Assistant Connect ZBT-1 (früher „SkyConnect“ genannt). Der Stick unterstützt generell auch Thread/Matter – beachte aber, dass (entgegen anfangs anders lautender Pläne seitens Home Assistant/Nabu Casa) Zigbee und Thread nicht gleichzeitig auf demselben Stick nutzbar sind (Multiprotokoll), sondern die Funktionalität nur durch Flashen der jeweiligen Firmware zwischen Zigbee oder Thread gewechselt werden kann.

Ich nutze im Folgenden einen USB-Stick mit einem Texas Instruments (TI) Chip CC2652, der Zigbee 3.0 und insbesondere die Kopplung per QR-Code bzw. Installationscode unterstützt.

Kopplung von Zigbee 3.0 Gerät mit ZHA

Auf Zigbee 3.0 Geräten ist in der Regel ein individueller Installationscode, die Zigbee-ID und zusätzlich ein QR-Code, der diese beiden Werte beinhaltet, aufgedruckt oder mit einem Aufkleber angebracht. Beim Thermostat von Bosch findet man die Infos sowohl im Batteriefach, als auch auf dem Batteriedeckel.

In ZHA kann man ein neues Gerät mit Zigbee 3.0 entweder mit dem  vollständigen Wert des QR-Installationscodes  oder mit den zwei Hauptbestandteilen  Quelle IEEE  und  Installationscode  verbinden. Schaue in der folgendem Anleitung nach, wie der QR-Code ausgelesen bzw. die Codebestandteile abgelesen und manuell zusammengesetzt werden können:

Verbindung mit zusammengesetztem Install-Code

Nimm den vollständig zusammengesetzten Install-Code aus obiger Anleitung, den du entweder per QR-Code-Scan (bei der Thermostat-Variante ohne „[+M]“) oder durch manuelles Zusammensetzen erhalten hast. Er muss von der Form und Länge etwa so aussehen:

RB01SG0D8310182648008000000000000000000018FC26000012A142DLK1234567812345678AABBCCDDAABBCCDDEEFF

  • Klicke in Home Assistant auf Entwicklerwerkzeuge (1) -> Dienste (2) und klicke ggf. auf „zum UI-Modus“, wenn du gerade im YAML-Modus bist. Suche dann im Feld Dienst (3) nach „permit“ und wähle „zha.permit“ aus.
  • Setze bei QR-Code (4) einen Haken und füge den  vollständigen Wert des QR-Installationscodes  in das Textfeld (5) ein.
  • Klicke auf Dienst ausführen (6).

Alternative: Verbindung mit „Installationscode“ und „Quelle IEEE“ (Zigbee-ID)

Nimm aus der obigen Anleitung nur die beiden Werte  Zigbee EUI-64  (in Home Assistant  Quelle IEEE  genannt) und  Install Code  (in Home Assistant  Installationscode  genannt).

  • Gehe wie oben beschrieben vor, aber setze nicht den Haken bei QR-Code. Stattdessen setzt du den Haken bei Quelle IEEE (4) und trägst den Wert  Zigbee EUI-64  ins Textfeld (5) ein. Auch bei Installationscode (6) setzt du einen Haken und trägst den  Install Code  in das Textfeld (7) ein.
  • Klicke anschließend auf Dienst ausführen (8).

Hinweis: Du kannst die Werte in Home Assistant direkt ohne irgendwelche Sonderzeichen eingeben, also z. B. bei  Quelle IEEE  18FC26000012A142 (statt 18:FC:26:00:00:12:A1:42) und bei  Installationscode  1234567812345678AABBCCDDAABBCCDDEEFF (statt 1234-5678-1234-5678-AABB-CCDD-AABB-CCDD-EEFF)

Bosch-Thermostat aktivieren

Nach dem Klick auf „Dienst ausführen“ haben wir 60 Sekunden Zeit, um die Batterien in das Heizkörperthermostat einzusetzen, damit es sich koppeln kann.

Kurze Zeit später sehen wir in Home Assistant unter Einstellungen -> Geräte & Dienste -> Zigbee Home Automation, dass dort ein Gerät mehr als vorher angezeigt wird (bei mir: vorher 32 Geräte, jetzt 33 Geräte).

Mit einem Klick auf 33 Geräte können wir in der Liste einen neuen Eintrag für das Thermostat sehen:

Die Kopplung war erfolgreich! Lass dich nicht davon beirren, dass das Heizkörperthermostat weiterhin im Display ein Viereck mit zwei blinkenden Pfeilen links und rechts zeigt. Auch wenn das Display nach einiger Zeit aus geht: Drückt man dann eine Taste, wird diese Anzeige wieder erscheinen. (Hinweis: Nicht die Taste „o“ drücken, während das Display an ist und das Thermostat noch nicht am Heizungventil montiert ist, sonst startet die Kalibrierungsfahrt und läuft „ins Leere“.)

Wir können auf zwei Wegen überprüfen, ob die Kopplung erfolgreich war. Klicken wir auf den Listeneintrage „BOSCH RBSH-TRV0-ZB-EU“ („RBSH-TRV0-ZB-EU“ ist die Zigbee-ID des Gerätetyps), sehen wir, dass bereits Werte vom Thermostat übermittelt werden, beispielsweise die aktuelle Temperatur.

Zum Testen kann man außerdem im Bereich Diagnose neben „Identifizieren“ auf den Button (1) drücken. Anschließend blinkt der LED-Ring des Thermostats zur Bestätigung mehrfach grün auf.

Montage an Heizkörper

Jetzt muss das Thermostat an den Heizkörper montiert werden. Verwende dazu ggf. die beiliegenden Adapter.

In meinem Fall habe ich einen „Danfoss RA-N (Serie 3)“ Anschluss und habe daher zuerst den abgebildeten Adapter auf das Heizkörperventil aufgesetzt und den Adapter mit der beiligende Schraube und Mutter fixiert. Anschließend kann man das Bosch-Thermostat auf den Adapter aufschrauben.

Quelle Kompatibilitätsdokument von Bosch

Kalibrierungsfahrt am Thermostat

Das Thermostat zeigt weiterhin wechselnd >☐< und  ☐  an. Falls das Display mittlerweile aus ist, drücke einen der Knöpfe + oder -, um es wieder zu aktivieren.

Anhand dieser Anzeige ist am Heizkörperthermostat nicht direkt erkennbar, dass es sich erfolgreich verbunden hat. Man erkennt es nur an einem kleinen zusätzlichen Funksymbol, das zusätzlich im Display erschienen ist.

Als letzten Schritt muss das Thermostat eine Kalibrierungsfahrt vornehmen. Drücke die Haupttaste „O“ auf deinem Heizkörperregler, um die Kalibrierung zu starten. Auf dem Display wird dies mit drei fahrenden Blöcken symbolisiert (siehe das nebenstehende Video).

Nach kurzer Zeit ist der Vorgang abgeschlossen und die Displayanzeige wechselt zur aktuellen Temperatur.

Bedienung über Home Assistant oder am Gerät

Jetzt kannst du das Thermostat entweder direkt am Gerät über die Tasten + und - nutzen oder in Home Assistant, indem du die entsprechende Kachel zum Dashboard hinzufügst.

Kopplungsvorgang fehlgeschlagen?

Falls der Kopplungsvorgang nicht funktioniert hat, kannst du das Bosch-Gerät auf Werkseinstellung zurücksetzen und es erneut versuchen.

Batterielaufzeit

Es kommen zwei AA-Batterien in das smarte Thermostat. Die Herstellerangabe zur Batterielaufzeit ist „< 2 Jahre“ bzw. „bis zu 2 Jahre“. Da diese Angabe relativ sinnlos ist, berichte ich hier über meine persönliche Erfahrung, wie häufig ich die Batterien wechseln muss.

  • Gerät 1:
    • Inbetriebnahme mit beiliegenden Batterien (Duracell 1,5 V): 08.01.2024
    • seitdem noch kein Batteriewechsel
  • Gerät 2:
    • Inbetriebnahme mit beiliegenden Batterien (Duracell 1,5 V): 10.01.2024
    • seitdem noch kein Batteriewechsel

Disclaimer:
Die hier bereitgestellten Anleitungen und Informationen wurden mit größter Sorgfalt erstellt. Dennoch übernehmen wir keinerlei Haftung für etwaige Schäden, Datenverluste oder andere Probleme, die durch das Befolgen dieser Anleitungen entstehen können. Jede*r handelt auf eigene Verantwortung. Bitte prüfe sorgfältig, ob die beschriebenen Schritte für dich, dein Gerät und dein System passen und erstelle vorab immer ein vollständiges Backup deiner Daten.

Kommentare

6 Antworten zu „Bosch Heizkörper-Thermostat 2 über ZHA mit Home Assistant verbinden“

  1. Tom

    Hallo
    ich danke Dir für die ausführliche Anleitung.
    Leider kommt es bei mir zu der Fehlermeldung
    „Fehler beim Aufrufen des Diensts zha.permit. Unknown error“
    Hättest Du hier einen Tip?
    LG Tom

    1. Thing King

      Danke für das Lob! 🙂
      Ich vermute, dass das von dir genutzte Zigbee-Modul bzw. die darauf eingesetzte Firmware leider kein Zigbee 3.0 und damit insbesondere keine Kopplung via QR-Code oder Installationscode unterstützt. Im Artikel habe ich einen Abschnitt „Kompatibilität mit Zigbee-Funkmodul (Stick/Dongle/Adapter)“ mit weiteren Informationen dazu ergänzt. Danke für den Hinweis! Berichte gerne, welchen Zigbee-Stick du bisher einsetzt und ob das tatsächlich die Ursache des Problems war.

      1. Tom

        Gerne! Ich nutze den Sonoff Zigbee 3.0 USB Dongle Plus, der hat den aktuellen Chip und sollte das eigentlich können.
        Ich hab jetzt alle Zigbee Geräte inkl. Bosch relativ problemlos über Zigbee2MQTT eingebunden und bin dabei geblieben da hier auch Updates eingespielt werden können. ZHA ist daher derzeit deaktiviert aber nicht außer Sichtweite

        1. Thing King

          Danke für deine Rückmeldung!
          Da war ich wohl auf der falschen Spur… aber schön zu hören, dass bei dir jetzt die Alternative mit Zigbee2MQTT gut funktioniert. Bei Zigbee2MQTT scheint so manches besser und einfacher implementiert zu sein, z. B. die von dir erwähnten OTA-Updates, aber auch weitere Funktionen des Bosch-Thermostats wie Orientierung/Drehung der Displayanzeige und die Öffnungs-Position des Ventils (in %). ZHA zieht aber langsam nach und bietet jetzt für ein paar Hersteller (leider bisher nicht für Bosch) direkte Firmware-Updates über das Home Assistant Einstellungsmenü an (siehe Release 2024-02).

  2. Stefan

    Hallo,

    Danke für diese hilfreiche Anleitung!
    Ich habe genau diese Konstellation. In den anderen Anleitungen steht nicht genau drin wie man was in welcher Reihenfolge ausführt. Super Beitrag, hat mir echt weitergeholfen!

    1. Thing King

      Sehr gerne 🙂
      Danke für den netten Kommentar!

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert