[nextion] Add configurable startup and queue timeout constants #5454
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description:
Makes the Nextion startup override and max queue age constants configurable via YAML, allowing users to tune timing parameters for their specific displays without modifying the code.
Previously, these were hardcoded as
const uint16_t
member variables with 8000ms defaults. Now they are configurable via YAML while maintaining the same memory efficiency through member variable initialization.This documentation supports esphome/esphome#11098, which supersedes and closes #3657, providing a cleaner, user-friendly solution that allows configuration without requiring code modifications or custom builds.
Changes
startup_override_ms
configuration option (default: 8000ms)max_queue_age
configuration option (default: 8000ms)Why?
Different Nextion displays (especially larger ones or those with complex startup sequences) may need longer timeouts. This allows users to optimize these values for their specific hardware without recompiling ESPHome or maintaining custom forks.
Memory Impact
uint16_t
member variables, same as before)Related issue (if applicable):
Pull request in esphome with YAML changes (if applicable):
Checklist:
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.New Component Images
If you are adding a new component to ESPHome, you can automatically generate a standardized black and white component name image for the documentation.
To generate a component image:
Comment on this pull request with the following command, replacing
COMPONENT_NAME
with your component name in UPPER_CASE format with underscores (e.g.,BME280
,SHT3X
,DALLAS_TEMP
):The ESPHome bot will respond with a downloadable ZIP file containing the SVG image.
Extract the SVG file and place it in the
images/
folder of this repository.Use the image in your component's index table entry in
/components/index.rst
.Example: For a component called "DHT22 Temperature Sensor", use: