Seit Kurzem stehe ich in der CODEOWNERS-Datei von Home Assistant Core — als offizieller Co-Maintainer der Bosch-Smart-Home-Controller-Integration, neben Original-Autor tschamm. Kein Nebenprojekt, kein Custom-Repo: der Code läuft im Kern-Repository, das jede Home-Assistant-Installation weltweit versorgt.
Wer meinen Smart-Home-Hub kennt, kennt bisher vor allem meine Bosch-Kamera-Projekte — Home Assistant Integration, Python CLI, ioBroker-Adapter, MCP-Server. Das hier ist etwas anderes: die Bosch Smart Home Controller (SHC) Integration, ein völlig eigenständiges Projekt mit eigener Geschichte, eigener Community — und jetzt mit mir als Co-Maintainer im offiziellen Core.
Zwei Bosch-Integrationen, ein Ökosystem
Bosch Smart Home ist bei mir in zwei komplett unabhängigen Strängen im Einsatz, und es lohnt sich, sie sauber zu trennen:
- Bosch Smart Home Controller (SHC) — die zentrale Steuereinheit für Heizung, Rollläden, Steckdosen, Sensorik. Läuft lokal über Mutual-TLS direkt gegen den Controller im eigenen Netzwerk, keine Cloud beteiligt. Genau darum geht es in diesem Beitrag.
- Bosch Smart Home Kameras — meine eigenen, reverse-engineerten Community-Projekte gegen die (nicht-offizielle) Bosch Kamera-Cloud-API, weil es dafür keine offizielle Schnittstelle gibt.
Beide Stränge laufen bei mir zu Hause parallel — aber nur die SHC-Integration ist Teil des offiziellen Home-Assistant-Codes.
Was macht die Bosch-SHC-Integration?
Die Integration spricht direkt und ausschließlich mit dem Bosch Smart Home Controller im eigenen LAN — Mutual-TLS, local_push, kein Polling, keine Cloud-Abhängigkeit für den laufenden Betrieb. Unter der Haube nutzt sie boschshcpy als API-Client. Unterstützt werden Thermostate, Rollläden/Jalousien (inklusive Lamellensteuerung), Mikromodule, Steckdosen, Lichter, Kameras, Twinguard-Rauchmelder, Bewegungs- und Tür/Fenster-Sensoren und einiges mehr — die Geräteliste ist über die Jahre kontinuierlich gewachsen.
Es gibt zwei Wege, an den Code zu kommen: den HACS-Community-Store als schnelllebiges Bleeding-Edge-Repo, in dem neue Geräte und Fixes zuerst landen — oder die Version, die bereits fest in Home Assistant Core eingebaut ist und mit jedem Update automatisch mitkommt, ganz ohne HACS. Qualitätsstufe: Home Assistant Gold auf der offiziellen Quality Scale, mit Platinum in Arbeit.
Vom Nutzer zum Co-Maintainer
Angefangen hat es wie bei den meisten Beiträgen zu Open-Source-Projekten: Ich hatte einen Bosch Smart Home Controller im Einsatz, bin über Kanten gestolpert, habe Fixes eingereicht und Geräte getestet, die mir zur Verfügung standen. Aus einzelnen Pull Requests wurde über Zeit eine kontinuierliche Mitarbeit — und daraus schließlich die Rolle als Co-Maintainer, sowohl im HACS-Repository als auch, verifiziert über die CODEOWNERS-Datei, direkt in Home Assistant Core.
Was ein Core-Maintainer eigentlich macht
Weniger glamourös als es klingt, aber genau deshalb wichtig: Pull Requests reviewen und freigeben, eingehende Issues triagieren, die Testabdeckung hoch halten (aktuell über 2.900 Tests, Coverage-Gate bei mindestens 95 %), Übersetzungen für alle unterstützten Sprachen vollständig halten und dafür sorgen, dass neue Geräte-Unterstützung nicht auf Kosten bestehender Setups geht. Home Assistant Core hat einen strengen Review-Prozess — Maintainer sind das Nadelöhr, durch das jede Änderung muss, bevor sie Millionen von Installationen erreicht.
Warum lokal wichtig ist
Das deckt sich mit einem Thema, das auf diesem Blog immer wiederkehrt: Datensouveränität statt Cloud-Zwang. Eine SHC-Integration, die komplett lokal läuft, bedeutet: Steuerbefehle für Heizung und Rollläden verlassen nie das eigene Netzwerk, es gibt keine Abhängigkeit von einem Bosch-Cloud-Server, der eines Tages abgeschaltet werden könnte, und keine Latenz durch einen Umweg über das Internet. Genau der Grund, warum ich mich für Home Assistant statt einer proprietären Insellösung entschieden habe.
Was ist der Unterschied zur Bosch Smart Home Controller Integration und den Bosch-Kamera-Projekten auf dieser Seite?
Die SHC-Integration ist Teil des offiziellen Home-Assistant-Core-Codes und spricht lokal mit dem Bosch Smart Home Controller (Heizung, Rollläden, Sensorik). Meine Bosch-Kamera-Projekte sind eigenständige, community-getragene Tools gegen eine reverse-engineerte, nicht-offizielle Bosch-Kamera-Cloud-API — zwei getrennte Codebasen für zwei getrennte Bosch-Produktlinien.
Muss ich HACS installieren, oder reicht die in Home Assistant Core enthaltene Version?
Die in Core enthaltene Version reicht für den normalen Betrieb völlig aus und kommt automatisch mit jedem Home-Assistant-Update. HACS lohnt sich nur, wenn ein brandneues Gerät oder ein Fix gebraucht wird, der in Core noch nicht angekommen ist — das Bleeding-Edge-Repo liegt immer etwas vor der in Core eingebauten Version.
Läuft die Bosch-SHC-Integration auch ohne Internetverbindung?
Ja, für den laufenden Betrieb vollständig. Die Kommunikation läuft direkt und lokal per Mutual-TLS zwischen Home Assistant und dem Controller im eigenen Netzwerk — ein Internetausfall unterbricht die Steuerung von Heizung, Rollläden und Sensorik nicht.
Wie kann ich zur Bosch-SHC-Integration beitragen oder einen Bug melden?
Am direktesten über die GitHub Issues des HACS-Repos, mit möglichst reproduzierbaren Schritten und Logs. Für Diskussionen rund um den Einsatz eignet sich der Community-Thread im Home-Assistant-Forum.
Community und Support
Fragen und Diskussionen rund um die Bosch-SHC-Integration laufen vor allem hier:
- community.home-assistant.io — das offizielle Home-Assistant-Forum, dort läuft der zentrale Bosch-Smart-Home-Thread.
- community.simon42.com — deutschsprachige Smart-Home-Community, ebenfalls aktiv rund um Bosch-Geräte in Home Assistant.
- GitHub Issues — strukturierte Bug-Reports und Feature-Anfragen direkt am HACS-Repo.
Direkter Kontakt zu mir geht über das Kontaktformular. Für den kompletten Überblick über alle meine Smart-Home-Projekte — SHC-Integration und Kamera-Tools zusammen — führt der Smart-Home-Hub alles zusammen.
Weitere Bosch Smart Home Projekte: Kamera Home Assistant Integration · Python CLI Tool · ioBroker-Adapter · MCP-Server · Smart-Home-Hub · Über mich