diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 8cc1156e03b..b2cea8deeda 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -291,3 +291,17 @@ logger: - The configuration entries for `homekit` and the `component` that is causing the issue. - The log / traceback you have generated before. - Screenshots of the failing entity in the `states` panel. + +## {% linkable_title Troubleshooting PIN not appearing %} + +In some instances, the PIN will not appear as a persistent status or in the log files despite deleting `.homekit.state`, enabling logging, and reboot. The log files will include the error ```Duplicate AID found when attempting to add accessory```. + +In such cases, modifying your configuration.yaml to add a filter limiting the included entities similar to the following: + +```yaml +filter: + include_domains: + - light +``` + +Restart Home-Assistant and re-attempt pairing - a persistent status should now correctly appear.