Aqara FP2 not detected in Homey Pro via HomeKit Controller – solved

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:

  1. Remove the FP2 from Apple Home
    (IMPORTANT: do this inside the Apple Home app, NOT inside the Aqara app)

  2. Power cycle the FP2
    (I unplugged power briefly)

  3. 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.

An add on From hugoinformatique :

If you reset the Aqara FP2 and re-pair it in the Aqara app after already having it in HomeKit Controller, you sometimes need to remove it from HomeKit Controller first before re-adding, otherwise the pairing just hangs at the code entry screen

Thanks. Very useful. One question just to confirm. In your “What finally worked for me”, I’m assuming that you still have to add the FP2 on the Aqara App first.

Hi

Not meant to be rude or being a smart ass, but it’s mentioned in the howto of the app topic quite clear:

Maybe you’d like to discuss with dev Martin on how to make that howto more clear?
Please post in the app topic:

(App topics can be found on the app page at the homey.app store)

I have tried solving this as you suggested but haven’t had a response. I have tried all scenarios but still can’t seem to make the FP2 visible when adding a device using Homekit Controller. It is a painful device.

Sorry to hear, Peter.