I spent a very long time trying to get my Aqara FP2 added to Homey Pro (Early 2023) and in the end it turned out to be a user mistake that I kept repeating without realizing it.
Maybe this helps someone else.
My setup:
- Homey Pro (Early 2023)
- Version 13.1.5
- Aqara FP2 already fully configured in the Aqara app
- Zones and stickers configured
- Zone names synced to Apple Home
I installed the HomeKit Controller app for Homey:
The first issue:
When adding devices in HomeKit Controller, it asked for a code.
To get the Homey HomeKit PIN:
- Go to Homey Settings
- Homey Experiments
- Enable HomeKit
If you already enabled it before and need a new PIN:
- Disable HomeKit
- Click somewhere else in settings
- Enable it again
- A new PIN will be generated
Now the MOST IMPORTANT part and the actual reason the FP2 would never appear in Homey:
I already had the Aqara FP2 added to Apple Home on my iPhone and Mac.
That was the problem.
The Aqara FP2 can apparently only provide access to one external ecosystem outside of Aqara itself at a time.
So if it is already added to Apple Home, Homey may not detect it.
What finally worked for me:
-
Remove the FP2 from Apple Home
(IMPORTANT: do this inside the Apple Home app, NOT inside the Aqara app) -
Power cycle the FP2
(I unplugged power briefly) -
In Homey:
Add Device β HomeKit Controller β HomeKit over IP
After that the Aqara FP2 finally appeared in Homey.
The code you need to enter is the code printed on the FP2 device itself above the QR code.
One more tip:
After pressing OK, wait patiently.
Do not press OK multiple times because pairing takes slightly longer than expected.
For me it completed within about 60 seconds.
After that the device worked correctly in Homey with the features provided by the HomeKit Controller app.
Hopefully this saves someone else a lot of frustration.