From a9b5cfb9f122058b05bb57ed0a944ea6cdd2927d Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 12 Sep 2024 12:19:38 +0200 Subject: [PATCH] Event entity: add section heading for state (#2315) * Lawn-mower: rename activity to state to streamline terminology * Undo unrelated changes --- docs/core/entity/event.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/core/entity/event.md b/docs/core/entity/event.md index bc693cfc..d352a3e6 100644 --- a/docs/core/entity/event.md +++ b/docs/core/entity/event.md @@ -5,12 +5,14 @@ sidebar_label: Event 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 entity captures these events in the physical world and makes them available in Home Assistant as an entity. +An event entity is derived from the [`homeassistant.components.event.EventEntity`](https://github.com/home-assistant/core/blob/dev/homeassistant/components/event/__init__.py). + +## States + The event entity is stateless, meaning you don't have to maintain a state. Instead, you can trigger an event when something in the physical world happens. Home Assistant will keep track of the last event that was emitted and will show that as the current state of the entity. The main state of the entity is the timestamp of when the last event was emitted, additionally the type of the event and optionally extra state data that was provided with the event are also kept track of. -An event entity is derived from the [`homeassistant.components.event.EventEntity`](https://github.com/home-assistant/core/blob/dev/homeassistant/components/event/__init__.py). - ## Properties :::tip