The principle of the Xiaomi smart home: architecture, protocols and instructions for setting up

Xiaomi's smart home ecosystem is one of the most popular in the world, thanks to its availability, wide range of devices and deep integration between them. But how exactly does this system work? Why does the Yeelight light respond to the motion of the Mi Motion Sensor sensor, and the Mi Robot Vacuum robot vacuum run on schedule from the Mi Home app? The answer lies in a combination of hardware protocols, cloud services and software algorithms that synchronize the work of dozens of devices in real time.

In this article, we’ll look at Xiaomi’s smart home architecture, from the physical layer (which radio frequencies are used to communicate) to the logical layer (how automation and scenarios are built), which protocols are supported, how devices communicate with each other and through the cloud, and how to configure the system from scratch, from connecting the first sensor to creating complex chains of reaction, with a special focus on compatibility issues, constraints and ways to circumvent them.

If you’re just planning to build a Xiaomi-based smart home, this article will help you avoid the typical mistakes you make when choosing your devices. If you’re already using the ecosystem, you’ll find answers to why some scenarios are unstable and how to fix them.

1. Smart home architecture Xiaomi: what is the system

The Xiaomi Smart Home ecosystem is built on a modular principle, where each device performs its role, but they are all united by a common management.

Endpoints are physical gadgets that perform specific tasks: sensors (movements, door openings, temperatures), actuators (sockets, lamps, locks), multimedia devices (columns, televisions) and household appliances (vacuum cleaners, air conditioners).

• 🔌 Zigby devices (operate with Zigbee protocol, require hub)
• 📶 Wi-Fi devices (connect directly to the router)
• 📡 Bluetooth devices (usually low power sensors)
• 🌐 Cloud devices (managed through Xiaomi servers, such as robot vacuum cleaners)

2. Hubs and bridges are intermediate devices that provide communication between different types of gadgets. For example, Xiaomi Mi Smart Home Hub (or Aqara Hub) converts Zigbee signals into commands for the cloud, and Mi Wi-Fi Router can act as a bridge for some Bluetooth sensors.

3. the Software Platform includes:

• 📱 Mi Home Mobile Application (Main Management Interface)
• 🖥️ Mi Home Web (Simplified Version for PC)
• 🤖 Voice assistants (Alice, Google Assistant, Siri via HomeKit)
• 🔄 Xiaomi Cloud Servers (Save scripts, Logs, and Settings)

It’s important to understand that not all Xiaomi devices are compatible, for example, the Aqara sensor may not work with the Mi Smart Home Hub of the first version, and the Yeelight lamp does not support local control without the Internet.

2. Communication protocols: how devices communicate

Xiaomi uses four basic protocols for communication between devices, and the choice of protocol depends on the stability of the operation, the reaction speed and even the consumption of the sensor battery.

📡 Zigbee (IEEE 802.15.4)

The main protocol for most sensors and actuators (outlets, switches) runs at 2.4 GHz, supports a mesh topology, where each device can relay the signal.

• 🔋 Low power consumption (sensors last for years from batteries)
• 🏠 Long range (up to 100 m in ideal conditions)
• 🛡️ Interference protection (using channels other than Wi-Fi)

Disadvantages: requires a hub (gateway), not all devices support local management without the cloud.

📶 Wi-Fi (IEEE 802.11 b/g/n)

Used for heavy devices: Yeelight lamps, Mi Smart Plug sockets, Mi Home Security Camera.

• 🚀 High data transfer speed (suitable for video)
• 🌍 No additional hub (connects directly to the router)

Cons: high power consumption (not suitable for battery sensors), dependence on the stability of Wi-Fi.

🔵 Bluetooth Low Energy (BLE)

It is used in compact sensors (for example, Mi Flora for plants) and some wearable devices.

• 🔋 Very low energy consumption
• 📱 Works without a hub (connects directly to the smartphone)

Limitations: small range (up to 10 m), unstable operation with a large number of devices.

🌥️ Cloud protocol (MQTT over TCP/IP)

All devices, even those that communicate over Zigbee or Wi-Fi, end up sending data to Xiaomi servers, which allows you to control your home from anywhere in the world, but creates an Internet dependency. Local control (without the cloud) is supported only by some devices, such as Yeelight lamps through the Yeelight App.

Comparison of protocols:

A critical feature: devices on different protocols cannot communicate directly, for example, the Zigbee motion sensor will not be able to turn on a Wi-Fi lamp without a cloud intermediary or local script in the hub.

3 How devices interact: scenarios and automation

The main benefit of the smart home is the automation of routine activities, and in the Xiaomi ecosystem, this is done through scripts (Automations) and quick commands (Quick Actions), and let's see how this works in practice.

🔄 Types of scenarios:

• 🕒 Time – start on schedule (for example, turn on the lights at 18:00)
• 📱 In the event - a reaction to the action of another device (for example, turn on the fan at high temperature)
• 🏠 Geolocation – activation when entering / leaving the zone (for example, turn off everything when leaving the house)
• 🎙️ Voice command – integration with Alice, Google Assistant or Siri

🛠️ How to Create a Script in Mi Home:

1. Open the Mi Home app → Go to the Automation tab.
2. Press Add Add Add. → Choose the type of script.
3. Specify a condition (for example, "If the motion sensor is triggered").
4. Add an action (e.g., "Switch on the lamp").
5. Save the script and test it out.

⚠️ Attention:

The scripts created in Mi Home run through Xiaomi’s cloud, which means that when the Internet is shut down, automation will cease to function. Local scenarios (without the cloud) require an Aqara hub with Home Assistant firmware or alternative platforms like Home Assistant.

🔗 An example of a complex scenario:

Let’s say you want to open the door (Mi) Door/Window Sensor: Lights on (Yeelight), and if it's dark outside (Mi Light Sensor), the camera (Mi Home Camera) will start:

1. Create a script with the condition "The door is open."
2. Add the action "Lunch the lamp".
3. Add the attached condition "If illumination is < 50 lux" → "Record the video on camera".

Hubs and gateways: why they are needed and how to choose

A hub is a central device that links gadgets on different protocols and manages their operation. Without a hub, most Zigbee devices (sensors, switches) simply won’t work.

🔧 The main functions of the hub:

• 📡 Converts Zigbee signals into commands for the cloud or local area network.
• 🔄 Provides interaction between devices (e.g., sensor) → plug).
• 🛡️ Encrypts traffic between devices and the cloud.
• 🔋 It serves as a repeater to increase the range of the network.

📦 Xiaomi's Popular Hubs:

⚠️ Attention:

Xiaomi and Aqara hubs are not always compatible, for example, the Aqara Temperature Sensor sensor may not connect to the first version of the Mi Smart Home Hub.

🔍 How to choose a hub?

1.If you only have Zigbee devices, take the Mi Smart Home Hub or Aqara Hub. M2.

2.If you want to integrate with HomeKit, choose Aqara Hub M2.

3. If you want to control Bluetooth without an additional hub, Mi Wi-Fi Router will do. 4A.

4.For advanced automation (no cloud) consider hubs with Home Assistant support (e.g. Sonoff Zigbee 3.0) USB Dongle).

5. Cloud vs. Local Management: Pros and Cons

All Xiaomi devices can be divided into two categories according to the way they are managed:

☁️ Cloud management – Teams run through Xiaomi servers, which allows you to manage your home from anywhere in the world, but has drawbacks:

• ⚡ Internet dependency (when disabled scenarios do not work).
• 🕒 Delays in execution of commands (up to) 1-2 seconds).
• 🔒 Data leakage risks (information stored on Xiaomi servers).

🏠 Local control: devices communicate directly through a hub or local area network:

• ⚡ Instantaneous activation (delay) < 0.5 sec).
• 🔒 Data does not leave your network.
• 🌐 It works without the internet.

Disadvantages: limited functionality (not all devices support local commands).

📊 What devices support local management?

💡

If local management is critical to you, consider alternative platforms like Home Assistant or OpenHAB. These let you integrate and manage Xiaomi devices without the cloud.

Typical problems and their solutions

Even in a well-functioning smart home system, there are periodic failures, and let's look at the most common problems and ways to fix them.

🚨 The device does not connect to the hub

Possible causes and solutions:

• 🔋 Battery discharged - replace the power supply (for example, CR2032 sensory).
• 📶 Weak signal – move the hub closer to the device or add a repeater (e.g. Xiaomi Zigbee Repeater).
• 🌍 Regions Disparity – in Mi Home go to Profile → Settings → Region and select China (many devices only work with it).
• 🔄 Outdated firmware – update the hub and device through the app.

⏳ Delays in the execution of commands

If the lamp is delayed in 1-2 The problem is probably cloud management:

• 🌐 Switch to local control (if the device supports).
• 📡 Check the Internet speed (Ping server delay should be) < 100 ms).
• 🔧 Set up static. IP router.

🔌 The device is periodically shut down

A common problem with Wi-Fi devices (sockets, lamps)

• 📶 Unstable Wi-Fi – switch router to 2.4GHz channel (many devices don’t run on 5GHz).
• ⚡ Network congestion – limit the number of connected devices to one access point.
• 🔋 Overheating – provide ventilation for outlets and hubs.

💡

If the problem is not solved by standard methods, try resetting the device to factory settings (usually hold the reset button). 5-10 seconds and reconnect it.

7. Integration with other systems: HomeKit, Google Home, Alice

Xiaomi’s ecosystem doesn’t exist in a vacuum — it can be integrated with other smart home platforms, which extends the management capabilities, but requires additional customization.

🍎 Integration with Apple HomeKit

Not all Xiaomi devices officially support HomeKit, but there are workarounds:

• 🔌 Use the Aqara Hub M2 — It has built-in support for HomeKit.
• 🖥️ Configure the bridge over Home Assistant with the Xiaomi Mi Home plugin.
• 📱 HomeBridge (requires a computer or Raspberry Pi to be permanently turned on).

🤖 Integration with Google Assistant

Officially supported through the Mi Home app:

1. Open Mi Home → Profile → Settings → Voice assistants.
2. Select Google Assistant and log in.
3. In the Google Home app, add Mi Home.

Restriction: only cloud commands are running (local management is not available).

🗣️ Integration with Alice (Yandex)

Xiaomi doesn’t officially support Alice, but there are two ways to do it:

1. Through Yandex IoT (only some devices, such as Yeelight, are supported).
2. Through Home Assistant + Yandex Smart Home (requires customization).

FAQ: Frequent questions about Xiaomi smart home