home-assistant.io/source/_integrations/vallox.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_domain

title	description	ha_category	ha_release	ha_iot_class	ha_domain
Valloxs	Instructions on how to integrate Vallox ventilation units into Home Assistant.	Fan Sensor	0.96	Local Polling	vallox

The vallox integration lets you control any Vallox ventilation unit that is supported by the vallox_websocket_api (follow the link for a list of supported units).

The fan platform of this integration allows you to either turn on/off the complete unit via the toggle switch or select a ventilation profile through the service vallox/set_profile. The four standard Vallox profiles are provided:

• At Home
• Away
• Boost
• Fireplace

Also, there is a sensor platform that exposes a number of relevant metrics like fan speed, various air temperatures and humidity.

Configuration

vallox:
  host: IP_ADDRESS

{% configuration %} host: description: The IP or hostname of the ventilation unit in your home network. required: true type: string name: description: The name of this device as you want to see it in Home Assistant. required: false default: Vallox type: string {% endconfiguration %}

Profile Switching

For convenient switching of ventilation profiles in the GUI, consider using an input_select hooked to an automation, for example:

{% raw %}

input_select:
  ventilation_profile:
    name: Ventilation profile select
    options:
      - "Home"
      - "Away"
      - "Boost"
      - "Fireplace"
    icon: mdi:fan

automation:
  - alias: Set Ventilation Profile
    trigger:
      platform: state
      entity_id: input_select.ventilation_profile
    action:
      service: vallox.set_profile
      data_template:
        profile: "{{ states('input_select.ventilation_profile') }}"

{% endraw %}

In order to also update the input select in case some external event changes the Vallox profile (web interface, mechanical switch, reboot, etc...) you can use the following automation:

{% raw %}

automation:
  - alias: Update Vallox input_select
    description: Update input_select when external event changes the profile
    trigger:
      - entity_id: sensor.vallox_current_profile
        platform: state
    action:
      - data_template:
        entity_id: input_select.ventilation_profile
        option: "{{ states('sensor.vallox_current_profile') }}"
        service: input_select.select_option

{% endraw %}

Fan Services

Service vallox.set_profile

Set the ventilation profile.

Service data attribute	Optional	Description
profile	no	Allowed values: Home, Away, Boost, Fireplace

Service vallox.set_profile_fan_speed_home

Set the fan speed of the Home profile.

Service data attribute	Optional	Description
fan_speed	no	Fan speed in %. Integer, between 0 and 100.

Service vallox.set_profile_fan_speed_away

Set the fan speed of the Away profile.

Service data attribute	Optional	Description
fan_speed	no	Fan speed in %. Integer, between 0 and 100.

Service vallox.set_profile_fan_speed_boost

Set the fan speed of the Boost profile.

Service data attribute	Optional	Description
fan_speed	no	Fan speed in %. Integer, between 0 and 100.