HomeKit pairing fails due to "Incorrect PIN code"

[ok2zar]

The problem

I had been asked to enter PIN code when I tried to pair Somfy Connectivity kit via HomeKit but I it was refused due to "Wrong PIN code". I've tried to enter many times in different formats like 1111-2222-3333 or 111122223333 but error message was still the same.

What version of Home Assistant Core has the issue?

2022.2.9

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant OS

Integration causing the issue

Somfy Connectivity kit via HomeKit

Link to integration documentation on our website

https://community.home-assistant.io/t/somfy-connectivity-kit-support-for-overkiz-and-or-homekit/392569/25

Diagnostics information

I can provide just diagnostic data downloaded for overkiz Somfy integration since not able to download diagnostic data for HomeKid until it's paired.
config_entry-overkiz-85f5eff403885431eebc3faf590cecd7.json.txt

Example YAML snippet

No response

Anything in the logs that might be useful for us?

No response

Additional information

As I understand it's not official stable integration yet so I provided link to forum where was reported it's possible to do it like this.

[iMicknl]

For next time, please mention the integration and a link to the documentation. (https://www.home-assistant.io/integrations/overkiz/). This will make sure that codeowners are assigned automatically, but now someone from core would need to tag this issue as 'overkiz'. If you wanted to report a bug in the HomeKit Controller integration, this would work in the same way.

Looking at your diagnostics information, there is no HomeKit ProtocolGateway. See https://github.com/iMicknl/python-overkiz-api/blob/f6651c88de235d4ecd5db0206253c8803c9f281a/tests/fixtures/setup/setup_tahoma_pro.json#L48-L91 for an example of what should show up in your diagnostic information.

Thus unfortunately, from an Overkiz perspective, we cannot show the HomeKit setup code since it is just not there.

Could you link your Somfy Connectivity Kit to an iOS device (as a test?). And did the HomeKit Controller got detected by Home Assistant? If so; perhaps you can create an issue for the homekit_controller integration to investigate why it doesn't work.

[ok2zar]

Overkiz integration works fine. Problem is with HomeKit integration.

Unfortunately I have no Apple device at all but maybe I can manage it if would be necessary test for next investigation. And yes, HomeKit Conroller has been detected by Home Assistant correctly.

[iMicknl]

Since your issue is 'Incorrect PIN code', perhaps you can contact Somfy about this issue. I hoped that the Overkiz integration would show you the HomeKit Setup Code as well, but unfortunately this is not the case.

Maybe the homekit_controller debug information can help, but @Jc2k knows more about that. I suspect that you are indeed using the wrong setup code..

[ok2zar]

But h3rb3rt reported the same "Wrong PIN code" issue as well but overall his integration works fine now.

I'm not able to provide HomeKit debug info since integration is not "paired" - There is no option to download.

[Jc2k]

Can you confirm your setup code is 12 digits? It loooks like it in the forum post but I want to be sure before commenting further.

[ok2zar]

Yes it's 12 digits separed by "-" like 1111-2222-3333. PIN code printed on paper box and device backside label is 21-36-0**5

[Jc2k]

So homekit pairing codes are always 8 digits. You can enter them without dashes or in the format xxx-xx-xxx. The crypto maths is for 8 digit codes with dashes in those places. There is nothing in the spec for 12 digit codes.

[iMicknl]

The PIN code you mention @ok2zar is the gateway id (also called PIN) for Overkiz / Somfy, thus this is not the right one. The other one you mention is 8 digits and should be the one.

My HomeKit Setup Code is in the format xxx-xx-xxx, so it is weird that apparently Somfy now uses xx-xx-xxxx.

[ok2zar]

Damn. All I have is printed on box and label

[iMicknl]

Did you try the code at the right bottom? (so 30xx45xx). That is your HomeKit code!

[ok2zar]

Yep, that was. Got also some error message but then integration started to work and I can seen all blinds.....

Uaaah...

[ok2zar]

But it's confusing since HomeAssistant says: Enter PIN. It's in xxx-xx-xxx format

and PIN printed on label is in very similar format....

[iMicknl]

Great to hear! It is indeed unfortunate that Somfy uses PIN as well, for another use-case. However, the logo next to the 8 digit number is the HomeKit logo. And normally on iOS, you would scan that QR code to link it.

[ok2zar]

Thank you a lot @iMicknl

[iMicknl]

@ok2zar can you close this issue if everything is resolved? :)

[probot-home-assistant]

overkiz documentation
overkiz source
_{^{(message by IssueLinks)}}

[probot-home-assistant]

Hey there @vlebourl, @tetienne, mind taking a look at this issue as it has been labeled with an integration (overkiz) you are listed as a code owner for? Thanks!
_{^{(message by CodeOwnersMention)}}