Home Assistant

Xiaomi Air Purifier

The xiaomi_miio fan platform allows you to control the Xiaomi Air Purifier 2, Air Purifier 2S and Air Purifier Pro.

Currently, the supported features are:

  • 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
    • power
    • aqi
    • average_aqi
    • humidity
    • temperature
    • mode
    • favorite_level
    • led
    • led_brightness
    • buzzer
    • child_lock
    • purify_volume
    • filter_life_remaining
    • filter_hours_used
    • motor_speed

Please follow the instructions on Retrieving the Access Token to get the API token.

To add a Xiaomi Air Purifier to your installation, add the following to your configuration.yaml file:

fan:
# Example configuration.yaml entry
  - platform: xiaomi_miio
    host: 192.168.130.66
    token: YOUR_TOKEN

Configuration Variables

host

(string)(Required)The IP address of your fan.

token

(string)(Required)The API token of your fan.

name

(string)(Optional)The name of your fan.

Default value: Xiaomi Air Purifier

Platform Services

Service fan.xiaomi_miio_set_buzzer_on

Turn the buzzer on.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_buzzer_off

Turn the buzzer off.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_led_on

Turn the led on.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_led_off

Turn the led off.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_child_lock_on

Turn the child lock on.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_child_lock_off

Turn the child lock off.

Service data attribute Optional Description
entity_id yes Only act on a specific air purifier. Else targets all.

Service fan.xiaomi_miio_set_led_brightness

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.

Service fan.xiaomi_miio_set_favorite_level

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.