Skip to content

Vallox RS-485 MQTT gateway to integrate Vallox RS485 ventilation device to Home Assistant via MQTT. Implements Home Assistant MQTT discovery but can also be used without Home Assistant.

License

Notifications You must be signed in to change notification settings

Blowfly69/vallox-mqtt

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vallox RS485 MQTT gateway for Home Assistant

Overview

This rs485 mqtt gateway can be used to publish events from Vallox rs485 serial bus to mqtt and send commands to Vallox devices via mqtt.

It supports Home Assistant MQTT Discovery but can also be used without Home Assistant.

Only requirement is MQTT Broker to connect to.

Supported features

Supports following features:

  • Home Assistant MQTT discovery, published device automatically to Home Assistant
  • Published regular intervals:
    • Ventilation fan speed
    • Outside temperature (sensor.temperature_incoming_outside)
    • Incoming temperature (sensor.temperature_incoming_inside)
    • Inside temperature (sensor.temperature_outgoing_inside)
    • Exhaust temperature (sensor.temperature_outgoing_outside)
  • Change ventilation speed

Supported devices

Use at your own risk.

Only tested with:

  • Vallox Digit SE model 3500 SE made in 2001 (one with old led panel, no lcd panel)

Might work with other Vallox devices with rs485 bus. There probably are some differences between different devices. If there are those probably are easy to adapt to.

The application itself has been tested running on Raspberry Pi 3, but probably works just fine with Raspberry Zero or anything running linux.

Quality RS485 adapter should be used, there can be strange problems with low quality ones.

Example usecase

Can be used to monitor and command Vallox ventilation device with Home Assistant. Raspberry Pi with properer usb to rs485 adapter can act as a gateway between Vallox and MQTT (and Home Assistant). Automation can be built to increase the speed in case of high CO2 or high humidity even if the Vallox device is not installed with co2 and humidity sensors.

Home Assistant Card screenshots

Speed select and graph: outdoor temp grap

Temperature graph: outdoor temp grap

Outdoor temperature graph: outdoor temp grap

Configuration

Application is configure with environment variables

variable required default description
SERIAL_DEVICE x serial device, for example /dev/ttyUSB0
MQTT_URL x mqtt url, for example tcp://10.1.2.3:8883
MQTT_USER mqtt username
MQTT_PASSWORD mqtt password
MQTT_CLIENT_ID vallox mqtt client id
DEBUG false enable debug output, true/false
ENABLE_WRITE false enable sending commands/writing to bus, true/false
SPEED_MIN 1 minimum speed for the device, between 1-8. Used for HA discovery to have correct min value in UI
ENABLE_RAW false enable sending raw events to mqtt, otherwise only known changes are sent

Usage

For example with following script

#!/bin/sh

# Change to your real rs485 device
export SERIAL_DEVICE=/dev/ttyUSB0
# Change to your real mqtt url
export MQTT_URL=tcp://localhost:8883

./vallox-mqtt

MQTT Topics used

  • homeassistant/status subscribe to HA status changes
  • vallox/fan/set subscribe to fan speed commands
  • vallox/fan/speed publish fan speeds
  • vallox/temperature_incoming_outside Outdoor temperature
  • vallox/temperature_incoming_inside Incoming temperature
  • vallox/temperature_outgoing_inside Inside temperature
  • vallox/temperature_outgoing_outside Exhaust temperature
  • vallox/raw/# Raw register value changes (if raw values are enabled)

About

Vallox RS-485 MQTT gateway to integrate Vallox RS485 ventilation device to Home Assistant via MQTT. Implements Home Assistant MQTT discovery but can also be used without Home Assistant.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 100.0%