integrations/xiaomi_miio added Air Humidifier CA (zhimi.humidifier.ca4) (#14466)

source/_integrations/xiaomi_miio.markdown

@@ -24,7 +24,7 @@ The `xiaomi_miio` integration supports the following devices:
 
 - [Xiaomi Gateway](#xiaomi-gateway)
 - [Xiaomi device tracker (Xiaomi Mi WiFi Repeater 2)](#xiaomi-device-tracker-xiaomi-mi-wifi-repeater-2))
-- [Xiaomi Air Purifier](#xiaomi-air-purifier)
+- [Xiaomi Air Purifier and Humidifier](#xiaomi-air-purifier-and-humidifier)
 - [Xiaomi Air Quality Index Monitor](#xiaomi-air-quality-index-monitor)
 - [Xiaomi Mi Air Quality Monitor](#xiaomi-mi-air-quality-monitor)
 - [Xiaomi IR Remote](#xiaomi-ir-remote)
@@ -89,7 +89,7 @@ This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuu
 ### iOS
 
 1. Configure the robot with the Mi Home app. Make sure to select the correct region, as Xiaomi uses different product names for different geographical areas. Note that the new RoboRock app is currently not supported for this method.
-2. Using iTunes, create an unencrypted backup of your iPhone. Since macOS 10.15 there is no iTunes app. Use Finder instead - after connecting your iOS device you should see it in left menu of Finder window. 
+2. Using iTunes, create an unencrypted backup of your iPhone. Since macOS 10.15 there is no iTunes app. Use Finder instead - after connecting your iOS device you should see it in left menu of Finder window.
 3. Install [iBackup Viewer](https://www.imactools.com/iphonebackupviewer/), open it, and open your backup.
 4. Open the "Raw Data" module.
 5. Navigate to `com.xiaomi.mihome`.
@@ -106,7 +106,7 @@ This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuu
 
     -- Execute to retrieve token for Smart Powerstrip
     SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%powerstrip%"
-  
+
     -- Execute to retrieve token for Smart Plug
     SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%plug%"
     ```
@@ -304,7 +304,7 @@ token:
   type: string
 {% endconfiguration %}
 
-## Xiaomi Air Purifier
+## Xiaomi Air Purifier and Humidifier
 
 The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier, Air Humidifier and Air Fresh.
 
@@ -329,6 +329,7 @@ Supported devices:
 | Air Purifier 3H (2019) | zhimi.airpurifier.mb3  | |
 | Air Humidifier         | zhimi.humidifier.v1    | |
 | Air Humidifier CA1     | zhimi.humidifier.ca1   | |
+| Air Humidifier CA4     | zhimi.humidifier.ca4   | |
 | Air Humidifier CB1     | zhimi.humidifier.cb1   | |
 | Air Fresh VA2          | zhimi.airfresh.va2     | |
 
@@ -579,6 +580,34 @@ This model uses newer MiOT communication protocol.
   - `depth`
   - `dry`
 
+### Air Humidifier CA (zhimi.humidifier.ca4)
+
+- On, Off
+- Operation modes (auto, low, mid, high)
+- Buzzer (on, off)
+- Child lock (on, off)
+- LED brightness (off, dim, bright)
+- Target humidity (30 - 80)
+- Dry mode (on, off)
+- Motor speed rpm (200 - 2000)
+- Attributes
+  - `model`
+  - `temperature`
+  - `humidity`
+  - `mode`
+  - `buzzer`
+  - `child_lock`
+  - `target_humidity`
+  - `led_brightness`
+  - `use_time`
+  - `actual_speed`
+  - `button_pressed`
+  - `dry`
+  - `fahrenheit`
+  - `motor_speed`
+  - `power_time`
+  - `water_level`
+
 ### Air Humidifier CB (zhimi.humidifier.cb1)
 
 - On, Off
@@ -832,13 +861,22 @@ Turn the dry mode off.
 |---------------------------|----------|---------------------------------------------------------|
 | `entity_id`               |       no | Only act on a specific Xiaomi miIO fan entity.          |
 
+### Service `xiaomi_miio.fan_set_motor_speed` (Air Humidifier CA4)
+
+Set motor speed RPM.
+
+| Service data attribute    | Optional | Description                                              |
+|---------------------------|----------|----------------------------------------------------------|
+| `entity_id`               |       no | Only act on a specific Xiaomi miIO fan entity.           |
+| `motor_speed`             |       no | Motor speed RPM. Allowed values are between 200 and 2000 |
+
 ### Troubleshooting `Unable to find device` error messages
 
 Check if the device is in the same subnet as the Home Assistant instance. Otherwise, you should configure your router/firewall to put this device in the same VLAN as the Home Assistant instance.
 
 If it's not possible to use VLANs for some reason, your last resort may be using NAT translation, between the IPs.
 
-## Xiaomi Air Quality Index Monitor 
+## Xiaomi Air Quality Index Monitor
 
 The `xiaomi_miio` sensor platform is observing your Xiaomi Mi Air Quality Monitor (PM2.5) and reporting the air quality index.
 
@@ -1297,7 +1335,7 @@ Clean the specified segment/room. A room is identified by a number. Instructions
 
 | Service data attribute    | Optional | Description                                           |
 |---------------------------|----------|-------------------------------------------------------|
-| `entity_id`               |       no | Only act on a specific robot                          | 
+| `entity_id`               |       no | Only act on a specific robot                          |
 | `segments`                |       no | List of segment numbers or one single segment number. |
 
 Example of `xiaomi_miio.vacuum_clean_segment` use: