mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-29 12:17:01 +00:00
Update definition of service (#26660)
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
parent
48c197aaa6
commit
661c11d341
@ -109,14 +109,14 @@
|
|||||||
- term: Entity
|
- term: Entity
|
||||||
definition: |-
|
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.
|
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**
|
**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
|
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 `%`).
|
(e.g. `sensor.humidity` with state `65.4` and unit `%`).
|
||||||
|
|
||||||
**Example for entities as part of a service**
|
**Example for entities as part of a service**
|
||||||
A weather service that provides 3 entities: wind speed, air pressure, and ozon level.
|
A weather service that provides 3 entities: wind speed, air pressure, and ozon level.
|
||||||
|
|
||||||
**Example of an entity used for control**
|
**Example of an entity used for control**
|
||||||
A fan that is turned on when the temperature exceeds 30 °C.
|
A fan that is turned on when the temperature exceeds 30 °C.
|
||||||
|
|
||||||
@ -271,8 +271,25 @@
|
|||||||
link: /docs/blueprint/selectors/
|
link: /docs/blueprint/selectors/
|
||||||
|
|
||||||
- term: Service
|
- term: Service
|
||||||
definition: >-
|
definition: |-
|
||||||
Services are called to perform actions.
|
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.
|
||||||
|
|
||||||
|
**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 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”.
|
||||||
|
|
||||||
|
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
|
||||||
|
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/
|
link: /docs/scripts/service-calls/
|
||||||
|
|
||||||
- term: Switch
|
- term: Switch
|
||||||
|
Loading…
x
Reference in New Issue
Block a user