Hi all,
Version 2.0.0 of the Viessmann app is out for testing using Viessmann | Homey. The big change is a new local driver, Vitodens (Optolink), which talks to your boiler directly instead of going through the Viessmann cloud and its API limits.
What’s new
Vitodens (Optolink) driver (local, no cloud)
- It reads your boiler through an Optolink adapter (the optical head on the controller) connected to a small bridge service on a Raspberry Pi. Homey Pro only, local network only.
- It identifies your controller when you add the device and only offers what that model supports.
- Temperatures, status values, burner and pump data, and the energy history where the controller keeps one.
- Setpoints (hot water, normal and reduced room temperature, heating curve) and the operating mode can be changed from Homey. There are also cards for the one-time hot water charge, party and economy mode, and setting the boiler clock.
Cloud devices (ViCare)
- The cloud devices gained the heating curve, frost protection, hot water pumps and the holiday program.
Which boilers for Local Connectivity?
Only one model has been verified on a real unit: a Vitodens 222-W (controller VScotHO1_200_11).
Three other variants are included but not verified: VScotHO1_72, VScotHO1 and VDensHO1_4. Vitodens 300 and everything that isn’t a Vitodens (Vitocal, Vitotronic KW, Ecotronic) are not supported yet.
Advanced usage
The local driver writes to the controller of your boiler, the way a service technician’s tool does. Wrong values can make your heating behave unexpectedly, switch off safety functions such as frost protection and, in the worst case, damage your installation. Use it at your own risk, and note the project is not affiliated with Viessmann. You can run the bridge read-only (leave out BRIDGE_ALLOW_WRITES=1), which I recommend until you’re comfortable. Write down your controller settings before changing anything from Homey.
You also need to free the Optolink port. A Vitoconnect or another tool can’t share it, so the ViCare cloud stops getting values from that boiler.
Installing the bridge
Download viessmann-optolink-bridge-2.0.0.zip, unzip it on the Pi (Node 20 or newer, no npm needed) and start it as a service. The full guide has every step with a check:
https://gitlab.com/functor-solutions/homey/viessmann/-/blob/master/docs/bridge-installation.md
Then in Homey: Add device → Viessmann → Vitodens (Optolink), and enter the Pi’s address and the token.
Questions and feedback welcome below.