ESP32 ESP-IDF TFT-LCD(ST7735 128x160)自定义组件驱动显示
- 🌿驱动参考来源：
https://blog.csdn.net/weixin_59250390/article/details/142691848 - 📍个人相关驱动内容文章：《ESP32 ESP-IDF TFT-LCD(ST7735 128x160) LVGL基本配置和使用》
- 🔖ESPIDF版本：
v5.4
✨个人在使用上面的驱动代码驱动时，直接放在工程目录下面使用没有问题，在将驱动文件作为组件形式放置到组件里面使用时，调用遇到了一些问题，为了避免其他使用者踩同样的坑，特此记录一下。
🔰components文件夹和managed_components文件夹差异
在espidf项目中，
components文件夹和managed_components文件夹都是用来存放组件的。它们之间的使用差异如下：
1. 组件内容差异
- components文件夹
存放用户自定义或项目本地组件，例如： - 用户自行开发的驱动程序（如LCD显示屏驱动、传感器驱动等）；
- 从其他项目手动拷贝的第三方组件（如ESP-IoT-Solution中的部分组件）；
- 通过VSCode命令（如idf.py create-component）生成的组件模板
managed_components文件夹
存放通过组件管理器（Component Manager）自动下载的组件，例如： - 官方注册表（ESP Component Registry）中的组件（如espressif/button、lvgl/lvgl）；
- 第三方发布的依赖库（需通过idf.py add-dependency命令添加）
2. 管理方式
- components文件夹
- 手动管理：需用户自行编写代码、配置CMakeLists.txt 文件（声明依赖、头文件路径等）；
- 路径优先级高：项目会优先搜索components中的组件，其次才是ESP-IDF内置组件。
- managed_components文件夹
- 自动管理：通过idf.py add-dependency命令添加依赖后，IDF工具会自动下载组件并更新dependencies.lock 文件；
- 禁止手动修改：该文件夹内容由组件管理器维护，用户仅需调用接口，无需修改文件。
3. 构建流程差异
- components
需在CMakeLists.txt 中显式配置路径和依赖（如INCLUDE_DIRS、REQUIRES） - managed_components
构建时自动解析idf_component.yml 清单文件，并递归处理依赖关系，无需手动配置。
📗自定义组件创建方法
- ✨个人自定义的组件使用自定义组件生成。不要自己在项目中自己创建
managed_components形式来加载组件，不然会在后的项目编译过程中，可能会遇到各种问题。
- 从VSCode 设置菜单-命令面板（Crtrl +Shift +P），来创建ESPIDF项目中的自定义组件。
- 输入想要创建的组件名称。
- 组件被创建后，项目目录下会自动生成下面框选内容：（包含组件文件夹以及下面的include文件夹以及cmakelist.txt文件）
- 放置驱动源文件以及头文件到组件目录对应位置。
- 🌿组件目录下的
cmakelist.txt文件内容填写：
idf_component_register(SRCS "lib_lcd7735.c"INCLUDE_DIRS "include"PRIV_REQUIRES driver )
- 🌿main文件目录下的cmakelist.txt文件填写：
set(srcs "hello_world_main.c")
idf_component_register(SRCS ${srcs}PRIV_REQUIRES spi_flash driverREQUIRES lib_lcd7735INCLUDE_DIRS "")
📘SPI参数配置
- ⚡通讯设备时钟频率可以设置到30MHz,但是设置为40MHz就无法显示了，但是在使用上面的LVGL内容中，所使用设备通讯时钟频率为40MHz，驱动显示没有问题。
- 屏幕驱动显示仅涉及到
写数据到ST7735屏幕中。如果挂载有多路SPI设备，需要使用读SPI设备数据操作，保证通讯质量，则通讯频率可能低于10MHz.
/*** @brief spi gpio初始化* @note 可修改适配自己不同的硬件*/
void LcdGpioSpiInit(void)
{//--gpio 配置 add your codegpio_config_t lcd_io = {.intr_type = GPIO_INTR_DISABLE,.mode = GPIO_MODE_OUTPUT,.pin_bit_mask = (1 << LCD_PIN_RES), ///<RES GPIO.pull_down_en = GPIO_PULLDOWN_DISABLE,.pull_up_en = GPIO_PULLUP_ENABLE,};gpio_config(&lcd_io);
#if !(LCD_HARDWARE_CS) ///<CS GPIOlcd_io.pin_bit_mask = (1 << LCD_PIN_CS);gpio_config(&lcd_io);
#endiflcd_io.pin_bit_mask = (1 << LCD_PIN_A0); //A0 GPIOgpio_config(&lcd_io);//总线配置 add your codespi_bus_config_t buscfg = {.miso_io_num = -1, ///<gpio12->miso.mosi_io_num = LCD_PIN_SDA, ///<gpio13->mosi.sclk_io_num = LCD_PIN_SCL ///<gpio14-> sclk};buscfg.max_transfer_sz = 12800; ///<设置传输数据的最大值。非DMA最大64bytes,DMA最大4096bytes:40 * sizeof(uint8_t)//buscfg.intr_flags = 0; ///<这个用于设置SPI通讯中相关的中断函数的中断优先级，0是默认。esp_err_t tft_spi_f = spi_bus_initialize(LCD_SPI_HOST, &buscfg, SPI_DMA_CH_AUTO); ///<总线初始化，并且使用DMA传输if (tft_spi_f != ESP_OK) {printf("--tft--spi--bus--initialize--err,%d\n", tft_spi_f); ///<错误信息打印}//设备配置结构体 add your codespi_device_interface_config_t interface_config = {.address_bits = 0,.command_bits = 0,.clock_speed_hz = 30 * 1000 * 1000,.mode = LCD_SPI_MODE, ///<设置SPI通讯的相位特性和采样边沿。包括了mode0-3四种。要看从设备能够使用哪种模式
#if LCD_HARDWARE_CS ///<宏选择硬件CS///传输前线片选 几个时钟再传数据不然容易失败// .cs_ena_pretrans = 2,// .cs_ena_posttrans = 2,.spics_io_num = -1, //LCD_PIN_CS, ///<配置片选线
#endif.pre_cb=NULL,.post_cb=NULL,//NULL.duty_cycle_pos = 0,.queue_size = 6 ///<传输队列的长度，表示可以在通讯的时候挂起多少个spi通讯。在中断通讯模式的时候会把当前spi通讯进程挂起到队列中};tft_spi_f = spi_bus_add_device(LCD_SPI_HOST, &interface_config, &tft_hspi); ///<添加spi设备if (tft_spi_f != ESP_OK) {printf("--tft--spi--deiver--config--err,%d\n", tft_spi_f); ///<错误信息打印}
}
- ESP32 SPI引脚和接口
//HSPI
// #define LCD_PIN_CS GPIO_NUM_15 ///< 片选
// #define LCD_PIN_RES GPIO_NUM_2 ///< 复位
// #define LCD_PIN_A0 GPIO_NUM_3 ///< 命令/数据
// #define LCD_PIN_SDA GPIO_NUM_13 ///< MOSI
// #define LCD_PIN_SCL GPIO_NUM_14 ///< spi CLK
//VSPI
#define LCD_PIN_CS GPIO_NUM_5 ///< 片选
#define LCD_PIN_RES GPIO_NUM_22 ///< 复位
#define LCD_PIN_A0 GPIO_NUM_21 ///< 命令/数据 DC
#define LCD_PIN_SDA GPIO_NUM_23 ///< MOSI
#define LCD_PIN_SCL GPIO_NUM_18 ///< spi CLK
📚工程源码
通过网盘分享的文件：lcd_st7735.rar
链接: https://pan.baidu.com/s/1h-D51el39i2jhQ1joDfFpA?pwd=65ia 提取码: 65ia
