Skip to content
Home Assistant TestFlight
Climate

Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration

syssi/xiaomi_airpurifier · v2026.6.0.0

HACSLocal polling

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.

EntityShows up asNote
climateThermostat
fanFan

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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Smartmi Air Purifier ZA1Works LocalSupport merged; early users could not switch on/off
Saved copy
Thank 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 X3Works LocalListed as supported in README
Saved copy
Supported 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 X5Works LocalListed as supported in README
Saved copy
Supported 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 X7SMWorks LocalListed as supported in README
Saved copy
Supported 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 CA1Works LocalPartly in Home
Speed values over 100 caused errors; later fixed with raw_speed
Works; speed attribute error with HomeKit fixed
Saved copy
Hello. 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 CA1Works LocalListed as supported in README
Saved copy
Supported 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 2Works LocalListed as supported in README
Saved copy
Supported 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 2SWorks LocalListed as supported in README
Saved copy
Supported 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 LocalListed as supported in README
Saved copy
Supported 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 LocalListed as supported in README
Saved copy
Supported 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 MA2Works LocalListed as supported in README
Saved copy
Supported 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 ProWorks LocalListed as supported in README
Saved copy
Supported 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 V3Works LocalListed as supported in README
Saved copy
Supported 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 ZA1Works LocalListed as supported in README
Saved copy
Supported 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-A1Works LocalSupport merged
Saved 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 VentilatorWorks LocalListed as supported in README
Saved copy
Supported 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 4LWorks Localdeerma.humidifier.jsq3 support merged
Saved copy
Looks 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 4LWorks LocalListed as supported in README
Saved 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 LocalListed as supported in README
Saved 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 DehumidifierWorks LocalListed as supported in README
Saved 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 1CWorks LocalListed as supported in README
Saved 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 P10Works LocalListed as supported in README
Saved 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 P5Works LocalListed as supported in README
Saved 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 P9Works LocalListed as supported in README
Saved 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 SA1Works LocalListed as supported in README
Saved 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 V2Works LocalListed as supported in README
Saved 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 V3Works LocalListed as supported in README
Saved 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 ZA3Works LocalListed as supported in README
Saved 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 ZA4Works LocalListed as supported in README
Saved 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 VentilatorWorks LocalListed as supported in README
Saved 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 EUWorks LocalSupport merged
Saved copy
Adding 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 XFXT01ZMWorks LocalListed as supported in README
Saved copy
Supported 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 XFXTDFR02ZMWorks LocalListed as supported in README
Saved copy
Supported 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 2Works LocalListed as supported in README
Saved 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 HumidifierWorks LocalListed as supported in README
Saved 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 dehumidifierPartly worksPartly in Home
Dehumidifier shows as air conditioner, humidifier shows as fan
Request for proper HomeKit humidifier types
Saved copy
Hello, 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 MaxNot workingNot recognized after setup
Saved copy
你好,按照配置按照,小米空气净化器 max 不识别,重启 hs,没有发现新设备,能看看是不是哪里配置错了吗?

Excerpt saved from GitHub on 2026-10-23.

Issue #201 · 2021-08
Mi Smart Evaporative HumidifierRequestedUnsupported device; support still open
Saved copy
Logger: 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 CompactRequestedSupport PR closed without merge
Saved copy
python-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 PurifierRequestedSupport PR open
Saved copy
Summary 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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Xiaomi Mijia Humidifier 4L (MJJSQ02LX)Won’t be supportedNot a smart device; no WiFi
Saved 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 stars499
Latest version2026.6.0.0 (2026-10-01)
Set up in the UINo, YAML
Maintainers@syssi
LicenseApache-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.