Connecting your Bosch appliances to the Bosch One Cloud can unlock a world of smart home automation and remote control capabilities. This comprehensive guide will walk you through the step-by-step process of integrating your Bosch devices with the Bosch One Cloud, ensuring a seamless and efficient setup.
Create a Home Connect User Account
- Visit the Home Connect Developer Portal: Begin by navigating to the Home Connect Developer portal at https://developer.home-connect.com.
- Sign Up for a Developer Account: Create a new developer account by providing the required information, such as your email address and other personal details.
- Enter the Default Home Connect User Account: During the sign-up process, you will be asked to enter the email of your login for the original Home Connect App from Bosch/Siemens under the “Default Home Connect User Account for Testing” field.
Register a New App
- Navigate to the Applications Section: After creating your developer account, locate the “Applications” section within the Home Connect Developer portal.
- Register a New App: Click on the option to register a new application. You will be prompted to provide the following details:
- Application ID: Choose a descriptive name for your application, such as “Home Assistant” or a name that aligns with your specific use case.
- OAuth Flow: Select the “Authorization Code Grant Flow” option.
- Redirect URI: Enter the following URL:
https://my.home-assistant.io/redirect/oauth
Power On Appliances
- Ensure All Appliances are Powered On: During the integration configuration process, it is crucial that all your Bosch appliances are powered on. If any appliances are turned off, the appliance programs list may be empty, which could lead to issues during the setup.
Log Out of the Home Connect Developer Account
- Log Out of the Developer Account: After completing the previous steps, it is essential that you log out of your Home Connect Developer account. Failing to do so can result in authentication issues during the configuration process, leading to the error message
"error": "unauthorized_client".
Add the Home Connect Integration
- Access Your Home Assistant Instance: Navigate to your Home Assistant instance, either through the web interface or the mobile app.
- Add the Integration: In the bottom right corner of the Home Assistant interface, locate and select the “Add Integration” button.
- Select the Home Connect Integration: From the list of available integrations, choose the “Home Connect” option.
- Follow the On-Screen Instructions: The Home Connect integration will guide you through the remaining setup steps. You will be prompted to provide the Client ID and Client Secret that you created earlier during the “Register a New App” step.
Explore the Home Connect Integration Features
Once you have successfully completed the integration setup, you will be able to control your Bosch appliances using the Home Connect integration within Home Assistant. The integration will add the following entities for each connected home appliance:
- Power Switch: A switch to control the power state of the appliance.
- Program Switches: If the device has multiple programs, individual switches for each program will be added.
- Remaining Time and Progress Sensors: For appliances with programs, the integration will provide a timestamp sensor for the remaining time and a numeric sensor for the progress percentage.
- Lighting Controls: For appliances with functional or ambient lighting, the integration will add light switches with brightness and color control capabilities.
It’s important to note that the specific features and entities available will depend on the capabilities of your Bosch appliances and the permissions granted by the Home Connect API.
Troubleshooting and Additional Resources
If you encounter any issues during the setup process, refer to the following resources for troubleshooting and further information:
- Bosch Home Connect Documentation: Visit the official Bosch Home Connect documentation at https://remote.boschsecurity.com for detailed guides, FAQs, and support information.
- Home Assistant Home Connect Integration: Explore the Home Assistant documentation for the Home Connect integration at https://www.home-assistant.io/integrations/home_connect/.
- Home Connect Developer Portal: The Home Connect Developer portal at https://developer.home-connect.com provides additional resources, including API documentation and community support.
By following this comprehensive guide, you will be able to successfully connect your Bosch appliances to the Bosch One Cloud, unlocking a world of smart home automation and remote control capabilities. Enjoy the convenience and efficiency of managing your Bosch devices through the seamless integration with Home Assistant.