feat: Use new dma_burst_size member for IDF>=5.3

Author: tore-espressif

SquareLine/boards/v8/custom_waveshare_7inch/components/ws_7inch/idf_component.yml

@@ -1,9 +1,9 @@
-version: "1.0.2"
+version: "1.0.3"
 description: Board Support Package for WaveShare 7inch
 url: https://github.com/espressif/esp-bsp/SquareLine/boards/custom_waveshare_7inch/components/ws_7inch
 
 dependencies:
-  idf: ">=5.0"
+  idf: ">=5.3"
   esp_lcd_ra8875: "^1"
   esp_lcd_touch_gt911: "^1"
   lvgl/lvgl: "^8"

SquareLine/boards/v8/custom_waveshare_7inch/components/ws_7inch/ws_7inch.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: CC0-1.0
  */
@@ -84,8 +84,7 @@ esp_err_t bsp_display_new(const bsp_display_config_t *config, esp_lcd_panel_hand
         },
         .bus_width = BSP_LCD_WIDTH,
         .max_transfer_bytes = (BSP_LCD_H_RES) * 80 * sizeof(uint16_t),
-        .psram_trans_align = 64,
-        .sram_trans_align = 4,
+        .dma_burst_size = 64,
     };
     ESP_RETURN_ON_ERROR(esp_lcd_new_i80_bus(&bus_config, &i80_bus), TAG, "I80 init failed");
 

bsp/esp32_s3_lcd_ev_board/src/bsp_sub_board.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -104,7 +104,7 @@ drift, please enable `ESP32S3_DATA_CACHE_LINE_32B` instead");
         ESP_LOGI(TAG, "Initialize RGB panel");
         esp_lcd_rgb_panel_config_t rgb_conf = {
             .clk_src = LCD_CLK_SRC_PLL160M,
-            .psram_trans_align = 64,
+            .dma_burst_size = 64,
             .data_width = 16,
             .bits_per_pixel = 16,
             .de_gpio_num = BSP_LCD_SUB_BOARD_2_3_DE,
@@ -166,7 +166,7 @@ drift, please enable `ESP32S3_DATA_CACHE_LINE_32B` instead");
         ESP_LOGI(TAG, "Initialize RGB panel");
         esp_lcd_rgb_panel_config_t panel_conf = {
             .clk_src = LCD_CLK_SRC_PLL160M,
-            .psram_trans_align = 64,
+            .dma_burst_size = 64,
             .data_width = 16,
             .bits_per_pixel = 16,
             .de_gpio_num = BSP_LCD_SUB_BOARD_2_3_DE,

components/esp_lvgl_port/examples/rgb_lcd/main/main.c

@@ -1,12 +1,13 @@
 /*
- * SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
 
 #include "esp_err.h"
 #include "esp_log.h"
 #include "esp_check.h"
+#include "esp_idf_version.h"
 #include "driver/i2c.h"
 #include "esp_lcd_panel_io.h"
 #include "esp_lcd_panel_ops.h"
@@ -96,7 +97,11 @@ static esp_err_t app_lcd_init(void)
     ESP_LOGI(TAG, "Initialize RGB panel");
     esp_lcd_rgb_panel_config_t panel_conf = {
         .clk_src = LCD_CLK_SRC_PLL160M,
+#if ESP_IDF_VERSION < ESP_IDF_VERSION_VAL(5, 3, 0)
         .psram_trans_align = 64,
+#else
+        .dma_burst_size = 64,
+#endif
         .data_width = 16,
         .bits_per_pixel = 16,
         .de_gpio_num = EXAMPLE_LCD_GPIO_DE,

components/lcd/esp_lcd_gc9503/README.md

@@ -56,7 +56,7 @@ It's recommended to use the [esp_lcd_panel_io_additions](https://components.espr
     ESP_LOGI(TAG, "Install GC9503 panel driver");
     esp_lcd_rgb_panel_config_t rgb_config = {
         .clk_src = LCD_CLK_SRC_DEFAULT,
-        .psram_trans_align = 64,
+        .dma_burst_size = 64,
         .data_width = 16,
         .bits_per_pixel = 16,
         .de_gpio_num = EXAMPLE_LCD_IO_RGB_DE,

components/lcd/esp_lcd_gc9503/test_apps/main/test_esp_lcd_gc9503.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -13,6 +13,7 @@
 #include "driver/gpio.h"
 #include "esp_heap_caps.h"
 #include "esp_log.h"
+#include "esp_idf_version.h"
 #include "esp_lcd_panel_ops.h"
 #include "esp_lcd_panel_io.h"
 #include "esp_lcd_panel_io_additions.h"
@@ -104,7 +105,11 @@ TEST_CASE("test gc9503 to draw color bar with RGB interface, using GPIO", "[gc95
     ESP_LOGI(TAG, "Install GC9503 panel driver");
     esp_lcd_rgb_panel_config_t rgb_config = {
         .clk_src = LCD_CLK_SRC_DEFAULT,
+#if ESP_IDF_VERSION < ESP_IDF_VERSION_VAL(5, 3, 0)
         .psram_trans_align = 64,
+#else
+        .dma_burst_size = 64,
+#endif
         .data_width = TEST_LCD_DATA_WIDTH,
         .bits_per_pixel = TEST_RGB_BIT_PER_PIXEL,
         .de_gpio_num = TEST_LCD_IO_RGB_DE,
@@ -191,7 +196,11 @@ TEST_CASE("test gc9503 to draw color bar with RGB interface, using IO expander",
     ESP_LOGI(TAG, "Install GC9503 panel driver");
     esp_lcd_rgb_panel_config_t rgb_config = {
         .clk_src = LCD_CLK_SRC_DEFAULT,
+#if ESP_IDF_VERSION < ESP_IDF_VERSION_VAL(5, 3, 0)
         .psram_trans_align = 64,
+#else
+        .dma_burst_size = 64,
+#endif
         .data_width = TEST_LCD_DATA_WIDTH,
         .bits_per_pixel = TEST_RGB_BIT_PER_PIXEL,
         .de_gpio_num = TEST_LCD_IO_RGB_DE,

components/lcd/esp_lcd_ra8875/README.md

@@ -61,8 +61,7 @@ esp_lcd_i80_bus_config_t bus_config = {
     },
     .bus_width = BOARD_DISP_PARALLEL_WIDTH,
     .max_transfer_bytes = (BOARD_DISP_PARALLEL_HRES) * 80 * sizeof(uint16_t),
-    .psram_trans_align = 64,
-    .sram_trans_align = 4,
+    .dma_burst_size = 64,
 };
 ESP_ERROR_CHECK(esp_lcd_new_i80_bus(&bus_config, &i80_bus));
 

components/lcd/esp_lcd_st7796/include/esp_lcd_st7796.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -97,7 +97,7 @@ esp_err_t esp_lcd_new_panel_st7796(const esp_lcd_panel_io_handle_t io, const esp
         .bus_width = data_width,                                                                \
         .max_transfer_bytes = max_trans_bytes,                                                  \
     }
-#else
+#elif ESP_IDF_VERSION < ESP_IDF_VERSION_VAL(5, 3, 0)
 #define ST7796_PANEL_BUS_I80_CONFIG(max_trans_bytes, data_width, dc, wr, d0, d1, d2, d3, d4,    \
                                     d5, d6, d7, d8 , d9, d10, d11, d12, d13, d14, d15)          \
     {                                                                                           \
@@ -112,6 +112,20 @@ esp_err_t esp_lcd_new_panel_st7796(const esp_lcd_panel_io_handle_t io, const esp
         .psram_trans_align = 64,                                                                \
         .sram_trans_align = 4,                                                                  \
     }
+#else
+#define ST7796_PANEL_BUS_I80_CONFIG(max_trans_bytes, data_width, dc, wr, d0, d1, d2, d3, d4,    \
+                                    d5, d6, d7, d8 , d9, d10, d11, d12, d13, d14, d15)          \
+    {                                                                                           \
+        .clk_src = LCD_CLK_SRC_PLL160M,                                                         \
+        .dc_gpio_num = dc,                                                                      \
+        .wr_gpio_num = wr,                                                                      \
+        .data_gpio_nums = {                                                                     \
+            d0, d1, d2, d3, d4, d5, d6, d7, d8 , d9, d10, d11, d12, d13, d14, d15               \
+        },                                                                                      \
+        .bus_width = data_width,                                                                \
+        .max_transfer_bytes = max_trans_bytes,                                                  \
+        .dma_burst_size = 64,                                                                   \
+    }
 #endif
 
 /**