From c2b2b7c21cad84ba01973ccc08d9a4d4693d3493 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Wed, 19 Jan 2022 22:07:52 -1000 Subject: [PATCH] Explain how HomeKit handles categorized entities (#21259) --- source/_integrations/homekit.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index dcc23e6e555..6b1352217b3 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -338,7 +338,7 @@ To add a single entity in accessory mode: ## Configure Filter -By default, no entity will be excluded. To limit which entities are being exposed to `HomeKit`, you can use the `filter` parameter. Keep in mind only [supported components](#supported-components) can be added. +By default, all entities except categorized entities (config, diagnostic, and system entities) are included. To limit which entities are being exposed to `HomeKit`, you can use the `filter` parameter. Keep in mind only [supported components](#supported-components) can be added. ```yaml # Example filter to include specified domains and exclude specified entities @@ -371,6 +371,8 @@ Filters are applied as follows: - If entity is included, pass (as #2 above) - If entity include and exclude, the entity exclude is ignored +Categorized entities are not included (config, diagnostic, and system entities) unless they are explicitly matched by `include_entity_globs` or `include_entities` or selected in the UI in include mode. + ## Docker Network Isolation The `advertise_ip` option can be used to run this integration even inside an ephemeral Docker container with network isolation enabled, e.g., not using the host network.