Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/maxatome/vitotrol2influx

Viessmann Vitotrol device to influx DB
https://github.com/maxatome/vitotrol2influx

golang influxdb viessmann vitodens vitotrol

Last synced: about 1 month ago
JSON representation

Viessmann Vitotrol device to influx DB

Awesome Lists containing this project

README

        

# Viessmann™ Vitotrol™ device to influx DB

Typically used to inject Viessmann™ Vitotrol™ boiler data into Influx
database.

## Installation

go 1.11 is needed to correctly handle dependencies.

```sh
go build -v
```

will generate a `vitotrol2influx` executable.

## Usage

Create a YAML file based on
[`vitotrol2influx.yml`](vitotrol2influx.yml), including your
credentials and the attributes you want to store in InfluxDB.

Registered attributes can be found here:
https://github.com/maxatome/go-vitotrol/blob/master/attributes.go#L79
(field `Name`).

If you want an attribute that is not registered, use a name like
`NAME_0xNNNN` where `NAME` is the name of the attribute, and `NNNN` is
the hexadecimal representation of the attribute ID, for example:

```
FuelConsumption_0x108d
```

You can use [`vitotrol`](https://github.com/maxatome/go-vitotrol) +
`rget all`, `bget` or `remote_attrs` actions to discover attributes
(german language skill needed :) ).

Note that you can provide the special attribute
`ComputedSetpointTemp`. This fake attribute is computed using several
others and corresponds to the setpoint temperature (as it appears that
this value is not available in Vitotrol™ served attributes).

Once your `vitotrol2influx.yml` is ready, you can launch:

```sh
vitotrol2influx -config vitotrol2influx.yml
```

That's all.

## Future

I will add a (very) simple REST API to serve cached values and so
avoid the huge amount of time needed to retrieve them from the
Vitotrol™ web service.