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
thennpm 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 athttp://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 theurl: http://127.0.0.1
above tourl: https://localhost
.
Credits
fineemb (Original author)