From 9178587def39f07126ceb798f348eb5bba6edf05 Mon Sep 17 00:00:00 2001
From: shred86 <32663154+shred86@users.noreply.github.com>
Date: Mon, 2 Aug 2021 21:04:15 -0700
Subject: [PATCH] Add FAQ section

Add FAQ section and verbiage about a finding with camera motion sensors in HomeKit.
---
 docs/docs/usage/home-assistant.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/docs/usage/home-assistant.md b/docs/docs/usage/home-assistant.md
index 45764e01a..c8cc0aaff 100644
--- a/docs/docs/usage/home-assistant.md
+++ b/docs/docs/usage/home-assistant.md
@@ -131,3 +131,9 @@ automation:
               - url: 'http://ccab4aaf-frigate:5000/api/events/{{trigger.payload_json["after"]["id"]}}/thumbnail.jpg'
                 caption: 'A {{trigger.payload_json["after"]["label"]}} was detected on {{ trigger.payload_json["after"]["camera"] }} camera'
 ```
+
+## FAQ
+
+### When using the [HomeKit integration](https://www.home-assistant.io/integrations/homekit/) in Home Assistant to expose cameras to HomeKit, the camera's motion sensor in HomeKit do not appear to function properly.
+
+If tracking multiple object types, the HomeKit integration will randomly link one of the motion sensor entities grouped with the camera device in Home Assistant. You can specify a `linked_motion_sensor` in the Home Assistant [HomeKit configuration](https://www.home-assistant.io/integrations/homekit/#linked_motion_sensor) for each camera.