Explain the custom polling (#31265)

* Update define_custom_polling.md

* Update source/_includes/common-tasks/define_custom_polling.md

Co-authored-by: Franck Nijhof <git@frenck.dev>

* Update source/_includes/common-tasks/define_custom_polling.md

Co-authored-by: Franck Nijhof <git@frenck.dev>

* tweaks

* Move intro from reuse topic to common tasks

- the rational does not need to be shown in every integration where the tasks is reused
- slight rephrase of the intro section

* Reduce redundancy

* Tweak

* Rephrase

---------

Co-authored-by: Franck Nijhof <git@frenck.dev>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: c0ffeeca7 <k0ffeeka7@gmail.com>
This commit is contained in:
Joost Lekkerkerker 2024-02-08 10:37:42 +01:00 committed by GitHub
parent 7b20660849
commit f2b0604715
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 10 additions and 1 deletions

View File

@ -1,6 +1,8 @@
If you want to define a specific interval at which your device is being polled for data, you can disable the default polling interval and create your own polling service.
If you want to define a specific interval at which your device is being polled for data, you can disable the default polling interval and create your own polling automation.
To add the automation:
1. Go to {% my integrations title="**Settings** > **Devices & Services**" %}, and select your integration.
2. On the integration entry, select the three dots.

View File

@ -9,4 +9,11 @@ This section provides tasks that do not depend on a specific Home Assistant inst
## Defining a custom polling interval
Creating an automation for polling gives you more flexibility on when to poll.
Why use an automation instead of changing the integration's configuration for polling?
1. Not all integrations have a configurable polling interval. The homassistant.update_entity service on the other hand works with most of the integrations, no code changes required.
2. An automation allows you to poll whenever you want. For example, if you have a rate-limited solar panel provider with a maximum number of requests per day, you may want to lower/stop the polling at night but poll more frequently during the day.
{% include common-tasks/define_custom_polling.md %}