Viessmann™ Vitotrol™ device to MQTT
Typically used to send Viessmann™ Vitotrol™ boiler data to a MQTT broker
Installation
go build -v
will generate a vitotrol2mqtt
executable.
Usage
Create a YAML file based on
vitotrol2mqtt.yml
, including your
credentials and the attributes you want to send to the MQTT broker.
Registered attributes can be found here:
https://github.com/maxatome/go-vitotrol/blob/master/attributes.go#L79
(field Name
).
Note! Including field mappings that are unsupported by your Viessmann device
will cause execution to crash and exit.
Custom attributes
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
These custom fields are by default read-only. To allow field being written,
prefix it with RW
, for example:
RWNormalRoomTemp_0x15e1
Note! Use RW
naming only for fields that you have checked to be writable, see below.
You can use vitotrol
+
rget all
, bget
or remote_attrs
actions to discover attributes and their read/write access
(german language skill needed :) ).
Computed attributes
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).
Run locally
Once your vitotrol2mqtt.yml
is ready, you can launch:
vitotrol2mqtt -config vitotrol2mqtt.yml
Docker
Alternatively, you can run the tool in a docker container.
docker-compose build --no-cache
docker-compose up
That's all.