Xiaomiβs smart home ecosystem has hundreds of devices, from Yeelight light bulbs to Mi Robot robot vacuum cleaners. But the first thing users encounter is connecting the gadget to the Mi Home or Mijia server. Without the right binding, the device will not appear in the application, will not receive firmware updates and will not be able to interact with other devices in the system.
In this article, we will look at all the ways Xiaomi devices can be added to a server, from standard Bluetooth connectivity to manually entering MAC- addresses for rare models. We will focus on common errors (such as 10012 code or 20004 code) that interfere with synchronization, and explain how to fix them. If you are just starting to build a smart home or encounter a problem when adding a new gadget, here you will find solutions.
Important: the procedure may vary depending on the server region (China, Europe, Russia) and the firmware version of the device. We will look at universal methods that work for most models, including Xiaomi Mi Band, Aqara, Redmi and other sub-brands.
1. Preparation before addition of the device
Before you start connecting, make sure that the basic conditions are met, otherwise you risk getting an error while you are still searching for the device.
- π± Install the latest version of the app: Mi Home (for most devices) or Mijia (for Chinese models). Download from official sources, mi.com or app stores.
- π Select the correct server region: your current region should be specified in your account settings (Profile β Region); for Russia; for Europe, Europe; if the region does not match the deviceβs firmware, it will not connect.
- π Charge or turn on the device: the robot vacuum cleaner should be on the base, the motion sensor with a fresh battery, and the socket is connected to the 220V network.
- πΆ Check Wi-Fi: The device and smartphone must be on the same 2.4GHz network (most Xiaomi gadgets don't support 5GHz). Disable VPN and the proxy.
If you connect an Aqara or Yeelight device, you may need a separate app from the sub-brand, for example, Yeelight light bulbs are better added through the Yeelight App and then synced with the Mi Home.
β οΈ Warning: Some devices (e.g., Xiaomi Mi Air Purifier 3H) require a firmware update before connecting. If the gadget has previously been used with another account, reset to factory settings (usually by pressing a button for 5-10 seconds).
2. Standard method: Adding via Mi Home
This is the most common method, which works for 90% of Xiaomi devices, and the instructions are relevant for the Mi Home app version 6.0 and later.
- Open the app and log in to your Mi Account.
- Click on the + (add device) icon in the upper right corner.
- Select the category of the device (for example, Lighting β Smart Light bulb).
- Follow the instructions on the screen: usually press a button on the device (e.g., 3 times on the switch) or scan the QR- code.
- Wait 10 to 30 seconds for the device to connect to the server.
If the device is not located, try:
- π Reboot the router and smartphone.
- π‘ Move closer to the router (some devices, such as the Xiaomi Mi Temperature & Humidity Sensor, have a weak Bluetooth signal).
- π Connect the device to another power source (e.g., USB- socket to charge from the phone).
The device is on and ready to pair
Smartphone and device in the same Wi-Fi network 2.4 GHz
The application selects the correct server region
VPNs and ad blockers disabled
The device is not linked to another account-->
3 Manual Addition to MAC- Address
Some devices (especially older or Chinese versions) are not automatically detected, and manually entering MAC- addresses will help.
MAC- address is usually given:
- π·οΈ On a sticker on the device body (e.g., under the sensor cover or at the bottom of the robot vacuum cleaner).
- π In the instructions for use (Section Technical Specifications).
- π In a mobile application (if the device has already been connected).
How to add it manually:
- In Mi Home, click + β Add manually.
- Select the category and model of the device (if it is not in the list, select the nearest functionality).
- Enter MAC- address in XX:XX:XX:XX:XX:XX format (without spaces and dash).
- Confirm the addition and wait for synchronization with the server.
| The device | Where to find MAC-address | Example of format |
|---|---|---|
| Xiaomi Mi Robot Vacuum | At the bottom of the case, under the battery cover. | 78:11:DC:12:AB:45 |
| Aqara Door & Window Sensor | On the back of the sensor. | 50:EC:50:98:7C:3E |
| Yeelight LED Ceiling Light | On the Yeelight mobile app | 34:CE:00:6F:8D:1A |
| Xiaomi Mi Smart Socket | On the side sticker | A4:C1:38:F0:2B:E9 |
β οΈ Warning: If the device is displayed as Offline after manual addition, check if it supports your server region. For example, the Chinese versions of Mi Air Purifier do not work with a European server without Custom Firmware firmware.
Connection via Bluetooth (for devices without Wi-Fi)
Temperature sensors, Aqara buttons and some other devices connect via Bluetooth Low Energy (BLE), a process different from Wi-Fi connections:
- Turn on Bluetooth on your smartphone.
- In Mi Home, select Add Device β via Bluetooth.
- Activate the pairing mode on the device (for example, press the button on the Xiaomi Mi Flora sensor for 5 seconds).
- Wait for the app to find the device and confirm the connection.
Features of Bluetooth devices:
- πΆ Only work within a 10-15-meter radius of a smartphone or hub (e.g., Xiaomi Mi Smart Home Hub).
- π Data is updated less frequently than Wi-Fi devices (e.g., temperature every 2-5 minutes).
- π Consume less energy but require periodic battery replacement.
π‘
If the Xiaomi Mi Temperature & Humidity Sensor doesn't connect, try removing and inserting the battery back in. Sometimes this resets the Bluetooth module errors.
5. Solving common mistakes
When adding devices, users often encounter error codes, and here are the most common ways to fix them:
| Error code | Reason. | Decision |
|---|---|---|
| 10012 | The device is not responding. | Restart the device and router, check the power |
| 20004 | The wrong server region | Change region in your account settings to China (for Chinese devices) |
| 10008 | The device is linked to another account | Perform reset to factory settings |
| 10030 | Weak Wi-Fi signal | Bring the device closer to the router or use a repeater |
If the error does not disappear, try:
- π± Delete the cache of the Mi Home app (Phone Settings β Apps β Mi Home β Memory β Clear the cache).
- π Switch Wi-Fi from 5 GHz to 2.4 GHz (even if the router supports both bands).
- π Use another DNS (e.g., Google 8.8.8.8) in the router settings.
What if the device is connected but shows Offline?
6. Additional settings after connection
After successfully adding the device to the Xiaomi server, it is recommended that:
- π Assign a room: In the Mi Home app, drag the device to the desired room (like the Living Room or the Bedroom) and make it easier to control it through voice assistants (Alice, Google Assistant).
- π Update your firmware: Go to your device settings and check for updates, which will fix bugs and add new features.
- π Set up Sharing: If you want your device to be managed by other family members, add their accounts to Settings β Sharing.
- βοΈ Activate automation: Create scenarios in the Automation section (e.g., if the motion sensor is triggered β turn on the lights).
Some devices (e.g. Xiaomi Mi Air Purifier) have advanced customizations available through Custom Firmware, which add support for other regions, new modes of operation and integration with Home Assistant, but require experience and may be unwarranted.
π‘
If the device is connected but not listed, check the filters in the app, for example, Mi Home may be hiding devices from other regions by default.
7. Features of connecting Aqara and Yeelight devices
The devices of the Aqara and Yeelight sub-brands often require a separate approach.
Aqara (sensors, switches, hubs)
Aqara requires a hub (like the Aqara Hub or Xiaomi Mi Smart Home Hub) without which most sensors won't be transmitting data to the server.
- Add a hub to Mi Home via Wi-Fi.
- Activate the pairing mode on the hub (press the button for 3 seconds).
- Add the sensor via Bluetooth (as described in Section 4).
Yeelight (light bulbs, LED panels)
Yeelight light bulbs are better to add through the company app, and then synchronize with Mi Home:
- Install the Yeelight App and create an account.
- Add the light bulb via Wi-Fi (press the button on the base 5 times).
- In Mi Home, select Add Device β Yeelight and log in through the same account.
β οΈ Warning: Yeelight light bulbs do not support Aqara hub operation. They are required to have a direct Wi-Fi connection.