From 8e6c94ea520131f83ed6a13fb6eb892a908f59f9 Mon Sep 17 00:00:00 2001
From: mkmer <m_kasper@sbcglobal.net>
Date: Fri, 20 Dec 2024 12:28:41 -0500
Subject: [PATCH] Add humidifier to honeywell.markdown (#36158)

* Update honeywell.markdown

Add humidifier based on PR

* Update honeywell.markdown

Use AI version of doc
Fix typo

* Update honeywell.markdown

Touchup spacing
Remove supported model section
---
 source/_integrations/honeywell.markdown | 39 ++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/honeywell.markdown b/source/_integrations/honeywell.markdown
index 425a0607073..3b6f9e9d1b0 100644
--- a/source/_integrations/honeywell.markdown
+++ b/source/_integrations/honeywell.markdown
@@ -27,6 +27,7 @@ If your system is compatible with this integration, then you will be able access
 - [Climate](#climate)
 - [Sensor](#sensor)
 - [Switch](#switch)
+- [Humidifier](#humidifier)
 
 {% include integrations/config_flow.md %}
 
@@ -48,7 +49,7 @@ Other devices like Security systems are not currently supported by this integrat
 
 The climate platform integrates Honeywell US-based thermostats into Home Assistant, allowing control of the thermostat through the user interface. The current inside temperature, operating mode, and fan state are also displayed on the thermostat card.
 
-All [climate actions](/integrations/climate) are supported except set_swing_mode.
+All [climate actions](/integrations/climate) are supported except `set_swing_mode`.
 
 Due to the instability of the Honeywell total connect system, actions within automations should repeat until success similar to the following example:
 
@@ -98,3 +99,39 @@ This integration will add a switch for the following:
 |Switch|Value|
 --- | ---
 |Emergency Heat | Activates second stage heat source as primary heat|
+
+## Humidifier
+
+If the discovered device supports humidity control, the integration will add a humidifier and/or dehumidifier for each device.
+
+### Available Actions
+
+| Action | Description |
+|--------|-------------|
+| `humidifier.set_humidity` | Set target humidity level |
+| `humidifier.turn_on` | Enable humidity control |
+| `humidifier.turn_off` | Disable humidity control |
+| `humidifier.toggle` | Toggle humidity control |
+
+For more details, see the [humidifier](/integrations/humidifier) integration documentation.
+
+### Configuration Example
+
+```yaml
+# Example configuration.yaml entry
+automation:
+  - alias: "Maintain Comfortable Humidity"
+    trigger:
+      - platform: numeric_state
+        entity_id: sensor.indoor_humidity
+        below: 30 # Trigger when humidity drops below 30%
+    action:
+      - service: humidifier.turn_on
+        target:
+          entity_id: humidifier.living_room
+      - service: humidifier.set_humidity
+        target:
+          entity_id: humidifier.living_room
+        data:
+          humidity: 35 # Set target humidity to 35% (recommended for comfort)
+```