ESP32 ESP-IDF TFT-LCD(ST7735 128x160) LVGL基本配置和使用

ESP32 ESP-IDF TFT-LCD(ST7735 128x160) LVGL基本配置和使用

---

• 📍项目地址：https://github.com/lvgl/lv_port_esp32
• 参考文章：https://blog.csdn.net/chentuo2000/article/details/126668088
• https://blog.csdn.net/p1279030826/article/details/120128339
• 🔖ESP-IDF版本：v5.4
• ESP32引脚功能图：
  
• 通过git命令将项目和所需的子模块全部下载到本地：（需要提前安装好git工具）

git clone --recurse-submodules https://github.com/lvgl/lv_port_esp32.git

SPI接口和引脚说明

ESP32 提供了两个独立的SPI主机接口，HSPI 和 VSPI.

• ESP32与ST7735 HSPI连接：
  
• ESP32与ST7735 VSPI连接图:
  

📑配置和参数修改说明

• 🌿在st7735s.h参数修改：

//st7735s.h
#define ST7735_GREENTAB160x80 // For 160 x 80 display (BGR, inverted, 26 / 1 offset)
#define COLSTART            0       //默认参数：26
#define ROWSTART           0    // 默认参数：1

• 🌿在SDK配置编辑器中（menuconfig）

• 屏幕像素参数配置：
  
  

• VSPI引脚：(可以参考前面的图进行配置)
  

• 字体选择：
  

• demo屏幕显示示例选择：

• 触摸组件控制功能没有开启

• 

🛠初次编译报错处理

• 在没有使用触摸组件情况下，编译器会报找不到相关定义： error: 'CONFIG_LV_AXP192_PIN_SDA'

参考上面文章的做法，将启用相关宏定义 CONFIG_LV_M5STICKC_HANDLE_AXP192 的判断，来跳过对应的代码。

//st7735s.h
#ifdef CONFIG_LV_M5STICKC_HANDLE_AXP192
#define AXP192_SDA   CONFIG_LV_AXP192_PIN_SDA
#define AXP192_SCL   CONFIG_LV_AXP192_PIN_SCL
#endif

//st7735s.c
static void i2c_master_init()
{
#ifdef CONFIG_LV_M5STICKC_HANDLE_AXP192i2c_config_t i2c_config = {.mode               = I2C_MODE_MASTER,.sda_io_num         = AXP192_SDA,.scl_io_num         = AXP192_SCL,.sda_pullup_en      = GPIO_PULLUP_ENABLE,.scl_pullup_en      = GPIO_PULLUP_ENABLE,.master.clk_speed   = 400000};i2c_param_config(I2C_NUM_0, &i2c_config);i2c_driver_install(I2C_NUM_0, I2C_MODE_MASTER, 0, 0, 0);
#endif
}

• main.c中报错error: implicit declaration of function 'esp_timer_start_periodic' [-Wimplicit-function-declaration]添加对应的头文件

#include "esp_timer.h" // 添加这一行

• 🌿编译找不到gpio_pad_select_gpio函数，使用函数替代：

esp_rom_gpio_pad_select_gpio

• 编译成功并烧录后，如果配置的demo显示示例选择的是：Show demo widgets，屏幕可以显示一行：Hello World
  
  所执行的是，main.c中的下面对应的函数：

static void create_demo_application(void)
{/* When using a monochrome display we only show "Hello World" centered on the* screen */
#if defined CONFIG_LV_TFT_DISPLAY_MONOCHROME || \defined CONFIG_LV_TFT_DISPLAY_CONTROLLER_ST7735S/* use a pretty small demo for monochrome displays *//* Get the current screen  */lv_obj_t * scr = lv_disp_get_scr_act(NULL);/*Create a Label on the currently active screen*/lv_obj_t * label1 =  lv_label_create(scr, NULL);/*Modify the Label's text*/lv_label_set_text(label1, "Hello\nworld");/* Align the Label to the center* NULL means align on parent (which is the screen now)* 0, 0 at the end means an x, y offset after alignment*/lv_obj_align(label1, NULL, LV_ALIGN_CENTER, 0, 0);
#else/* Otherwise we show the selected demo */#if defined CONFIG_LV_USE_DEMO_WIDGETSlv_demo_widgets();#elif defined CONFIG_LV_USE_DEMO_KEYPAD_AND_ENCODERlv_demo_keypad_encoder();#elif defined CONFIG_LV_USE_DEMO_BENCHMARKlv_demo_benchmark();#elif defined CONFIG_LV_USE_DEMO_STRESSlv_demo_stress();#else#error "No demo application selected."#endif
#endif
}

📗SPI默认参数配置查看

• 项目默认配置的SPI时钟频率：40MHz,CS设备片选信号采用软件方式。（如果该SPI总线上只有一个屏幕显示设备，屏幕CS引脚可以直接接地），SPI模式0，显示缓冲区：(LV_HOR_RES_MAX * 40)。此信息可以通过复位ESP32设备，通过默认调试输出的串口查看到。
  
• 个人没有搞明白,添加的设备时钟频率能设定到40MHz.( SPI_TFT_CLOCK_SPEED_HZ (40*1000*1000))

在这里插入代码片

void disp_spi_add_device_with_speed(spi_host_device_t host, int clock_speed_hz)
{ESP_LOGI(TAG, "Adding SPI device");ESP_LOGI(TAG, "Clock speed: %dHz, mode: %d, CS pin: %d",clock_speed_hz, SPI_TFT_SPI_MODE, DISP_SPI_CS);//DISP_SPI_CSspi_device_interface_config_t devcfg={.clock_speed_hz = clock_speed_hz,.mode = SPI_TFT_SPI_MODE,.spics_io_num= DISP_SPI_CS,//DISP_SPI_CS=-1, // 片选线CS pin,软件控制填写引脚号，硬件.input_delay_ns=DISP_SPI_INPUT_DELAY_NS,.queue_size=SPI_TRANSACTION_POOL_SIZE,////   .cs_ena_pretrans = 2,//采用硬件CS需要添加的参数//	.cs_ena_posttrans = 2,//采用硬件CS需要添加的参数.pre_cb=NULL,.post_cb=NULL,//NULL
#if defined(DISP_SPI_HALF_DUPLEX).flags = SPI_DEVICE_NO_DUMMY | SPI_DEVICE_HALFDUPLEX,	/* dummy bits should be explicitly handled via DISP_SPI_VARIABLE_DUMMY as needed */
#else#if defined (CONFIG_LV_TFT_DISPLAY_CONTROLLER_FT81X).flags = 0,#elif defined (CONFIG_LV_TFT_DISPLAY_CONTROLLER_RA8875).flags = SPI_DEVICE_NO_DUMMY,#endif
#endif};disp_spi_add_device_config(host, &devcfg);/* create the transaction pool and fill it with ptrs to spi_transaction_ext_t to reuse */if(TransactionPool == NULL) {TransactionPool = xQueueCreate(SPI_TRANSACTION_POOL_SIZE, sizeof(spi_transaction_ext_t*));assert(TransactionPool != NULL);for (size_t i = 0; i < SPI_TRANSACTION_POOL_SIZE; i++){spi_transaction_ext_t* pTransaction = (spi_transaction_ext_t*)heap_caps_malloc(sizeof(spi_transaction_ext_t), MALLOC_CAP_DMA);assert(pTransaction != NULL);memset(pTransaction, 0, sizeof(spi_transaction_ext_t));xQueueSend(TransactionPool, &pTransaction, portMAX_DELAY);}}
}