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

title, description, ha_category, ha_release, ha_iot_class, ha_domain, ha_platforms, ha_codeowners

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_codeowners
Vallox	Instructions on how to integrate Vallox ventilation units into Home Assistant.	Fan Sensor	0.96	Local Polling	vallox	fan sensor	@andre-richter

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:
        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:
      - service: input_select.select_option
        target:
          entity_id: input_select.ventilation_profile
        data:
          option: "{{ states('sensor.vallox_current_profile') }}"

{% 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.