1）实验平台：正点原子ESP32S3开发板
2）购买链接：https://detail.tmall.com/item.htm?id=768499342659
3）全套实验源码+手册+视频下载地址：http://www.openedv.com/thread-347618-1-1.html
4）正点原子官方B站：https://space.bilibili.com/394620890
5）正点原子手把手教你学ESP32S3快速入门视频教程：https://www.bilibili.com/video/BV1sH4y1W7Tc
6）正点原子FPGA交流群：132780729
第三十三章 RGB显示屏实验
ESP32-S3的LCD_CAM控制器由独立的LCD模块和Camera模块组成。LCD模块主要用于发送并行视频数据信号，支持多种接口时序，如RGB、MOTO6800和I8080。而Camera模块则用于接收并行视频数据信号，支持DVP 8-/16-bit模式。在本章节中，我们将首先介绍正点原子的RGBLCD显示屏的参数和功能参数，然后详细介绍LCD_CAM控制器的LCD模块，该模块用于驱动RGBLCD接口。
本章分为如下几个小节：
33.1 RGBLCD和LCD模块接口简介
33.2 硬件设计
33.3 程序设计
33.4 下载验证
33.1 RGBLCD和LCD模块接口简介
33.1.1 RGBLCD简介
RGBLCD是基于一组特定的同步信号，该同步信号指示在哪里开始和停止帧。帧缓冲区分配在ESP侧。因为在这种情况下我们不需要安装任何IO接口驱动程序，所以这使得驱动程序的安装步骤极大简化了。接下来我们就简单介绍一些RGBLCD的驱动。
1，RGBLCD的信号线
RGBLCD的信号线如表33.1.1.1所示：
表33.1.1.1 RGBLCD信号线
一般的RGB屏都有如表33.1.1.1所示的信号线，有24根颜色数据线（RGB各8根，即RGB888格式），这样可以表示最多1600W色，DE、VS、HS和DCLK，用于控制数据传输。
2，RGBLCD的驱动模式
RGB屏一般有2种驱动模式：DE模式和HV模式。DE模式使用DE信号来确定有效数据（DE为高/低时，数据有效），而HV模式，则需要行同步和场同步，来表示扫描的行和列。
DE模式和HV模式的行扫描时序图（以800*480的LCD面板为例），如图33.1.1.1所示：
图33.1.1.1 DE/HV模式行扫描时序图
从图中可以看出，DE和HV模式，时序基本一样，DEN模式需要提供DE信号（DEN），而HV模式，则无需DE信号。图中的HSD即HS信号，用于行同步，注意：在DE模式下面，是可以不用HS信号的，即不接HS信号，液晶照样可以正常工作。
图中的thpw为水平同步有效信号脉宽，用于表示一行数据的开始；thb为水平后廊，表示从水平有效信号开始，到有效数据输出之间的像素时钟个数；thfp为水平前廊，表示一行数据结束后，到下一个水平同步信号开始之前的像素时钟个数。
图33.1.1.1仅是一行数据的扫描，输出800个像素点数据，而液晶面板总共有480行，这就还需要一个垂直扫描时序图，如图33.1.1.2所示：
图33.1.1.2 垂直扫描时序图
图中的VSD就是垂直同步信号，HSD就是水平同步信号，DE为数据使能信号。如图可知，一个垂直扫描，刚好就是480个有效的DE脉冲信号，每一个DE时钟周期，扫描一行，总共扫描480行，完成一帧数据的显示。这就是800*480的LCD面板扫描时序，其他分辨率的LCD面板，时序类似。
图中的tvpw为垂直同步有效信号脉宽，用于表示一帧数据的开始；tvb为垂直后廊，表示垂直同步信号以后的无效行数，tvfp为垂直前廊，表示一帧数据输出结束后，到下一个垂直同步信号开始之前的无效行数；这几个时间同样在配置LTDC的时候，需要进行设置。
3，正点原子 RGBLCD模块
正点原子目前提供大家五款 RGBLCD 模块：ATK-4342（4.3寸，480*272）、ATK-4384（4.3寸，800*480） ATK-7084（7寸，800*480）、 ATK-7016（7 寸，1024*600）和ATK-1018（10.1 寸，1280*800），这里我们以 ATK-7084 为例，给大家介绍。该模块的接口原理图如图 33.1.1.3 所示：
图33.1.1.3 RGBLCD模块对外接口原理图
图中 J3就是对外接口，是一个 40PIN 的 FPC 座（ 0.5mm 间距），通过 FPC 线，可以连接到ESP32-S3 开发板的RGB接口上面，从而实现和ESP32-S3的连接。该接口十分完善，采用 RGB888 格式，并支持 DE&HV 模式，还支持触摸屏（电阻/电容）和背光控制。右侧的几个电阻，并不是都焊接的，而是可以用户自己选择。默认情况， R1 和 R6 焊接，设置 LCD_LR和 LCD_UD，控制 LCD 的扫描方向，是从左到右，从上到下（横屏看）。而 LCD_R7/G7/B7 则用来设置 LCD 的 ID，由于 RGBLCD 没有读写寄存器，也就没有所谓的 ID，这里我们通过在模块上面，控制 R7/G7/B7 的上/下拉，来自定义 LCD 模块的 ID，帮助 MCU 判断当前 LCD 面板的分辨率和相关参数，以提高程序兼容性。这几个位的设置关系如表 33.1.1.2 所示：
表33.1.1.2正点原子 RGBLCD模块ID对应关系
这样我们在程序里面，读取 LCD_R7/G7/B7，得到 M0:M2 的值，从而判断 RGBLCD 模块的型号，并执行不同的配置，即可实现不同 LCD模块的兼容。
更详细的RGB屏相关内容，可以参考正点原子提供的《ATK-MD0430R模块用户手册_V1.0》和《ATK-MD0430R模块使用说明_V1.0》，在这两个手册中，已经详细说明了RGB的工作原理及相关参数信息。
33.1.2 LCD模块接口简介
本小节主要介绍LCD_CAM控制器的LCD模块，至于CAMERA模块讲解，作者会在摄像头章节中涉及，下面我们来看一下LCD模块的结构框架。
图33.1.2.1 LCD_CAM控制器结构框架
这个系统的LCD模块（即上图的下方部分）包括以下模块：一个独立的发送控制单元（LCD_Ctrl），用于控制LCD的发送；一个发送异步FIFO（Async Tx FIFO），用于与外部设备交互，发送数据；一个LCD_Clock Generator时钟生成模块，用于生成对应模块的时钟；以及一个格式转换模块，即RGB/YCbCr Converter，用于各种格式的视频数据互相转换。这些模块协同工作，确保系统能够高效、稳定地处理和传输并行视频数据信号。
需要读者注意的是：LCD_CAM的所有信号均需要经过GPIO交换矩阵映射到芯片管脚。更多信息请参考章节6 IO MUX和GPIO 交换矩阵（GPIO, IO MUX）。
1，LCD模块信号描述
LCD模块信号对应了上图右下角的几个信号，它们的具体作用如下所示。
表33.1.2.1 LCD模块信号描述
在启动LCD模块时，信号的位宽是一个关键参数。根据所接入的LCD的位宽，N的值会有所不同。如果使用RGBLCD接口连接，并且位宽为16位，则N的值为15。相反，如果接入的LCD使用8位的位宽，则N的值为7。因此，根据LCD的位宽，可以确定N的具体值。
2，LCD时钟选择
从上图可以清晰地看到，LCD模块的时钟由三个不同的时钟源提供，它们分别是XTAL_CLK、PLL_D2_CLK和PLL_F160M_CLK。LCD模块的时钟源选择模式是由寄存器LCD_CAM_LCD_CLOCK_REG中的LCD_CAM_LCD_CLK_SEL位决定的。最后，LCD_Clock Generator时钟生成模块负责生成LCD模块所需的时钟，即上图中的LCD_CLK。
下图是LCD时钟选择与计算框图。
图33.1.2.2 LCD时钟选择与计算框图
LCD_CLK 的频率 fLCD_CLK 与分频器时钟源频率 fLCD_CLK_S 间的关系如下：
其中，2<=N<=256，N对应为LCD_CAM_LCD_CLOCK_REG寄存器中LCD_CAM_LCD_CLKM_DIV_NUM的值。LCD模块的像素时钟PCLK为LCD_PCLK信号，由LCD_CLK分频获得。计算公式如下：
其中，MO由寄存器LCD_CAM_LCD_CLK_EQU_SYSCLK和LCD_CAM_LCD_CLKCNT_N决定。最终我们得到了LCD_PCLK时钟，该时钟经过分频得到了像素时钟 LCD_PCLK。
如果读者想了解更多的LCD模块知识，可参考《esp32-s3_technical_reference_manual_cn.pdf》技术手册29章节内容。
33.2 硬件设计
33.2.1 例程功能
本章实验功能简介：本实验利用ESP32-S3开发板的RGB接口来驱动RGB屏，RGBLCD模块的接口在核心板上，通过40P的FPC排线连接RGBLCD模块，实现RGBLCD模块的驱动和显示，下载成功后，按下复位之后，就可以看到RGBLCD模块不停的显示一些信息并不断切换底色。同时，屏幕上会显示LCD的ID。需要注意的是：DNESP32S3开发板的RGB例程仅支持4.3寸的RGB显示屏。
33.2.2 硬件资源
1. LED灯
LED-IO1
2. XL9555
IIC_SDA-IO41
IIC_SCL-IO42
3. RGBLCD
LCD_BL-IO1_3（XL9555）
LCD_DE-IO4
LCD_VSYNC-NC
LCD_HSYNC-NC
LCD_PCLK-IO5
LCD_R3-IO45
LCD_R4-IO48
LCD_R5-IO47
LCD_R6-IO21
LCD_R7-IO14
LCD_G2-IO10
LCD_G3-IO9
LCD_G4-IO46
LCD_G5-IO3
LCD_G6-IO8
LCD_G7-IO18
LCD_B3-IO17
LCD_B4-IO16
LCD_B5-IO15
LCD_B6-IO7
LCD_B7-IO6
33.2.3 原理图
RGB接口与ESP32-S3的连接关系，如下图所示：
图33.2.3.1 RGB接口与ESP32-S3的连接电路图
33.3 程序设计
33.3.1 程序流程图
程序流程图能帮助我们更好的理解一个工程的功能和实现的过程，对学习和设计工程有很好的主导作用。下面看看本实验的程序流程图：
图33.3.1.1 RGB实验程序流程图
33.3.2 RGB-LCD函数解析
ESP-IDF提供了一套API来配置RGB。要使用此功能，需要导入必要的头文件：
- #include "esp_lcd_panel_ops.h"
- #include "esp_lcd_panel_rgb.h"
1，创建RGB对象
该函数通过配置结构体参数的方式将参数以指针的方式传进，该函数原型如下所示：
- esp_err_t esp_lcd_new_rgb_panel(const esp_lcd_rgb_panel_config_t
- *rgb_panel_config,
- esp_lcd_panel_handle_t *ret_panel);
表33.3.2.1 esp_lcd_new_rgb_panel()函数形参描述
该函数的返回值描述，如下表所示：
表33.3.2.2 函数esp_lcd_new_rgb_panel ()返回值描述
该函数使用esp_lcd_rgb_panel_config_t类型的结构体变量传入，该结构体的定义如下：
表33.3.2.3 esp_lcd_rgb_panel_config_t结构体参数值描述
完成上述结构体参数配置之后，可以将结构传递给 esp_lcd_new_rgb_panel () 函数，用以实例化RGB。
2，复位RGB屏幕
在创建RGB屏幕对象后需要进行RGB屏幕复位，该函数原型如下所示：
- esp_err_t esp_lcd_panel_reset(esp_lcd_panel_handle_t panel);
表33.3.2.4 esp_lcd_panel_reset ()函数形参描述
该函数的返回值描述，如下表所示：
表33.3.2.5 函数esp_lcd_panel_reset ()返回值描述
3，初始化RGB屏幕
通过上两个步骤的配置，可以对屏幕进行初始化了，该函数原型如下所示：
- esp_err_t esp_lcd_panel_init(esp_lcd_panel_handle_t panel);
表33.3.2.6 esp_lcd_panel_init ()函数形参描述
该函数的返回值描述，如下表所示：
表33.3.2.7 函数esp_lcd_panel_init ()返回值描述
33.3.3 RGB-LCD驱动解析
在IDF版的23_rgb例程中，作者23_rgb\components\BSP路径下新增了一个RGB文件夹，分别用于存放ltdc.c、ltdc.h以及ltdcfont.h这三个文件。其中，ltdc.h和ltdc.h文件负责声明RGB相关的函数和变量并存放了LTDC 字库，而ltdc.c文件则实现了RGB的驱动代码。下面，我们将详细解析这三个文件的实现内容。
1，ltdc.h文件
该文件下定义了屏幕需要用到的一些重要参数，比如引脚定义，RGB颜色的十六进制值以及屏幕横向纵向的方向参数等。
- /* RGB_BL */
- #define LCD_BL(x) do { x ? \
- xl9555_pin_write(LCD_BL_IO, 1): \
- xl9555_pin_write(LCD_BL_IO, 0); \
- } while(0)
- /* RGBLCD引脚 */
- #define GPIO_LCD_DE (GPIO_NUM_4)
- #define GPIO_LCD_VSYNC (GPIO_NUM_NC)
- #define GPIO_LCD_HSYNC (GPIO_NUM_NC)
- #define GPIO_LCD_PCLK (GPIO_NUM_5)
- #define GPIO_LCD_R3 (GPIO_NUM_45)
- #define GPIO_LCD_R4 (GPIO_NUM_48)
- #define GPIO_LCD_R5 (GPIO_NUM_47)
- #define GPIO_LCD_R6 (GPIO_NUM_21)
- #define GPIO_LCD_R7 (GPIO_NUM_14)
- #define GPIO_LCD_G2 (GPIO_NUM_10)
- #define GPIO_LCD_G3 (GPIO_NUM_9)
- #define GPIO_LCD_G4 (GPIO_NUM_46)
- #define GPIO_LCD_G5 (GPIO_NUM_3)
- #define GPIO_LCD_G6 (GPIO_NUM_8)
- #define GPIO_LCD_G7 (GPIO_NUM_18)
- #define GPIO_LCD_B3 (GPIO_NUM_17)
- #define GPIO_LCD_B4 (GPIO_NUM_16)
- #define GPIO_LCD_B5 (GPIO_NUM_15)
- #define GPIO_LCD_B6 (GPIO_NUM_7)
- #define GPIO_LCD_B7 (GPIO_NUM_6)
- /* 常用画笔颜色 */
- #define WHITE 0xFFFF /* 白色 */
- #define BLACK 0x0000 /* 黑色 */
- #define RED 0xF800 /* 红色 */
- #define GREEN 0x07E0 /* 绿色 */
- #define BLUE 0x001F /* 蓝色 */
- #define MAGENTA 0xF81F /* 品红色/紫红色 = BLUE + RED */
- #define YELLOW 0xFFE0 /* 黄色 = GREEN + RED */
- #define CYAN 0x07FF /* 青色 = GREEN + BLUE */
- /* LCD LTDC重要参数集 */
- typedef struct
- {
- /* LTDC面板的宽度,固定参数,不随显示方向改变,如果为0,说明没有任何RGB屏接入 */
- uint32_t pwidth;
- uint32_t pheight; /* LTDC面板的高度,固定参数,不随显示方向改变 */
- uint16_t hsw; /* 水平同步宽度 */
- uint16_t vsw; /* 垂直同步宽度 */
- uint16_t hbp; /* 水平后廊 */
- uint16_t vbp; /* 垂直后廊 */
- uint16_t hfp; /* 水平前廊 */
- uint16_t vfp; /* 垂直前廊 */
- uint8_t activelayer; /* 当前层编号:0/1 */
- uint8_t dir; /* 0,竖屏;1,横屏; */
- uint16_t id; /* LTDC ID */
- uint32_t pclk_hz; /* 设置像素时钟 */
- uint16_t width; /* LTDC宽度 */
- uint16_t height; /* LTDC高度 */
- } _ltdc_dev;
- /* LTDC参数 */
- extern _ltdc_dev ltdcdev; /* 管理LTDC重要参数 */
- extern esp_lcd_panel_handle_t panel_handle;
2，ltdc.c文件
该文件下便是实现RGB屏幕的驱动函数了。由于代码过长，笔者仅整理出部分代码粘贴至此，详细内容请各位读者进入工程界面进行理解与学习。
- static const char *TAG = "ltdc";
- esp_lcd_panel_handle_t panel_handle = NULL; /* RGBLCD句柄 */
- /* 定义portMUX_TYPE类型的自旋锁变量,用于临界区保护 */
- static portMUX_TYPE my_spinlock = portMUX_INITIALIZER_UNLOCKED;
- uint32_t g_back_color = 0xFFFF; /* 背景色 */
- /* 管理LTDC重要参数 */
- _ltdc_dev ltdcdev;
- /**
- * @brief LTDC读取面板ID
- * @note 利用LCD RGB线的最高位(R7,G7,B7)来识别面板ID
- * PG6 = R7(M0); PI2 = G7(M1); PI7 = B7(M2);
- * M2:M1:M0
- * 0 :0 :0 4.3 寸480*272 RGB屏,ID = 0X4342
- * 1 :0 :0 4.3 寸800*480 RGB屏,ID = 0X4384
- * @param 无
- * @retval 0, 非法;
- * 其他, LCD ID
- */
- uint16_t ltdc_panelid_read(void)
- {
- uint8_t idx = 0;
- gpio_config_t gpio_init_struct = {0};
- gpio_init_struct.intr_type = GPIO_INTR_DISABLE; /* 失能引脚中断 */
- gpio_init_struct.mode = GPIO_MODE_INPUT; /* 输入输出模式 */
- gpio_init_struct.pull_up_en = GPIO_PULLUP_ENABLE; /* 使能上拉 */
- gpio_init_struct.pull_down_en = GPIO_PULLDOWN_DISABLE; /* 失能下拉 */
- gpio_init_struct.pin_bit_mask = 1ull << GPIO_LCD_B7;
- gpio_config(&gpio_init_struct); /* 配置GPIO */
- gpio_init_struct.pin_bit_mask = 1ull << GPIO_LCD_R7 || 1ull << GPIO_LCD_G7;
- gpio_config(&gpio_init_struct); /* 配置GPIO */
- idx = (uint8_t)gpio_get_level(GPIO_LCD_R7); /* 读取M0 */
- idx |= (uint8_t)gpio_get_level(GPIO_LCD_G7) << 1; /* 读取M1 */
- idx |= (uint8_t)gpio_get_level(GPIO_LCD_B7) << 2; /* 读取M2 */
- switch (idx)
- {
- case 0 :
- return 0X4342; /* 4.3寸屏, 480*272分辨率 */
- case 4 :
- return 0X4384; /* 4.3寸屏, 800*480分辨率 */
- default :
- return 0;
- }
- }
- /**
- * @brief 初始化ltdc
- * @param 无
- * @retval 无
- */
- void ltdc_init(void)
- {
- panel_handle = NULL;
- ltdcdev.id = ltdc_panelid_read(); /* 读取LCD面板ID */
- if (ltdcdev.id == 0X4342) /* 4.3寸屏, 480*272 RGB屏 */
- {
- ltdcdev.pwidth = 480; /* 面板宽度,单位:像素 */
- ltdcdev.pheight = 272; /* 面板高度,单位:像素 */
- ltdcdev.hsw = 1; /* 水平同步宽度 */
- ltdcdev.vsw = 1; /* 垂直同步宽度 */
- ltdcdev.hbp = 40; /* 水平后廊 */
- ltdcdev.vbp = 8; /* 垂直后廊 */
- ltdcdev.hfp = 5; /* 水平前廊 */
- ltdcdev.vfp = 8; /* 垂直前廊 */
- ltdcdev.pclk_hz = 9 * 1000 * 1000; /* 设置像素时钟 9Mhz */
- }
- else if (ltdcdev.id == 0X4384)
- {
- ltdcdev.pwidth = 800; /* 面板宽度,单位:像素 */
- ltdcdev.pheight = 480; /* 面板高度,单位:像素 */
- ltdcdev.hbp = 88; /* 水平后廊 */
- ltdcdev.hfp = 40; /* 水平前廊 */
- ltdcdev.hsw = 48; /* 水平同步宽度 */
- ltdcdev.vbp = 32; /* 垂直后廊 */
- ltdcdev.vfp = 13; /* 垂直前廊 */
- ltdcdev.vsw = 3; /* 垂直同步宽度 */
- ltdcdev.pclk_hz = 18 * 1000 * 1000; /* 设置像素时钟 18Mhz */
- }
- /* 配置RGB参数 */
- esp_lcd_rgb_panel_config_t panel_config = { /* RGBLCD配置结构体 */
- .data_width = 16, /* 数据宽度为16位 */
- .psram_trans_align = 64, /* 在PSRAM中分配的缓冲区的对齐 */
- .clk_src = LCD_CLK_SRC_PLL160M, /* RGBLCD外设时钟源 */
- .disp_gpio_num = GPIO_NUM_NC, /* 用于显示控制信号,不使用设为-1 */
- .pclk_gpio_num = GPIO_LCD_PCLK, /* PCLK信号引脚 */
- .hsync_gpio_num = GPIO_NUM_NC, /* HSYNC信号引脚,DE模式可不使用 */
- .vsync_gpio_num = GPIO_NUM_NC, /* VSYNC信号引脚,DE模式可不使用 */
- .de_gpio_num = GPIO_LCD_DE, /* DE信号引脚 */
- .data_gpio_nums = { /* 数据线引脚 */
- GPIO_LCD_B3, GPIO_LCD_B4, GPIO_LCD_B5, GPIO_LCD_B6, GPIO_LCD_B7,
- GPIO_LCD_G2, GPIO_LCD_G3, GPIO_LCD_G4, GPIO_LCD_G5, GPIO_LCD_G6, GPIO_LCD_G7,
- GPIO_LCD_R3, GPIO_LCD_R4, GPIO_LCD_R5, GPIO_LCD_R6, GPIO_LCD_R7,
- },
- .timings = { /* RGBLCD时序参数 */
- .pclk_hz = ltdcdev.pclk_hz, /* 像素时钟频率 */
- .h_res = ltdcdev.pwidth, /* 水平分辨率，即一行中的像素数 */
- .v_res = ltdcdev.pheight, /* 垂直分辨率，即帧中的行数 */
- /* 水平后廊，hsync和行活动数据开始之间的PCLK数 */
- .hsync_back_porch = ltdcdev.hbp,
- /* 水平前廊，活动数据结束和下一个hsync之间的PCLK数 */
- .hsync_front_porch = ltdcdev.hfp,
- .hsync_pulse_width = ltdcdev.vsw, /* 垂直同步宽度，单位：行数 */
- /* 垂直后廊，vsync和帧开始之间的无效行数 */
- .vsync_back_porch = ltdcdev.vbp,
- /* 垂直前廊，帧结束和下一个vsync之间的无效行数 */
- .vsync_front_porch = ltdcdev.vfp,
- .vsync_pulse_width = ltdcdev.hsw, /* 水平同步宽度，单位：PCLK周期 */
- .flags.pclk_active_neg = true, /* RGB数据在下降沿计时 */
- },
- .flags.fb_in_psram = true, /* 在PSRAM中分配帧缓冲区 */
- /* 解决写spiflash时,抖动问题 */
- .bounce_buffer_size_px = (ltdcdev.id == 0X4384) ? 480 * 10 : 272 * 10,
- };
- /* 创建RGB对象 */
- esp_lcd_new_rgb_panel(&panel_config, &panel_handle);
- /* 复位RGB屏 */
- ESP_ERROR_CHECK(esp_lcd_panel_reset(panel_handle));
- /* 初始化RGB */
- ESP_ERROR_CHECK(esp_lcd_panel_init(panel_handle));
- /* 设置横屏 */
- ltdc_display_dir(1);
- /* 清除屏幕为颜色 */
- ltdc_clear(WHITE);
- /* 打开背光 */
- LCD_BL(1);
- }
- /**
- * @brief 清除屏幕
- * @param color:清除的颜色
- * @retval 无
- */
- void ltdc_clear(uint16_t color)
- {
- uint16_t *buffer = heap_caps_malloc(ltdcdev.width * sizeof(uint16_t), MALLOC_CAP_INTERNAL |
- MALLOC_CAP_8BIT);
- if (NULL == buffer)
- {
- ESP_LOGE(TAG, "Memory for bitmap is not enough");
- }
- else
- {
- for (uint16_t i = 0; i < ltdcdev.width; i++)
- {
- buffer = color;
- }
-
- for (uint16_t y = 0; y < ltdcdev.height; y++)
- {/*使用taskENTER_CRITICAL()和taskEXIT_CRITICAL()保护画点过程,禁止任务调度*/
- taskENTER_CRITICAL(&my_spinlock); /* 屏蔽中断 */
- esp_lcd_panel_draw_bitmap(panel_handle,
- 0,
- y,
- ltdcdev.width,
- y + 1,
- buffer);
- taskEXIT_CRITICAL(&my_spinlock); /* 重新使能中断 */
- }
-
- heap_caps_free(buffer);
- }
- }
33.3.4 CMakeLists.txt文件
打开本实验BSP下的CMakeLists.txt文件，其内容如下所示：
- set(src_dirs
- IIC
- LED
- XL9555
- RGBLCD)
- set(include_dirs
- IIC
- LED
- XL9555
- RGBLCD)
- set(requires
- driver
- esp_lcd
- esp_common
- log)
- idf_component_register(SRC_DIRS ${src_dirs}
- INCLUDE_DIRS ${include_dirs} REQUIRES ${requires})
- component_compile_options(-ffast-math -O3 -Wno-error=format=-Wno-format)
33.3.5 实验应用代码
打开main/main.c文件，该文件定义了工程入口函数，名为app_main。该函数代码如下。
- i2c_obj_t i2c0_master;
- /**
- * @brief 程序入口
- * @param 无
- * @retval 无
- */
- void app_main(void)
- {
- uint8_t x = 0;
- uint8_t lcd_id[12];
- esp_err_t ret;
-
- ret = nvs_flash_init(); /* 初始化NVS */
- if (ret == ESP_ERR_NVS_NO_FREE_PAGES ||
- ret == ESP_ERR_NVS_NEW_VERSION_FOUND)
- {
- ESP_ERROR_CHECK(nvs_flash_erase());
- ret = nvs_flash_init();
- }
- led_init(); /* 初始化LED */
- i2c0_master = iic_init(I2C_NUM_0); /* 初始化IIC0 */
- xl9555_init(i2c0_master); /* IO扩展芯片初始化 */
- ltdc_init(); /* RGB屏初始化 */
- sprintf((char *)lcd_id, "LCD ID:%04X", ltdcdev.id);/*将ID打印到lcd_id数组*/
- while (1)
- {
- switch (x)
- {
- case 0:
- ltdc_clear(WHITE);
- break;
- case 1:
- ltdc_clear(BLACK);
- break;
- case 2:
- ltdc_clear(BLUE);
- break;
- case 3:
- ltdc_clear(RED);
- break;
- case 4:
- ltdc_clear(MAGENTA);
- break;
- case 5:
- ltdc_clear(GREEN);
- break;
- case 6:
- ltdc_clear(CYAN);
- break;
- case 7:
- ltdc_clear(YELLOW);
- break;
- }
- ltdc_show_string(10, 40, 240, 32, 32, "ESP32S3", RED);
- ltdc_show_string(10, 80, 240, 24, 24, "LTDC TEST", RED);
- ltdc_show_string(10, 110, 240, 16, 16, "ATOM@ALIENTEK", RED);
- ltdc_show_string(10, 130, 240, 16, 16, (char *)lcd_id, RED);/* LCD ID */
- x++;
- if (x == 8)
- {
- x = 0;
- }
- vTaskDelay(1000);
- }
- }
33.4 下载验证
在初始化完RGB-LCD屏幕后，便在RGB-LCD上显示一些本实验的相关信息，随后便每间隔1000毫秒就更换一次RGB-LCD屏幕显示的背景色。
|
发表于 
