Home Assistant Installation Guide
This page describes the installaton of the Bosch integration.
You Home Assistant should have a HACS installed and fully working. Please follow the guide at HACS for guidance. Manual installation of the integration is possible, but not covered on this page.
The integration is using HTTP and XMPP to connect to the Bosch gateway. Please ensure that your network has no blocking firewall for XMPP traffic. XMPP uses under normal circumstances port 5222 and or 5223.
Connection to a CT200 EasyControl requires a password. This needs to be set at the EasyControl App. See details below
Move to Configuration in your Home Assistant sidebar and select Integration:
Use the right lower corner button to add an integration.
A search dialog appears that shows all integrations available for your installation. If HACS is working successfully, your should be able to search for Bosch by entering it in the search line.
Select Bosch as integration for installation and click on it. Bosch SHC is the Smart Home Controller and NOT the integration for Buderus, Junkers etc.
After clicking on the integration, you need to select your heating control system. This guide is specific to EasyControl. NEFIT and IVT may differ.
You will need to enter the gateway serial number, the token and the EasyControl password now. The device has preset serial number and token. These are printed on the back of the EasyControl and on the little manual provided by Bosch. They look like this: Serial 101042138, Access Code: 7Eq4jClmTLAlfbT6. The EasyControl password is set by you. NOTE: There were reports of issues with passwords longer than 8 letters and with passwords that contained special characters. If the integration does not work, please check the password.
Be patient now. Your Home Assistant is connecting to the Bosch gateway and fetches the system configuration. This will take more than 10 seconds and should complete within 2 minutes. As a result, the integration will show your setup. Before pressing Finish, you may want to set the Area of the diffent devices.
In the case below, we have 4 zones or rooms set up. These have Bosch thermostats in each zone. This is equivalent to the rooms setup in the EasyControl app. The other devices are the gateway and the heater itself.
Pressing Finish will show the integrated Bosch heating system and it's entities. The thermostats will show up in your default Lovelace System Overview after a couple of seconds. Be patient again. NOTE: Many entities/sensors are NOT activated. This needs to be done next.
You will find serial and token on the back of your EasyControl. This sticker shows them as Login Name and Password.
Do not enter the - in the password. The printed password 7Eq4-jClm-TLAl-fbT6 should be entered as 7Eq4jClmTLAlfbT6.
- Go to Settings:
- Go to Personal
- Next screen has option to Change your thermostat password. There were reports of issues with passwords longer than 8 letters and with passwords that contained special characters. If the integration does not work, please check the password.
To setup component go to Integration page in Home Assistant, click + to add integration and choose
Bosch thermostat.
Choose your device type. For:
- CT200 - EasyControl,
- NEFIT - NEFIT
- KM200, RC300 etc. - IVT
Choose protocol for IVT - either XMPP or HTTP (HTTP is local). For rest of devices it's only possible to use XMPP. Then screen will appear with following inputs:
- SERIAL Number / IP Address
- Access token
- Password
Now you have to find sticker on your KM device (sample sticker below) and put info as follows:
- IP Address -> ip address of your device
- Access token -> password from sticker without dashes (-)
- Password -> password you set in application My Mode or similar. For EasyControl look note below. #password-in-easycontrol-type-app-ct200
If you want put devices in areas. Wait for about 5 seconds and choose area for gateway. More devices should come up on the screen. Choose areas you want. Click submit.
Go to sensors section in Wiki to configure sensors.