esphome-docs icon indicating copy to clipboard operation
esphome-docs copied to clipboard
verified publisher icon esphome

light: document transition_state_publish_interval guidance

Open nohat opened this issue 1 month ago • 1 comments

Description:

Add documentation for the new transition_state_publish_interval option on the light component.

This PR:

  • Documents the new transition_state_publish_interval light configuration option and how 0s vs >0 intervals affect when state is published during transitions and flashes.
  • Explains that shorter intervals increase API/MQTT traffic and CPU load.
  • Provides guidance based on hardware-in-the-loop testing on an ESP8266-class Athom E27 15W (ESP8285) bulb, noting that:
    • Intervals below ~150ms rarely produce smoother visible transitions but can generate a large number of publishes and push the device near its CPU limits.
    • Intervals in the 200–250ms range (≈4–5 Hz) are a good default on ESP8266-class devices, balancing smoothness and overhead.

These documentation changes introduce and describe the new transition_state_publish_interval feature added in the linked core ESPHome PR, and provide guidance to help users choose practical values for transition_state_publish_interval.

Related issue (if applicable): fixes

Pull request in esphome with YAML changes (if applicable):

  • esphome/esphome#11968

Checklist:

  • [x] I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • [ ] I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • [ ] Link added in /components/index.rst when creating new documents for new components or cookbook.

nohat avatar Nov 19 '25 03:11 nohat

Deploy Preview for esphome ready!

Name Link
Latest commit b4b8827928e1039d4853faf21f1841e9c073d20a
Latest deploy log https://app.netlify.com/projects/esphome/deploys/691d40667cca930008730a92
Deploy Preview https://deploy-preview-5645--esphome.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify[bot] avatar Nov 19 '25 03:11 netlify[bot]