Xiaomi Miio and Smartmi Fan 2 (zhimi.fan.za3) not responding intermittently
See original GitHub issueThe problem
Xiaomi Smartmi Fan 2 sets up properly using the GUI, then swiftly becomes unavailable and unable to be controlled. It pops back up intermittently for brief periods and can be controlled, then goes offline again. Other apps can control it just fine, so there is something going on with this integration and this fan.
Edit: I should mention I am running HA in Docker. @syssi suspected this might have something to do with it, although other users below are not and still have problems.
What version of Home Assistant Core has the issue?
2022.3.3
What was the last working version of Home Assistant Core?
No response
What type of installation are you running?
Home Assistant Container
Integration causing the issue
Xiami Miio
Link to integration documentation on our website
https://www.home-assistant.io/integrations/xiaomi_miio/
Diagnostics information
Does not seem to provide any, unfortunately
Example YAML snippet
N/A
Anything in the logs that might be useful for us?
Not more than this unfortunately
Smartmi Standing Fan 2 became unavailable 21:28:00 - 2 minutes ago
Smartmi Standing Fan 2 turned off 21:27:35 - 3 minutes ago
Smartmi Standing Fan 2 became unavailable 21:26:47 - 3 minutes ago
Smartmi Standing Fan 2 turned off 21:26:22 - 4 minutes ago
Smartmi Standing Fan 2 became unavailable 21:25:33 - 5 minutes ago
Additional information
Some notes that may be of use:
- my device is on the same VLAN
- Wi-Fi reliability and signal are great
- the unofficial integration still works
- the Mi app still works
- the Homebridge fan plugin still works
- the
python-miioCLI is able to read the fan - the fan device screen displays the UniFi logo rather than the Mi logo after initial setup, probably because I have a UDM Pro and the UniFi Network integration enabled
According to python-miio:
Model: zhimi.fan.za3 Hardware version: esp32 Firmware version: 2.0.2
Issue Analytics
- State:
- Created 2 years ago
- Reactions:3
- Comments:37 (13 by maintainers)

Top Related StackOverflow Question
I’m also experiencing this issue with my Home Assistant setup as per the below and am happy to configure any additional environments to help debug the issue further.
@syssi Just let me know how I can help, I am familiar with Home Assistant, Docker and Linux systems so can get you what you need quickly to progress this issue.
Configuration
Log Data I can trigger this when the fan is toggled from on to off, it quickly goes into an unavailable state shortly after, then it comes and goes for quite some time.
Let me know how I can help, this Fan has been flakey for quite some time, would love to get it stable !
Additional Log Data I’ve configured logging for the component using the following configuration
I’ve then generated the attached log data for your reference. From what I can see, there are long delays in the current status of the fan occurring, resulting in timeouts. You’ll see in the logs the other fan I have working correctly, and you can ignore the vacuum messages, this all works fine, it’s just offline at the moment.
miio_logs.txt
no