Update glossary entry on entity (#26641)

This commit is contained in:
c0ffeeca7 2023-03-17 10:23:21 +01:00 committed by GitHub
parent 44439f07af
commit 218b07067a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -107,18 +107,27 @@
It is often shown as the first part (before the dot) of entity IDs.
- term: Entity
definition: >-
An entity is the representation of a single control or data point of a
device or service inside Home Assistant. A single device or service can
thus provide multiple entities to be able to monitor and control all
features a device provides. For example, a combined temperature and
humidity sensor, in general, provides two `sensor` entities. One for the
temperature (e.g., `sensor.temperature` with state `21.0` and unit `°C`)
and one for the humity
(e.g., `sensor.humidity` with state `65.4` and unit `%`).
definition: |-
An entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. Entities have states.
**Example for entities as part of a device**
A combined temperature and humidity sensor device provides two sensor entities. One for temperature (e.g. `sensor.temperature` with state `21.0` and unit `°C`) and one for humidity
(e.g. `sensor.humidity` with state `65.4` and unit `%`).
**Example for entities as part of a service**
A weather service that provides 3 entities: wind speed, air pressure, and ozon level.
**Example of an entity used for control**
A fan that is turned on when the temperature exceeds 30 °C.
There are standardized types of entities for common integrations such as light, switch, camera, sensor, fan, or vacuum.
Some entities are not part of a device or service. Examples of standalone entities are automation, script, scene entities, and helper entities (e.g. input helpers).
Most properties of entities are related to the state. Entities have optional attributes such as friendly name, unit of measurement, and an icon or picture that can be displayed in the frontend.
link: /docs/configuration/state_object/
excerpt: >
An entity is the representation of a single control or data point of a
device or service inside Home Assistant.
An entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service.
- term: Event
definition: >-