This is a custom component for home assistant to integrate the Xiaomi Mi Air Purifier 2, Air Purifier 2S, Air Purifier Pro, Air Humidifier, Air Fresh and Pedestal Fan.
Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.
Credits: Thanks to Rytilahti for all the work.
- Power (on, off)
- 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)
- Attributes
- model
- temperature
- humidity
- aqi
- mode
- filter_hours_used
- filter_life_remaining
- favorite_level
- child_lock
- led
- motor_speed
- average_aqi
- purify_volume
- learn_mode
- sleep_time
- sleep_mode_learn_count
- extra_features
- turbo_mode_supported
- auto_detect
- use_time
- button_pressed
- buzzer
- led_brightness
- sleep_mode
- Power (on, off)
- Operation modes (auto, silent, favorite)
- Child lock (on, off)
- LED (on, off)
- Favorite Level (0...16)
- Attributes
- model
- temperature
- humidity
- aqi
- mode
- filter_hours_used
- filter_life_remaining
- favorite_level
- child_lock
- led
- motor_speed
- average_aqi
- purify_volume
- learn_mode
- sleep_time
- sleep_mode_learn_count
- extra_features
- turbo_mode_supported
- auto_detect
- use_time
- button_pressed
- filter_rfid_product_id
- filter_rfid_tag
- filter_type
- illuminance
- motor2_speed
- volume
- Power (on, off)
- Operation modes (auto, silent, favorite, idle, medium, high, strong)
- Child lock (on, off)
- LED (on, off)
- Attributes
- model
- aqi
- mode
- led
- buzzer
- child_lock
- 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
- learn_mode
- sleep_time
- sleep_mode_learn_count
- extra_features
- auto_detect
- use_time
- button_pressed
- On, Off
- Operation modes (silent, medium, high)
- Buzzer (on, off)
- Child lock (on, off)
- LED brightness (bright, dim, off)
- Target humidity (30, 40, 50, 60, 70, 80)
- Attributes
- model
- temperature
- humidity
- mode
- buzzer
- child_lock
- trans_level
- target_humidity
- led_brightness
- button_pressed
- use_time
- hardware_version
- On, Off
- 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)
- Dry mode (on, off)
- Attributes
- model
- temperature
- humidity
- mode
- buzzer
- child_lock
- trans_level
- target_humidity
- led_brightness
- button_pressed
- use_time
- hardware_version
- speed
- depth
- dry
- Power (on, off)
- Operation modes (auto, silent, interval, low, middle, strong)
- Buzzer (on, off)
- Child lock (on, off)
- LED (on, off), LED brightness (bright, dim, off)
- Attributes
- model
- aqi
- average_aqi
- temperature
- humidity
- co2
- mode
- led
- led_brightness
- buzzer
- child_lock
- filter_life_remaining
- filter_hours_used
- use_time
- motor_speed
- extra_features
- Power (on, off)
- Speed levels (Level 1, Level 2, Level 3, Level 4)
- Oscillate (on, off)
- Oscillation angle (30, 60, 90, 120)
- Natural mode (on, off)
- Rotate by 5 degrees (left, right)
- Child lock (on, off)
- LED brightness (bright, dim, off)
- Attributes
- model
- temperature (zhimi.fan.v2 and v3 only)
- humidity (zhimi.fan.v2 and v3 only)
- led_brightness
- buzzer
- child_lock
- natural_level
- oscillate
- delay_off_countdown
- speed
- direct_speed
- natural_speed
- angle
- use_time
- ac_power
- battery (zhimi.fan.v2 and v3 only)
- battery_charge (zhimi.fan.v2 & v3 only)
- button_pressed (zhimi.fan.v2 & v3 only)
- led (zhimi.fan.v2 only)
- battery_state (zhimi.fan.v2 only)
# configuration.yaml
fan:
- platform: xiaomi_miio
name: Xiaomi Air Purifier 2
host: 192.168.130.71
token: b7c4a758c251955d2c24b1d9e41ce47d
model: zhimi.airpurifier.m1
- platform: xiaomi_miio
name: Xiaomi Air Purifier Pro
host: 192.168.130.73
token: 70924d6fa4b2d745185fa4660703a5c0
model: zhimi.airpurifier.v6
- platform: xiaomi_miio
name: Xiaomi Air Humidifier
host: 192.168.130.72
token: 2b00042f7481c7b056c4b410d28f33cf
model: zhimi.humidifier.v1
- platform: xiaomi_miio
name: Xiaomi Air Fresh
host: 192.168.130.74
token: 91d89cf53c4090f4c653174f6737102f
model: zhimi.airfresh.va2
- platform: xiaomi_miio
name: Xiaomi Smart Fan
host: 192.168.130.75
token: b7c4a758c251955d2c24b1d9e41ce4ff
Configuration variables:
- host (Required): The IP of your light.
- token (Required): The API token of your light.
- name (Optional): The name of your light.
- model (Optional): The model of your device. Valid values are
zhimi.airpurifier.m1
,zhimi.airpurifier.m2
,zhimi.airpurifier.ma1
,zhimi.airpurifier.ma2
,zhimi.airpurifier.sa1
,zhimi.airpurifier.sa2
,zhimi.airpurifier.v1
,zhimi.airpurifier.v2
,zhimi.airpurifier.v3
,zhimi.airpurifier.v5
,zhimi.airpurifier.v6
,zhimi.airpurifier.mc1
,zhimi.humidifier.v1
,zhimi.humidifier.ca1
,zhimi.airfresh.va2
,zhimi.fan.v2
,zhimi.fan.v3
,zhimi.fan.sa1
andzhimi.fan.za1
. This setting can be used to bypass the device model detection and is recommended if your device isn't always available.
Set the fan speed/operation mode.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
speed |
no | Fan speed. Valid values are 'Auto', 'Silent', 'Favorite' and 'Idle'. Valid values of the Pedestal Fan are Level 1 , Level 2 , Level 3 and Level 4 as well as a value between 0 and 100. |
Turn the buzzer on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the buzzer off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the led on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the led off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the child lock on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the child lock off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Set the led brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off).
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
brightness |
no | Brightness, between 0 and 2. |
Set the favorite level of the operation mode "favorite".
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
level |
no | Level, between 0 and 16. |
Turn the auto detect on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the auto detect off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the learn mode on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the learn mode off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Set the sound volume.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
volume |
no | Volume, between 0 and 100. |
Reset the filter lifetime and usage.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Set the extra features.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
features |
no | Integer, known values are 0 and 1. |
Set the target humidity.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
humidity |
no | Target humidity. Allowed values are 30, 40, 50, 60, 70 and 80 |
Turn the dry mode on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Turn the dry mode off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific air purifier. Else targets all. |
Oscillates the fan.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific fan entity. Else targets all. |
oscillating |
no | Flag to turn on/off oscillation. Valid values are True and False . |
Rotates the fan 5 degrees to the left/right.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific fan entity. Else targets all. |
direction |
no | Rotate the fan 5 degrees. Valid values are left and right . |
Set the oscillation angle. Supported values are 30, 60, 90 and 120 degrees.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific xiaomi miio entity. Else targets all. |
angle |
no | Angle in degrees. Valid values are 30 , 60 , 90 and 120 . |
Turn the natural mode on.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific xiaomi miio entity. Else targets all. |
Turn the natural mode off.
Service data attribute | Optional | Description |
---|---|---|
entity_id |
yes | Only act on a specific xiaomi miio entity. Else targets all. |