esp32_lvgl_driver小缺陷

一月一星辰 / 2024-10-15 / 原文

问题背景

最近在调试一个新屏幕的过程中，使用LVGL官方的lvgl_esp32_driver驱动，在我这个分辨率比较大(454 x 454)的屏幕下会出现，在分配完成buff后，若buff过大会出现，在刷屏的时候会这种警告。

txdata transfer > hardware max supported len

研究了底层代码后发现在spi_master.c文件中，在发送大量数据queue中，会检测一下相关参数。

查看一下这个宏SPI_LL_DMA_MAX_BIT_LEN

[!注意]
这里注意下，这个宏在不同芯片中，体现的是不同的，在esp32s3中是1<<18 ,在esp32中却是1<<24。

这时看下官方的这里的驱动接口：

只调用了一次，所以会将buff中的数据一次性全部发送出去，官方推荐buff为：分辨率宽 x 高 x 1/10 。
约为 454 x 45 x 8 x 2 = 326880。(16bit 像素色彩)
1 << 18 = 262144
远大于判断，所以无法正常刷屏。

如何解决这个问题呢，解决方法很简单那就是分包。把一打包数据分几次发送就可以了。其实esp32官方是对这个问题有一套很好的解决方法。并归入了官方SDK的esp_lcd中，我们只需要根据官方架构编写一套即可。

ESP32_LCD使用

首先官方例程下相关示例，可以在examples/peripherals/lcd/找到。
更多的驱动程序可以通过乐鑫组件注册表获取。
这里我复制一套驱动(GC9A01)并且修改一下初始化代码既可以改写完成。下面介绍一下如何正确的调用。

头文件

#include "esp_lcd_rm69330.h" // 自定义的驱动文件

#include "esp_lcd_panel_io.h"

#include "esp_lcd_panel_vendor.h"

#include "esp_lcd_panel_ops.h"

设备初始化

ESP_LOGI(TAG, "Initialize SPI bus");

spi_bus_config_t buscfg = {

	.sclk_io_num = LV_PIN_NUM_LCD_CLK,

	.mosi_io_num = LV_PIN_NUM_LCD_MOSI,

	.miso_io_num = LV_PIN_NUM_LCD_MISO,

	.quadwp_io_num = -1,

	.quadhd_io_num = -1,

	.max_transfer_sz = SPI_BUS_MAX_TRANSFER_SZ,

};

ESP_ERROR_CHECK(spi_bus_initialize(SPI_LCD_HOST, &buscfg, SPI_DMA_CH_AUTO));



ESP_LOGI(TAG, "Install panel IO");

esp_lcd_panel_io_handle_t io_handle = NULL;

esp_lcd_panel_io_spi_config_t io_config = {

	.dc_gpio_num = LV_PIN_NUM_LCD_DC,

	.cs_gpio_num = LV_PIN_NUM_LCD_CS,

	.pclk_hz = SPI_TFT_CLOCK_SPEED_HZ,

	.lcd_cmd_bits = 8,

	.lcd_param_bits = 8,

	.spi_mode = 0,

	.trans_queue_depth = SPI_TRANSACTION_POOL_SIZE,

	.on_color_trans_done = notify_refresh_ready,

	.user_ctx = &disp_drv,

};



// Attach the LCD to the SPI bus

ESP_ERROR_CHECK(esp_lcd_new_panel_io_spi((esp_lcd_spi_bus_handle_t)SPI_LCD_HOST, &io_config, &io_handle));



esp_lcd_panel_dev_config_t panel_config = {

	.reset_gpio_num = LV_PIN_NUM_LCD_RST,

	.color_space = ESP_LCD_COLOR_SPACE_BGR,

	.bits_per_pixel = 16,

};



ESP_LOGI(TAG, "Install RM69330 panel driver");

ESP_ERROR_CHECK(esp_lcd_new_panel_rm69330(io_handle, &panel_config, &panel_handle));



ESP_ERROR_CHECK(esp_lcd_panel_reset(panel_handle));

ESP_ERROR_CHECK(esp_lcd_panel_init(panel_handle));



ESP_ERROR_CHECK(esp_lcd_panel_invert_color(panel_handle, false));

ESP_ERROR_CHECK(esp_lcd_panel_mirror(panel_handle, true, true));

ESP_ERROR_CHECK(esp_lcd_panel_set_gap(panel_handle, 14, 0));

// user can flush pre-defined pattern to the screen before we turn on the screen or backlight

ESP_ERROR_CHECK(esp_lcd_panel_disp_on_off(panel_handle, true));

其中：

SPI_BUS_MAX_TRANSFER_SZ : 我直接设置为最大 (1<<18)
SPI_TRANSACTION_POOL_SIZE : 50

IRAM_ATTR static bool notify_refresh_ready(esp_lcd_panel_io_handle_t panel_io, esp_lcd_panel_io_event_data_t *edata, void *user_ctx)

{

    lv_disp_drv_t *disp_driver = (lv_disp_drv_t *)user_ctx;

    lv_disp_flush_ready(disp_driver);

    return false;

}

LVGL初始化步骤省略
flush_cb:

static void lvgl_flush_cb(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_map)

{

    esp_lcd_panel_handle_t panel_handle = (esp_lcd_panel_handle_t) drv->user_data;

    int offsetx1 = area->x1;

    int offsetx2 = area->x2;

    int offsety1 = area->y1;

    int offsety2 = area->y2;

    // copy a buffer's content to a specific area of the display

    esp_lcd_panel_draw_bitmap(panel_handle, offsetx1, offsety1, offsetx2 + 1, offsety2 + 1, color_map);

}