viessmann-optolink2mqtt 0.1.1

Open source interface between a Viessmann device (heat pump, gas heater, etc) and MQTT

viessmann-optolink2mqtt

Open source interface between a Viessmann device (heat pump, gas heater, etc) and MQTT.

Architecture

Hardware

• A Single Board Computer (SBC) which is capable of running Python and has a USB-A connector (if you plan to use the original Viessmann Optolink USB cable)
• The Optolink USB cable to read/write; you have two main options: a) buy the original Viessmann cable on specialized shops such as https://www.loebbeshop.de/; see exact item here or b) build your own cable, more details available from other tinkerers like MyVitotronicLogger or at Optolink splitter readme

Installation

This project supports 2 main installation methods: PyPi and Docker. Both methods are meant to be used from a Linux Operating system which has the USB/DIY cable attached (see "Hardware" section above).

Pypi package

python3 -m venv optolink2mqtt-venv
source optolink2mqtt-venv/bin/activate
pip install viessmann-optolink2mqtt

optolink2mqtt --help

Docker

Just use:

docker run -d -v <your config file>:/etc/optolink2mqtt/optolink2mqtt.yaml \
    --hostname $(hostname) \
    --name optolink2mqtt \
    ghcr.io/f18m/optolink2mqtt:latest

Configuration file

This software accepts a declarative configuration in YAML format. Please look at the optolink2mqtt.yaml file as reference source for the syntax.

How to discover register addresses

TO BE WRITTEN

Related projects

• Optolink Splitter: this is the original project that inspired this one
• Optolink Bridge: inspired from the "Optolink Splitter"; requires you to own a VitoConnect device and allows you to setup a "man in the middle" device
• openv vcontrold: seems abandoned but contains a C-based implementation of the VS1 and VS2 protocols apparently. Its wiki has plenty of details although in German
• VitoWiFi: a C++ implementation of VS1 (KW) and VS2 (P300) Optolink protocols, for use on ESP microcontrollers but also Linux systems