From fcbbfd86534cab3d6e01498e96cbdf6f27353c88 Mon Sep 17 00:00:00 2001
From: Shulyaka <Shulyaka@gmail.com>
Date: Tue, 23 Jun 2020 09:48:54 +0300
Subject: [PATCH] Humidifier: new domain (#11151)

Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
---
 source/_integrations/humidifier.markdown | 93 ++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 source/_integrations/humidifier.markdown

diff --git a/source/_integrations/humidifier.markdown b/source/_integrations/humidifier.markdown
new file mode 100644
index 00000000000..a402dd13e4d
--- /dev/null
+++ b/source/_integrations/humidifier.markdown
@@ -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.