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-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add information about switch platform for Xiaomi Miio fans (#19012)

Browse Source
This commit is contained in:
Maciej Bieniek 2021-08-21 13:51:55 +02:00 committed by GitHub
parent 9407158183
commit b6b00290fd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 62 additions and 131 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

193
source/_integrations/xiaomi_miio.markdown
View File

@ -223,26 +223,18 @@ Supported devices:
### Air Purifier 2 (zhimi.airpurifier.v2) ### Air Purifier 2 (zhimi.airpurifier.v2)
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite, idle) - Operation modes (Auto, Silent, Favorite, Idle)
- Buzzer (on, off)
- Child lock (on, off)
- LED (on, off), LED brightness (bright, dim, off)
- Favorite Level (0...16) - Favorite Level (0...16)
- Attributes - Attributes
- `model` - `model`
- `mode` - `mode`
- `favorite_level` - `favorite_level`
- `child_lock`
- `led`
- `learn_mode`
- `sleep_time` - `sleep_time`
- `sleep_mode_learn_count` - `sleep_mode_learn_count`
- `extra_features` - `extra_features`
- `turbo_mode_supported` - `turbo_mode_supported`
- `auto_detect`
- `use_time` - `use_time`
- `button_pressed` - `button_pressed`
- `buzzer`
- `sleep_mode` - `sleep_mode`
- Sensor entities - Sensor entities
@ -255,21 +247,24 @@ Sensor | Description
`purify_volume` | The volume of purified air in qubic meter `purify_volume` | The volume of purified air in qubic meter
`temperature` | The current `temperature` measured `temperature` | The current `temperature` measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off `buzzer`
Child Lock | Turn on/off `child lock`
Learn Mode | Turn on/off `learn mode`
LED | Turn on/off `led`
### Air Purifier Pro (zhimi.airpurifier.v6) ### Air Purifier Pro (zhimi.airpurifier.v6)
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite) - Operation modes (Auto, Silent, Favorite)
- Child lock (on, off)
- LED (on, off)
- Favorite Level (0...16) - Favorite Level (0...16)
- Attributes - Attributes
- `model` - `model`
- `mode` - `mode`
- `favorite_level` - `favorite_level`
- `child_lock`
- `led`
- `learn_mode`
- `sleep_time` - `sleep_time`
- `sleep_mode_learn_count` - `sleep_mode_learn_count`
- `extra_features` - `extra_features`
@ -291,20 +286,23 @@ Sensor | Description
`purify_volume` | The volume of purified air in qubic meter `purify_volume` | The volume of purified air in qubic meter
`temperature` | The current `temperature` measured `temperature` | The current `temperature` measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Child Lock | Turn on/off `child lock`
Learn Mode | Turn on/off `learn mode`
LED | Turn on/off `led`
### Air Purifier Pro V7 (zhimi.airpurifier.v7) ### Air Purifier Pro V7 (zhimi.airpurifier.v7)
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite) - Operation modes (Auto, Silent, Favorite)
- Child lock (on, off)
- LED (on, off)
- Favorite Level (0...16) - Favorite Level (0...16)
- Attributes - Attributes
- `model` - `model`
- `mode` - `mode`
- `favorite_level` - `favorite_level`
- `child_lock`
- `led`
- `learn_mode`
- `extra_features` - `extra_features`
- `turbo_mode_supported` - `turbo_mode_supported`
- `button_pressed` - `button_pressed`
@ -321,25 +319,26 @@ Sensor | Description
`motor2_speed` | The current `motor2_speed` measured in rpm `motor2_speed` | The current `motor2_speed` measured in rpm
`temperature` | The current `temperature` measured `temperature` | The current `temperature` measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Child Lock | Turn on/off `child lock`
Learn Mode | Turn on/off `learn mode`
LED | Turn on/off `led`
### Air Purifier 2S (zhimi.airpurifier.mc1) ### Air Purifier 2S (zhimi.airpurifier.mc1)
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite) - Operation modes (Auto, Silent, Favorite)
- Buzzer (on, off)
- Child lock (on, off)
- LED (on, off)
- Favorite Level (0...16) - Favorite Level (0...16)
- Attributes - Attributes
- `model` - `model`
- `mode` - `mode`
- `favorite_level` - `favorite_level`
- `child_lock`
- `led`
- `learn_mode`
- `extra_features` - `extra_features`
- `turbo_mode_supported` - `turbo_mode_supported`
- `button_pressed` - `button_pressed`
- `buzzer`
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
@ -350,25 +349,27 @@ Sensor | Description
`motor_speed` | The current `motor_speed` measured in rpm `motor_speed` | The current `motor_speed` measured in rpm
`temperature` | The current `temperature` measured `temperature` | The current `temperature` measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off `buzzer`
Child Lock | Turn on/off `child lock`
LED | Turn on/off `led`
### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3) ### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3)
This model uses newer MiOT communication protocol. This model uses newer MiOT communication protocol.
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite, fan) - Operation modes (Auto, Silent, Favorite, Fan)
- Buzzer (on, off)
- Child lock (on, off)
- LED (on, off)
- Favorite Level (0...16) - Favorite Level (0...16)
- Fan Level (1...3) - Fan Level (1...3)
- Attributes - Attributes
- `model` - `model`
- `mode` - `mode`
- `favorite_level` - `favorite_level`
- `child_lock`
- `led`
- `use_time` - `use_time`
- `buzzer`
- `fan_level` - `fan_level`
- Sensor entities - Sensor entities
@ -387,19 +388,21 @@ Select | Description
--- | --- --- | ---
`led brightness` | Controls the brightness of the LEDs (bright, dim, off) `led brightness` | Controls the brightness of the LEDs (bright, dim, off)
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off `buzzer`
Child Lock | Turn on/off `child lock`
### Air Purifier V3 (zhimi.airpurifier.v3) ### Air Purifier V3 (zhimi.airpurifier.v3)
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, favorite, idle, medium, high, strong) - Operation modes (Auto, Silent, Favorite, Idle, Medium, High, Strong)
- Child lock (on, off)
- LED (on, off)
- Attributes - Attributes
- `model` - `model`
- `aqi` - `aqi`
- `mode` - `mode`
- `led`
- `buzzer`
- `child_lock`
- `illuminance` - `illuminance`
- `filter_hours_used` - `filter_hours_used`
- `filter_life_remaining` - `filter_life_remaining`
@ -411,11 +414,9 @@ Select | Description
- `filter_rfid_tag` - `filter_rfid_tag`
- `filter_type` - `filter_type`
- `purify_volume` - `purify_volume`
- `learn_mode`
- `sleep_time` - `sleep_time`
- `sleep_mode_learn_count` - `sleep_mode_learn_count`
- `extra_features` - `extra_features`
- `auto_detect`
- `use_time` - `use_time`
- `button_pressed` - `button_pressed`
- Sensor entities - Sensor entities
@ -429,6 +430,14 @@ Sensor | Description
`motor2_speed` | The current `motor2_speed` measured in rpm `motor2_speed` | The current `motor2_speed` measured in rpm
`purify_volume` | The volume of purified air in qubic meter `purify_volume` | The volume of purified air in qubic meter
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off `buzzer`
Child Lock | Turn on/off `child lock`
LED | Turn on/off `led`
### Air Humidifier (zhimi.humidifier.v1) ### Air Humidifier (zhimi.humidifier.v1)
- On, Off - On, Off
@ -554,10 +563,7 @@ Sensor | Description
### Air Fresh VA2 ### Air Fresh VA2
- Power (on, off) - Power (on, off)
- Operation modes (auto, silent, interval, low, middle, strong) - Operation modes (Auto, Silent, Interval, Low, Middle, Strong)
- Buzzer (on, off)
- Child lock (on, off)
- LED (on, off)
- Attributes - Attributes
- `model` - `model`
- `aqi` - `aqi`
@ -566,9 +572,6 @@ Sensor | Description
- `humidity` - `humidity`
- `co2` - `co2`
- `mode` - `mode`
- `led`
- `buzzer`
- `child_lock`
- `filter_life_remaining` - `filter_life_remaining`
- `filter_hours_used` - `filter_hours_used`
- `use_time` - `use_time`
@ -591,6 +594,14 @@ Select | Description
--- | --- --- | ---
`led brightness` | Controls the brightness of the LEDs (bright, dim, off) `led brightness` | Controls the brightness of the LEDs (bright, dim, off)
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off `buzzer`
Child Lock | Turn on/off `child lock`
LED | Turn on/off `led`
### Platform Services ### Platform Services
<div class='note'> <div class='note'>
@ -642,54 +653,6 @@ Turn `buzzer`, `child_lock`, `clean_mode` or `dry_mode` 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_on` (Air Purifier Pro and Air Humidifiers excluded)
Turn the buzzer on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_buzzer_off` (Air Purifier Pro and Air Humidifiers excluded)
Turn the buzzer off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_led_on` (Air Purifiers only)
Turn the LED on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_led_off` (Air Purifiers only)
Turn the LED off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_child_lock_on` (Air Humidifiers excluded)
Turn the child lock on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_child_lock_off` (Air Humidifiers excluded)
Turn the child lock off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `select.select_option` (Air Humidifiers only) ### Service `select.select_option` (Air Humidifiers only)
Set the LED brightness. Supported values are 'Bright', 'Dim', 'Off'. Set the LED brightness. Supported values are 'Bright', 'Dim', 'Off'.
@ -717,38 +680,6 @@ Set the fan level for "fan" operation mode.
| `entity_id` | no | Only act on a specific Xiaomi MiOT fan entity. | | `entity_id` | no | Only act on a specific Xiaomi MiOT fan entity. |
| `level` | no | Level, between 1 and 3. | | `level` | no | Level, between 1 and 3. |
### Service `xiaomi_miio.fan_set_auto_detect_on` (Air Purifier 2S and Air Purifier Pro only)
Turn the auto detect on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_auto_detect_off` (Air Purifier 2S and Air Purifier Pro only)
Turn the auto detect off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_learn_mode_on` (Air Purifier 2 only)
Turn the learn mode on.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_learn_mode_off` (Air Purifier 2 only)
Turn the learn mode off.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
### Service `xiaomi_miio.fan_set_volume` (Air Purifier Pro only) ### Service `xiaomi_miio.fan_set_volume` (Air Purifier Pro only)
Set the sound volume. Set the sound volume.