How to Connect Aqara Zigbee/Thread dual-protocol Devices to Home Assistant
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 Home Assistant
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
● Home Assistant latest version
● Matter integration installed
● Thread Border Router configured
● Aqara Matter Hub and FP300 already paired together in Zigbee
Pairing Steps
1. Obtain Matter pairing code from the Hub
● Go to Hub Settings > Matter > Enable Pairing Mode.
● Generate pairing code or QR code.
2. Open Home Assistant Companion App
● Go to Settings > Matter > Add device.
● Select "No, it's new".
● Scan the Hub's QR code or enter the pairing code.
3. Wait for connection
● Home Assistant connects to the Hub via Bluetooth and completes secure pairing.
● The Hub joins the Thread network; process takes approximately 1-3 minutes.
4. View bridged devices
● After pairing completes, go to Settings > Matter > Devices.
● The Hub appears as a Bridge device.
● Tap to expand and view all bridged Zigbee devices, including the FP300.
5. Advanced configuration
● To adjust FP300 sensitivity, detection range, and other parameters, use the Aqara App.
● Home Assistant can only read sensor data and perform basic controls.
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
● Home Assistant running the latest stable version
● Matter integration installed (Settings > Devices & Services > Add Integration > Matter)
● Thread Border Router configured:
○ Method A: Home Assistant Connect ZBT-2 + OpenThread Border Router Add-on
○ Method B: Apple HomePod mini / Google Nest Hub (multi-protocol coexistence)
○ Method C: Silicon Labs Multiprotocol Add-on (if compatible hardware is available)
● Home Assistant Companion App (Android or iOS) installed
● Phone Bluetooth enabled
2.3 Pairing Steps
1. Prepare Home Assistant
● Ensure the Matter Server is running (check in Settings > Add-ons).
● Ensure the Thread Border Router is configured and running (check network status in Settings > Thread).
● For Android: ensure Google Play Services is updated and Thread credentials are synced to the phone.
● For iPhone: ensure you have joined Home Assistant's Thread network.
2. Add device (Android)
● Open the Home Assistant Companion App.
● Navigate to Settings > Matter.
● Tap "Add device" > "Add Matter device".
● Select "Yes. It's already in use.".
● Scan the Matter pairing code from Aqara Home App, or select "Setup without QR code" to enter the 11-digit pairing code.
● Wait for the pairing process to complete (approx. 1-3 minutes).
3. Add device (iOS)
● Open the Home Assistant Companion App.
● Navigate to Settings > Matter.
● Tap "Add device".
● Scan the QR code or enter the pairing code manually.
● When prompted "Add to Home Assistant?", confirm and wait for pairing to complete.
4. Complete setup
● After a successful pairing, go to Settings > Matter > Devices to view the added FP300.
● The device name defaults to the factory name; tap the pencil icon to rename.
2.4 Troubleshooting
● If the prompt "this device requires a border router" appears:
○ Check that the Thread Border Router is running normally.
○ Sync Thread credentials to your phone in Home Assistant's Settings > Thread.
○ Restart the Matter Server Add-on.
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.