HA Integration for Helios Pro / Vallox SE ventilation systems (pre-EasyControls / pre-2014 models with RS-485)

This is the Home Assistant adaptation of my Python script, which has been running 24/7 in my previous home automation system since 2014 (see here). In-depth insights, how-to's, installation instructions, adapter setup / configuration and a brief project history of the last 10 years of programming are documented in detail on the Wiki.

By default, the integration reads more than 30 common variables from the ventilation unit at regular intervals (60s, adjustable). You can optionally add further variables which my own ventilation doesn't have by simply editing the configuration files (useful if you have additional humidity or CO₂ sensors) - no programming skills are required for that, just amend the integration's configuration files.

The integration also implements writing to ANY writable register in the ventilation unit, including plausibility and safety checks before the actual write. This can be used e.g. in your automations, in the Lovelace GUI on buttons / sliders / dropdowns, or directly from the developer tools:

action: helios_vallox_ventilation.write_value
data:
  variable: fanspeed
  value: 5

The integration has been tested with various RS485-LAN/Wi-Fi adapters - no soldering, no additional voltage or stepdown boards etc required. Simply use the screw / plugin terminals of your LAN/Wi-Fi adapter. For specific adapters, you can even remove the external power supply and run everything from bus power (see wiki).

Compatible devices

If your ventilation system has this remote control board, it is almost certainly compatible:

Users have reported the successful use on the following models:

• Helios EC 200 Pro R/L, Helios EC 300 Pro R/L, Helios EC 500 Pro R/L, Vallox 090 SE, Vallox 910 SE, Vallox Digit SE, Vallo Plus 350 SE, Vallo Plus 510 SE, Vallox 130D (this one requires changing a few register numbers due to different addresses; see old wiki)

Documentations show that the following models also use the proprietary Helios/Vallox protocol, therefore they should also work:

• Vallox 096 SE, Vallox 110 SE, Vallox 121 SE (both versions with and without front heating module), Vallox 150 SE, Vallox 270 SE, Vallox Digit SE 2, Vallox ValloPlus SE 500. (Please report back if you got the integration running on one of these models, thanks in advance!)

Installation through HACS

Launch HACS and click the 3 dots in the top right corner, then choose Custom repositories. You will see 2 fields to fill out:

• Repository: https://github.com/Tom-Bom-badil/home-assistant_helios-vallox
• Type: Integration

Click add and download the integration. Do NOT restart yet to avoid restarting twice.

Add this to your secrets.yaml file in the HA root (adjust the IP and port of your LAN/Wifi-RS485 adaptor as needed):

helios_vallox_ip:   192.168.178.38
helios_vallox_port: 502

Now add this to your configuration.yaml to set up the integration and its log level:

logger:
  logs:
    helios_vallox: error      # set to 'info' or even 'debug' for more details

helios_vallox_ventilation:
  !include custom_components/helios_vallox_ventilation/vent_conf.yaml

Restart HA to load the integration, and enjoy! :)

Manual installation

Upload the directories and files with original pathes to your HA.

Add this to your secrets.yaml file in the HA root (adjust the IP and port of your LAN/Wifi-RS485 adaptor as needed):

helios_vallox_ip:   192.168.178.38
helios_vallox_port: 8234

Now add this to your configuration.yaml to set up the integration and its log level:

logger:
  logs:
    helios_vallox: error      # set to 'info' or even 'debug' for more details

helios_vallox_ventilation:
  !include custom_components/helios_vallox_ventilation/vent_conf.yaml

Restart HA to load the integration, and enjoy! :)