Xiaomi Fan Lovelace Card

Xiaomi Smartmi Fan Lovelace card for HASS/Home Assistant.

Features

Supports HACS installation
CSS fan blade and oscillation animation
UI config of card
Wide range of fans support by using HA standard speeds flag

Toggles

Oscillation
Natural mode
Child lock
Sleep mode

Cycling

Speed level
Oscillation angle
Timer duration

Requirements

By default, the Xiaomi Miio native integration will be used.

If you have a model that's not supported by the native integration yet, this card also supports the Xiaomi Mi Smart Pedestal Fan integration.

HACS Installation

Search for Xiaomi Smartmi Fan Card

Manual Installation

Download fan-xiaomi.js
Copy to www/community/lovelace-fan-xiaomi/fan-xiaomi.js

Add the following to your Lovelace resources

resources:
  - url: /community_plugin/lovelace-fan-xiaomi/fan-xiaomi.js
    type: js

Card Configuration

Example of Lovelace config views.cards key

entity: fan.entity_id
name: Fan Name
type: "custom:fan-xiaomi"
platform: xiaomi_miio_airpurifier

Card attribute	Default	Description
`entity_id`	-	`entity_id` of your fan
`type`	-	Must be `custom:fan-xiaomi`
`name`	-	(Optional) Fan name shown on card title
`platform`	`default`	(Optional) If using Xiaomi Mi Smart Pedestal Fan integration, specify `xiaomi_miio_fan`.
`disable_animation`	`False`	(Optional) Disable fan image and animation
`force_sleep_mode_support`	`False`	(Optional) Enables Sleep button in UI which sets speed to 1%
`hide_led_button`	`False`	(Optional) Hide LED toggle for supported models

Preview

Contributing

Clone the repo and install the latest node LTS
Run npm install then npm run build from the root of the repo

Build output should appear in the /dist directory.

Development Inner Loop

npm install
Run npm run start to do a watch build and host the built files at http://127.0.0.1:8234/xiaomi-fan-card.js.
On a running Home Assistant installation add this to your Lovelace resources:

- url: "http://127.0.0.1:8234/xiaomi-fan-card.js"
  type: module

You may need to change "127.0.0.1" to the IP of your development machine if you are developing remotely.

If your Home Assistant UI is running on https, you'll need to provide the resources via https as well. Use npm run start -- --https to serve via https, and switch the url: http://127.0.0.1 above to url: https://localhost.

Credits

fineemb (Original author)

shaonianzhentan

花神

override80/lovelace-fan-xiaomi