"on_bounce_frame_finish" compilation error in esp_lvgl_port after commit 414dba5 in ESP-IDF (BSP-707)

[DemTerritory]

Board

ESP32-S3

Hardware Description

custom board

IDE Name

VSCode

Operating System

Windows 11

Description

The recent commit 414dba5 titled "refactor(lcd)!: remove deprecated types" removed the member on_bounce_frame_finish from the esp_lcd_rgb_panel_event_callbacks_t structure. This removal has introduced a compilation error in the file espressif__esp_lvgl_port/src/lvgl9/esp_lvgl_port_disp.c, which still references the on_bounce_frame_finish callback.

'esp_lcd_rgb_panel_event_callbacks_t' has no member named 'on_bounce_frame_finish'

Sketch

#include "esp_lvgl_port.h"

will trigger the compilation error due to the missing on_bounce_frame_finish member in the esp_lcd_rgb_panel_event_callbacks_t structure.

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 @DemTerritory! 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.

---

The compilation error you are seeing is due to a recent breaking change in ESP-IDF: the on_bounce_frame_finish member has been removed from the esp_lcd_rgb_panel_event_callbacks_t structure. This change was introduced in a refactor commit that removed deprecated types and members, including on_bounce_frame_finish. Your code (or the BSP/library you are using) still references this member, which no longer exists in the latest ESP-IDF.

How to resolve:

• Update your code: Replace any usage of on_bounce_frame_finish in your code with the new callback member. According to the migration guide, the correct replacement is on_frame_buf_complete. This new callback is invoked when a complete frame buffer has been sent to the LCD controller, which covers the use case previously handled by on_bounce_frame_finish ESP-IDF v6.0 Migration Guide - LCD.

• Example fix:

  esp_lcd_rgb_panel_event_callbacks_t cbs = {
      // .on_bounce_frame_finish = ...   // REMOVE this line
      .on_frame_buf_complete = ...      // ADD your callback here
      // other callbacks...
  };

• Update dependencies: If you are using a BSP or library (such as esp_lvgl_port) that has not yet updated to this new API, you will need to either:

  • Update to a newer version of the BSP/library that supports the latest ESP-IDF, or
  • Patch the BSP/library locally to use on_frame_buf_complete instead of on_bounce_frame_finish.

References:

• The migration guide for ESP-IDF v6.0 documents this change and the required code update ESP-IDF v6.0 Migration Guide - LCD.
• The new structure and callback member are described in the ESP-IDF API Reference.

Summary:
Remove all references to on_bounce_frame_finish and use on_frame_buf_complete in your event callbacks structure. This will resolve the compilation error after the breaking change in ESP-IDF.

If you need to support both old and new ESP-IDF versions, you may need to add conditional compilation based on the ESP-IDF version.

[espzav]

Hi @DemTerritory, sorry for late reply. I cannot find specific commit, which you are mentioned. There was made lot of changes and fixes (due to new IDF version). Now, all CI passing and everything should by ok.
Please, could you re-test it?