please add version number

[dannybackx]

Related area

esp_lvgl_port

Hardware specification

esp32s3 board with display

Is your feature request related to a problem?

It's nice that this component is in active development, but when you guys add a field, it's hard to cope without version numbering.
Example : adding task_stack_caps recently screwed up my build.

Describe the solution you'd like

So please add esp_lvgl_port version numbers to some include file.

Describe alternatives you've considered

No response

Additional context

No response

I have checked existing list of Feature requests and the Contribution Guide

• I confirm I have checked existing list of Feature requests and Contribution Guide.

[github-actions]

Hi @dannybackx! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

You’re right that tracking breaking changes is much easier when you can test against a component version in code.

From the available information:

• esp_lvgl_port is published as a managed component on the ESP Component Registry with a clear semantic version (currently 2.7.0 in the registry snapshot). [esp_lvgl_port comp]
• The project maintains a detailed CHANGELOG.md with versioned entries (2.7.1, 2.7.0, 2.6.x, etc.), including the kind of change you mentioned (e.g., new options, behavior changes). [esp_lvgl_port changelog]

However, in the knowledge I have, there is no mention of a public C API macro or header that exposes the esp_lvgl_port version (e.g. something like ESP_LVGL_PORT_VERSION_MAJOR), nor any guidance that such a macro already exists. The docs only show:

• The component’s version in the registry metadata.
• The changelog in the repository.
• That esp_idf_version.h exists for ESP‑IDF itself, but nothing analogous is documented for esp_lvgl_port. [misc system api]

So, based on the current docs:

1. Your request is valid and not yet documented as implemented. There is no documented header with version macros for esp_lvgl_port.

2. Suggested direction for the maintainers (what you can post back in the issue):

   • Add a small header in esp_lvgl_port (for example esp_lvgl_port_version.h) that defines version macros derived from the component’s semantic version, similar in spirit to esp_idf_version.h.

   • Example of what users are asking for (conceptually, not currently present in the codebase as far as the docs show):

     #define ESP_LVGL_PORT_VERSION_MAJOR 2
     #define ESP_LVGL_PORT_VERSION_MINOR 7
     #define ESP_LVGL_PORT_VERSION_PATCH 1
     #define ESP_LVGL_PORT_VERSION_VAL(major, minor, patch) \
         ((major) * 10000 + (minor) * 100 + (patch))
     
     #define ESP_LVGL_PORT_VERSION \
         ESP_LVGL_PORT_VERSION_VAL(ESP_LVGL_PORT_VERSION_MAJOR, \
                                   ESP_LVGL_PORT_VERSION_MINOR, \
                                   ESP_LVGL_PORT_VERSION_PATCH)

   • This would let applications use #if checks to guard against new fields like task_stack_caps and keep older code building cleanly across versions.

3. Current workaround for users (until such a header exists):

   • Pin the component version explicitly in your project’s idf_component.yml, for example:

     dependencies:
       espressif/esp_lvgl_port:
         version: "==2.6.3"

     This ensures that a new field like task_stack_caps will not suddenly appear in your build without you intentionally updating the component. [esp_lvgl_port comp]

Because the existing documentation does not show an in-code version macro, this is best treated as a feature request to add such a header and keep it in sync with the managed component version and CHANGELOG.md.

[dannybackx]

Please note the same appears to be true for esp_lcd_touch .
The current version warns for obsoletion of a function, but we can't put this into source code in a reliable way.

[[deprecated("This API will be removed in version 2.0.0. Use esp_lcd_touch_get_data instead!")]]