From 41055bf4848ac9c5efc0a6249f8866afe2bafb8f Mon Sep 17 00:00:00 2001 From: Matt Schmitt Date: Sun, 24 Jun 2018 07:26:13 -0400 Subject: [PATCH] Update HomeKit documentation (#5544) * Address device limit and switch type caching * :pencil2: Corrected typo --- source/_components/homekit.markdown | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 4d7fc95f2f7..8cc1156e03b 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -34,6 +34,10 @@ homekit: entity_config: alarm_control_panel.home: code: 1234 + light.kitchen_table: + name: Kitchen Table Light + lock.front_door: + code: 1234 media_player.living_room: feature_list: - feature: on_off @@ -114,10 +118,10 @@ homekit: required: true type: string type: - description: Only for `switch` entities. Type of accessory to be created within HomeKit. Valid types are `switch` and `outlet`. + description: Only for `switch` entities. Type of accessory to be created within HomeKit. Valid types are `switch` and `outlet`. HomeKit will cache the type on the first run so a device must be removed and then re-added for any change to take effect. required: false type: string - default: switch + default: '`switch`' {% endconfiguration %}

@@ -151,6 +155,10 @@ After the setup is completed you should be able to control your Home Assistant c Currently this component uses the `entity_id` to generate a unique `accessory id (aid)` for `HomeKit`. The `aid` is used to identify a device and save all configurations made for it. This however means that if you decide to change an `entity_id` all configurations for this accessory made in the `Home` app will be lost. +### {% linkable_title Device Limit %} + +The HomeKit guidelines only allow a maximum of 100 unique accessories (`aid`) per bridge. Be mindful of this when configuring the filter(s). + ### {% linkable_title Persistence Storage %} Unfortunately `HomeKit` doesn't support any kind of persistent storage - only the configuration for accessories that are added to the `Home Assistant Bridge` are kept. To avoid problems it is recommended to use an automation to always start `HomeKit` with at least the same entities setup. If for some reason some entities are not setup, their config will be deleted. (State unknown or similar will not cause any issues.)