Xiaomi Mi Smart Pedestal Fan for Home Assistant (Marketplace integration)

Installs: 601 sharing analytics
GitHub stars: 509
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2026.8.0.0, October 1, 2026
Category: Climate, Fans and ventilation
Kind: Marketplace integration
Brand: Xiaomi
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: xiaomi_miio_fan
Source: github.com/syssi/xiaomi_fan
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Xiaomi Mi Smart Pedestal Fan is a custom integration that controls Xiaomi Mi Smart Fans from Home Assistant. It communicates with the fan locally and exposes it as a fan entity with power, preset levels, speed percentage, oscillation and a 5 degree left or right rotation. Extra actions switch natural mode, the buzzer, the child lock and the ionizer on or off, and set LED brightness, oscillation angle and a scheduled turn off time. Some actions apply only to certain models, such as vertical oscillation and evaporative water cooling. The Rosou SS4 ventilator is also covered, with operation modes such as manual, sleep, strong and natural. Setup is done in the YAML configuration with the fan's host address and API token, since there is no config flow.

Automatic summary of the README and code of syssi/xiaomi_fan. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Fans

Setting it up

Install it from the Marketplace and restart Home Assistant. It is then set up in configuration.yaml.

Actions

Set buzzer onTurn the buzzer on.Fields: Entity ID
Set buzzer offTurn the buzzer off.Fields: Entity ID
Set child lock onTurn the child lock on.Fields: Entity ID
Set child lock offTurn the child lock off.Fields: Entity ID
Set LED brightnessSet the LED brightness.Fields: Entity ID, Brightness
Set raw LED brightnessSet the raw LED brightness.Fields: Entity ID, Brightness
Set natural mode onTurn the natural mode on.Fields: Entity ID
Set natural mode offTurn the natural mode off.Fields: Entity ID
Set anion onTurn the ionizer on.Fields: Entity ID
Set anion offTurn the ionizer off.Fields: Entity ID
Set air cooler onTurn the evaporative water cooling on.Fields: Entity ID
Set air cooler offTurn the evaporative water cooling off.Fields: Entity ID
Set oscillation angleSet the oscillation angle.Fields: Entity ID, Angle
Set delay offSet the scheduled turn off time.Fields: Entity ID, Delay off countdown
Set vertical oscillation onTurn the vertical oscillation on. (P70, P76, SS310 and P28 only)Fields: Entity ID
Set vertical oscillation offTurn the vertical oscillation off. (P70, P76, SS310 and P28 only)Fields: Entity ID
TurnTurn to the given direction. (P30, P45, P70, P76, P85, P43, and P51)Fields: Entity ID, Direction
Set vertical oscillation angleSet the vertical oscillation angle. (P70, P76 and P28 only)Fields: Entity ID, Vertical angle

From the README

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.
Power (on, off)
Preset modes (Level 1, Level 2, Level 3, Level 4)
Speed percentage (0...100)
Oscillate (on, off)
Oscillation angle (30, 60, 90, 120, 140, 150)
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)