Integration of Xiaomi light bulbs in Apple Home: a step-by-step guide

Apple’s HomeKit ecosystem is renowned for its safety and convenience, but the choice of compatible devices is often limited compared to competitors. Owners of Xiaomi and Yeelight products often face the dilemma: you want to use affordable and high-quality smart lamps, but you want to control them through the native home app on the iPhone. Fortunately, modern technology allows you to combine these two worlds to create a single network of smart lighting.

The integration process can vary from simple scanning to QR-The method of choosing a local server with HomeBridge software depends on the specific lamp model, the region of purchase and your level of technical training. In this article, we’ll break down all the current ways, from official to advanced, so you can enjoy voice control through Siri and automation scenarios.

A critical condition for most methods is having a Gateway of a certain type or using third-party software on a computer or Raspberry Pi. Without understanding the architecture of your smart home network, connecting can take hours to wast. Let's look at how to turn your ecosystem into a single powerful system.

Compatibility checks for models and protocols

Before you start setting up, you need to clearly understand what device you are dealing with. Xiaomi lamps and Yeelight sub-brand use different communication protocols: Wi-Fi, Bluetooth Mesh and Zigbee, and their method of “friending” iOS depends on this.

Not all models have official support for HomeKit, most often more expensive versions or regionally specific editions, and if the package does not have the Works with Apple Home logo, you will need a middleman.

• 💡 Yeelight White (Color) – Requires a HomeBridge gateway or software for full integration.
• 💡 Zigbee lamps – only work through gateways that support the HomeKit spread.
• 💡 Bluetooth Mesh – often requires a Xiaomi hub with HomeKit support or an Aqara gateway.

Owners of devices made for the Chinese market are less fortunate: regional restrictions can block direct connection. However, using universal gateways allows you to bypass these restrictions. Always check the base model and firmware version before buying additional equipment.

Official method: Aqara and Xiaomi Gateway

The most stable and native way of integration is to use hardware gateways, which act as a bridge between the Zigbee protocol (which runs many Xiaomi lamps) and the Zigbee protocol. Wi-Fi/HomeKit. Aqara Gateway Gateway Series (especially versions) V3 and M1S) It has built-in support for Apple HomeKit.

To get started, you will need to connect the gateway to the socket and add it to the Aqara Home or Mi Home application (the region must match the account region). QR-add-on.

It is important to understand that not all Zigbee lamps are visible to the gateway.Make sure your light bulb supports Zigbee 3.0. The mating process usually looks like this: you turn on the device add mode on the gateway and quickly turn off and turn on the light on the switch several times (5 times) until the lamp starts to blink.

⚠️ Note: When you link the lamps to the Aqara gateway through the Mi Home app, they can become invisible to the native Yeelight app.

If you are using the Xiaomi Multimode Gateway, the procedure is similar, but requires careful choice of mode of operation. In the settings of the gateway, you must explicitly activate the HomeKit protocol, since by default it can only work in Miot mode.

Using HomeBridge for Advanced Users

If you don't have a dedicated gateway that supports HomeKit, or your lamps only work on Wi-Fi, HomeBridge comes to the rescue, a server that emulates HomeKit accessories and allows you to add thousands of devices that don't have official Apple support to the Home.

You can install HomeBridge on your computer (Windows, macOS, Linux), Raspberry Pi or even NAS. For macOS users, there is a simplified version - HOOBS, which is installed as a regular application. The main plugin for working with the Xiaomi ecosystem is called homebridge-mi-aqara or homebridge-yeelight.

To set up, you'll need to get a device token, which is a unique encryption key that allows the server to control the lamp, and the token can be mined through Android developer tools (Mi Home plugin) or using Python scripts that intercept the app's traffic.

npm install -g homebridge


npm install -g homebridge-config-ui-x




homebridge -I

After installing the plugin and prescribing the tokens in the config.json configuration file, the server will start a process that will be visible to your iPhone as a new accessory.

Alternative hubs: Tuya and Smart Life

Don’t discount the universal solutions. Some users are going by replacing the smart home head using Tuya or Smart Life hubs that also know how to be friends with HomeKit (via the same bridges or natively in new models).

A more realistic scenario is to use voice assistants as an intermediary, where you can link your Google Home or Amazon Alexa accounts to your Mi Home account, and then use HomeBridge’s bundle of plugins for those assistants to toss the devices into Apple Home.

This method increases latency when lights are turned on. The team goes a long way: Siri -> iCloud -> Google/Alexa Service -> Xiaomi Server -> Lamp. For scenarios, "turn on the lights" can be a noticeable pause of 1-2 seconds.

• 🔌 Requires a stable Internet connection (local will not work).
• 🔌 Dependence on third-party servers (if Google server crashes, the lights won’t turn on).
• 🔌 Complex setup of automation scenarios inside the Home app».

However, for users who are already deeply integrated into the Google or Amazon ecosystem, this path may be less painful than deploying their own HomeBridge server.

Comparison of connection methods

To make it easier for you to choose the right option, we have prepared a summary table that will help you assess the time, money and technical skills required for each method.

As you can see from the table, using native gateways or HomeBridge gives you the advantage of local work, which means that the lights will turn on on a cotton or a timer, even if the provider turns off the Internet.

Setup of automations and scenarios

The core value of Apple Home integration is its powerful automation engine, so once you've successfully connected the lamps, you can create scenarios that aren't available in the native Mi Home app, like geolocation, where the lights turn on when you drive up to your house.

To create a script, open the Home app, go to Automation and press +. You can use time triggers, other sensor states (movements, door openings) or voice commands.

⚠️ Warning: When creating complex action chains ("if the sensor is open and time after 18:00") make sure all devices are in the same "Home Location" in the application, otherwise the automation may not work.

An interesting scenario is a simulation of presence. Set up lights to turn on at random times in different rooms while you're on vacation. Xiaomi and Yeelight lamps are great at supporting smooth brightness change, which can be used for Good Morning or Movie scenarios.

💡

Use an accessory trigger (such as the Aqara wireless button) to turn off all the lights in the apartment at a single click, even if Xiaomi’s Internet services are temporarily unavailable, provided you use a local gateway.

Solving Frequent Problems and Errors

During the setup process, users often experience a device becoming "Not responding." This may be due to an update. IP-To avoid this, reserve static addresses. IP-address for the gateway or HomeBridge server in your router settings.

Another common problem is that you've turned off the light in the Mi Home app, and it's on Apple Home, so that's done by rebooting the bridge in HomeBridge or re-connecting the gateway in the Aqara Home app.

If the Yeelight lamp does not respond to commands from HomeKit, check if the lamp itself (via the Yeelight app) has a "LAN Control" mode activated for local control.

💡

The stability of a smart home is 90% dependent on the quality of Wi-Fi coverage and the correct setup of the 2.4 GHz network, since most IoT devices do not support 5 GHz.

Also worth remembering is the limits: One Aqara gateway supports up to 32 sub-devices, and if you plan to scale, consider buying a second hub to distribute the load.