Xiaomi, Smartmi, Mijia

Xiaomi Fans

homebridge-xiaomi-fan · v1.5.9

VerifiedLocal

Adds Xiaomi Smartmi and Mijia fans with speed, swing, natural wind, buzzer, LED and timer.

View on npm Source code

What it says it supports

Brands

Xiaomi
Smartmi
Mijia

Devices it names

zhimi.fan.sa1
zhimi.fan.v2/v3
zhimi.fan.za1
zhimi.fan.za3
zhimi.fan.za4
zhimi.fan.za5
zhimi.fan.fa1

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Maintainer adds fan models on request when given the exact model string; Mi Standing Fan Pro had several non-working features.

Works1
Partly works2
Requested2

Device	Status	What they said	Source
Airmate fan air.fan.ca23ad9	Works	Support added in v1.5.7 after request Saved copy Hi merdok, I've been using your plugin and found it great with my smartmi fans. But unfortunately the plug in does not work with my new air mate fan of air.fan.ca23ad9. Please add support for it. this is what I got from lthe link https://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:fan:0000A005:air-ca23ad9:1 {"type":"urn:miot-spec-v2:device:fan:0000A005:air-ca23ad9:1","description":"Fan","services":[{"iid":1,"type":"urn:miot-spec-v2:service:device-information:00007801:air-ca23ad9:1","description":"Device … Excerpt saved from GitHub on 2026-10-22.	Issue #105 · 2021-08
Dmaker fan p9 (miot)	Partly works	Switches toggled randomly after v1.4.0 because of reconnect loop; fix was tested by users Saved copy Hi merdok, since Version 1.4.0 the switches in HomeKit-App toggling randomly every couple seconds. I can switch the fan on, but it can only be switched off if the button in HomeKit shows "on" during the random switchovers. See attached GIF. It shows a timespan of 38 seconds with no switching process of a device in HK or HB. Cheers, Oli Debug: [10/2/2020, 01:43:04] [xiaomifan] [Xiaomi Fan 1C] Connected to Fan dmaker.fan.1c [10/2/2020, 01:43:04] [xiaomifan] [Xiaomi Fan 1C] Setting up fan! [10/2/2020, 01:43:04] [xiaomifan] [Xiaomi Fan 1C] Getting device info. [10/2/2020, 01:43:04] [xiaomifan] … Excerpt saved from GitHub on 2026-10-22.	Issue #52 · 2020-10
Mi Smart Standing Fan Pro	Partly works	On/off and speed buttons work; speed slider, natural mode, timer, LED, oscillate-left/right do not Saved copy Are you sure that your fan model is the `dmaker.fan.p15`? If your are unsure then the best is that you delete this from the config. Also try to reset your fan, it might be that it got stuck and does not respond correctly to some command anymore. Excerpt saved from GitHub on 2026-10-22.	Issue #77 · 2021-02
Dreame Maker fan (fan02)	Requested	Owner asked for support; maintainer needs full model name and token Saved copy Hi Merdok, I've hold two Dream Maker Fan which are same manufacturer as dmaker.p5-p15, while they're smart fans supported by Dream Maker (the manufacturer) through 造梦者+ APP and they could be connected to miot through Mi home app "other platform devices:. Could you pls add support for them? The link below maybe the miot description of Dream Maker Fan. Many thanks. https://miot-spec.org/miot-spec-v2/instance?type=urn:miot-spec-v2:device:fan:0000A005:dmaker-02:1 Excerpt saved from GitHub on 2026-10-22.	Issue #98 · 2021-07
Xiaomi Mijia DC circulating fan ZLXHS01ZM	Requested	Asks for 5 speeds and vertical oscillation; connects but features missing Saved copy Mijia DC Variable Frequency Circulating Fan Desktop Product Model: ZLXHS01ZM Circulating Fan Rated Voltage: 12V = Circulating Fan Rated Power: 24W Adapter Rated Input: 100-240V~, 50/60Hz, 0.6A This equipment includes the model approval code CMIIT ID: 2017DP7231 The manufacturer of the radio transmitter module: Beijing Zhimi Electronic Technology Co., Ltd. Service Tel: 400-100-5678 200330-Y CC Excerpt saved from GitHub on 2026-10-22.	Issue #74 · 2021-02

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Xiaomi miIO protocol over LAN

You’ll need

Device IP and token

Compatibility

Verified by Homebridge	Yes
Homebridge versions	>=1.0.0
Homebridge 2.0	No
Node.js	>=12.9.0
Settings in Homebridge UI	Yes
Matter	No
Platform name	xiaomifan
License	MIT

Community signals

Downloads a week	28
Downloads a month	157
GitHub stars	111
Open issues	7
Closed issues	135
Last code push	2022-05-31
Latest version	1.5.9 (2022-05-31)
First published	2019-08-04
Releases	39

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.