diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml index 1bd22345711..7502a31d68f 100644 --- a/source/_data/glossary.yml +++ b/source/_data/glossary.yml @@ -275,23 +275,33 @@ The term service has 2 meanings in Home Assistant: **The information service** - E.g. the municipal waste management service that provides entities for organic, paper, and packaging waste. In terms of functionality, the information service is like a device. It is called *service* to avoid confusion, as it does not come with a piece of hardware. + For example, the municipal waste management service that provides entities for organic, paper, and packaging waste. In terms of functionality, the information service is like a device. It is called *service* to avoid confusion, as it does not come with a piece of hardware. **The software function that interacts with targets to make something happen** - A service carries out one specific task: e.g. turning on the light in the living room or sending a notification to a mobile phone. + A service carries out one specific task, for example: turning on the light in the living room or sending a notification to a mobile phone. - A service has targets and data. Service targets are: areas, devices, and entities. Service data carries the information required to define the desired state change in the target. E.g. the target, together with brightness 150 and RGB color `[255,0,0]`, or the message “Your coffee is ready”. + A service has targets and data. Service targets are: areas, devices, and entities. Service data carries the information required to define the desired state change in the target. For example, the target, together with brightness 150 and RGB color `[255,0,0]`, or the message “Your coffee is ready”. Services can be used in, for example, automation, scripts, dashboards, or voice commands to control your home. Home Assistant provides a series of predefined services, such as `homeassistant.turn_on`, `homeassistant.toggle`, or `homeassistant.reload`. excerpt: > - A service carries out one specific task: e.g. turn on the light in the + A service carries out one specific task, for example: turn on the light in the living room. A service has targets and data and can be called by actions, a dashboard, or via voice command. link: /docs/scripts/service-calls/ +- term: State + definition: |- + The state holds the information of interest of an entity. For example, if a light is on or off, the current temperature, or the amount of energy used. The data type of state is `string` (a textual value). Entities store 2 timestamps related to the state: `last_updated` and `last_changed`. Each entity has exactly one state and the state only holds one value at a time. However, entities can store attributes related to that state. For example, the state of a light is _on_, and the related state attributes could be its current brightness and color values. + + State changes can be used as the source of triggers. The current state can be used in conditions. + + link: /docs/scripts/configuration/state_object/ + excerpt: > + The state holds the information of interest of an entity, for example, if a light is on or off. Each entity has exactly one state and the state only holds one value at a time. However, entities can store attributes related to that state such as brightness, color, or a unit of measurement. + - term: Switch definition: >- Switches are things that have two states you can select between, such as @@ -319,7 +329,7 @@ - term: Variables definition: >- Variables are used to store values in memory that can be processed - e.g. in a script. + for example, in a script. link: /docs/scripts/#variables - term: Zone