[APP][Pro] Viessmann - Make your heating smart

It is the one I got before doing everything again, but looked a little bit empty so I decided to do a fresh start but only saved the installations.json.
I can DM it anyway.

After resetting the app, I got the message “no new device found” when adding a device. When getting the installations.json i get the error noAuth.

Yeah, please send it already.

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.

:warning: 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.

Kenny, a local solution: just perfect. Would you know if the opticoupler can also run on a ESP 32 device?

Hey @Jan_Peeters

I haven’t tested it - it is basically a NodeJS proces that should run on it. We need access to the serial port (USB) to access the device over the optolink adaptor.

I have it running on a Raspberry Pi 3 B+

Kind regards,

I did send it by email, the address was shown a few posts earlier.
Any conclusions yet?
I do see actual information like temperature and schedule in the featuters.json

Hey @Rmb

Sorry for the delay, but I have a quite busy week.

I’ve checked your installations.json file and it appears it does not contain the tags I expect. Typically it gives devices of type boiler, heatpump etc. But in your case it does not show up that way, probably because of a newer device.

I’ve done some changes which should allow you to pair your device in v2.1.0 (available from Viessmann | Homey ).

It can be that some features won’t work, please come back if something fails.

Kind regards,

Thank you so much.
Here are my first test results.


Hoi Jan,

Ik heb geen 100% oplossing, maar ik probeer het zelf middels een timer. Wanneer er een bepaald over productie is start ik een timer, bijvoorbeeld 15min. Wanneer de timer afloopt dan doe ik in mijn geval de boiler temp omhoog. Maar wanneer binnen die 15min de productie onder een bepaalde waarde komt dan stop ik de timer. In de praktijk gaat dit wel redelijk, maar nooit foutloos. Vooral op dagen dat en regelmatig wolken verschijnen, dan gaat het op en neer. Maar je kunt natuurlijk ook voor het periode van het jaar met andere parameters werken.

Misschien heb je hier iets aan, nogmaals het is geen 100%.

Marijn

FYI: Unfortunately, if you connect an Optolink cable (with a USB plug) to the micro-USB port of an ESP32-WROOM-32 using an adapter, data transfer will not be possible.

The micro-USB port on this type of ESP32 is designed exclusively as a receiver. The ESP32 chip lacks the internal USB Host hardware required to read data from external USB devices. Additionally, the port does not supply power back to the Optolink.

Therefor, Raspberry Pi seems to be the (only possible) way forward indeed.

Hi @KennyMoens,
Do you think it is possible to show the setpoint too?
I think that is :
{"feature":"heating.circuits.0.temperature","gatewayId":"-","deviceId":"-","timestamp":"2026-11-11T17:35:59.742Z","isEnabled":true,"isReady":true,"apiVersion":1,"uri":"-","properties":{"value":{"type":"number","value":25.2,"unit":"celsius"}},"commands":{}}

And may be it is also possible to fill the missing values, noted as “-“?

Some values have never changed, so maybe you can check them too? See the red circles in the pictures below.
I also see from the settings that a lot of parameters are available, but not shown in the app.
I can understand that using a generic display for all kind of different devices is quite some task. So I can understand all my whishes cannot be realized (at once :wink:)

A more generic solution could be a card I can process the features.json myself and show / set the features in an Advanced Device.

Hi Kenny,

First of all, thank you very much for developing and maintaining this great Viessmann app!

The Following Text has been Translationen by AI Ecuador my english is not so perfect. I Hope my wish is understandable.

I have a feature request regarding the daily gas consumption (and power consumption) values:

Currently, the app exposes the ongoing daily consumption (properties.day.value[0]). However, the Viessmann cloud servers finalize and recalculate the daily consumption figures retroactively after midnight (often between 00:15 and 02:00 AM). Because of this delay, reading the value at 00:00 via a Homey Flow always captures an incomplete figure that doesn’t match the final daily value shown in the official ViCare app the next morning.

Request:
Could you please expose the yesterday’s consumption value(properties.day.value[1] from features like heating.gas.consumption.total, .heating, and .dhw) as an additional capability/tag (e.g. Gas consumption yesterday)?

This would allow us to run a Flow in the morning (e.g. at 06:00 AM) to log the exact, finalized daily figure that 100% matches the ViCare app.

Thanks a lot in advance for considering this!

Regards, thomas