jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Remove line braks

Browse Source
This commit is contained in:
Fabian Affolter 2018-08-11 14:20:33 +02:00
parent 8717eb9f8f
commit 3a0a54cf14
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
1 changed files with 7 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
source/_docs/configuration/entity-registry.markdown
View File

@ -9,24 +9,18 @@ sharing: true
footer: true footer: true
--- ---
Starting with version 0.63, Home Assistant keeps a registry of known entities. Starting with version 0.63, Home Assistant keeps a registry of known entities. The entity registry makes sure that entities get unique identifiers and allow customizing the identifiers and names of these entities.
The entity registry makes sure that entities get unique identifiers and allow
customizing the identifiers and names of these entities.
Changes require that Home Assistant is shut down when you edit the file, otherwise Changes require that Home Assistant is shut down when you edit the file, otherwise Home Assistant may over-write your changes, and a restart of Home Assistant is required for your changes to take effect. Version 0.75 introduced a configuration user interface.
Home Assistant may over-write your changes, and a restart of Home Assistant is
required for your changes to take effect. Version 0.75 introduced a configuration
user interface.
<p class='note'> <p class='note'>
An entity needs to have a unique ID to be registered in the entity registry. An entity needs to have a unique ID to be registered in the entity registry.
Not all integrations currently provide a unique id for their entities. Not all integrations currently provide a unique id for their entities.
</p> </p>
The entity registry is stored in `<config>/entity_registry.yaml`. As a user, The entity registry is stored in `<config>/entity_registry.yaml`. As a user, you are unable to add entries, only update them. Here is an example file:
you are unable to add entries, only update them. Here is an example file:
``` ```yaml
climate.downstairs_virtual: climate.downstairs_virtual:
platform: nest platform: nest
unique_id: EPoMyWkpNyoYu3pGlmGxabcdefghijkl unique_id: EPoMyWkpNyoYu3pGlmGxabcdefghijkl
@ -37,16 +31,13 @@ light.study_ceiling:
disabled_by: user disabled_by: user
``` ```
As a user, you can change the `entity_id` and add the `name` and `disabled_by` As a user, you can change the `entity_id` and add the `name` and `disabled_by`value to each entry.
value to each entry.
- Changing the _first line_ of each entry will change the `entity_id` of the entity throughout Home Assistant.
- Changing the _first line_ of each entry will change the `entity_id` of the entity throughout Home Assistant.
- The value of `name` will override the _friendly name_ of the entity as given by the integration. - The value of `name` will override the _friendly name_ of the entity as given by the integration.
_Added in Home Assistant 0.64._ _Added in Home Assistant 0.64._
- The key `disabled_by` can either be `hass` or `user`. This functionality - The key `disabled_by` can either be `hass` or `user`. This functionality is even more experimental than the whole entity registry itself and might cause integrations to fail and might be removed in the future.
is even more experimental than the whole entity registry itself and might
cause integrations to fail and might be removed in the future.
_Added in Home Assistant 0.64._ _Added in Home Assistant 0.64._