Custom Home Assistant integration for accessing Bosch Smart Home Controller (SHC).
The integration is using boschshcpy as backend towards the API.
The SmartHomeController is added as a device. The component provides access to:
- Service calls:
bosch_shc.trigger_scenario
service call to trigger a scenario by its namebosch_shc.smokedetector_check
service call to trigger a check routine of the smokedetector
bosch_shc.event
events:- Button events for Universal Switches devices (lower and upper button, short and long press)
- Scenario events for triggered scenarios registered in SHC device, each scenario is identified by its name
- Motion events for detected motion triggered by Motion Detector devices
- Alarm events for alarms triggered by Smoke Detector devices
The following platforms are implemented:
- Alarm Control Panel
- Intrusion Detection Control (deprecated, using API 1.0)
- Intrusion Detection System (based on API 2.1)
- Binary Sensor
- Shutter Contact
- Smoke Detector
- Motion Detector
- Climate
- Room Climate Control
- Cover
- Shutter Control
- Light
- LEDVANCE Light
- Sensor
- Thermostat
- Wall Thermostat
- Twinguard
- Battery: all battery powered devices
- Smart Plug and Light Control (energy and power)
- Switch
- Smart Plug
- Light Control
For installation, follow these steps to add Bosch Smart Home devices to HomeAssistant
.
- Install bosch_shc custom component
- Generate a certificate/key pair
- Register a new client on the SHC device
- Configure bosch_shc integration in HA.
1.) To install bosch_shc
as custom component, inside your HA configuration directory create a new folder called custom_components
. This is the folder that Home Assistant will look at when looking for custom code. Install the custom component there:
Just copy paste the content of the boschshc-hass/bosch_shc
folder in your config/custom_components
directory. As example, you will get the entity.py
file in the following path: config/custom_components/bosch_shc/entity.py
.
Afterwards, restart HomeAssistant
.
2.) + 3.) Follow the official guide for setting up a new SSL certificate public / private key pair and for registering this certificate on the Bosch SHC step by step. As a result, you obtained a generated SSL certificate key pair which is registered for accessing and controlling the SHC.
4.) For configuration of bosch_shc
custom component, follow the steps described in configuration. During configuration, you have to enter the obtained credentials from step 2.) by providing the path to your public and private key pair of your SSL certificate.
Configuration of the component bosch_shc
is done via config flow mechanism, either by zeroconf
detection or by manual configuration:
If the SHC
is running in the same network as the HomeAssistant
, it is even found directly via zeroconf
.
Follow this thread for discussions on the Bosch Smart Home Controller Home Assistant integration.
- Preparation step for creating and registering of SSL key pair necessary before loading the integration.
- Encrypted SSL private key and SSL host verification is not supported due to limitations of
requests
library. - The integration is not (yet) async.
- After adding new devices to SHC, reloading the component is necessary before these devices appear in HomeAssistant.
- Hue Lights added to SHC do not appear in HomeAssistant. Please use the provided hue component instead.
- Arming and disarming of alarm control panel does not support using a code.