dumpfheimer / OptoProxy

Viessmann Optolink <-> WiFi Proxy
Other
4 stars 1 forks source link

ABOUT THIS PROJECT

This project runs on ESP8266 (and probably is easily portable to ESP32) and connects to WiFi and Viessmann Heaters using Optolink (https://github.com/openv/openv/wiki/Die-Optolink-Schnittstelle) with a self-made adapter (https://github.com/openv/openv/wiki/Bauanleitung) If you have a 3D printer check out OptolinkConnector.blend and OptolinkConnector.stl located in the hardware folder.

INSTALL INSTRUCTIONS

  1. Check out this repository

  2. Download and install PlatformIO https://docs.platformio.org/en/latest/core/installation/index.html

  3. Go to the software folder of this repository

    $ cd software

  4. copy wifi-credentials.h.example to wifi-credentials.h

    $ [ -f src/wifi-credentials.h ] || cp src/wifi-credentials.h.example src/wifi-credentials.h

  5. edit the wifi credentials using your favourite text editor

    $ vim src/wifi-credentials.h

  6. Compile

    $ pio run

  7. Upload to device

    $ pio run -t upload

  8. Check log output

    $ pio device monitor

  9. Open an issue with the error and hope for help, because things never work out the way you expect it

    https://github.com/dumpfheimer/OptoProxy/issues

HOW TO USE OptoProxy

General information

OptopLink communicates via addresses. To read or write information you need to know two things:

  1. Which address the information is stored in
  2. In which format the data is stored in (see Data types)

Refer to openv Wiki for more information: https://github.com/openv/openv/wiki/Adressen

Data types

There are several data for converting the datapoint into useable format:

1. Reading a datapoint

Example URL for reading Address 0x2000 (Room Temperature Setpoint)

http:///read?addr=0x2000&conv=temp

2. Writing a datapoint

Example URL for writing Address 0x2000 (Room Temperature Setpoint)

http:///write?addr=0x2000&conv=temp&val=21