jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update fan to add fan.increase_speed, fan.decrease_speed (#16558)

Browse Source
This commit is contained in:
J. Nick Koston 2021-02-18 21:06:05 -10:00 committed by GitHub
parent 7fdfb48d3f
commit 97290f831c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 49 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
source/_integrations/fan.markdown
View File

@ -16,7 +16,7 @@ The Fan integration allows you to control and monitor Fan devices.
### Fan control services
Available services:
`fan.set_percentage`, `fan.set_preset_mode`, `fan.set_direction`, `fan.oscillate`, `fan.turn_on`, `fan.turn_off`, `fan.toggle`
`fan.set_percentage`, `fan.set_preset_mode`, `fan.set_direction`, `fan.oscillate`, `fan.turn_on`, `fan.turn_off`, `fan.toggle`, `fan.increase_speed`, `fan.decrease_speed`
Deprecated services:
`fan.set_speed`
@ -161,3 +161,51 @@ automation:
entity_id: fan.kitchen
speed: low
```
### Service `fan.increase_speed`
Increases the speed of the fan device.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
| `percentage_step` | yes | Increase speed by a percentage. Should be between 0..100.
#### Automation example
```yaml
automation:
trigger:
- platform: device
device_id: 097cd9f706a86e9163acb64ba7d630da
domain: lutron_caseta
type: press
subtype: raise
action:
- service: fan.increase_speed
entity_id: fan.dining_room_fan_by_front_door
```
### Service `fan.decrease_speed`
Decreases the speed of the fan device.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that define the entity ID(s) of fan device(s) to control. To target all fan devices, use `all`.
| `percentage_step` | yes | Decrease speed by a percentage. Should be between 0..100.
#### Automation example
```yaml
automation:
trigger:
- platform: device
device_id: 097cd9f706a86e9163acb64ba7d630da
domain: lutron_caseta
type: press
subtype: lower
action:
- service: fan.decrease_speed
entity_id: fan.dining_room_fan_by_front_door
```