Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration
syssi/xiaomi_airpurifier · v2026.6.0.0
Xiaomi Mi Air Purifier and Xiaomi Mi Air Humidifier integration for Home Assistant
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
climate | Thermostat | |
fan | Fan |
2 reports below say how a device from this integration behaves in the Home app.
What people report
Many Xiaomi purifiers, humidifiers, fresh-air systems and fans work locally via miio; new models are added through user-supplied logs. Early HomeKit use showed humidifiers as fans.
- Works35
- Partly works1
- Not working1
- Requested3
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Smartmi Air Purifier ZA1 | Works Local | Support merged; early users could not switch on/offSaved copyThank you for your response: Name Smartmi Air Purifier Model: KQJHQ01ZM Spec: https://www.aze.com.pl/pl/p/Oczyszczacz-powietrza-Smartmi-Air-Purifier/2483, https://www.smartmiglobal.com/collections/air-purifier/products/smartmi-air-purifier Coverage 9-48m², 400m³/h CADR, 30 dB - 64 dB, 40 W (max.) Sensors: Temperature, laser particle sensor, Total VOC, humidity. Some things are compatible with zhimi.airpurifier.mb3, but some functionalities are missing: - the device status does not work (the device cannot be turned on and off) - led not working (led: null) - motor speed is not working … Excerpt saved from GitHub on 2026-10-23. | Issue #181 · 2021-04 | |
| Xiaomi Air Dog X3 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Dog X5 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Dog X7SM | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Humidifier CA1 | Works Local | Partly in Home Speed values over 100 caused errors; later fixed with raw_speed | Works; speed attribute error with HomeKit fixedSaved copyHello. I added zhimi.humidifier.ca1, all works great, but i have strange errors in my log. `2019-03-04 21:38:52 ERROR (MainThread) [homeassistant.core] Error doing job: Future exception was never retrieved Traceback (most recent call last): File "/usr/lib/python3.5/concurrent/futures/thread.py", line 55, in run result = self.fn(*self.args, self.kwargs) File "/srv/homeassistant/lib/python3.5/site-packages/homeassistant/components/homekit/type_fans.py", line 132, in update_state hk_speed_value = self.speed_mapping.speed_to_homekit(speed) File … Excerpt saved from GitHub on 2026-10-23. | Issue #33 · 2019-03 |
| Xiaomi Air Humidifier CA1 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier 2 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier 2S | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier 3 (2019) | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier 3H (2019) | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier MA2 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier Pro | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier V3 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Purifier ZA1 | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Mi Air Fresh MJXFJ-150-A1 | Works Local | Support mergedSaved copy… get_sensor, get_speed? Supported methods: - [x] `set_power [power]` on/off - [x] `set_mode [mode]` sleep/auto/favourite - [x] `set_favourite_speed` 0...150 - [ ] `get_sensor [sensor]` pm25/co2 (at the mihome app pm25 values above 999 are capped to 999) - [x] `set_ptc_on [on/off]` - [ ] `get_timer []` - [ ] `get_ptc_timer []` - [ ] `set_ptc_timer [ptcTime]` - [ ] `set_timer [time]` - [ ] `get_light_timer []` - [ ] `set_light_timer [lightTime]` - [ ] `delete_timer [time]` - [x] `set_display [light]` on/off(?) - [x] `set_sound [sound]` on/off - [x] `set_child_lock [lock]` on/off - [x] … Excerpt saved from GitHub on 2026-10-23. | PR #97 · 2020-11 | |
| Xiaomi Mi Fresh Air Ventilator | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Mijia Humidifier 4L | Works Local | deerma.humidifier.jsq3 support mergedSaved copyLooks like support for deerma.humidifier.jsq3 can be added with minimal changes as it very similar to jsq5. I have tested it for several days and looks like all features works fine. Here diff: ```diff diff --git a/custom_components/xiaomi_miio_airpurifier/fan.py b/custom_components/xiaomi_miio_airpurifier/fan.py index 9fc3e47..137674b 100644 --- a/custom_components/xiaomi_miio_airpurifier/fan.py +++ b/custom_components/xiaomi_miio_airpurifier/fan.py @@ -137,6 +137,7 @@ MODEL_AIRHUMIDIFIER_CB2 = "zhimi.humidifier.cb2" MODEL_AIRHUMIDIFIER_MJJSQ = "deerma.humidifier.mjjsq" … Excerpt saved from GitHub on 2026-10-23. | Issue #123 · 2020-12 | |
| Xiaomi Mijia Humidifier 4L | Works Local | Listed as supported in READMESaved copy… 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent Sterilization Humidifier (EU version?); Mijia Smart Humidifier 2 (EU version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Mijia Smart Humidifier 2 (EU) | Works Local | Listed as supported in READMESaved copy… 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent Sterilization Humidifier (EU version?); Mijia Smart Humidifier 2 (EU version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi New Widetech Internet Dehumidifier | Works Local | Listed as supported in READMESaved copy… version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan 1C | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan P10 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan P5 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan P9 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan SA1 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan V2 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan V3 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan ZA3 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Pedestal Fan ZA4 | Works Local | Listed as supported in READMESaved copy… Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Rosou SS4 Ventilator | Works Local | Listed as supported in READMESaved copy… SCK0A45; Zero Fog Humidifier; New Widetech Internet Dehumidifier; Smartmi Fresh Air System XFXT01ZM; Smartmi Fresh Air System XFXTDFR02ZM; Mi Fresh Air Ventilator; Pedestal Fan Fan V2; Pedestal Fan Fan V3; Pedestal Fan Fan SA1; Pedestal Fan Fan ZA1; Pedestal Fan Fan ZA3; Pedestal Fan Fan ZA4; Pedestal Fan Fan 1C; Pedestal Fan Fan P5; Pedestal Fan Fan P8; Pedestal Fan Fan P9; Pedestal Fan Fan P10; Mijia Pedestal Fan; Rosou SS4 Ventilator; Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.. Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Smart Humidifier 2 EU | Works Local | Support mergedSaved copyAdding the following device: https://www.mi.com/global/product/xiaomi-smart-humidifier-2/ Log: [code] Excerpt saved from GitHub on 2026-10-23. | PR #352 · 2023-12 | |
| Xiaomi Smartmi Fresh Air System XFXT01ZM | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Smartmi Fresh Air System XFXTDFR02ZM | Works Local | Listed as supported in READMESaved copySupported devices: Air Purifier; Air Purifier 2; Air Purifier V3; Air Purifier V5; Air Purifier Pro; Air Purifier Pro V7; Air Purifier 2 (mini); Air Purifier (mini); Air Purifier MA1; Air Purifier MA2; Air Purifier 2S; Air Purifier 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Smartmi Humidifier Evaporator 2 | Works Local | Listed as supported in READMESaved copy… 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent Sterilization Humidifier (EU version?); Mijia Smart Humidifier 2 (EU version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Zero Fog Humidifier | Works Local | Listed as supported in READMESaved copy… 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent Sterilization Humidifier (EU version?); Mijia Smart Humidifier 2 (EU version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech … Excerpt saved from the README on 2026-10-23. | README | |
| Xiaomi Air Humidifiers and dehumidifier | Partly works | Partly in Home Dehumidifier shows as air conditioner, humidifier shows as fan | Request for proper HomeKit humidifier typesSaved copyHello, I'm heard that Home Assistant will be support Humidifier/Dehumidifiers with homekit. So if you have free time, please convert few device to that Device type. Current Dehumidifier show as Air Conditional and humidifier show as a fan at homekit Air Humidifier | zhimi.humidifier.v1 | | -- | -- | -- | -- Air Humidifier | zhimi.humidifier.v1 | | Air Humidifier CA1 | zhimi.humidifier.ca1 | | Smartmi Humidifier Evaporator 2 | zhimi.humidifier.ca4 | CJXJSQ04ZM | Air Humidifier CB1 | zhimi.humidifier.cb1 | | Mijia Smart Sterilization Humidifier S | deerma.humidifier.mjjsq | MJJSQ03DY | 4.5L, … Excerpt saved from GitHub on 2026-10-23. | Issue #116 · 2020-12 |
| Xiaomi Air Purifier Max | Not working | Not recognized after setupSaved copy你好,按照配置按照,小米空气净化器 max 不识别,重启 hs,没有发现新设备,能看看是不是哪里配置错了吗? Excerpt saved from GitHub on 2026-10-23. | Issue #201 · 2021-08 | |
| Mi Smart Evaporative Humidifier | Requested | Unsupported device; support still openSaved copyLogger: custom_components.xiaomi_miio_airpurifier.fan Source: custom_components/xiaomi_miio_airpurifier/fan.py:1011 Integration: xiaomi_miio_airpurifier (documentation, issues) Unsupported device found! Please create an issue at https://github.com/syssi/xiaomi_airpurifier/issues and provide the following data: deerma.humidifier.jsq4 hass:0.118.3 miio:0.54(after copy the official xiaomi_miio component to custom_components) Excerpt saved from GitHub on 2026-10-23. | Issue #109 · 2020-11 | |
| Xiaomi Smart Air Purifier 4 Compact | Requested | Support PR closed without mergeSaved copypython-miio (>=0.5.12) does not ship a MIoT mapping for this model yet, so the mapping is registered on AirPurifierMiot at import time, verified against https://home.miot-spec.com/spec/xiaomi.airp.cpa4. - power, mode (auto/silent/favorite), aqi (pm2.5), filter life/hours/left time, buzzer, child lock, motor speed, favorite level, led brightness. - No fan_level/favorite_rpm properties exist on this model's spec, unlike the zhimi.airp.* Air Purifier 4 variants. Excerpt saved from GitHub on 2026-10-23. | PR #450 · 2026-09 | |
| Xiaomi Smart Pet Care Air Purifier | Requested | Support PR openSaved copySummary Adds support for the Xiaomi Smart Pet Care Air Purifier (`xiaomi.airp.cpa5`) to the `fan` platform: model constant, config schema whitelist entry, `PURIFIER_MIOT` dispatch entry, available attributes, operation modes and feature flags. This depends on the corresponding python-miio mapping, submitted upstream at rytilahti/python-miio#2087. ## Test plan - [x] Verified against real hardware: power on/off, mode (auto/manual), aqi, favorite_level, buzzer, child_lock, led_brightness (off/dim/on), filter/firmware info retrieval, all via a local Home Assistant instance with this branch and … Excerpt saved from GitHub on 2026-10-23. | PR #449 · 2026-07 |
Show 1 more
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Xiaomi Mijia Humidifier 4L (MJJSQ02LX) | Won’t be supported | Not a smart device; no WiFiSaved copy… 2H; Air Purifier Super; Air Purifier Super 2; Air Purifier 3 (2019); Air Purifier 3H (2019); Air Purifier ZA1; Air Dog X3; Air Dog X5; Air Dog X7SM; Air Humidifier; Air Humidifier CA1; Smartmi Humidifier Evaporator 2; Smartmi Evaporative Humidifier; Smartmi Evaporative Humidifier (Korea Version); Mijia Smart Sterilization Humidifier S; Mijia Intelligent Sterilization Humidifier (EU version?); Mijia Smart Humidifier 2 (EU version); Mijia Humidifier 4L; Mijia Smart Sterilization Humidifier S (EU version?); Mijia Intelligent Sterilization Humidifier SCK0A45; Zero Fog Humidifier; New Widetech … Excerpt saved from the README on 2026-10-23. | README |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 333 (0.05%) |
|---|---|
| GitHub stars | 499 |
| Latest version | 2026.6.0.0 (2026-10-01) |
| Set up in the UI | No, YAML |
| Maintainers | @syssi |
| License | Apache-2.0 |
Devices listed in its README
- Air Purifier
- Air Purifier 2
- Air Purifier V3
- Air Purifier V5
- Air Purifier Pro
- Air Purifier Pro V7
- Air Purifier 2 (mini)
- Air Purifier (mini)
- Air Purifier MA1
- Air Purifier MA2
- Air Purifier 2S
- Air Purifier 2H
- Air Purifier Super
- Air Purifier Super 2
- Air Purifier 3 (2019)
- Air Purifier 3H (2019)
- Air Purifier ZA1
- Air Dog X3
- Air Dog X5
- Air Dog X7SM
- Air Humidifier
- Air Humidifier CA1
- Smartmi Humidifier Evaporator 2
- Smartmi Evaporative Humidifier
- Smartmi Evaporative Humidifier (Korea Version)
- Mijia Smart Sterilization Humidifier S
- Mijia Intelligent Sterilization Humidifier (EU version?)
- Mijia Smart Humidifier 2 (EU version)
- Mijia Humidifier 4L
- Mijia Smart Sterilization Humidifier S (EU version?)
- Mijia Intelligent Sterilization Humidifier SCK0A45
- Zero Fog Humidifier
- New Widetech Internet Dehumidifier
- Smartmi Fresh Air System XFXT01ZM
- Smartmi Fresh Air System XFXTDFR02ZM
- Mi Fresh Air Ventilator
- Pedestal Fan Fan V2
- Pedestal Fan Fan V3
- Pedestal Fan Fan SA1
- Pedestal Fan Fan ZA1
- Pedestal Fan Fan ZA3
- Pedestal Fan Fan ZA4
- Pedestal Fan Fan 1C
- Pedestal Fan Fan P5
- Pedestal Fan Fan P8
- Pedestal Fan Fan P9
- Pedestal Fan Fan P10
- Mijia Pedestal Fan
- Rosou SS4 Ventilator
- Mijia Humidifer 4L (MJJSQ02LX): This device isn't smart / has no WiFi support.
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/syssi/xiaomi_airpurifier
- Source code: https://github.com/syssi/xiaomi_airpurifier
- Issues: https://github.com/syssi/xiaomi_airpurifier/issues
- HACS: https://hacs.xyz