Xiaomiβs smart home ecosystem allows you to control lighting by voice, on a schedule, or through a mobile app β but you first need to connect the light bulb to the gateway correctly. Many users face synchronization errors, unstable operation, or a complete lack of response of the device to commands, the reason most often lies in the wrong sequence of actions, outdated firmware or conflicts on the Wi-Fi network.
In this article, we will explore all possible ways to connect Xiaomi Yeelight, Mi LED Smart Bulb and other models to Mi Home Gateways (including v2, v3 and Aqara versions). We will focus on common errors, such as when the lamp flashes but is not detected in the application, or the gateway does not see a new device, you will also learn how to reset the lamp to factory settings and what to do if the connection is interrupted during the synchronization stage.
For beginners, the process can seem complicated due to the abundance of settings in the Mi Home and Mi Home Lite. However, with our step-by-step instructions, you can connect the light bulb in 5-10 minutes - even if you have never worked with Xiaomi devices before. And experienced users will find solutions here for non-standard situations, such as connecting the lamp to the gateway through Home Assistant or setting up automations using Aqara Hub.
1. Which light bulbs and gateways are compatible with each other?
Before you start connecting, make sure your light bulb and gateway are technically compatible. Not all lamp models work with all versions of gateways - it depends on the communication protocol (ZigBee, Wi-Fi or Bluetooth Mesh) and regional firmware.
The main combinations that are guaranteed to work:
- π‘ Mi light bulbs LED Smart Bulb (Wi-Fi) β Connect directly to the router, no gateway required (but can be integrated into Mi Home for automation).
- π‘ Yeelight bulbs (Wi-Fi) β similarly, operate without a gateway, but communicate with Mi Home Gateway for scripts.
If your light bulb uses ZigBee protocol and the gateway uses Wi-Fi, it will be impossible to connect, as will devices with different regional firmware (for example, a Chinese lamp will not connect to the European gateway without changing the server in Mi Home).
Preparation for connection: what to do before synchronization
Before you plug the light bulb into the gateway, follow the mandatory preparatory steps, and ignoring them is the main cause of synchronization errors.
Preparation checklist:
Install the Mi Home app (version no lower than 6.5.0)|Update the lock firmware to the latest version|Connect the gateway to the 2.4 GHz network (5 GHz not supported)|Turn the light bulb into the socket and wait for the blinking|Make sure that the distance between the lamp and the gateway is not more than 10 meters.-->
Pay special attention to the Wi-Fi network:
- πΆ Xiaomi Gateway only works with 2.4 GHz networks. If your router broadcasts two networks (2.4 and 5 GHz) with the same name, divide them in the router settings.
- π Turn it off. WPA3 or 802.11r (Fast Roaming β These protocols can block the connection of Xiaomi devices.
- π If you use the Chinese version of the gateway, select China Mainland region in Mi Home (otherwise the lamp will not be identified).
β οΈ Warning: If the light bulb was previously connected to another gateway or account, it must be reset. To do this, turn on / off the lamp 5 times in a row (with an interval of 1 second) - it will flash quickly, signaling a reset.
3. Step-by-step instruction: how to connect a light bulb to the Xiaomi gateway
Consider the universal algorithm for ZigBee lamps (e.g. Mijia ZigBee Smart LED Bulb) and Mi Home Gateway v3. For other models, the steps may differ slightly.
Step 1: Add a gateway to Mi Home (if not already added)
- Open the Mi Home app and go to Devices β Add Device.
- Select the Gateway category and your gateway model (e.g. Mi Home Gateway 3).
- Hold the phone to the gateway and wait for the beep. Connect the gateway to the Wi-Fi network (only 2.4 GHz!).
Step 2. Connect the light bulb
- Turn the light bulb into the socket. It should start flashing slowly (if there is no blinking, drop it, as described above).
- In Mi Home, click Add Device β Lighting and select your light bulb model.
- An instruction will appear on the screen: press and hold the button on the gateway (about 5 seconds) until you hear a voice message βReady to add the deviceβ.
- The light bulb should stop flashing and light up with a smooth light β this means that it is connected.
Step 3. Adjust the light bulb
- π¨ In the device card in Mi Home you can change the color, brightness and color temperature.
- β° Set up a schedule (for example, automatically turn on the alarm clock).
- π Create automation (e.g., turning on the lamp when opening the door with an Aqara sensor).
π‘
If the light bulb doesn't plug in the first time, try removing it from the cartridge, waiting 10 seconds and re-rotating it, sometimes helping to reset temporary communication errors.
4. Typical errors and their solutions
Even if you do the instructions correctly, you can have problems, and here's a table of the most common errors and the specific ways to fix them.
| Mistake. | Possible cause | Decision |
|---|---|---|
| Light bulb flashes, but is not defined in Mi Home | Conflict with other ZigBee devices or weak signal | Turn off other ZigBee-device, bring the lamp closer to the gateway (1-2 meters) |
| Gateway says "Adding device failed" | Outdated firmware of the lock or lamp | Update the gateway software in Mi Home β Gateway settings β Update |
| The light bulb connects but does not respond to commands | Mi Home or conflict with the cloud | Change region to China Mainland (even for European devices) or reboot the gateway |
| Appendix "does not see" gateway | Gateway connected to 5 GHz or blocked by firewall | Reconnect the gateway to 2.4 GHz, disable the VPN/antivirus on your phone |
If neither of these methods worked, try an alternative method of connecting via Mi Home Lite (a simplified version of the app) or Aqara Home (for Aqara devices), which sometimes works better than the main Mi Home.
β οΈ Note: If you use Home Assistant or Yandex Alice to control the light bulb, first connect her to the gateway via Mi Home, and then integrate the gateway into a third-party system. Direct connection of the lamp to Home Assistant without a gateway is only possible for Wi-Fi models (for example, Yeelight).
5. How to connect Xiaomi light bulb to Aqara Hub gateway
Aqara gateways (such as the Aqara Hub M2 or E1) support Xiaomi light bulbs, but with some nuances. The main difference from the Mi Home Gateway is using the Aqara Home app instead of the Mi Home.
Connection algorithm:
- Install the Aqara Home app and add your Aqara gateway to it.
- Go to Add Device β Lighting and select a light bulb model (e.g. Xiaomi Mijia ZigBee Bulb).
- Press the button on the Aqara gateway (located on the top panel) and wait for the beep.
- The light bulb should blink 3 times and go out - this means that it is connected.
If the light bulb is not detected, check:
- π Firmware compatibility: Aqara gateway must be at least 1.4.6.
- π‘ Signal level: Aqara Home has a ZigBee Signal Strength indicator, if it's below 20%, move the gateway closer to the lamp.
- π Region: In Aqara Home, select the server that matches your light bulb (e.g. China for Chinese models).
What if the light bulb plugs in but appears as an βUnknown Deviceβ?
6.Light bulb control after connection: scenarios and automation
After successfully connecting a light bulb to the gateway, you can set up automatic scripting, voice control, and integration with other smart home devices.
Examples of automation:
- π Simulated presence: The lamp accidentally turns on/off when you are not at home (set up in Mi Home) β Automation β Simulation of presence).
- πͺ Motion sensor link: lamp lights up when motion is detected (Xiaomi Motion Sensor needed).
- πΆ Sync with music: the lamp flashes to the beat of music (works with Yeelight and the Mi Home app on Android).
- βοΈ Adaptive lighting: the color of the lamp varies depending on the time of day (warm light in the evening, cold in the daytime).
For voice control, connect the gateway to Alice, Google Assistant or Amazon Alexa:
- In Mi Home, go to Profile β Settings β Voice Assistants.
- Choose the right assistant and follow the instructions for the bundle of accounts.
- After synchronization, say, for example, βAlice, turn on the light in the living room.β
π‘
For stable operation of automations, make sure that the gateway and the light bulb are connected to the same Wi-Fi network. If you use multiple routers (for example, in a Mesh network), disable the Band Steering function - it can break the connection with ZigBee devices.
7. Alternative ways to connect (without the Xiaomi gateway)
If you donβt have a Xiaomi gateway, but you have a Yeelight or Mi LED Smart Bulb (Wi-Fi), you can connect it directly to the router and manage it via:
- π± Yeelight app (for Yeelight lamps).
- π Home Assistant (via Yeelight or Mi Home integration).
- π£οΈ Voice assistants (Alice, Google Home) through cloud synchronization.
For connection without gateway:
- Install Yeelight (for Yeelight lamps) or Mi Home (for Mi LED Smart Bulb).
- Turn the light bulb into the socket and it will create its own Wi-Fi hotspot (the name will be like yeelink-light-XXXX).
- Connect to this network from your phone and enter your home Wi-Fi (2.4GHz only!).
- Once connected, the lamp will be available in the app and through the Xiaomi cloud.
β οΈ Note: Light bulbs connected directly to Wi-Fi (without gateway) do not support ZigBee automation and may be slower when controlled via the cloud.