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-18 06:46:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Xiaomi_Miio Humidifier rework (#18339)

Browse Source 
* Docs update for Xiaomi Miio Humidifiers

* fan speed model updates services

* Temporary resolve conflixting part

* Undo Temporary resolve conflixting part

* Remove some duplcate lines
This commit is contained in:
Jan Bouwhuis 2021-07-28 11:11:04 +02:00 committed by GitHub
parent 29f6cba2a6
commit 7a6fa418aa
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 65 additions and 93 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

158
source/_integrations/xiaomi_miio.markdown
View File

@ -180,7 +180,10 @@ token:
## Xiaomi Air Purifier and Humidifier ## Xiaomi Air Purifier and Humidifier
The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier, Air Humidifier and Air Fresh. The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier and Air Fresh.
The Air Humidifier uses multiple platforms to allow you to set the target humidiy, control modes and settings.
Unlike the the Air Purifier and Air Fresh the Air Humidfiers use Home Assistant native integrations and services to support the device.
Humidifiers cannot setup using a configuration file.
Supported devices: Supported devices:
@ -415,19 +418,9 @@ This model uses newer MiOT communication protocol.
- Child lock (on, off) - Child lock (on, off)
- LED (on, off), LED brightness (bright, dim, off) - LED (on, off), LED brightness (bright, dim, off)
- Target humidity (30, 40, 50, 60, 70, 80) - Target humidity (30, 40, 50, 60, 70, 80)
- Attributes - Sensor entities
- `model`
- `temperature`
- `humidity` - `humidity`
- `mode` - `temperature`
- `buzzer`
- `child_lock`
- `trans_level`
- `target_humidity`
- `led_brightness`
- `button_pressed`
- `use_time`
- `hardware_version`
### Air Humidifier CA (zhimi.humidifier.ca1) ### Air Humidifier CA (zhimi.humidifier.ca1)
@ -435,25 +428,12 @@ This model uses newer MiOT communication protocol.
- Operation modes (silent, medium, high, auto) - Operation modes (silent, medium, high, auto)
- Buzzer (on, off) - Buzzer (on, off)
- Child lock (on, off) - Child lock (on, off)
- LED (on, off), LED brightness (bright, dim, off) - LED brightness (bright, dim, off)
- Target humidity (30, 40, 50, 60, 70, 80) - Target humidity (30, 40, 50, 60, 70, 80)
- Dry mode (on, off) - Dry mode (on, off)
- Attributes - Sensor entities
- `model`
- `temperature`
- `humidity` - `humidity`
- `mode` - `temperature`
- `buzzer`
- `child_lock`
- `trans_level`
- `target_humidity`
- `led_brightness`
- `button_pressed`
- `use_time`
- `hardware_version`
- `motor_speed`
- `depth`
- `dry`
### Air Humidifier CA (zhimi.humidifier.ca4) ### Air Humidifier CA (zhimi.humidifier.ca4)
@ -463,26 +443,19 @@ This model uses newer MiOT communication protocol.
- Child lock (on, off) - Child lock (on, off)
- LED brightness (off, dim, bright) - LED brightness (off, dim, bright)
- Target humidity (30 - 80) - Target humidity (30 - 80)
- Clean mode (on, off)
- Dry mode (on, off) - Dry mode (on, off)
- Motor speed rpm (200 - 2000) - Motor speed rpm (200 - 2000)
- Attributes - Sensor entities
- `model`
- `temperature`
- `humidity`
- `mode`
- `buzzer`
- `child_lock`
- `target_humidity`
- `led_brightness`
- `use_time`
- `actual_speed` - `actual_speed`
- `button_pressed` - `humidity`
- `dry` - `temperature`
- `fahrenheit`
- `motor_speed`
- `power_time`
- `water_level` - `water_level`
<div class='note'>
Clean mode and Motor speed can only be set when the device is turned on.
</div>
### Air Humidifier CB (zhimi.humidifier.cb1) ### Air Humidifier CB (zhimi.humidifier.cb1)
- On, Off - On, Off
@ -492,23 +465,9 @@ This model uses newer MiOT communication protocol.
- LED (on, off), LED brightness (bright, dim, off) - LED (on, off), LED brightness (bright, dim, off)
- Target humidity (30, 40, 50, 60, 70, 80) - Target humidity (30, 40, 50, 60, 70, 80)
- Dry mode (on, off) - Dry mode (on, off)
- Attributes - Sensor entities
- `speed`
- `speed_list`
- `model`
- `temperature`
- `humidity` - `humidity`
- `mode` - `temperature`
- `buzzer`
- `child_lock`
- `target_humidity`
- `led_brightness`
- `use_time`
- `hardware_version`
- `motor_speed`
- `depth`
- `dry`
- `supported_features`
### Air Fresh VA2 ### Air Fresh VA2
@ -535,9 +494,22 @@ This model uses newer MiOT communication protocol.
- `motor_speed` - `motor_speed`
- `extra_features` - `extra_features`
### Platform Services ### Platform Services
<div class='note'>
For supported Air Humidifiers additional entities for will be generated automatically (if supported) and added to the entity registry based on the platforms:
<br></br>
The sensor platform does not supply additional services.
</div>
| Platform | Service(s) | Related auto generated device entities |
|--------------|----------------------------|-------------------------------------------------------------|
| `humidifier` | `set_humidity`, `set_mode` | Main device entity |
| `switch` | `turn_on`, `turn_off` | `buzzer`, `child_lock`, `cleaning_mode` and `dry_mode` |
| `sensor` | _None_ | `actual_speed`, `humidity`, `temperature` and `water_level` |
| `number` | `set_value` | `motor_speed` |
| `select` | `select_option` | `led_brightness` |
### Service `fan.set_percentage` ### Service `fan.set_percentage`
Set the fan speed percentage. Set the fan speed percentage.
@ -556,7 +528,23 @@ Set the fan operation mode.
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
| `preset_mode` | no | The Xiaomi miIO operation mode | | `preset_mode` | no | The Xiaomi miIO operation mode |
### Service `xiaomi_miio.fan_set_buzzer_on` (Air Purifier Pro excluded) ### Service `switch.turn_on` (Air Humidifiers only)
Turn the `buzzer`, `child_lock`, `cleaning_mode` or `dry_mode` on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `switch.turn_off` (Air Humidifiers only)
Turn `buzzer`, `child_lock`, `clean_mode` or `dry_mode` on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_buzzer_on` (Air Purifier Pro and Air Humidifiers excluded)
Turn the buzzer on. Turn the buzzer on.
@ -564,7 +552,7 @@ Turn the buzzer on.
|---------------------------|----------|---------------------------------------------------------| |---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_buzzer_off` (Air Purifier Pro excluded) ### Service `xiaomi_miio.fan_set_buzzer_off` (Air Purifier Pro and Air Humidifiers excluded)
Turn the buzzer off. Turn the buzzer off.
@ -588,7 +576,7 @@ Turn the LED off.
|---------------------------|----------|---------------------------------------------------------| |---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_child_lock_on` ### Service `xiaomi_miio.fan_set_child_lock_on` (Air Humidifiers excluded)
Turn the child lock on. Turn the child lock on.
@ -596,7 +584,7 @@ Turn the child lock on.
|---------------------------|----------|---------------------------------------------------------| |---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_child_lock_off` ### Service `xiaomi_miio.fan_set_child_lock_off` (Air Humidifiers excluded)
Turn the child lock off. Turn the child lock off.
@ -604,7 +592,16 @@ Turn the child lock off.
|---------------------------|----------|---------------------------------------------------------| |---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_led_brightness` (Air Purifier 2S and Air Purifier Pro excluded) ### Service `select.select_option` (Air Humidifiers only)
Set the LED brightness. Supported values are 'Bright', 'Dim', 'Off'.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
| `option` | no | Brightness option. Should be 'Bright', 'Dim' or 'Off' |
### Service `xiaomi_miio.fan_set_led_brightness` (Air Humidifiers, Air Purifier 2S and Air Purifier Pro excluded)
Set the LED brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off). Set the LED brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off).
@ -689,39 +686,14 @@ Set the extra features.
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
| `features` | no | Integer, known values are 0 and 1. | | `features` | no | Integer, known values are 0 and 1. |
### Service `xiaomi_miio.fan_set_target_humidity` (Air Humidifier only) ### Service `number.set_value` (Air Humidifier CA4)
Set the target humidity.
| Service data attribute | Optional | Description |
|---------------------------|----------|-----------------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
| `humidity` | no | Target humidity. Allowed values are 30, 40, 50, 60, 70 and 80 |
### Service `fan.xiaomi_miio_set_dry_on` (Air Humidifier CA and CB)
Turn the dry mode on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `fan.xiaomi_miio_set_dry_off` (Air Humidifier CA and CB)
Turn the dry mode off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `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. Set motor speed RPM.
| Service data attribute | Optional | Description | | Service data attribute | Optional | Description |
|---------------------------|----------|----------------------------------------------------------| |---------------------------|----------|----------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. | | `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 | | `value` | no | Motor speed RPM. Allowed values are between 200 and 2000 |
### Troubleshooting `Unable to find device` error messages ### Troubleshooting `Unable to find device` error messages