Screenshots Aus der README von tschamm/boschshc-hass.
Überblick
Bosch SHC verbindet Home Assistant über das lokale Netzwerk mit einem Bosch Smart Home Controller, ganz ohne Cloud. Es nutzt die Bibliothek boschshcpy und empfängt Updates, die der Controller selbst sendet, wobei beide Seiten per Mutual TLS gesichert sind. Gekoppelte Geräte erscheinen als Entitäten auf vielen Plattformen, darunter Klima, Abdeckungen, Lichter, Ventile, Sensoren, Schalter und Update-Entitäten für die Firmware. Mit den Optionen lassen sich ausgewählte Sensoren unterdrücken, Szenarien und Bosch-Automationsregeln als Tasten oder Schalter bereitstellen, Lichter pro Raum gruppieren und einige Lichter als Lichter statt als Schalter anzeigen. Die Aktionen umfassen das Auslösen von Szenarien, Tests von Rauchmeldern, das Auslesen des Messverlaufs und den Export einer Zigbee-Topologiekarte. Der Controller wird meist automatisch erkannt, und bei der Einrichtung werden die Adresse des Controllers und das Systempasswort aus der Bosch-App abgefragt.
Zusammenfassung der README und des Codes von tschamm/boschshc-hass, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Geräteauslöser Die Geräte können Automationen direkt starten.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Lichter
- Klima
- Abdeckungen
- Ventile
- Alarmanlagen
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
SHC Authentifizierungsparameter
- HostIP-Adresse oder Hostname des SHC Controllers (z. B. 192.168.x.y).
Wird auch beim erneuten Anmelden abgefragt.
Anmelden
- Client-Name für das ZertifikatName, der in der SHC-App unter verbundenen Clients angezeigt wird.
- Passwort des Smart Home ControllersDas in der Bosch Smart Home App gesetzte Passwort.
Neu koppeln — Client-Zertifikat neu erstellen
- HostIP-Adresse oder Hostname des SHC Controllers (z. B. 192.168.x.y).
- Passwort des Smart Home ControllersDas in der Bosch Smart Home App gesetzte Passwort.
- Client-Name für das ZertifikatName, der in der SHC-App unter verbundenen Clients angezeigt wird.
Host / IP-Adresse ändern
- HostNeue IP-Adresse oder Hostname des SHC Controllers (z. B. 192.168.x.y).
Nach der Einrichtung
- Szenarien als Button-Entitäten anzeigenWenn EIN: Jedes Bosch SHC Szenario erscheint auch als Button-Entität in Home Assistant (zusätzlich zum trigger_scenario Dienst). Nützlich für Dashboard-Kacheln und Automationen, die Szenarien direkt auslösen. Standard: aus.
- Diagnose-Sensoren erstellenWenn EIN (Standard): Diagnose-Sensor-Entitäten werden für jedes unterstützte Gerät angelegt — Ventilteller-Position (Thermostate) und Kommunikationsqualität (Smart Plugs). AUS um die Entitätsanzahl zu reduzieren, wenn diese Sensoren nicht benötigt werden.
- Rawscan-Diagnosedienst aktivierenWenn EIN: registriert den Dienst bosch_shc.trigger_rawscan für Roh-API-Debugging. AUS zum Ausblenden. Standard: ein.
- ALLE Licht-/Rollladensteuerung II als Lampen darstellenEinschalten, um alle Geräte vom Typ Lichtsteuerung II / Unterputz-Lichtschalter auf einmal als light-Entität darzustellen — überschreibt die gerätebezogene Auswahl unten. Aus (Standard) behält die gerätebezogene Auswahl. Gleicher Hinweis: Dies wechselt die Entitäts-Domain (switch.* ↔ light.*) — passe Automationen/Dashboards an, die die alten Entitäten verwenden.
- Licht-/Rollladensteuerung II als Lampen darstellenWähle die Geräte vom Typ Lichtsteuerung II / Unterputz-Lichtschalter, die als light-Entitäten statt als switch-Entitäten erscheinen sollen. Bei jedem ausgewählten Gerät wird der Schalter durch eine Ein/Aus-Lampe ersetzt. Leer lassen (Standard), um sie als Schalter zu behalten. Diese Änderung wechselt die Entitäts-Domain (switch.* ↔ light.*) — passe Automationen oder Dashboards an, die die alte Entität verwenden.
- Hue-Leuchten vom Bosch SHC unterdrückenWenn AN: Hue-Leuchten, die am SHC angemeldet sind, werden nicht mehr als Entitäten bereitgestellt. Nützlich bei gleichzeitig aktiver Hue-Integration. Standard: aus.
- Leistungs- und Energiemesser unterdrückenWenn AN: Leistungs- und Energiemesser (Watt / kWh) werden für smarte Steckdosen, BSM-Schalter, Mikromodule und den EMMA Energiemanager nicht angelegt. Standard: aus.
- Szenario-Schaltflächen-FilterLeer lassen, um Schaltflächen für ALLE Szenarien zu erstellen (Standard). Wähle ein oder mehrere aus, um die Schaltflächen auf diese Szenarien zu beschränken. Gilt nur, wenn 'Szenarien als Schaltflächen anzeigen' aktiviert ist.
- LEDVANCE-Leuchten vom Bosch SHC unterdrückenWenn AN: LEDVANCE-Leuchten, die am SHC angemeldet sind, werden nicht mehr als Entitäten bereitgestellt. Nützlich bei gleichzeitig aktiver LEDVANCE- oder Zigbee-Integration. Standard: aus.
- Statusleuchte des Bewegungsmelders unterdrückenWenn AN: die Entität zur Steuerung der Statusleuchte von Bewegungsmeldern II wird nicht angelegt. Standard: aus.
- Bosch-Kamera-Schalter unterdrückenWenn AN: Datenschutz-, Licht- und Benachrichtigungs-Schalter für Bosch-Kameras (Eyes / 360 / Outdoor Gen2) werden nicht angelegt. Nützlich, wenn das Bosch Camera Tool ebenfalls aktiv ist. Standard: aus.
- Raum-Lichtgruppen aktivierenWenn AN: erstellt für jeden SHC-Raum mit 2 oder mehr dimmbaren/farbigen Lampen (LEDVANCE, Hue, Light/Shutter Control II Dimmer) eine gebündelte light-Entität, mit der sich alle Lampen eines Raums über eine einzige Entität ein- und ausschalten lassen – analog zur Raumsteuerung, die die Heizung über die Raumklimasteuerung bereits hat. Nur Ein/Aus, keine Helligkeits-/Farbbündelung. Standard: aus (keine neuen Entitäten).
- Bosch-Automatisierungsregeln als Entitäten anzeigenBei AN: erstellt für jede in der Bosch-App konfigurierte Automatisierungsregel einen Schalter (aktivieren/deaktivieren) und eine Schaltfläche (manuell auslösen) — Boschs eigene lokale Regel-Engine, komplett getrennt von den Automatisierungen von Home Assistant. Standard: aus (keine neuen Entitäten).
- Temperaturabsenkungs-Entitäten aktivierenWenn AN: erstellt einen Schalter (aktivieren/deaktivieren) und eine Zahl (Absenkwert) für den Temperaturabsenkungsdienst (Frostschutz/Fenster offen) jedes Raums. Die meisten Installationen nutzen dieses Feature nicht. Standard: aus (keine neuen Entitäten).
- Physische Tasten für HA-Automatisierungen bereitstellenWenn AN: erstellt für jedes Rollladen-/Lichtsteuerungs-II-Gerät mit physischer Auf-Putz-Taste eine kleine Automatisierung direkt auf dem Bosch Smart Home Controller, die bei einem Tastendruck einen virtuellen Ein/Aus-Zustand kurz aktiviert. Dieser Zustand erscheint bereits als normale Schalter-Entität — nutze dessen Ein/Aus-Wechsel als Trigger in eigenen Home-Assistant-Automatisierungen. Wird diese Option ausgeschaltet, werden die dafür angelegten Automatisierungen und Zustände wieder entfernt. Standard: aus (keine neuen Entitäten, nichts wird auf dem Controller angelegt).
Texte aus dem Code von tschamm/boschshc-hass.
Entitäten
- BinärsensorenAkustischer Alarm, Visueller Alarm, Sabotage, AC/DC-Fehler, Batteriedefekt, Batterietemperatur abnormal, Stromausfall, Wärmeanforderung und 7 weitere
- TastenTestalarm, Funktionstest starten, Funktionstest stoppen, Sabotage zurücksetzen, Vorschau maximale Helligkeit, Vorschau minimale Helligkeit, Verbrauchswert zurücksetzen, Automatische Kalibrierung starten und 4 weitere
- KlimaRaumtemperaturregelung
- EreignisseUntere Taste, Obere Taste, Untere linke Taste, Untere rechte Taste, Obere linke Taste, Obere rechte Taste
- LichterOrientierungslicht, Licht
- ZahlenImpulslänge, Temperaturabweichung, Energiesparmodus Leistungsschwelle, Energiesparmodus Einschaltdauer, LED-Helligkeit, Display-Helligkeit, Display-Einschaltdauer, Alarmdauer Sirenenton und 10 weitere
- AuswahlfelderBewegungsempfindlichkeit, Vibrationsempfindlichkeit, Zustand nach Stromausfall, Rauchempfindlichkeit, Anzeigeausrichtung, Angezeigte Temperatur, Sensoranschluss, Ventiltyp und 11 weitere
- SensorenOffene Türen und Fenster, Funktionstest-Status, Batteriestand, Gesamtbewertung, Luftqualitätsbeschreibung, Signalstärke, Batterieladung, Primäre Stromquelle und 18 weitere
- SchalterPause-Funktion, Pause-Funktion läuft nie ab, Temperaturabsenkung, Aktiviert, Kindersicherung, Haustier / Saugroboter, Automatische Sensitivität, Sabotageerkennung und 15 weitere
- UpdatesSoftware-Aktualisierung, Firmware
- VentileVentil
Aktionen
- Rauchmelder TestroutineAufruf der Testroutine des Rauchmelders.Felder: Entity-ID
- Szenario auslösenAuslösen eines Bosch SHC Szenarios.Felder: SHC Name, Szenario-Name
- Rawscan auslösenAuslösen eines Bosch SHC Rawscan zur Geräteerkennung. Ergebnis wird dem Info-Logger übergeben.Felder: SHC Name, Rawscan-Befehl, Geräte-ID, Service-ID
- Rauchmelder AlarmzustandSendet einen benutzerdefinierten Befehl an einen Rauchmelder.Felder: Entity-ID, Benutzerdefinierter Befehl
- Zigbee-Topologie exportierenErstellt aus den zuletzt abgefragten Routing-Daten eine Zigbee-Mesh-Topologie (Verbindungsqualität pro Hop) als JSON + eine anzeigbare HTML-Seite unter www/bosch_shc/. Liefert den Graphen zusätzlich als JSON und als Mermaid-Diagrammtext in der Serviceantwort.Felder: SHC Name
- Zigbee-Routing aktualisierenRuft jetzt sofort einen aktuellen Zigbee-Routing-Status ab. Routing-Daten werden sonst nur einmal beim Start abgerufen, nicht regelmäßig, um unnötigen Batterieverbrauch bei Zigbee-Geräten zu vermeiden — vor „Zigbee-Topologie exportieren“ verwenden, um eine aktuelle Karte zu erhalten.Felder: SHC-Name
- Messwert-Historie abrufenLiest eine Seite gespeicherter Messwerte (zum Beispiel Temperatur oder Luftfeuchte eines Twinguards) vom SHC und gibt sie in der Antwort zurück. Der SHC-Endpunkt stammt aus der Bosch-App und ist noch nicht an echter Hardware bestätigt. Alle Zeiten sind in Sekunden.Felder: SHC-Name, Geräte-ID, Bezugszeit, Intervall, Rundung, Überlappung
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Mehr für deine Bosch-Kameras, Bosch SHC-Client-Zertifikat läuft bald ab, Firmware-Update durch niedrigen Akkustand blockiert, Manuelle Kalibrierung erforderlich
Aus der README
A local-only Home Assistant integration for the Bosch Smart Home Controller (SHC I & II). It talks directly to the controller over mutual-TLS on your LAN — no cloud, no polling (local_push) — using boschshcpy as the API backend (the exact version is pinned in manifest.json).
Looking for the version that ships inside Home Assistant Core? This HACS repo is the bleeding-edge upstream — fixes and new devices land here first, then flow to Core later.
- 🔒 Local & private — mutual-TLS to the SHC, real-time push updates, nothing leaves your network.
- 🧩 Broad device coverage — thermostats, shutters/blinds (with tilt), micromodules, plugs, lights, cameras, Twinguard, smoke & intrusion, motion, contacts, water-leak, Energy Manager (EMMA), and more.
- 🔥 Firmware updates in HA — the controller and every firmware-capable device get a normal HA "Update available" notification with an Install button, no need to open the Bosch app.
- 🤖 Bosch's own automation rules as HA entities (opt-in) — enable/disable and trigger any rule you already built in the Bosch app, straight from Home Assistant.
- 🚨 Alarm "Mute" buttons for the intrusion system and the whole-home water-leak alarm.
- 🌡️ Per-room temperature-drop (anti-frost) controls and a thermostat regulation-algorithm select, mirroring the Bosch app's room-detail screen.
- 🚪 Whole-home "Open Doors/Windows" summary sensor — one glance at how many openings are open.
Erscheint in Vulpo
Lichtkarte, Schnellumschalterkarte, Rollladenkarte, Klimasteuerungs-Karte, Apple Watch, Kontrollzentrum, Klima-Live-Aktivität.Informationen
- Installationen
- 2.132 teilen Analysedaten
- GitHub-Sterne
- 239
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v0.12.42,
- Kategorie
- Hubs und Protokolle, Smart-Home-Zentralen
- Art
- Marketplace-Integration
- Marke
- Bosch
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
bosch_shc- Probleme
- Problem melden
















