Update definition of service (#26660)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
c0ffeeca7 2023-03-20 12:21:21 +01:00 committed by GitHub
parent 48c197aaa6
commit 661c11d341
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -271,8 +271,25 @@
link: /docs/blueprint/selectors/
- term: Service
definition: >-
Services are called to perform actions.
definition: |-
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/
- term: Switch