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-13 20:36:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Remove deprecation warnings from 0.42 (#11861)

Browse Source
This commit is contained in:
Franck Nijhof 2020-01-24 18:09:46 +01:00 committed by GitHub
parent 627608ab2d
commit b88030871b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 28 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -22,12 +22,6 @@ automation:
mood: happy mood: happy
``` ```
<div class='note warning'>
Starting 0.42, it is no longer possible to listen for event `homeassistant_start`. Use the 'homeassistant' platform below instead.
</div>
### Home Assistant trigger ### Home Assistant trigger
Triggers when Home Assistant starts up or shuts down. Triggers when Home Assistant starts up or shuts down.

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

@ -8,62 +8,49 @@ The core of Home Assistant is the event bus. The event bus allows any integratio
Home Assistant contains a few built-in events that are used to coordinate between various components. Home Assistant contains a few built-in events that are used to coordinate between various components.
### Event `homeassistant_start`
Event `homeassistant_start` is fired when all integrations from the configuration have been initialized. This is the event that will start the timer firing off `time_changed` events.
<div class='note warning'>
Starting 0.42, it is no longer possible to listen for event `homeassistant_start`. Use the 'homeassistant' [platform](/docs/automation/trigger) instead.
</div>
### Event `homeassistant_stop`
Event `homeassistant_stop` is fired when Home Assistant is shutting down. It should be used to close any open connection or release any resources.
### Event `state_changed` ### Event `state_changed`
Event `state_changed` is fired when a state changes. Both `old_state` and `new_state` are state objects. [Documentation about state objects.](/topics/state_object/) Event `state_changed` is fired when a state changes. Both `old_state` and `new_state` are state objects. [Documentation about state objects.](/topics/state_object/)
Field | Description | Field | Description |
----- | ----------- | ----------- | --------------------------------------------------------------------------------------------------- |
`entity_id` | Entity ID of the changed entity. Example: `light.kitchen` | `entity_id` | Entity ID of the changed entity. Example: `light.kitchen` |
`old_state` | The previous state of the entity before it changed. This field is omitted if the entity is new. | `old_state` | The previous state of the entity before it changed. This field is omitted if the entity is new. |
`new_state` | The new state of the entity. This field is omitted if the entity is removed from the state machine. | `new_state` | The new state of the entity. This field is omitted if the entity is removed from the state machine. |
### Event `time_changed` ### Event `time_changed`
Event `time_changed` is fired every second by the timer and contains the current time. Event `time_changed` is fired every second by the timer and contains the current time.
Field | Description | Field | Description |
----- | ----------- | ----- | ---------------------------------------------------------------------------------------------------------------------------- |
`now` | A [datetime object](https://docs.python.org/3.4/library/datetime.html#datetime.datetime) containing the current time in UTC. | `now` | A [datetime object](https://docs.python.org/3.4/library/datetime.html#datetime.datetime) containing the current time in UTC. |
### Event `service_registered` ### Event `service_registered`
Event `service_registered` is fired when a new service has been registered within Home Assistant. Event `service_registered` is fired when a new service has been registered within Home Assistant.
Field | Description | Field | Description |
----- | ----------- | --------- | ---------------------------------------- |
`domain` | Domain of the service. Example: `light`. | `domain` | Domain of the service. Example: `light`. |
`service` | The service to call. Example: `turn_on` | `service` | The service to call. Example: `turn_on` |
### Event `call_service` ### Event `call_service`
Event `call_service` is fired to call a service. Event `call_service` is fired to call a service.
Field | Description | Field | Description |
----- | ----------- | ----------------- | ------------------------------------------------------------------------------ |
`domain` | Domain of the service. Example: `light`. | `domain` | Domain of the service. Example: `light`. |
`service` | The service to call. Example: `turn_on` | `service` | The service to call. Example: `turn_on` |
`service_data` | Dictionary with the service call parameters. Example: `{ 'brightness': 120 }`. | `service_data` | Dictionary with the service call parameters. Example: `{ 'brightness': 120 }`. |
`service_call_id` | String with a unique call id. Example: `23123-4`. | `service_call_id` | String with a unique call id. Example: `23123-4`. |
### Event `service_executed` ### Event `service_executed`
Event `service_executed` is fired by the service handler to indicate the service is done. Event `service_executed` is fired by the service handler to indicate the service is done.
Field | Description | Field | Description |
----- | ----------- | ----------------- | ----------------------------------------------------------------------------------------- |
`service_call_id` | String with the unique call id of the service call that was executed. Example: `23123-4`. | `service_call_id` | String with the unique call id of the service call that was executed. Example: `23123-4`. |
<div class='note warning'> <div class='note warning'>
@ -75,15 +62,15 @@ Field | Description
Event `platform_discovered` is fired when a new platform has been discovered by the [`discovery`](/integrations/discovery/) component. Event `platform_discovered` is fired when a new platform has been discovered by the [`discovery`](/integrations/discovery/) component.
Field | Description | Field | Description |
----- | ----------- | ------------ | ------------------------------------------------------------------------------------------------ |
`service` | The platform that is discovered. Example: `zwave`. | `service` | The platform that is discovered. Example: `zwave`. |
`discovered` | Dictionary containing discovery information. Example: `{ "host": "192.168.1.10", "port": 8889}`. | `discovered` | Dictionary containing discovery information. Example: `{ "host": "192.168.1.10", "port": 8889}`. |
### Event `component_loaded` ### Event `component_loaded`
Event `component_loaded` is fired when a new integration has been loaded and initialized. Event `component_loaded` is fired when a new integration has been loaded and initialized.
Field | Description | Field | Description |
----- | ----------- | ----------- | --------------------------------------------------------------------------- |
`component` | Domain of the integration that has just been initialized. Example: `light`. | `component` | Domain of the integration that has just been initialized. Example: `light`. |