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-16 13:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Humidifier: new domain (#11151)

Browse Source 
Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Shulyaka 2020-06-23 09:48:54 +03:00 committed by GitHub
parent d5bd65bf44
commit fcbbfd8653
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 93 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

93
source/_integrations/humidifier.markdown Normal file
View File

@ -0,0 +1,93 @@
---
title: "Humidifier"
description: "Instructions on how to set up humidity control devices within Home Assistant."
ha_category:
- Humidifier
ha_release: "0.112"
ha_domain: humidifier
ha_quality_scale: internal
---
The `humidifier` integration is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.
## Services
### Humidifier services
Available services: `humidifier.set_mode`, `humidifier.set_humidity`, `humidifier.turn_on`, `humidifier.turn_off`, `humidifier.toggle`
<div class='note'>
Not all humidifier services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking <img src='/images/screenshots/developer-tool-services-icon.png' alt='service developer tool icon' class="no-shadow" height="38" /> **Services**.
</div>
### Service `humidifier.set_mode`
Set mode for the humidifier device. This service is only available if the device supports operating in several working modes. The list of available modes and the device functionality in every mode depend on the device itself.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of humidifier devices to control.
| `mode` | no | New mode.
#### Automation example
```yaml
automation:
trigger:
platform: time
at: "07:15:00"
action:
- service: humidifier.set_mode
data:
entity_id: humidifier.bedroom
preset_mode: 'eco'
```
### Service `humidifier.set_humidity`
Set target humidity of the humidifier device
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of humidifier devices to control.
| `humidity` | no | New target humidity for humidifier device
#### Automation example
```yaml
automation:
trigger:
platform: time
at: "07:15:00"
action:
- service: humidifier.set_humidity
data:
entity_id: humidifier.bedroom
humidity: 60
```
### Service `humidifier.turn_on`
Turn the humidifier device on.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of humidifier devices to control.
### Service `humidifier.turn_off`
Turn the humidifier device off.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of humidifier devices to control.
### Service `humidifier.toggle`
Toggle the humidifier device on/off.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of humidifier devices to control.