Clean up the documentation of Xiaomi Miio fans and humidifiers (#19077)

This commit is contained in:
Maciej Bieniek 2021-08-25 13:12:58 +02:00 committed by GitHub
parent 94d7bf171b
commit 2134d11680
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -208,6 +208,7 @@ Supported devices:
| Air Purifier Super 2 | zhimi.airpurifier.sa2 | | | Air Purifier Super 2 | zhimi.airpurifier.sa2 | |
| Air Purifier 3 (2019) | zhimi.airpurifier.ma4 | | | Air Purifier 3 (2019) | zhimi.airpurifier.ma4 | |
| Air Purifier 3H (2019) | zhimi.airpurifier.mb3 | | | Air Purifier 3H (2019) | zhimi.airpurifier.mb3 | |
| Air Fresh VA2 | zhimi.airfresh.va2 | |
| Air Humidifier | zhimi.humidifier.v1 | | | Air Humidifier | zhimi.humidifier.v1 | |
| Air Humidifier CA1 | zhimi.humidifier.ca1 | | | Air Humidifier CA1 | zhimi.humidifier.ca1 | |
| Air Humidifier CA4 | zhimi.humidifier.ca4 | | | Air Humidifier CA4 | zhimi.humidifier.ca4 | |
@ -215,7 +216,6 @@ Supported devices:
| Air Humidifier JSQ | deerma.humidifier.jsq | | | Air Humidifier JSQ | deerma.humidifier.jsq | |
| Air Humidifier JSQ1 | deerma.humidifier.jsq1 | | | Air Humidifier JSQ1 | deerma.humidifier.jsq1 | |
| Air Humidifier MJJSQ | deerma.humidifier.mjjsq| | | Air Humidifier MJJSQ | deerma.humidifier.mjjsq| |
| Air Fresh VA2 | zhimi.airfresh.va2 | |
### Features ### Features
@ -224,7 +224,7 @@ Supported devices:
- Power (on, off) - Power (on, off)
- Operation modes (Auto, Silent, Favorite, Idle) - Operation modes (Auto, Silent, Favorite, Idle)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `mode` - `mode`
- `sleep_time` - `sleep_time`
@ -238,33 +238,34 @@ Supported devices:
Number | Description Number | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Favorite Level | Set the `favorite_level` Favorite Level | Set the favorite level
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured Filter Life Remaining | The remaining life of the filter
`filter_life_remaining` | The remaining life of the filter Filter Use | Filter usage time in hours
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`motor_speed` | The current `motor_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`purify_volume` | The volume of purified air in qubic meter PM2.5 | The current particulate matter 2.5 measured
`temperature` | The current `temperature` measured Purify Volume | The volume of purified air in qubic meter
Temperature | The current temperature measured
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Buzzer | Turn on/off `buzzer` Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the child lock
Learn Mode | Turn on/off `learn mode` Learn Mode | Turn on/off the learn mode
LED | Turn on/off `led` LED | Turn on/off the 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)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `mode` - `mode`
- `sleep_time` - `sleep_time`
@ -278,35 +279,36 @@ LED | Turn on/off `led`
Number | Description Number | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Favorite Level | Set the `favorite_level` Favorite Level | Set the favorite level
Volume | Set the `volume` Volume | Set the volume
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured Filter Life Remaining | The remaining life of the filter
`filter_life_remaining` | The remaining life of the filter Filter Use | Filter usage time in hours
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`illuminance` | The current `illuminance` measured Illuminance | The current illuminance measured
`motor_speed` | The current `motor_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`motor2_speed` | The current `motor2_speed` measured in rpm PM2.5 | The current particulate matter 2.5 measured
`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 Second Motor Speed | The current second motor speed measured in rpm
Temperature | The current temperature measured
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the child lock
Learn Mode | Turn on/off `learn mode` Learn Mode | Turn on/off the learn mode
LED | Turn on/off `led` LED | Turn on/off the 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)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `mode` - `mode`
- `extra_features` - `extra_features`
@ -316,34 +318,35 @@ LED | Turn on/off `led`
Number | Description Number | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Favorite Level | Set the `favorite_level` Favorite Level | Set the favorite level
Volume | Set the `volume` Volume | Set the volume
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured Filter Life Remaining | The remaining life of the filter
`filter_life_remaining` | The remaining life of the filter Filter Use | Filter usage time in hours
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`illuminance` | The current `illuminance` measured Illuminance | The current illuminance measured
`motor_speed` | The current `motor_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`motor2_speed` | The current `motor2_speed` measured in rpm PM2.5 | The current particulate matter 2.5 measured
`temperature` | The current `temperature` measured Second Motor Speed | The current second motor speed measured in rpm
Temperature | The current temperature measured
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the child lock
Learn Mode | Turn on/off `learn mode` Learn Mode | Turn on/off the learn mode
LED | Turn on/off `led` LED | Turn on/off the 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)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `mode` - `mode`
- `extra_features` - `extra_features`
@ -353,25 +356,27 @@ LED | Turn on/off `led`
Number | Description Number | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Favorite Level | Set the `favorite_level` Favorite Level | Set the favorite level
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured Filter Life Remaining | The remaining life of the filter
`filter_life_remaining` | The remaining life of the filter Filter Use | Filter usage time in hours
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`motor_speed` | The current `motor_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`temperature` | The current `temperature` measured PM2.5 | The current particulate matter 2.5 measured
Temperature | The current temperature measured
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Buzzer | Turn on/off `buzzer` Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the child lock
LED | Turn on/off `led` Learn Mode | Turn on/off the learn mode
LED | Turn on/off the LED
### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3) ### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3)
@ -379,7 +384,7 @@ 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)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `mode` - `mode`
- `use_time` - `use_time`
@ -387,52 +392,41 @@ This model uses newer MiOT communication protocol.
Number | Description Number | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Fan Level | Set the `fan_level` Fan Level | Set the fan level
Favorite Level | Set the `favorite_level` Favorite Level | Set the favorite level
- Select entities
Select | Description
----------------------- | -----------------------
LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured Filter Life Remaining | The remaining life of the filter
`filter_life_remaining` | The remaining life of the filter Filter Use | Filter usage time in hours
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`motor_speed` | The current `motor_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`purify_volume` | The volume of purified air in qubic meter PM2.5 | The current particulate matter 2.5 measured
`temperature` | The current `temperature` measured Purify Volume | The volume of purified air in qubic meter
Temperature | The current temperature measured
- Select entities
Select | Description
--- | ---
`led brightness` | Controls the brightness of the LEDs (bright, dim, off)
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Buzzer | Turn on/off `buzzer` Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the 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)
- Attributes - Attributes (fan platform)
- `model` - `model`
- `aqi`
- `mode` - `mode`
- `illuminance`
- `filter_hours_used`
- `filter_life_remaining`
- `motor_speed`
- `average_aqi`
- `volume`
- `motor2_speed`
- `filter_rfid_product_id`
- `filter_rfid_tag`
- `filter_type`
- `purify_volume`
- `sleep_time` - `sleep_time`
- `sleep_mode_learn_count` - `sleep_mode_learn_count`
- `extra_features` - `extra_features`
@ -442,12 +436,48 @@ Child Lock | Turn on/off `child lock`
Sensor | Description Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured PM2.5 | The current particulate matter 2.5 measured
`illuminance` | The current `illuminance` measured Illuminance | The current illuminance measured
`filter_life_remaining` | The remaining life of the filter Filter Life Remaining | The remaining life of the filter
`motor_speed` | The current `motor_speed` measured in rpm Filter Use | Filter usage time in hours
`motor2_speed` | The current `motor2_speed` measured in rpm Motor Speed | The current motor speed measured in rpm
`purify_volume` | The volume of purified air in qubic meter Second Motor Speed | The current second motor speed measured in rpm
Purify Volume | The volume of purified air in qubic meter
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off the child lock
LED | Turn on/off the LED
### Air Fresh VA2
- Power (on, off)
- Operation modes (Auto, Silent, Interval, Low, Middle, Strong)
- Attributes (fan platform)
- `model`
- `mode`
- `use_time`
- `extra_features`
- Sensor entities
Sensor | Description
----------------------- | -----------------------
Carbon Dioxide | The current carbon dioxide measured in ppm
Filter Life Remaining | The remaining life of the filter
Filter Use | Filter usage time in hours
Humidity | The current humidity measured
Illuminance | The current illuminance measured
PM2.5 | The current particulate matter 2.5 measured
Temperature | The current temperature measured
- Select entities
Select | Description
----------------------- | -----------------------
LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Switch entities - Switch entities
@ -461,82 +491,137 @@ LED | Turn on/off `led`
- On, Off - On, Off
- Operation modes (Silent, Medium, High, Strong) - Operation modes (Silent, Medium, High, Strong)
- Buzzer (on, off)
- Child lock (on, 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 (humidifier platform) - Attributes (humidifier platform)
Attribute | Description Attribute | Description
--- | --- ----------------------- | -----------------------
`humidity` | The current `target_humidity`
`max_humidity` | The maximum settable `target_humidity`
`min_humidity` | The minimum settable `target_humidity`
`available_modes` | A list with the operation modes available `available_modes` | A list with the operation modes available
`mode` | the current operation mode selected `humidity` | The current target humidity
`max_humidity` | The maximum settable target humidity
`min_humidity` | The minimum settable target humidity
`mode` | The current operation mode selected
- Binary sensor entities
Binary sensor | Description
----------------------- | -----------------------
Water Tank | Indicates whether the water tank is connected or not
- Select entities
Select | Description
----------------------- | -----------------------
LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
--- | --- ----------------------- | -----------------------
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`temperature` | The current `temperature` measured Temperature | The current temperature measured
Water Level | The current water level percentage measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off the child lock
### Air Humidifier CA (zhimi.humidifier.ca1) ### Air Humidifier CA (zhimi.humidifier.ca1)
- On, Off - On, Off
- Operation modes (Silent, Medium, High, Auto) - Operation modes (Silent, Medium, High, Auto)
- Buzzer (on, off)
- Child lock (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)
- Attributes (humidifier platform) - Attributes (humidifier platform)
Attribute | Description Attribute | Description
--- | --- ----------------------- | -----------------------
`humidity` | The current `target_humidity`
`max_humidity` | The maximum settable `target_humidity`
`min_humidity` | The minimum settable `target_humidity`
`available_modes` | A list with the operation modes available `available_modes` | A list with the operation modes available
`mode` | the current operation mode selected `humidity` | The current target humidity
`max_humidity` | The maximum settable target humidity
`min_humidity` | The minimum settable target humidity
`mode` | The current operation mode selected
- Binary sensor entities
Binary sensor | Description
----------------------- | -----------------------
Water Tank | Indicates whether the water tank is connected or not
- Select entities
Select | Description
----------------------- | ---
LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
--- | --- ----------------------- | -----------------------
`humidity` | The current `humidity` measured Humidity | The current humidity measured
`temperature` | The current `temperature` measured Temperature | The current temperature measured
Water Level | The current water level percentage measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off the child lock
Dry Mode | Turn on/off the dry mode
### Air Humidifier CA (zhimi.humidifier.ca4) ### Air Humidifier CA (zhimi.humidifier.ca4)
- On, Off - On, Off
- Operation modes (Auto, Low, Medium, High) - Operation modes (Auto, Low, Medium, High)
- Buzzer (on, off)
- Child lock (on, off)
- LED brightness (off, dim, bright)
- Target humidity (30 - 80) - Target humidity (30 - 80)
- Clean mode (on, off)
- Dry mode (on, off)
- Motor speed rpm (200 - 2000)
- Attributes (humidifier platform) - Attributes (humidifier platform)
Attribute | Description Attribute | Description
--- | --- ----------------------- | -----------------------
`humidity` | The current `target_humidity`
`max_humidity` | The maximum settable `target_humidity`
`min_humidity` | The minimum settable `target_humidity`
`available_modes` | A list with the operation modes available `available_modes` | A list with the operation modes available
`mode` | the current operation mode selected `humidity` | The current target humidity
`max_humidity` | The maximum settable target humidity
`min_humidity` | The minimum settable target humidity
`mode` | The current operation mode selected
- Binary sensor entities
Binary sensor | Description
----------------------- | -----------------------
Water Tank | Indicates whether the water tank is connected or not
- Number entities
Number | Description
----------------------- | -----------------------
Motor Speed | Set the motor speed
- Select entities
Select | Description
----------------------- | -----------------------
LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Sensor entities - Sensor entities
Sensor | Description Sensor | Description
--- | --- ----------------------- | -----------------------
`actual_speed` | The current `motor_speed` measured in (rpm) Actual Speed | The current motor speed measured in rpm
`humidity` | The current `humidity` percentage measured Humidity | The current humidity measured
`temperature` | The current `temperature` measured in degrees Celius Temperature | The current temperature measured
`water_level` | The current `water_level` percentage measured Water Level | The current water level percentage measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off the child lock
Clean Mode | Turn on/off the clean mode
Dry Mode | Turn on/off the dry mode
<div class='note'> <div class='note'>
Clean mode and Motor speed can only be set when the device is turned on. Clean mode and Motor speed can only be set when the device is turned on.
@ -546,97 +631,100 @@ Clean mode and Motor speed can only be set when the device is turned on.
- On, Off - On, Off
- Operation modes (Silent, Medium, High, Auto) - Operation modes (Silent, Medium, High, Auto)
- Buzzer (on, off)
- Child lock (on, 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)
- Attributes (humidifier platform) - Attributes (humidifier platform)
Attribute | Description Attribute | Description
--- | ---
`humidity` | The current `target_humidity`
`max_humidity` | The maximum settable `target_humidity`
`min_humidity` | The minimum settable `target_humidity`
`available_modes` | A list with the operation modes available
`mode` | the current operation mode selected
- Sensor entities
Sensor | Description
--- | ---
`humidity` | The current `humidity` measured
`temperature` | The current `temperature` measured
### Air Humidifier JSQ/JSQ1/MJJSQ (deerma.humidifier.jsq/deerma.humidifier.jsq1/deerma.humidifier.mjjsq)
- On, Off
- Operation modes (low, medium, high, humidity)
- Buzzer (on, off)
- LED (on, off)
- Target humidity (30, 40, 50, 60, 70, 80)
- Sensor entities
- `humidity`
- `temperature`
### Air Fresh VA2
- Power (on, off)
- Operation modes (Auto, Silent, Interval, Low, Middle, Strong)
- Attributes
- `model`
- `aqi`
- `average_aqi`
- `temperature`
- `humidity`
- `co2`
- `mode`
- `filter_life_remaining`
- `filter_hours_used`
- `use_time`
- `motor_speed`
- `extra_features`
- Sensor entities
Sensor | Description
----------------------- | ----------------------- ----------------------- | -----------------------
`aqi` | The current `aqi` measured `available_modes` | A list with the operation modes available
`carbon_dioxide` | The current `carbon_dioxide` measured `humidity` | The current target humidity
`filter_life_remaining` | The remaining life of the filter `max_humidity` | The maximum settable target humidity
`humidity` | The current `humidity` measured `min_humidity` | The minimum settable target humidity
`illuminance` | The current `illuminance` measured `mode` | The current operation mode selected
`temperature` | The current `temperature` measured
- Binary sensor entities
Binary sensor | Description
----------------------- | -----------------------
Water Tank | Indicates whether the water tank is connected or not
- Select entities - Select entities
Select | Description Select | Description
--- | --- ----------------------- | -----------------------
`led brightness` | Controls the brightness of the LEDs (bright, dim, off) LED Brightness | Controls the brightness of the LEDs (bright, dim, off)
- Sensor entities
Sensor | Description
----------------------- | -----------------------
Humidity | The current humidity measured
Temperature | The current temperature measured
Water Level | The current water level percentage measured
- Switch entities - Switch entities
Switch | Description Switch | Description
----------------------- | ----------------------- ----------------------- | -----------------------
Buzzer | Turn on/off `buzzer` Buzzer | Turn on/off the buzzer
Child Lock | Turn on/off `child lock` Child Lock | Turn on/off the child lock
LED | Turn on/off `led` Dry Mode | Turn on/off the dry mode
### Air Humidifier JSQ/JSQ1/MJJSQ (deerma.humidifier.jsq/deerma.humidifier.jsq1/deerma.humidifier.mjjsq)
- On, Off
- Operation modes (low, medium, high, humidity)
- Target humidity (30, 40, 50, 60, 70, 80)
- Attributes (humidifier platform)
Attribute | Description
----------------------- | -----------------------
`available_modes` | A list with the operation modes available
`humidity` | The current target humidity
`max_humidity` | The maximum settable target humidity
`min_humidity` | The minimum settable target humidity
`mode` | The current operation mode selected
- Binary sensor entities
Binary sensor | Description
----------------------- | -----------------------
Water Tank | Indicates whether the water tank is connected or not
Water Tank Empty | Indicates whether the water tank is empty or not
- Sensor entities
Sensor | Description
----------------------- | -----------------------
Humidity | The current humidity measured
Temperature | The current temperature measured
- Switch entities
Switch | Description
----------------------- | -----------------------
Buzzer | Turn on/off the buzzer
LED | Turn on/off the LED
### Platform Services ### Platform Services
<div class='note'> ### Service `humidifier.set_humidity`
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 | Set the target humidity.
|-----------------|----------------------------|--------------------------------------------------------------|
| `humidifier` | `set_humidity`, `set_mode` | Main device entity | | Service data attribute | Optional | Description |
| `switch` | `turn_on`, `turn_off` | `buzzer`, `child_lock`, `cleaning_mode`, `dry_mode` and `led`| |---------------------------|----------|---------------------------------------------------------------------|
| `sensor` | _None_ | `actual_speed`, `humidity`, `temperature` and `water_level` | | `entity_id` | no | Only act on a specific Xiaomi miIO humidifier entity. |
| `number` | `set_value` | `motor_speed` | | `humidity` | no | Target humidity |
| `select` | `select_option` | `led_brightness` |
| `binary_sensor` | _None_ | `water_tank_empty` and `water_tank_detached` | ### Service `humidifier.set_mode`
Set the humidifier operation mode.
| Service data attribute | Optional | Description |
|---------------------------|----------|---------------------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO humidifier entity. |
| `mode` | no | The Xiaomi miIO operation mode |
### Service `fan.set_percentage` ### Service `fan.set_percentage`
@ -656,31 +744,6 @@ 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 `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 `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_reset_filter` (Air Purifier 2 only) ### Service `xiaomi_miio.fan_reset_filter` (Air Purifier 2 only)
Reset the filter lifetime and usage. Reset the filter lifetime and usage.
@ -698,15 +761,6 @@ 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 `number.set_value` (Air Humidifier CA4)
Set motor speed RPM.
| Service data attribute | Optional | Description |
|---------------------------|----------|----------------------------------------------------------|
| `entity_id` | no | Only act on a specific Xiaomi miIO fan entity. |
| `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
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. 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.