Integration for Helios / Vallox central house ventilation systems with RS-485 bus (pre-EasyControls aka pre-2014 models)

This is the HA adaption of my Python script that used to work in my previous home automation system for >10 years (see here, also for Wiki/docs/how-to's - it will take a bit until I have translated and moved everything over here). Users have confirmed that the following models are compatible to the proprietary protocol implemented in this custom component:

• Helios EC 200 Pro R/L
• Helios EC 300 Pro R/L
• Helios EC 500 Pro R/L
• Vallo Plus 510 SE
• Vallo Plus 350SE
• Vallox 910SE
• Vallox 090 SE
• Vallox Digit SE
• Vallox 130D (not all registers reported working or with same number, see see wiki)

The proprietary protocol of the ventilation devices on the RS-485 bus is Modbus-like; however - it is not EXACTLY Modbus, so an individual implementation is required (pyModbus or the standard HA modbus implemetation simply don't work here).

The previous version of my main script was based on serial communication through a virtual serial port, which was doing fine for years for many users. However, in the early stages of the HA adoption, I tinkered around and found it quite hard to add the necessary standard UNIX/Linux tools like socat or netcat to HAOS (there is a way, but I would call it an ugly hack by utilizing ssh and command line - nothing the default end user would prefer to do). So, this HA version has been implemented with socket-based communication instead of reading/writing through virtual COM ports, resulting in a direct network connection between the integration and the RS485-LAN/Wifi adaptor (no additional tools needed).

What does this Integration do?

The integration creates a bunch of sensors, binary_sensors and switches to control your ventilation. All those entities are prefixed with ventilation_, so you can easily filter all of them at once in the developer tools.

Also, the integration will install a writing service for use in your automations:

action: helios_vallox_ventilation.write_value
data:
  variable: "fanspeed" # entity name after the "ventilation_" prefix
  value: 1             # the value

If you want to test the write service by hand in the developer tools: Choose Helios Pro / Vallox SE Ventilation: write_value and copy/paste the yaml above into the text field.

Please note that most registers and coils are read-only, and many have only a few valid values. The integration will take care of that - so better look up it's attributes in the developer tools before writing to an entity, I have included all valid options as far as known to me or stated in the manuals / docs.

Installation through HACS

Pro tip: Please do not restart until finished. Finished means 'finished finished'.

Launch HACS and click the 3 dots top right corner, then choose Custom repositories.

You will see 2 fields you have to fill out:

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

Click add, read the pro tip above again - do not restart yet in order to avoid another restart lateron.

Add this to your secrets.yaml (adjust IP and Port of your LAN/Wifi-RS485 adaptor as needed):

helios_vallox_ip:   192.168.178.38
helios_vallox_port: 8234

Add this to your configuration.yaml:

helios_vallox_ventilation:  !include custom_components/helios_vallox_ventilation/configuration.yaml

Optionally: If you want to have detailed debug logs at the beginning, you can also add this to your configuration.yaml:

logger:
  logs:
    custom_components.helios_vallox_ventilation: debug

This is the point where you are 'finished finished' - you can now restart HA once and enjoy the integration!

Manual installation

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

Then add this to your secrets.yaml (adjust IP and Port of your LAN/Wifi-RS485 adaptor as needed):

helios_vallox_ip:   192.168.178.38
helios_vallox_port: 8234

Add this to your configuration.yaml:

helios_vallox_ventilation:  !include custom_components/helios_vallox_ventilation/configuration.yaml

Optionally: If you want to have detailed debug logs at the beginning, you can also add this to your configuration.yaml:

logger:
  logs:
    custom_components.helios_vallox_ventilation: debug

Finally restart HA and enjoy! :)