mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
Update Vallox documentation (#21671)
This commit is contained in:
parent
a059ffcdda
commit
cc9ff69bc9
@ -9,20 +9,18 @@ ha_release: 0.96
|
|||||||
ha_iot_class: Local Polling
|
ha_iot_class: Local Polling
|
||||||
ha_domain: vallox
|
ha_domain: vallox
|
||||||
ha_platforms:
|
ha_platforms:
|
||||||
|
- binary_sensor
|
||||||
- fan
|
- fan
|
||||||
- sensor
|
- sensor
|
||||||
ha_codeowners:
|
ha_codeowners:
|
||||||
- '@andre-richter'
|
- '@andre-richter'
|
||||||
|
- '@slovdahl'
|
||||||
|
- '@viiru-'
|
||||||
---
|
---
|
||||||
|
|
||||||
The `vallox` integration lets you control any Vallox ventilation unit that is supported by the [vallox_websocket_api](https://github.com/yozik04/vallox_websocket_api) (follow the link for a list of supported units).
|
The `vallox` integration lets you control any Vallox ventilation unit that is supported by the [vallox_websocket_api](https://github.com/yozik04/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:
|
The **fan** platform of this integration allows you to turn on/off the complete unit via the toggle switch and to select a ventilation profile.
|
||||||
|
|
||||||
- `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.
|
Also, there is a **sensor** platform that exposes a number of relevant metrics like fan speed, various air temperatures and humidity.
|
||||||
|
|
||||||
@ -30,65 +28,17 @@ Also, there is a **sensor** platform that exposes a number of relevant metrics l
|
|||||||
|
|
||||||
## Profile Switching
|
## Profile Switching
|
||||||
|
|
||||||
For convenient switching of ventilation profiles in the GUI, consider using an [input_select](../input_select) hooked to an automation, for example:
|
For convenient switching of ventilation profiles in the GUI, just click on the `Vallox` fan entity to get a drop-down menu to select from. Alternatively, the service `fan/set_preset_mode` can be used.
|
||||||
|
|
||||||
{% raw %}
|
The four standard Vallox profiles are supported:
|
||||||
|
|
||||||
```yaml
|
- `At Home`
|
||||||
input_select:
|
- `Away`
|
||||||
ventilation_profile:
|
- `Boost`
|
||||||
name: Ventilation profile select
|
- `Fireplace`
|
||||||
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 %}
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
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
|
## 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`
|
### Service `vallox.set_profile_fan_speed_home`
|
||||||
|
|
||||||
Set the fan speed of the `Home` profile.
|
Set the fan speed of the `Home` profile.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user