ESP32 RGB LVGL

### ESP32 使用 RGB 和 LVGL 的教程

#### 创建项目并配置环境
为了在 ESP32 上使用 LVGL 并支持 RGB 接口，需先创建一个新的 esp-idf 项目。假设已经安装好 esp-idf 工具链，在命令行中执行如下操作：

cd esp-idf-v4.2/examples/
mkdir lvgl && cd lvgl
git clone --recurse-submodules https://github.com/lvgl/lv_port_esp32.git .

此过程会下载适用于 ESP32 的 LVGL 移植版本及其依赖项[^1]。

#### 配置显示参数
对于基于 ILI9488 芯片的显示屏，需要调整 `components/lvgl_esp32_drivers/lvgl_helpers.h` 文件中的分辨率设置以及 SPI 主机数量的最大值:

#define SPI_HOST_MAX 3
#ifdef CONFIG_LV_DISPLAY_ORIENTATION_PORTRAIT
    #define LV_HOR_RES_MAX 128
    #define LV_VER_RES_MAX 160
#else
    #define LV_HOR_RES_MAX 160
    #define LV_VER_RES_MAX 128
#endif

这些修改确保了屏幕能够按照预期方向正确渲染图像，并指定了最大可用的 SPI 总线数为 3 条[^2]。

#### 初始化 RGB 显示屏
针对 RGB 类型的显示器初始化工作通常涉及指定颜色格式、像素时钟频率以及其他硬件特性。下面是一个简单的 C 函数用于完成这一任务：

#include "driver/spi_master.h"
#include "lvgl/lvgl.h"

void init_rgb_display(void){
    static spi_device_handle_t spi;
    
    // 设置SPI通信模式和其他必要选项...
    spi_bus_config_t buscfg = {
        .mosi_io_num=GPIO_NUM_23,
        .miso_io_num=-1,
        .sclk_io_num=GPIO_NUM_18,
        .quadwp_io_num=-1,
        .quadhd_io_num=-1
    };
    
    spi_device_interface_config_t devcfg={
        .command_bits = 0,
        .address_bits = 0,
        .dummy_bits = 0,
        .mode = 0,
        .duty_cycle_pos = 0,
        .cs_ena_pretrans = 0,
        .cs_ena_posttrans = 0,
        .clock_speed_hz = 27 * 1000 * 1000,  
        .input_delay_ns = 0,
        .spics_io_num = GPIO_NUM_5,
        .flags = 0,
        .queue_size = 7,
        .pre_cb = NULL,
        .post_cb = NULL,
    };

    // 安装驱动程序并与特定设备关联起来
    spi_bus_initialize(VSPI_HOST,&buscfg,NULL);
    spi_bus_add_device(VSPI_HOST,&devcfg,&spi);

    // 进一步配置LVGL以适应RGB接口的具体需求
    disp_drv_t drv;
    memset(&drv, 0, sizeof(drv));
    drv.disp_flush = my_disp_flush; // 自定义刷新函数实现
    lv_disp_drv_register(&drv);      // 注册到LVGL框架内
    
}

上述代码片段展示了如何通过 SPI 协议连接至外部 RGB 屏幕，并将其集成进 LVGL 库以便后续图形绘制调用。