From d3ac04fb1c036072358497d6dd738e25ab458be3 Mon Sep 17 00:00:00 2001 From: Stefan Agner Date: Sat, 31 Oct 2020 23:51:46 +0100 Subject: [PATCH] Clarify how devices are matched in device registry (#709) The exact device registry behaviour is somewhat unclear. Clarify how devices are matched exactly. --- docs/device_registry_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/device_registry_index.md b/docs/device_registry_index.md index 1b0debea..09a9d5d3 100644 --- a/docs/device_registry_index.md +++ b/docs/device_registry_index.md @@ -44,7 +44,7 @@ Although not currently available, we could consider offering an option to users Entity device info is only read if the entity is loaded via a [config entry](config_entries_index.md). ::: -Each entity is able to define a device via the `device_info` property. This property is read when an entity is added to Home Assistant via a config entry. A device will be matched up with an existing device via supplied identifiers and connections, like serial numbers or MAC addresses. +Each entity is able to define a device via the `device_info` property. This property is read when an entity is added to Home Assistant via a config entry. A device will be matched up with an existing device via supplied identifiers or connections, like serial numbers or MAC addresses. If identifiers and connections are provided, the device registry will first try to match by identifiers. Each identifier and each connection is matched individually (e.g. only one connection needs to match to be considered the same device). ```python # Inside a platform