The esp_lvgl_port component does not support esp-idf v5.0 (BSP-718)

[TDA-2030]

Board

ESP32-S3-USB_OTG

Hardware Description

Hardware-independent

IDE Name

VSCode

Operating System

Ubuntu 24

Description

The dependencies for the esp_lvgl_port component show that it supports idf v5.0, but the following error occurs:

[09/17/25 02:35:34] ERROR    /builds/group/esp-iot-solution/examples/usb/host/usb_cdc_4g_module/managed_components/espressif__esp_lvgl_port/src/lvgl9/esp_lvgl_port.c: In function 'lvgl_port_init':
[09/17/25 02:35:34] ERROR    /builds/group/esp-iot-solution/examples/usb/host/usb_cdc_4g_module/managed_components/espressif__esp_lvgl_port/src/lvgl9/esp_lvgl_port.c:90:15: error: implicit declaration of function 'xTaskCreateWithCaps'; did you mean 'xTaskCreateStatic'? [-Werror=implicit-function-declaration]
[09/17/25 02:35:34] ERROR       90 |         res = xTaskCreateWithCaps(lvgl_port_task, "taskLVGL", cfg->task_stack, xTaskGetCurrentTaskHandle(), cfg->task_priority, &lvgl_port_ctx.lvgl_task, caps);
[09/17/25 02:35:34] ERROR          |               ^~~~~~~~~~~~~~~~~~~
[09/17/25 02:35:34] ERROR          |               xTaskCreateStatic
[09/17/25 02:35:34] ERROR    /builds/ae_group/esp-iot-solution/examples/usb/host/usb_cdc_4g_module/managed_components/espressif__esp_lvgl_port/src/lvgl9/esp_lvgl_port.c:92:15: error: implicit declaration of function 'xTaskCreatePinnedToCoreWithCaps'; did you mean 'xTaskCreatePinnedToCore'? [-Werror=implicit-function-declaration]
[09/17/25 02:35:34] ERROR       92 |         res = xTaskCreatePinnedToCoreWithCaps(lvgl_port_task, "taskLVGL", cfg->task_stack, xTaskGetCurrentTaskHandle(), cfg->task_priority, &lvgl_port_ctx.lvgl_task, cfg->task_affinity, caps);
[09/17/25 02:35:34] ERROR          |               ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[09/17/25 02:35:34] ERROR          |               xTaskCreatePinnedToCore
[09/17/25 02:35:34] ERROR    cc1: some warnings being treated as errors
[09/17/25 02:35:34] ERROR    [1668/1676] Building C object esp-idf/espressif__esp32_s3_usb_otg/CMakeFiles/__idf_espressif__esp32_s3_usb_otg.dir/esp32_s3_usb_otg.c.obj
[09/17/25 02:35:34] ERROR    ninja: build stopped: subcommand failed.

Sketch

The example https://github.com/espressif/esp-bsp/tree/master/examples/display

Other Steps to Reproduce

No response

I have checked existing issues, README.md and ESP32 Forum

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[github-actions]

Hi @TDA-2030! 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.

---

Thank you for your detailed report.

Based on the available information, the esp_lvgl_port component currently requires ESP-IDF v5.1.3 or later. Although some documentation and dependency files may suggest compatibility with ESP-IDF v5.0, the use of APIs such as xTaskCreateWithCaps and xTaskCreatePinnedToCoreWithCaps is only supported in ESP-IDF v5.1 and above. These functions are not available in ESP-IDF v5.0, which leads to the build errors you are seeing.

Key points:

• The component registry and BSP documentation for ESP32-S3-USB-OTG both specify ESP-IDF >=5.1.3 as a requirement for the board and its supported components, including esp_lvgl_port.
• The esp_lvgl_port changelog and README do not mention support for ESP-IDF v5.0, and the dependency on newer FreeRTOS APIs confirms this requirement.
• The error you encountered is expected when building with ESP-IDF v5.0, as those task creation APIs do not exist in that version.

Recommendation:
Please upgrade your ESP-IDF version to v5.1.3 or later to use the esp_lvgl_port component and related examples successfully. This will resolve the build errors related to missing FreeRTOS APIs.

If you have further questions or encounter issues after upgrading, please let us know!