How to add a robot vacuum cleaner Xiaomi HomeKit: 4 working methods + mistake-making

Integrating Xiaomi’s robot vacuum cleaner into the Apple HomeKit ecosystem is a non-trivial task, but it’s doable. While officially Mi Robot, Dreame or Viomi devices don’t support the HomeKit protocol, there are workarounds through intermediate hubs, third-party firmware or cloud bridges. This article reveals all the current ways of connecting, their pros/cons, and helps avoid the typical mistakes that plague users when setting up.

It's important to understand that there's no one-size-fits-all solution. The integration method depends on the vacuum cleaner model, the firmware version, the availability of additional equipment (like the Home Assistant or Aqara Hub), and even the region of purchase of the device. We analyzed all the working schemes for 2026 - from the simplest (through the cloud) to the most complex (with firmware) - so you can choose the best option for your tasks.

Before you start, check it out: 1. Your vacuum cleaner supports connection to Mi Home/Xiaomi Home (if not, solve this problem first). 2. You have a device on iOS (iPhone/iPad) latest version of the app Home. 3. Are you ready for possible limitations: for example, with cloud integration, you can only manage a vacuum cleaner via the Internet, not locally.

1.Why is Xiaomi not officially supporting HomeKit?

The root of the problem lies in the difference in ecosystems: Xiaomi uses its own Mi Home protocol (or Mijia for Mijia-branded devices), which is incompatible with Apple’s HomeKit.

• 🔒 Prohibited protocols: Apple requires HomeKit certification, which is expensive and time-consuming for manufacturers.
• 🌍 Regional restrictions: China’s Mi Home ecosystem dominates, and HomeKit is barely used.
• 📱 Platform competition: Xiaomi promotes its own ecosystem Xiaomi Smart Home, where vacuum cleaners work with other devices of the brand.
• 🔄 Firmware updates: New software versions often “close” lofholes for third-party integration.

But there are workarounds, and you can divide them into 4 categories:

Important: Xiaomi vacuum cleaners with a chip STM32 (Mi Robot Vacuum-Mop 2 Lite is easier to play than the models on the model. MT7688 (Like, Dreame. D9). Clarify your device model before choosing a method!

Method 1: Integration through Home Assistant (recommended method)

Home Assistant is an open-source smart home platform that can translate Xiaomi protocols into HomeKit.

• 🖥️ Home Assistant (Raspberry Pi 4, NAS, or even an old PC).
• 🔌 Access to the local network (vacuum cleaner and Home Assistant must be in the same subnet).
• 📱 Home Assistant app on iPhone.

Step-by-step:

1. Install Home Assistant: Download the image for your device from the official website and infollowing installation instructions. OS.
2. Add Xiaomi Miio integration: Go to Settings → Devices and services → Add integration, find Xiaomi Miio and enter data from your Mi Home account (login and password).
3. Set up an access token: New devices require a Mi Home Token. Use mihome-bin or online services like miot-spec.org.
4. Activate HomeKit Controller: In the same integrations menu, add HomeKit Controller and select a vacuum cleaner from the list of devices.

Advantages of the method:

✅ Local management (no matter what the Xiaomi cloud is).

✅ Support for automatic scripting in HomeKit (for example, starting cleaning on the motion sensor).

✅ Ability to integrate other Xiaomi devices (lamps, sensors, sockets).

Make sure the vacuum cleaner is connected to 2.4 GHz Wi-Fi|

Get access token for Mi Home|

Update Home Assistant to the latest version|

Check that port 51827 is open on the router (for HomeKit)-->

⚠️ Note: If the vacuum cleaner does not appear in the Home app after adding, check: 1. Is the HomeKit Controller enabled in the integration settings. 2. Are there any conflicts IP-Addresses (vacuum cleaner and Home Assistant must be in the same subnet). 3. Is the vacuum cleaner firmware updated (older versions may not support local vacuum cleaner? API).

Method 2: Using the Aqara Hub as a bridge

If you already have an Aqara hub (e.g. Aqara Hub) M2 or M3), You can plug a vacuum cleaner in through it, which is easier than Home Assistant, but has limitations:

• 🔄 It only works through the Mi Home cloud (no local management).
• ⚡ Requires a Mi Home account with a tied vacuum cleaner.
• 📶 Depends on the stability of Xiaomi servers.

Instructions:

1. Open the Aqara Home app and go to Automation → Add the device.
2. Choose Xiaomi Mi Home and log in with the same account that the vacuum cleaner is attached to.
3. Once synchronized, the device will appear in the list. Now it can be added to HomeKit through the standard Settings menu. → HomeKit and Siri in the Aqara app.

⚠️ Note: This method does not support vacuum cleaner models released after 2023 (e.g. Xiaomi Robot Vacuum-Mop 2 Ultra.

Pros of the method:

✔️ Minimum technical skills (no need to be trained in the YAML Docker).

✔️ Compatible with other Aqara devices (sensors, sockets).

✔️ Official support (no risk of "breaking" the vacuum cleaner).

Cons:

❌ Delays of commands up to 2-5 seconds (due to cloud synchronization).

❌ Limited functionality: for example, you can not configure cleaning areas through HomeKit.

❌ It doesn't work without the Internet.

4. Method 3: Flashing on Valetudo or OpenMi (for advanced)

If you're willing to take risks, you can replace the standard vacuum cleaner firmware with an alternative, like Valetudo or OpenMi.

• 🔓 Full control of the device (without the cloud Xiaomi).
• 🛠️ Support MQTT, What makes integration with HomeKit easier.
• 📊 Advanced settings (e.g. manual control of fan speed).

⚠️ Warning: Flashing voids warranty and can cause the device to fail if something is done wrong. USB-OTG (For example, Mi Robot Vacuum 1S, Dreame Z10 Pro).

Step-by-step instructions for Valetudo:

1. Preparation: Download Valetudo firmware for your model. USB-OTG cable Linux/macOS (or Windows WSL).
2. Connect to the vacuum cleaner: Open the vacuum cleaner cover, find the connector USB and connect the cable to the PC. Turn the vacuum cleaner into firmware mode (usually by pressing the Reset button for 10 seconds).
3. Firmware: Start the command in the terminal: sudo./flash.sh /dev/ttyUSB0 firmware.bin (where firmware.bin — firmware).
4. HomeKit setup: After installation, Valetudo will open a web interface at the address http://[IP_In it, activate the HomeKit plugin and scan. QR-code.

Warnings:

⚠️ Note: Some models (e.g. Xiaomi Mi Robot Vacuum-Mop 2 Pro) have firmware protection, and require a soldering iron and chip experience.

Pros:

✔️ Maximum stability (no dependence on the cloud).

✔️ Full access to API The vacuum cleaner (you can write your own scripts).

✔️ It works without the internet.

Cons:

❌ Difficulty (requires terminal skills).

❌ Risk of damage to the device.

❌ No support for branded features (such as Xiao voice assistant) AI).

sudo ./dump.sh /dev/ttyUSB0 backup.bin

This will help restore the vacuum cleaner if something goes wrong.-->

5. Method 4: Cloud services (HomeBridge/Hoobs)

If the first three methods don't work for you, you can use cloud bridges like HomeBridge or Hoobs, which emulate HomeKit devices by connecting to your home. API Mi Home.

What will be required:

• 🖥️ HomeBridge (Raspberry Pi, Hoobs Box, or even Docker on PC).
• 🔑 Mi Home account access token (can be accessed through the miio plugin).
• 📡 A stable Internet connection (all commands go through the cloud).

Instructions for Hoobs (the easiest option):

1. Buy Hoobs Box or install Hoobs on Raspberry Pi (image downloaded from hoobs.org).
2. In the Hoobs web interface, go to Plug-ins and install homebridge-mi-robot-vacuum.
3. In the plugin settings, specify: {"platform": "MiRobotVacuum", "devices": [{"deviceId": "YOUR_DEVICE_ID", "token": "YOUR_MI_HOME_TOKEN", "name": "Xiaomi Vacuum" } ] }
4. Restart Hoobs and add the device to HomeKit via QR-code.

Limitations of the method:

• 🐢 Delays in execution of commands (up to 3-7 seconds).
• 🔌 It doesn't work without the Internet.
• 🔄 Possible problems after vacuum cleaner firmware updates.

💡

HomeBridge/Hoobs — The best choice for those who don’t want to mess with Home Assistant, but are willing to put up with cloud delays.

6. Solving Common Errors in Integration

Even with the exact instructions, there can be problems. TOP-5 errors and ways of correcting them:

⚠️ Note: If after integration the vacuum cleaner started to turn on or behaves strangely, check: 1. Are there any conflicting automatic scenarios in HomeKit. 2. Is the vacuum cleaner firmware updated (sometimes bugs are fixed in new versions). 3. Is the vacuum cleaner connected to both Mi Home and HomeKit at the same time (this can cause conflicts).

7. Comparison of methods: which one to choose?

To make the choice easier, we have compiled a comparative table taking into account the complexity of configuration, stability and functionality:

Selection recommendations:

• 🏠 If you already have a Home Assistant, use it (the best balance of stability and functionality).
• 🔌 If you want a simple setup and you have an Aqara Hub, choose this method (minimum body movements).
• 🛠️ If you are technically savvy and want complete control, go to Valetudo.
• ☁️ If you do not want to mess with the settings, but are ready to put up with lags — HomeBridge/Hoobs.

8. Frequently Asked Questions (FAQ)