jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-25 02:06:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add tip for required unique_id for device_registry (#814)

Browse Source 
Entities will not be connected to a device if unique_id is not set.
This commit is contained in:
Thomas Geymayer 2021-02-20 00:18:09 +01:00 committed by GitHub
parent 82f30a3050
commit 10cf2c5d80
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 1 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/device_registry_index.md
View File

@ -41,7 +41,7 @@ Although not currently available, we could consider offering an option to users
## Defining devices
:::tip
Entity device info is only read if the entity is loaded via a [config entry](config_entries_index.md).
Entity device info is only read if the entity is loaded via a [config entry](config_entries_index.md) and the `unique_id` property is defined.
:::
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).