mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-07-14 12:56:30 +00:00
Add blog post about configuration URL and entity categories (#1108)
Co-authored-by: Franck Nijhof <git@frenck.dev> Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
This commit is contained in:
parent
54d9d084a7
commit
f1bf2f67e8
35
blog/2021-10-26-config-entity.md
Normal file
35
blog/2021-10-26-config-entity.md
Normal file
@ -0,0 +1,35 @@
|
||||
---
|
||||
author: Erik Montnémery
|
||||
authorURL: https://github.com/emontnemery
|
||||
title: "Device configuration URL and entity categories"
|
||||
---
|
||||
|
||||
Home Assistant Core 2021.11 introduces two new concepts to make managing devices easier,
|
||||
device configuration URL and entity categories.
|
||||
|
||||
### Device configuration URL
|
||||
|
||||
It's now possible to provide a configuration_url as part of the device registry information.
|
||||
The configuration_url is used in the device card to allow the user to visit the device
|
||||
for configuration or diagnostics which is not available in Home Assistant.
|
||||
Note that the URL linked to is not proxied by Home Assistant, so this typically won't work
|
||||
when connecting to Home Assistant remotely.
|
||||
|
||||
[](/img/en/blog/2021-10-26-config-entity/configuration_url.png)
|
||||
|
||||
### Entity categories
|
||||
|
||||
Entities now have an optional property `entity_category` for classifying non-primary
|
||||
entities. Set to `config` for entities that allow changing the configuration of a device,
|
||||
for example, a switching entity making it possible to turn the background illumination of a
|
||||
switch on and off. Set to `diagnostic` for an entity exposing some configuration parameter
|
||||
or diagnostics of a device but does not allow changing it, for example, a sensor showing
|
||||
RSSI or MAC address with allowed values.
|
||||
|
||||
Entities which have the `entity_category` set:
|
||||
- Are not included in a service call targetting a whole device or area.
|
||||
- Are, by default, not exposed to Google Assistant or Alexa.
|
||||
- Are shown on a separate card on the device configuration page.
|
||||
- Do not show up on the automatically generated Lovelace Dashboards.
|
||||
|
||||
[](/img/en/blog/2021-10-26-config-entity/entity_categories.png)
|
Binary file not shown.
After Width: | Height: | Size: 9.8 KiB |
Binary file not shown.
After Width: | Height: | Size: 21 KiB |
Loading…
x
Reference in New Issue
Block a user