Add automation examples to Home Connect (#37671)

* Add automation examples to Home Connect

* Apply suggestions

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
J. Diego Rodríguez Royo 2025-02-25 09:28:01 +01:00 committed by GitHub
parent abc81a9e8e
commit 8c6682d39d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -169,8 +169,79 @@ Changes a setting.
| `key` | no | Key of the setting. | | `key` | no | Key of the setting. |
| `value` | no | Value of the setting. | | `value` | no | Value of the setting. |
## Automation examples
Get started with these automation examples
### Send a notification when the appliance ends the program
{% details "Example YAML configuration" %}
{% raw %}
```yaml
alias: "Notify when program ends"
triggers:
- trigger: state
entity_id:
- sensor.appliance_operation_state
to: finished
actions:
- service: notify.notify
data:
message: "The appliance has finished the program."
```
{% endraw %}
{% enddetails %}
### Start a program when electricity is cheap
Because electricity is typically cheaper at night, this automation will activate the silent mode when starting the program at night.
{% details "Example YAML configuration" %}
{% raw %}
```yaml
alias: "Start program when electricity is cheap"
triggers:
- trigger: state
entity_id: sensor.electricity_price
to: "0.10"
conditions:
- condition: state
entity_id: sensor.diswasher_door
state: closed
actions:
- if:
- condition: time
after: '22:00:00'
before: '06:00:00'
then:
- service: home_connect.set_program_and_options
data:
device_id: "your_device_id"
affects_to: "active_program"
program: "dishcare_dishwasher_program_eco_50"
options:
- key: "dishcare_dishwasher_option_silence_on_demand"
value: true
else:
- service: home_connect.set_program_and_options
data:
device_id: "your_device_id"
affects_to: "active_program"
program: "dishcare_dishwasher_program_eco_50"
```
{% endraw %}
{% enddetails %}
## Data updates ## Data updates
This integration uses server-sent events from the Home Connect API to receive live updates from the appliances. This integration uses server-sent events from the Home Connect API to receive live updates from the appliances.
When the configuration entry is loaded or after a streaming error (for example after disconnection), the integration will request all data (such as appliance info, available commands, programs, settings, and status) for all appliances. When the configuration entry is loaded or after a streaming error (for example after disconnection), the integration will request all data (such as appliance info, available commands, programs, settings, and status) for all appliances.
If a new appliance is added to the account, the integration will request data for the new appliance and expose the related entities automatically. If a new appliance is added to the account, the integration will request data for the new appliance and expose the related entities automatically.