jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Explain that event and event entity are not the same (#34574)

Browse Source 
* Explain that event and event entity are not the same

* Implement review feedback

* Fix typo

* Update source/_docs/configuration/events.markdown

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>

---------

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
This commit is contained in:
c0ffeeca7 2024-09-05 13:10:47 +02:00 committed by GitHub
parent 00fa27f456
commit 41369ba4bc
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
source/_docs/automation/trigger.markdown
View File

@ -85,7 +85,7 @@ automation:
## Event trigger
Fires when an {% term event %} is being received. Events are the raw building blocks of Home Assistant. You can match events on just the event name or also require specific event data or context to be present.
An event trigger fires when an [event](/docs/configuration/events/) is being received. Events are the raw building blocks of Home Assistant. You can match events on just the event name or also require specific event data or context to be present.
Events can be fired by integrations or via the API. There is no limitation to the types. A list of built-in events can be found [here](/docs/configuration/events/).

8
source/_docs/configuration/events.markdown
View File

@ -8,11 +8,13 @@ related:
title: Event integration
---
The core of Home Assistant is the event bus. The event bus allows any integration to fire or listen for events. It is the core of everything.
The core of Home Assistant is the event bus. The event bus allows any integration to fire or listen for events.
For example, any state change will be announced on the event bus as a `state_changed` event containing the previous and the new state of an entity.
## Events and state changes
Home Assistant contains a few built-in events that are used to coordinate between various integrations.
All {% term entities %} produce state change events. Every time a {% term state %} changes, a state change event is produced. State change events are just one type of event on the event bus, but there are other kinds of events, such as the [built-in events](#built-in-events-core) that are used to coordinate between various integrations. State change events are not to be confused with the [event entity](/integrations/event/). This is a specific type of entity, that itself produces event state changes, just like all other entities.
Any state change will be announced on the event bus as a `state_changed` event, containing the previous and the new state of an entity.
## Common fields

2
source/_integrations/event.markdown
View File

@ -20,6 +20,8 @@ related:
Events are signals that are emitted when something happens, for example, when a user presses a physical button like a doorbell or when a button on a remote control is pressed.
The **Event** {% term integration %} provides {% term entities %} that trigger state change events, as do all other entity integrations.
These events do not capture a state in the traditional sense. For example, a doorbell does not have a state such as "on" or "off" but instead is momentarily pressed. Some events can have variations in the type of event that is emitted. For example, maybe your remote control is capable of emitting a single press, a double press, or a long press.
The event entity can capture these events in the physical world and makes them available in Home Assistant as an entity.