mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-04 00:51:42 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			260 lines
		
	
	
		
			9.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			260 lines
		
	
	
		
			9.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
#include <stdio.h>
 | 
						|
#include <string.h>
 | 
						|
#include "sdkconfig.h"
 | 
						|
#include "unity.h"
 | 
						|
#include "test_utils.h"
 | 
						|
#include "driver/spi_master.h"
 | 
						|
#include "driver/gpio.h"
 | 
						|
#include "esp_lcd_panel_io.h"
 | 
						|
#include "esp_lcd_panel_vendor.h"
 | 
						|
#include "esp_lcd_panel_ops.h"
 | 
						|
#include "esp_system.h"
 | 
						|
#include "soc/soc_caps.h"
 | 
						|
#include "test_spi_board.h"
 | 
						|
 | 
						|
#define TEST_SPI_HOST_ID        (1)
 | 
						|
#define TEST_LCD_PIXEL_CLOCK_HZ (20 * 1000 * 1000) // 20MHz
 | 
						|
 | 
						|
static void lcd_initialize_spi(esp_lcd_panel_io_handle_t *io_handle, esp_lcd_panel_io_color_trans_done_cb_t on_color_trans_done, void *user_ctx, int cmd_bits, int param_bits, bool oct_mode)
 | 
						|
{
 | 
						|
    gpio_config_t bk_gpio_config = {
 | 
						|
        .mode = GPIO_MODE_OUTPUT,
 | 
						|
        .pin_bit_mask = 1ULL << TEST_LCD_BK_LIGHT_GPIO
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(gpio_config(&bk_gpio_config));
 | 
						|
 | 
						|
    spi_bus_config_t buscfg = {
 | 
						|
        .sclk_io_num = TEST_LCD_PCLK_GPIO,
 | 
						|
        .mosi_io_num = TEST_LCD_DATA0_GPIO,
 | 
						|
        .miso_io_num = -1,
 | 
						|
        .quadwp_io_num = -1,
 | 
						|
        .quadhd_io_num = -1,
 | 
						|
        .max_transfer_sz = TEST_LCD_H_RES * TEST_LCD_V_RES * sizeof(uint16_t)
 | 
						|
    };
 | 
						|
    if (oct_mode) {
 | 
						|
        buscfg.data1_io_num = TEST_LCD_DATA1_GPIO;
 | 
						|
        buscfg.data2_io_num = TEST_LCD_DATA2_GPIO;
 | 
						|
        buscfg.data3_io_num = TEST_LCD_DATA3_GPIO;
 | 
						|
        buscfg.data4_io_num = TEST_LCD_DATA4_GPIO;
 | 
						|
        buscfg.data5_io_num = TEST_LCD_DATA5_GPIO;
 | 
						|
        buscfg.data6_io_num = TEST_LCD_DATA6_GPIO;
 | 
						|
        buscfg.data7_io_num = TEST_LCD_DATA7_GPIO;
 | 
						|
        buscfg.flags = SPICOMMON_BUSFLAG_OCTAL;
 | 
						|
    }
 | 
						|
    TEST_ESP_OK(spi_bus_initialize(TEST_SPI_HOST_ID, &buscfg, SPI_DMA_CH_AUTO));
 | 
						|
 | 
						|
    esp_lcd_panel_io_spi_config_t io_config = {
 | 
						|
        .dc_gpio_num = TEST_LCD_DC_GPIO,
 | 
						|
        .cs_gpio_num = TEST_LCD_CS_GPIO,
 | 
						|
        .pclk_hz = TEST_LCD_PIXEL_CLOCK_HZ,
 | 
						|
        .spi_mode = 0,
 | 
						|
        .trans_queue_depth = 10,
 | 
						|
        .lcd_cmd_bits = cmd_bits,
 | 
						|
        .lcd_param_bits = param_bits,
 | 
						|
        .on_color_trans_done = on_color_trans_done,
 | 
						|
        .user_ctx = user_ctx
 | 
						|
    };
 | 
						|
    if (oct_mode) {
 | 
						|
        io_config.flags.octal_mode = 1;
 | 
						|
        io_config.spi_mode = 3;
 | 
						|
    }
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_io_spi((esp_lcd_spi_bus_handle_t)TEST_SPI_HOST_ID, &io_config, io_handle));
 | 
						|
}
 | 
						|
 | 
						|
static void lcd_panel_test(esp_lcd_panel_io_handle_t io_handle, esp_lcd_panel_handle_t panel_handle)
 | 
						|
{
 | 
						|
#define TEST_IMG_SIZE (100 * 100 * sizeof(uint16_t))
 | 
						|
    uint8_t *img = heap_caps_malloc(TEST_IMG_SIZE, MALLOC_CAP_DMA);
 | 
						|
    TEST_ASSERT_NOT_NULL(img);
 | 
						|
 | 
						|
    // turn off backlight
 | 
						|
    gpio_set_level(TEST_LCD_BK_LIGHT_GPIO, 0);
 | 
						|
    esp_lcd_panel_reset(panel_handle);
 | 
						|
    esp_lcd_panel_init(panel_handle);
 | 
						|
    esp_lcd_panel_invert_color(panel_handle, true);
 | 
						|
    // the gap is LCD panel specific, even panels with the same driver IC, can have different gap value
 | 
						|
    esp_lcd_panel_set_gap(panel_handle, 0, 20);
 | 
						|
    // turn on backlight
 | 
						|
    gpio_set_level(TEST_LCD_BK_LIGHT_GPIO, 1);
 | 
						|
 | 
						|
    for (int i = 0; i < 200; i++) {
 | 
						|
        uint8_t color_byte = esp_random() & 0xFF;
 | 
						|
        int x_start = esp_random() % (TEST_LCD_H_RES - 100);
 | 
						|
        int y_start = esp_random() % (TEST_LCD_V_RES - 100);
 | 
						|
        memset(img, color_byte, TEST_IMG_SIZE);
 | 
						|
        esp_lcd_panel_draw_bitmap(panel_handle, x_start, y_start, x_start + 100, y_start + 100, img);
 | 
						|
    }
 | 
						|
    // turn off screen
 | 
						|
    esp_lcd_panel_disp_off(panel_handle, true);
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_del(panel_handle));
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_io_del(io_handle));
 | 
						|
    TEST_ESP_OK(spi_bus_free(TEST_SPI_HOST_ID));
 | 
						|
    TEST_ESP_OK(gpio_reset_pin(TEST_LCD_BK_LIGHT_GPIO));
 | 
						|
    free(img);
 | 
						|
#undef TEST_IMG_SIZE
 | 
						|
}
 | 
						|
 | 
						|
TEST_CASE("lcd panel spi io test", "[lcd]")
 | 
						|
{
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 8, 8, false);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1A, NULL, 0);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1B, (uint8_t[]) {
 | 
						|
        0x11, 0x22, 0x33
 | 
						|
    }, 3);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1C, NULL, 0);
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_io_del(io_handle));
 | 
						|
    TEST_ESP_OK(spi_bus_free(TEST_SPI_HOST_ID));
 | 
						|
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 16, 16, false);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1A01, NULL, 0);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1B02, (uint16_t[]) {
 | 
						|
        0x11, 0x22, 0x33
 | 
						|
    }, 6);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1C03, NULL, 0);
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_io_del(io_handle));
 | 
						|
    TEST_ESP_OK(spi_bus_free(TEST_SPI_HOST_ID));
 | 
						|
 | 
						|
#if SOC_SPI_SUPPORT_OCT
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 8, 8, true);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1A, NULL, 0);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1B, (uint8_t[]) {
 | 
						|
        0x11, 0x22, 0x33
 | 
						|
    }, 3);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1C, NULL, 0);
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_io_del(io_handle));
 | 
						|
    TEST_ESP_OK(spi_bus_free(TEST_SPI_HOST_ID));
 | 
						|
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 16, 16, true);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1A01, NULL, 0);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1B02, (uint16_t[]) {
 | 
						|
        0x11, 0x22, 0x33
 | 
						|
    }, 6);
 | 
						|
    esp_lcd_panel_io_tx_param(io_handle, 0x1C03, NULL, 0);
 | 
						|
    TEST_ESP_OK(esp_lcd_panel_io_del(io_handle));
 | 
						|
    TEST_ESP_OK(spi_bus_free(TEST_SPI_HOST_ID));
 | 
						|
#endif // SOC_SPI_SUPPORT_OCT
 | 
						|
}
 | 
						|
 | 
						|
#if SOC_SPI_SUPPORT_OCT
 | 
						|
TEST_CASE("lcd panel with 8-line spi interface (st7789)", "[lcd]")
 | 
						|
{
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 8, 8, true);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle));
 | 
						|
    lcd_panel_test(io_handle, panel_handle);
 | 
						|
}
 | 
						|
 | 
						|
TEST_CASE("lcd panel with 8-line spi interface (nt35510)", "[lcd]")
 | 
						|
{
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 16, 16, true);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_nt35510(io_handle, &panel_config, &panel_handle));
 | 
						|
    lcd_panel_test(io_handle, panel_handle);
 | 
						|
}
 | 
						|
#endif // SOC_SPI_SUPPORT_OCT
 | 
						|
 | 
						|
TEST_CASE("lcd panel with 1-line spi interface (st7789)", "[lcd]")
 | 
						|
{
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, NULL, NULL, 8, 8, false);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle));
 | 
						|
    lcd_panel_test(io_handle, panel_handle);
 | 
						|
}
 | 
						|
 | 
						|
// The following test shows a porting example of LVGL GUI library
 | 
						|
// To run the LVGL tests, you need to clone the LVGL library into components directory firstly
 | 
						|
#if CONFIG_LV_USE_USER_DATA
 | 
						|
#include "test_lvgl_port.h"
 | 
						|
 | 
						|
static bool notify_lvgl_ready_to_flush(esp_lcd_panel_io_handle_t panel_io, esp_lcd_panel_io_event_data_t *edata, void *user_ctx)
 | 
						|
{
 | 
						|
    lv_disp_t *disp = *(lv_disp_t **)user_ctx;
 | 
						|
    lv_disp_flush_ready(&disp->driver);
 | 
						|
    return false;
 | 
						|
}
 | 
						|
 | 
						|
static void lvgl_gui_test(esp_lcd_panel_io_handle_t io_handle, esp_lcd_panel_handle_t panel_handle, lv_disp_t **disp)
 | 
						|
{
 | 
						|
    // initialize LVGL graphics library
 | 
						|
    lv_init();
 | 
						|
    // turn off backlight
 | 
						|
    gpio_set_level(TEST_LCD_BK_LIGHT_GPIO, 0);
 | 
						|
    esp_lcd_panel_reset(panel_handle);
 | 
						|
    esp_lcd_panel_init(panel_handle);
 | 
						|
    esp_lcd_panel_invert_color(panel_handle, true);
 | 
						|
    // the gap is LCD panel specific, even panels with the same driver IC, can have different gap value
 | 
						|
    esp_lcd_panel_set_gap(panel_handle, 0, 20);
 | 
						|
    // turn on backlight
 | 
						|
    gpio_set_level(TEST_LCD_BK_LIGHT_GPIO, 1);
 | 
						|
 | 
						|
    test_lvgl_task_loop(panel_handle, TEST_LCD_H_RES, TEST_LCD_V_RES, disp);
 | 
						|
}
 | 
						|
 | 
						|
#if SOC_SPI_SUPPORT_OCT
 | 
						|
TEST_CASE("lvgl gui with 8-line spi interface (st7789)", "[lcd][lvgl][ignore]")
 | 
						|
{
 | 
						|
    lv_disp_t *disp = NULL;
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, notify_lvgl_ready_to_flush, &disp, 8, 8, true);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle));
 | 
						|
    lvgl_gui_test(io_handle, panel_handle, &disp);
 | 
						|
}
 | 
						|
 | 
						|
TEST_CASE("lvgl gui with 8-line spi interface (nt35510)", "[lcd][lvgl][ignore]")
 | 
						|
{
 | 
						|
    lv_disp_t *disp = NULL;
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, notify_lvgl_ready_to_flush, &disp, 16, 16, true);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_nt35510(io_handle, &panel_config, &panel_handle));
 | 
						|
    lvgl_gui_test(io_handle, panel_handle, &disp);
 | 
						|
}
 | 
						|
#endif // SOC_SPI_SUPPORT_OCT
 | 
						|
 | 
						|
TEST_CASE("lvgl gui with 1-line spi interface (st7789)", "[lcd][lvgl][ignore]")
 | 
						|
{
 | 
						|
    lv_disp_t *disp = NULL;
 | 
						|
    esp_lcd_panel_io_handle_t io_handle = NULL;
 | 
						|
    esp_lcd_panel_handle_t panel_handle = NULL;
 | 
						|
    lcd_initialize_spi(&io_handle, notify_lvgl_ready_to_flush, &disp, 8, 8, false);
 | 
						|
    esp_lcd_panel_dev_config_t panel_config = {
 | 
						|
        .reset_gpio_num = TEST_LCD_RST_GPIO,
 | 
						|
        .color_space = ESP_LCD_COLOR_SPACE_RGB,
 | 
						|
        .bits_per_pixel = 16,
 | 
						|
    };
 | 
						|
    TEST_ESP_OK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle));
 | 
						|
    lvgl_gui_test(io_handle, panel_handle, &disp);
 | 
						|
}
 | 
						|
 | 
						|
#endif // CONFIG_LV_USE_USER_DATA
 |