Bosch Smart Home

Lokale Anbindung des Bosch Smart Home Systems an Symcon.

Inhaltsverzeichnis

• 1. Funktionsumfang
• Vorbemerkungen
  • Zur Library
  • Zur Integration von Geräten
• 2. Voraussetzungen
• 3. Software-Installation
• 4. Enthaltende Module
• 5. Anhang
  • 1. GUID der Module
  • 2. Changelog
  • 3. Spenden
• 6. Lizenz

1. Funktionsumfang

• Findet den Bosch Smart Home Controller im Netzwerk und koppelt Symcon mit ihm.
• Bildet Geräte mit allen ihren Diensten als Statusvariablen ab: Zwischenstecker, Licht- und Rollladensteuerung, Thermostate und Raumklima, Tür-/Fensterkontakte, Bewegungs-, Rauch- und Wassermelder, Universalschalter, Relais, Außensirene, Hausgeräte (Home Connect) und weitere.
• Schaltet Geräte, Szenarien, Automationen und benutzerdefinierte Zustände aus Symcon.
• Zeigt die Zustände von Einbruchmeldeanlage, Wasseralarm-System, Meldungen sowie offenen Türen und Fenstern.
• Startet Softwareaktualisierungen des Controllers.
• Änderungen meldet der Controller per Ereignis (Long Poll). Symcon fragt nicht zyklisch ab.

Vorbemerkungen

Zur Library

• Die Library nutzt die lokale API von Bosch (Local API 3.x). Es wird keine Cloud benötigt.
• Unterstützt wird, was die lokale API anbietet. Hausgeräte (Home Connect) und Kameras bindet Bosch über die Cloud an den Controller an, für sie ist die Anbindung daher nicht rein lokal. Die Library spricht aber auch hier nur mit dem Controller.
• Dienste, die die Library noch nicht kennt, zeigt die Geräte-Instanz im Konfigurationsformular mit ihren Rohwerten an. Darüber lassen sich fehlende Dienste melden.
• Einige Dienste sind nach der Bosch-Dokumentation umgesetzt, aber mangels Hardware nicht live geprüft. Das steht jeweils in der Dokumentation des Moduls.

Zur Integration von Geräten

Important

Zum Koppeln von Symcon mit dem Controller wird das Systempasswort des Controllers benötigt, außerdem muss die Taste am Controller gedrückt werden. Geräte, Räume, Szenarien und Automationen werden weiterhin in der Bosch Smart Home App eingerichtet.

2. Voraussetzungen

• IP-Symcon ab Version 8.1
• Bosch Smart Home Controller I oder II mit aktueller Software.
• Der Controller muss vom Symcon-Rechner aus erreichbar sein (Ports 8443, 8444 und 8446). Für die automatische Suche muss mDNS im selben Netz verfügbar sein.

3. Software-Installation

Über den Module Store in Symcon die Library „Bosch SmartHome“ hinzufügen.

Nach der Installation fragt Symcon, ob die Discovery-Instanz angelegt werden soll:

Tip

Die Einrichtung mit der Bosch SmartHome Discovery beginnen. Sie findet den Controller und legt Konfigurator und IO an. Im IO wird Symcon mit dem Controller gekoppelt, im Konfigurator werden danach die Geräte angelegt.

4. Enthaltende Module

• Bosch SmartHome Discovery (Dokumentation)
  Findet Controller im Netzwerk und legt Konfigurator und IO an.

• Bosch SmartHome Konfigurator (Dokumentation)
  Listet Geräte, Automationen, Szenarien und Systemdienste eines Controllers und legt die Instanzen an.

• Bosch SmartHome IO (Dokumentation)
  Kopplung und Verbindung zum Controller, empfängt die Ereignisse und verteilt sie.

• Bosch SmartHome Gerät (Dokumentation)
  Ein Gerät mit allen seinen Diensten, z. B. Zwischenstecker, Thermostat oder Rauchmelder.

• Bosch SmartHome System (Dokumentation)
  Systemdienste des Controllers: Softwareaktualisierung, Fernzugriff, Benachrichtigungen.

• Bosch SmartHome Automatisierungsregel (Dokumentation)
  Eine Automation aktivieren, deaktivieren und auslösen.

• Bosch SmartHome Szenarien (Dokumentation)
  Ein Szenario starten, Zeitpunkt der letzten Ausführung.

• Bosch SmartHome Benutzerdefinierter Zustand (Dokumentation)
  Benutzerdefinierte Zustände der Bosch Smart Home App anzeigen und schalten.

• Bosch SmartHome Wasseralarm-System (Dokumentation)
  Zustand des Wasseralarm-Systems, Alarm stumm schalten.

• Bosch SmartHome Einbruchmeldeanlage (Dokumentation)
  Zustand der Einbruchmeldeanlage, scharf und unscharf schalten, Alarm stumm schalten.

• Bosch SmartHome Meldungen (Dokumentation)
  Meldungen des Controllers je Kategorie zählen, auslesen und löschen.

• Bosch SmartHome Türen und Fenster (Dokumentation)
  Anzahl offener, abgeschalteter und unbekannter Türen, Fenster und sonstiger Öffnungen.

5. Anhang

1. GUID der Module

Modul	Typ	Prefix	GUID
Bosch SmartHome Discovery	Discovery	BSHC	{98281B33-2867-4A31-9D21-DFEC24D4ECCF}
Bosch SmartHome Konfigurator	Konfigurator	BSHC	{D9479A03-8726-B4E2-FFD1-2CC390CFE166}
Bosch SmartHome IO	IO	BSHC	{8D1D21A7-FDE3-EB16-B5B3-6D38D0673B62}
Bosch SmartHome Gerät	Gerät	BSHC	{6595716D-84D6-807C-E0E8-365568AD8217}
Bosch SmartHome System	Gerät	BSHC	{100F2205-145A-434E-BAF1-6FD64528A6BA}
Bosch SmartHome Automatisierungsregel	Gerät	BSHC	{10999DC2-2A1E-4D34-95BB-885CD9B7F584}
Bosch SmartHome Szenarien	Gerät	BSHC	{6E721ADA-F07D-4C17-9BAD-AC2087DE2F74}
Bosch SmartHome Benutzerdefinierter Zustand	Gerät	BSHC	{E00A0F6B-BE97-4718-9BE5-8758640FE680}
Bosch SmartHome Wasseralarm-System	Gerät	BSHC	{C2EF63F8-549A-43B2-B51E-5170129E84CB}
Bosch SmartHome Einbruchmeldeanlage	Gerät	BSHC	{BDD8FC64-E404-46BE-B317-B7253E1816A9}
Bosch SmartHome Meldungen	Gerät	BSHC	{02661809-F3CE-4D12-95B0-C81123084A12}
Bosch SmartHome Türen und Fenster	Gerät	BSHC	{1080892A-31C2-4234-A1FB-D88E6C14118C}

2. Changelog

Version 1.30:

Important

• Die Variablen Privacy mode, Camera notification und Routing state hatten bisher eine umgekehrte Bedeutung. Jetzt steht true für aktiviert. Ereignisse und Skripte, die diese Variablen auswerten oder schalten, müssen angepasst werden.
• Twinguard: Die Luftreinheit wird in ppm statt in Prozent angezeigt. Grenzwerte in Ereignissen und Skripten anpassen.
• Meldungen: Die Variable der Infomeldungen erhält beim Update automatisch den Ident INFO (bisher INFORMATION) und zählt weiter. Gibt es bereits eine Variable mit Ident INFO, bleibt die alte Variable unverändert und wird nicht mehr gepflegt.
• Rollladen: Über die Variable der Bewegung lässt sich nur noch „gestoppt“ schalten. Zum Fahren dient die Position.

Neue Module

• Bosch SmartHome Einbruchmeldeanlage: Zustand, Alarmzustand, Alarmereignisse und offene Sicherheitslücken anzeigen, scharf und unscharf schalten mit Profil, Alarm stumm schalten
• Bosch SmartHome Benutzerdefinierter Zustand: benutzerdefinierte Zustände des Controllers anzeigen und schalten

Neue Funktionen und Aktionen

• Gerät: Operationen, die der Controller für einen Dienst anbietet (z. B. Energiezähler zurücksetzen), über Schaltflächen im Konfigurationsformular und per BSHC_ExecuteOperation
• System: Operationen wie beim Gerät, Softwareaktualisierung des Controllers starten über eine Schaltfläche und per BSHC_StartSoftwareUpdate
• Automation: Automation auslösen über die neue Variable Automation auslösen und per BSHC_TriggerAutomationRule

Neue Statusvariablen

• Rauchmelder II: Alarm, darüber lässt sich der Einbruchalarm des Rauchmelders ein- und ausschalten
• Zwischenstecker und Lichtschalter: Energieverbrauch gezählt seit und Automatisch ausschalten nach
• Raumklima: Temperaturabsenkung aktiv und Temperaturabsenkung
• Heizkessel (Multiroom-Kesselsteuerung): Kesselheizung, Wärmebedarf und je Raum ein Schalter für die Zuordnung zum Kessel
• Bewegungsmelder II: Gehtest, Sabotageschutz, Beleuchtungsstärke, Anwesenheit, Bewegungsempfindlichkeit und Abfrageintervall
• Thermostat II: Ausrichtung der Anzeige und angezeigte Temperatur
• Relais: Impulsschalter mit Impulsdauer und letztem Impuls
• Außensirene: Alarmzustände, Konfiguration, Stromversorgung und Verhalten zur Einbruchmeldeanlage
• Licht- und Rollladensteuerung II: Kindersicherung und Schaltereingang
• System: Aktivierung der Softwareaktualisierung

Geändertes Verhalten

• Geräte, die es auf dem Controller nicht mehr gibt, gehen auf den Status „Gerät auf dem Controller nicht verfügbar“, nicht erreichbare Geräte auf „Gerät nicht erreichbar“
• System: Neuer Status „Controller hat eine andere MAC-Adresse“, z. B. nach einem Tausch des Controllers
• IO verbindet sich nach einem Verbindungsverlust selbst neu (alle 60 Sekunden)
• Die Verbindung zum Controller wird gegen die Zertifizierungsstelle von Bosch geprüft
• Fehlermeldungen des Controllers werden übersetzt und enthalten den Fehlercode (z. B. INVALID_REQUEST_OBJECT)
• Meldungen, Türen und Fenster und System lesen ihren Zustand neu, sobald der IO aktiv wird
• Raumklima: Beim Ändern der Betriebsart wird ein aktiver Sommermodus zuerst ausgeschaltet, sonst lehnt der Controller die Änderung ab
• Dimmstufe wird als Schieberegler 0 bis 100 % angezeigt
• Der Kopplungsdialog zeigt das Bild des tatsächlich verwendeten Controllers (I oder II)

Behobene falsche Werte in Statusvariablen

• Batteriezustand: Schwache Batterien wurden nicht gemeldet
• Meldungen: Der Zähler ging nicht auf 0, wenn keine Infomeldung mehr vorlag
• Werte mit Faktor 0,01 (z. B. Rollladenposition) wurden abgeschnitten statt gerundet
• Bewegungsmelder: Die Haustier-Immunität zeigte die Werte des Gehtests
• Rollladen, Universalschalter, Geschirrspüler und Softwareaktualisierung: Zustände, die der Controller meldet, wurden teilweise nicht angezeigt (z. B. Rollladen kalibriert, Universalschalter Tasten links und rechts)
• Privacy mode, Camera notification und Routing state waren umgekehrt (siehe Hinweis oben)

Fehlerbehebungen

• Automationen und Wasseralarm: Ereignisse des Controllers wurden nicht ausgewertet
• Türen und Fenster: Zähler wurden bei Änderungen von Kontakten nicht aktualisiert und nach einem Neustart nicht neu gelesen
• Gleichzeitige Anfragen führten am Controller II zu Zeitüberschreitungen, der IO sendet sie jetzt nacheinander
• Die mitgelieferte Zertifizierungsstelle von Bosch war abgelaufen und wurde ersetzt
• Das Systempasswort wurde beim Koppeln im Klartext im Debug ausgegeben
• Discovery brach ab, wenn mDNS nichts fand
• Fehlende Übersetzungen ergänzt, insbesondere die Variablennamen der System-Instanz

Version 1.20:

• Version für Symcon 8.1 und neuer
• Durchgängige Nutzung von Darstellungen anstatt von Profilen

Version 1.10:

• Setzen des Betriebsmodus von RoomClimateControl war fehlerhaft

Version 1.00:

• Diverse Rückmeldungen von Funktionen ergänzt
• Dokumentation erstellt
• Umrechnung Leistung war um den Faktor 1000 falsch
• Bei Lizenzwechsel war keine Verbindung mit dem Controller mehr möglich
• Neu Koppel Funktion ergänzt, nach Lizenzwechsel

Version 0.70:

• Beta Release für Symcon 7.0

3. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

6. Lizenz

IPS-Modul:
Custom NC-SA

Verwendete Quellen:

• Bosch Smart Home Local API (Dokumentation: CC BY-NC-ND 4.0, Bosch). Daraus stammen die Protokolldetails, außerdem die Zertifikatskette des Controllers.
• Ergänzungen zur API aus Pull Request #132 (Temperaturabsenkung, Reihenfolge Sommermodus, Softwareaktualisierung des Controllers).
• boschshcpy (BSD-3-Clause, Copyright 2020 Clemens-Alexander Brust, Thomas Schamm): Auswertung des Batteriezustands, Einheit der Luftreinheit, einzelne Wertelisten (Rollladen, Haustier-Immunität, Gehtest, Rauchmelder-Alarm, Universalschalter, Einbruchmeldeanlage) sowie das Format der Operationen.