How to Connect Aqara Zigbee/Thread dual-protocol Devices to Homey
Aktie
This third-party platform connection guide uses the Presence Multi-Sensor FP300 as an example. Other Aqara Matter devices can also be connected by following this guide. If you have any questions or encounter any issues that you are unable to resolve during the process, please contact the relevant customer service team for assistance.
1. Matter over Bridge
1.1 Prerequisites
● FP300 is in Zigbee mode
● The user owns an Aqara Matter Hub (recommended: Aqara Hub M3)
● Aqara Home App installed and the user is signed in
● The Aqara Matter Hub's initial setup is completed (powered on, network connected, added to the Aqara App)
1.2 Connect the FP300 to the Aqara Matter Hub via Zigbee
Steps
1. Ensure FP300 is in Zigbee mode
● If currently in Thread, switch to Zigbee mode first.
● After switching, the FP300 will automatically enter Zigbee pairing mode (LED alternates flashing blue and purple).
2. Open the Aqara Home App
● Tap "+" > "Add Device".
● Select the "Sensor" category, find and tap "FP300".
3. Select a Hub
● Choose an Aqara Matter hub to add the FP300 to.
● Confirm the Hub is online and on the same network as your phone and the device.
4. Pair device
● The app will show "Searching for device..."
● With the FP300 in Zigbee pairing mode, it is usually discovered within seconds.
● If not discovered automatically, long-press the FP300 reset button for 3 seconds to re-enter pairing mode.
5. Complete Zigbee Pairing
● Once discovered, the app will take you through the steps to complete the pairing.
● Name the device and select the room.
● The FP300 is now connected to Aqara Hub M3 via Zigbee.
6. Unlock advanced features
● Open the FP300 device page in the Aqara App to see four sensor cards:
○ Presence / Motion Detection
○ Temperature
○ Humidity
○ Light
● Configurable options include:
○ Detection Mode (PIR priority / Radar priority / Dual-mode linkage)
○ Detection Sensitivity (multi-level adjustable)
○ Detection Range (distance adjustment)
○ Absence Confirmation Period
○ Individual sensor toggles (disable unused sensors to save power)
○ AI Spatial Learning (AI room scanning to reduce false triggers)
○ Sampling and reporting frequency
1.3 Bridge the Aqara Hub to Homey
After the FP300 is connected to an Aqara Matter hub via Zigbee, you can to pair The Hub as a Matter Bridge in each target platform. Once paired, the Hub will automatically expose its Zigbee devices that support Matter Bridging (including the FP300) to that platform.
Prerequisites
● Homey Pro (2023) or Homey Pro Mini
● Homey App v7.1.0+ / Homey firmware v10.3.0+
● Aqara Matter Hub and FP300 Zigbee paired together
Pairing Steps
1. Obtain Matter pairing code from the Hub
● Aqara App > Hub Settings > Matter > Generate pairing code.
2. Open Homey App
● Tap Devices > "+" > "New Device" > "Matter".
3. Select connection method
● Connect via Homey (recommended).
4. Scan the Hub's QR code
● Scan the QR code or enter the pairing code.
● Tap "Continue".
5. Wait for connection
● Homey connects to Hub; process takes approximately 30-60 seconds.
6. Name and configure
● Name the Hub, select an icon, and assign it to a room.
7. View bridged devices
● After Hub pairing succeeds, the FP300 automatically appears in Homey's device list.
● All sensor capabilities are auto-recognized and can be used directly in Homey Flows.
2. Matter Direct Connection (Matter over Thread)
It is recommended to first connect the device to the Aqara Home App via Thread for the initial setup. Then, on the device page in the Aqara Home App, go to “Third-Party Matter Ecosystems” to obtain the Matter pairing code. Use this code to add the device to a third-party Matter platform to have access to all Aqara features.
If the device is added directly to a third-party Matter platform by scanning the Matter code on the device itself, without first configuring it in the Aqara Home App, only basic functions will be available.
2.1 Preparation Steps
● Open the Aqara Home App
● Enter the Device settings page.
● Find the "Matter" option.
● Tap to generate a Matter pairing code.
2.2 Prerequisites
● Homey Pro (2023) or Homey Pro Mini
● Homey App installed (Android or iOS) or Homey Web App
● Homey firmware version v10.3.0 or later
● Homey App version v7.1.0 or later
● Phone OS: iOS 16.5+ or Android 8+
2.3 Pairing Steps
1. Open Homey App
● Tap "Devices" in the bottom navigation bar.
● Tap the "+" icon > "New Device".
2. Select Matter
● Tap "Matter" in the technology category.
3. Select connection method
● Connect via Homey: Recommended option; uses Homey's Thread network.
● Connect via Android/iOS: Uses the phone's Thread network (Homey Pro only; Homey Pro Mini can only Connect via Android).
4. Scan pairing code
● Scan the Matter pairing code from Aqara Home App.
● If no QR code, tap "Set up without QR code" and enter the 11-digit pairing code.
5. Wait for connection
● Process takes approximately 30-60 seconds.
6. Name and assign
● After successful connection, name the device, select an icon, and assign it to a room.
7. Verify device
● View the FP300 and all its capabilities in Homey's device list.
● Can be used directly in Homey Flows automation.
● Homey recognizes Matter device capabilities without requiring additional apps.
2.4 Notes
● Homey Pro and Homey Pro Mini have built-in Thread Border Routers; no additional hardware required.
● When adding a Matter-over-Thread device via the Homey Web App, the device always joins Homey Pro's Thread network.
● Ensure your router/switch does not have Multicast Enhancement, VLAN isolation, or mDNS forwarding filtering enabled, as these may interfere with Matter communication.
The End
If you do not have an Aqara Hub, you can scan the Matter code on the device itself to add it directly to a third-party Matter hub. However, only basic functions will be available.