Home

Awesome

Xiaomi Mi Smart Pedestal Fan

GitHub actions GitHub stars GitHub forks GitHub watchers "Buy Me A Coffee"

This is a custom component for home assistant to integrate the Xiaomi Mi Smart 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.

Supported devices

NameModelModel no.Specs
Pedestal Fan Fan V2zhimi.fan.v2
Pedestal Fan Fan V3zhimi.fan.v3
Pedestal Fan Fan SA1zhimi.fan.sa1
Pedestal Fan Fan ZA1zhimi.fan.za1
Pedestal Fan Fan ZA3zhimi.fan.za3
Pedestal Fan Fan ZA4zhimi.fan.za4ZLBPLDS04ZM
Smartmi Standing Fan 3zhimi.fan.za5
Pedestal Fan Fan 1Cdmaker.fan.1c
Pedestal Fan Fan P5dmaker.fan.p5
Pedestal Fan Fan P8dmaker.fan.p8
Pedestal Fan Fan P9dmaker.fan.p9
Pedestal Fan Fan P10dmaker.fan.p10
Mijia Pedestal Fandmaker.fan.p11BPLDS03DM2800mAh, 24W, <=58dB
Smart Standing Fan 2 Prodmaker.fan.p33BPLDS03DM2800mAh, 24W, <=58dB
Pedestal Fan Fan P15dmaker.fan.p15
Mi Smart Standing Fan 2 P18dmaker.fan.p18BPLDS02DMAC, 15W, 30.2-55.8bB
Mi Smart Standing Fan 2 P30dmaker.fan.p30BPLDS02DMAC, 15W, 30.2-55.8bB
Rosou SS4 Ventilatorleshow.fan.ss4
Xiaomi Smart Tower Fandmaker.fan.p39BPTS01DM22W, <=63dB

Features

Pedestal Fan

Rosou SS4 Ventilator (leshow.fan.ss4)

Install

You can install this custom component via HACS. Search for for 'Xiaomi Mi Smart Pedestal Fan Integration' at the integration page of HACS. Alternatively, you can install it manually by copying the custom_component folder to your Home Assistant configuration folder.

As next step you have to setup the custom component at your configuration.yaml. This custom component doesn't provide a config-flow right now. A restart of Home Assistant is required afterwards.

Setup

# configuration.yaml

fan:
  - platform: xiaomi_miio_fan
    name: Xiaomi Smart Fan
    host: 192.168.130.71
    token: b7c4a758c251955d2c24b1d9e41ce47d

Configuration variables:

Platform services

Service fan.set_percentage

Set the fan speed percentage.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific fan entity. Else targets all.
percentagenoPercentage speed setting. Valid values are between 0 and 100.

Service fan.set_preset_mode

Set a preset mode.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific fan entity. Else targets all.
preset_modenoPreset mode. Valid values are Level 1, Level 2, Level 3 and Level 4.

Service fan.oscillate

Oscillates the fan.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific fan entity. Else targets all.
oscillatingnoFlag to turn on/off oscillation. Valid values are True and False.

Service fan.set_direction

Rotates the fan 5 degrees to the left/right.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific fan entity. Else targets all.
directionnoRotate the fan 5 degrees. Valid values are left/reverse and right/forward.

Service xiaomi_miio_fan.fan_set_oscillation_angle

Set the oscillation angle. Supported values are 30, 60, 90 and 120 degrees.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.
anglenoAngle in degrees. Valid values are 30, 60, 90, 120, and 140.

Service xiaomi_miio_fan.fan_set_delay_off

Set the scheduled turn off time. Supported values are 0, 60, 120, 180, 240, 300, 360, 420, 480 minutes. When 0 is passed, delay_off is disabled.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.
delay_off_countdownnoTime in minutes. Valid values are 0, 60, 120, 180, 240, 300, 240, 300, 360, 420, 480 minutes.

Service xiaomi_miio_fan.fan_set_natural_mode_on

Turn the natural mode on.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_natural_mode_off

Turn the natural mode off.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_buzzer_on

Turn the buzzer on.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_buzzer_off

Turn the buzzer off.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_child_lock_on

Turn the child lock on.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_child_lock_off

Turn the child lock off.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_led_brightness

Set the led brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off).

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.
brightnessnoBrightness, between 0 and 2.

Service xiaomi_miio_fan.fan_set_anion_on

Turn the ionizer on.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.

Service xiaomi_miio_fan.fan_set_anion_off

Turn the ionizer off.

Service data attributeOptionalDescription
entity_idyesOnly act on a specific xiaomi miio entity. Else targets all.