Direct official integration for most Xiaomi devices with SmartThings is not available, so you'll need a community-developed Edge Driver to bridge the gap. The primary solution for connecting xiaomi devices with SmartThings is to enroll your hub in a developer channel and install a custom driver for your specific Xiaomi or Aqara Zigbee sensor.
The truth about integrating Xiaomi devices with SmartThings
Let's be blunt: you cannot simply open the SmartThings app, tap "Add Device," and expect a Xiaomi motion sensor to appear. Samsung and Xiaomi have not built a native, official integration for the vast majority of Xiaomi's smart home lineup. The only reliable path is through the community. Developers have created Edge Drivers, the modern replacement for the old Groovy SmartThings code, that translate Xiaomi's Zigbee signals into something SmartThings understands. This is not a hack or a workaround; it's the accepted, community-standard method. If you were hoping for a plug-and-play experience, adjust your expectations now. You'll be spending a few extra minutes on setup, but the result is a stable, locally-processed connection that doesn't rely on cloud bridges.
Prerequisites: Setting up your SmartThings hub
Before you can install any drivers, your SmartThings hub must be online and updated. Unbox the hub, plug it into a power source, and wait for the LED to blink. Download the SmartThings app on your iOS or Android phone, create an account, and log in. The app will walk you through connecting the hub to your 2.4GHz Wi-Fi network. Do not skip the firmware update check, go to the hub's settings in the app and install any pending updates. A stale firmware version can cause pairing failures down the line. Once the hub shows as "Online" in the app, you're ready for the next step.
Step 1: Enroll in a developer channel and install Edge Drivers
This is the crucial missing step that most tutorials gloss over. You cannot install a third-party Edge Driver without first enrolling your hub in a "channel" that hosts that driver. The most common community channel for Xiaomi devices is hosted at lazymocha.com. Navigate to that website, find the channel enrollment link for Xiaomi/Aqara Edge Drivers, and copy the channel URL. Paste the channel URL and confirm enrollment. The app will push the driver to your hub. You should now see the community driver listed. Select it and install it. This driver is what tells your SmartThings hub how to interpret the Zigbee signals from your Xiaomi sensor.
Step 2: The specific pairing process for Xiaomi Zigbee sensors
Pairing a Xiaomi Zigbee sensor with an Edge Driver is not the same as pairing a native SmartThings device. The sensor must be physically placed within 1 inch of the SmartThings hub, this is non-negotiable. Xiaomi sensors use a weak radio signal during pairing, and being too far away will cause the pairing to fail silently. Once the sensor is right next to the hub, press and hold the pairing button on the sensor for 5 seconds until you see the LED blink 3 times. Then, release the button and immediately press the reset button once every 1 second. While you're doing this, have a second person (or your other hand) open the SmartThings app and initiate a device scan. Tap "Devices," then "+", then "Scan." The app will search for nearby Zigbee devices. If it doesn't appear, repeat the button sequence from scratch, do not just press the button again; you must go through the full 5-second hold, 3 blinks, and 1-second reset cycle.
Step 3: Naming and organizing your newly added device
Once the sensor appears in the app, you'll be prompted to assign a name and a location. This step is more important than it seems. This organization isn't just for aesthetics, it's essential for creating clean automations later. If you name everything "Sensor" and put it in "Default Room," your automation list will become a confusing mess.
Controlling your devices and creating automations
With the device added, you can now control it like any other SmartThings device. Tap on the sensor in the app to see its current state. You can also use the SmartThings app to create automations. These automations run locally on your hub, meaning they work even if your internet goes down. You can also control the device remotely via the app when you're away from home, as long as your hub is online.
Device exclusion and re-inclusion tip
If a Xiaomi device starts showing as "Unavailable" or behaves erratically, the first fix is to exclude it from the hub and then re-include it. After removal, wait 10 seconds. Then, put the sensor into pairing mode (the same 5-second hold, 3 blinks, 1-second reset sequence) and scan for it again. This process clears any stuck Zigbee routing tables and usually resolves connectivity issues.
Alternative method: Mi Connector for Wi-Fi and Bluetooth devices
For Xiaomi devices that are not Zigbee, like Wi-Fi plugs or Bluetooth temperature sensors, the Edge Driver method won't work. Instead, the community has built "Mi Connector," a separate solution that runs on a local server. Mi Connector requires you to have a device like a Raspberry Pi or a Synology NAS with Docker installed, plus a MySQL database. It acts as a bridge, pulling data from Xiaomi's cloud API and exposing it to SmartThings via a local network connection. This method is more complex and requires ongoing maintenance, but it's the only way to integrate non-Zigbee Xiaomi gear without buying a separate hub. If you're not comfortable with Docker and command-line setup, this alternative may not be worth the effort, stick to Zigbee sensors for the smoothest experience.
