/* * SPDX-FileCopyrightText: 2021-2022 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: CC0-1.0 */ #include #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "esp_timer.h" #include "esp_lcd_panel_io.h" #include "esp_lcd_panel_vendor.h" #include "esp_lcd_panel_ops.h" #include "driver/gpio.h" #include "esp_err.h" #include "esp_log.h" #include "lvgl.h" #if CONFIG_EXAMPLE_LCD_TOUCH_ENABLED #include "driver/i2c.h" #if CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_GT911 #include "esp_lcd_touch_gt911.h" #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_TT21100 #include "esp_lcd_touch_tt21100.h" #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_FT5X06 #include "esp_lcd_touch_ft5x06.h" #endif #endif static const char *TAG = "example"; //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// Please update the following configuration according to your LCD spec ////////////////////////////// //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// #if CONFIG_EXAMPLE_LCD_I80_COLOR_IN_PSRAM // PCLK frequency can't go too high as the limitation of PSRAM bandwidth #define EXAMPLE_LCD_PIXEL_CLOCK_HZ (2 * 1000 * 1000) #else #define EXAMPLE_LCD_PIXEL_CLOCK_HZ (10 * 1000 * 1000) #endif // CONFIG_EXAMPLE_LCD_I80_COLOR_IN_PSRAM #define EXAMPLE_LCD_BK_LIGHT_ON_LEVEL 1 #define EXAMPLE_LCD_BK_LIGHT_OFF_LEVEL !EXAMPLE_LCD_BK_LIGHT_ON_LEVEL #define EXAMPLE_PIN_NUM_DATA0 6 #define EXAMPLE_PIN_NUM_DATA1 7 #define EXAMPLE_PIN_NUM_DATA2 8 #define EXAMPLE_PIN_NUM_DATA3 9 #define EXAMPLE_PIN_NUM_DATA4 10 #define EXAMPLE_PIN_NUM_DATA5 11 #define EXAMPLE_PIN_NUM_DATA6 12 #define EXAMPLE_PIN_NUM_DATA7 13 #if CONFIG_EXAMPLE_LCD_I80_BUS_WIDTH > 8 #define EXAMPLE_PIN_NUM_DATA8 14 #define EXAMPLE_PIN_NUM_DATA9 15 #define EXAMPLE_PIN_NUM_DATA10 16 #define EXAMPLE_PIN_NUM_DATA11 17 #define EXAMPLE_PIN_NUM_DATA12 18 #define EXAMPLE_PIN_NUM_DATA13 19 #define EXAMPLE_PIN_NUM_DATA14 20 #define EXAMPLE_PIN_NUM_DATA15 21 #endif #define EXAMPLE_PIN_NUM_PCLK 5 #define EXAMPLE_PIN_NUM_CS 3 #define EXAMPLE_PIN_NUM_DC 4 #define EXAMPLE_PIN_NUM_RST 2 #define EXAMPLE_PIN_NUM_BK_LIGHT 1 // The pixel number in horizontal and vertical #define EXAMPLE_LCD_H_RES 240 #define EXAMPLE_LCD_V_RES 280 // Bit number used to represent command and parameter #if CONFIG_EXAMPLE_LCD_I80_CONTROLLER_ST7789 #define EXAMPLE_LCD_CMD_BITS 8 #define EXAMPLE_LCD_PARAM_BITS 8 #elif CONFIG_EXAMPLE_LCD_I80_CONTROLLER_NT35510 #define EXAMPLE_LCD_CMD_BITS 16 #define EXAMPLE_LCD_PARAM_BITS 16 #elif CONFIG_EXAMPLE_LCD_I80_CONTROLLER_ILI9341 #define EXAMPLE_LCD_CMD_BITS 8 #define EXAMPLE_LCD_PARAM_BITS 8 #endif #if CONFIG_EXAMPLE_LCD_TOUCH_ENABLED #define EXAMPLE_I2C_NUM 0 // I2C number #define EXAMPLE_I2C_SCL 39 #define EXAMPLE_I2C_SDA 40 #endif #define EXAMPLE_LVGL_TICK_PERIOD_MS 2 // Supported alignment: 16, 32, 64. A higher alignment can enables higher burst transfer size, thus a higher i80 bus throughput. #define EXAMPLE_PSRAM_DATA_ALIGNMENT 64 extern void example_lvgl_demo_ui(lv_disp_t *disp); static bool example_notify_lvgl_flush_ready(esp_lcd_panel_io_handle_t panel_io, esp_lcd_panel_io_event_data_t *edata, void *user_ctx) { lv_disp_drv_t *disp_driver = (lv_disp_drv_t *)user_ctx; lv_disp_flush_ready(disp_driver); return false; } static void example_lvgl_flush_cb(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_map) { esp_lcd_panel_handle_t panel_handle = (esp_lcd_panel_handle_t) drv->user_data; int offsetx1 = area->x1; int offsetx2 = area->x2; int offsety1 = area->y1; int offsety2 = area->y2; // copy a buffer's content to a specific area of the display esp_lcd_panel_draw_bitmap(panel_handle, offsetx1, offsety1, offsetx2 + 1, offsety2 + 1, color_map); } #if CONFIG_EXAMPLE_LCD_TOUCH_ENABLED static void example_lvgl_touch_cb(lv_indev_drv_t * drv, lv_indev_data_t * data) { uint16_t touchpad_x[1] = {0}; uint16_t touchpad_y[1] = {0}; uint8_t touchpad_cnt = 0; /* Read touch controller data */ esp_lcd_touch_read_data(drv->user_data); /* Get coordinates */ bool touchpad_pressed = esp_lcd_touch_get_coordinates(drv->user_data, touchpad_x, touchpad_y, NULL, &touchpad_cnt, 1); if (touchpad_pressed && touchpad_cnt > 0) { data->point.x = touchpad_x[0]; data->point.y = touchpad_y[0]; data->state = LV_INDEV_STATE_PRESSED; } else { data->state = LV_INDEV_STATE_RELEASED; } } #endif static void example_increase_lvgl_tick(void *arg) { /* Tell LVGL how many milliseconds has elapsed */ lv_tick_inc(EXAMPLE_LVGL_TICK_PERIOD_MS); } void app_main(void) { static lv_disp_draw_buf_t disp_buf; // contains internal graphic buffer(s) called draw buffer(s) static lv_disp_drv_t disp_drv; // contains callback functions ESP_LOGI(TAG, "Turn off LCD backlight"); gpio_config_t bk_gpio_config = { .mode = GPIO_MODE_OUTPUT, .pin_bit_mask = 1ULL << EXAMPLE_PIN_NUM_BK_LIGHT }; ESP_ERROR_CHECK(gpio_config(&bk_gpio_config)); gpio_set_level(EXAMPLE_PIN_NUM_BK_LIGHT, EXAMPLE_LCD_BK_LIGHT_OFF_LEVEL); ESP_LOGI(TAG, "Initialize Intel 8080 bus"); esp_lcd_i80_bus_handle_t i80_bus = NULL; esp_lcd_i80_bus_config_t bus_config = { .clk_src = LCD_CLK_SRC_DEFAULT, .dc_gpio_num = EXAMPLE_PIN_NUM_DC, .wr_gpio_num = EXAMPLE_PIN_NUM_PCLK, .data_gpio_nums = { EXAMPLE_PIN_NUM_DATA0, EXAMPLE_PIN_NUM_DATA1, EXAMPLE_PIN_NUM_DATA2, EXAMPLE_PIN_NUM_DATA3, EXAMPLE_PIN_NUM_DATA4, EXAMPLE_PIN_NUM_DATA5, EXAMPLE_PIN_NUM_DATA6, EXAMPLE_PIN_NUM_DATA7, #if CONFIG_EXAMPLE_LCD_I80_BUS_WIDTH > 8 EXAMPLE_PIN_NUM_DATA8, EXAMPLE_PIN_NUM_DATA9, EXAMPLE_PIN_NUM_DATA10, EXAMPLE_PIN_NUM_DATA11, EXAMPLE_PIN_NUM_DATA12, EXAMPLE_PIN_NUM_DATA13, EXAMPLE_PIN_NUM_DATA14, EXAMPLE_PIN_NUM_DATA15, #endif }, .bus_width = CONFIG_EXAMPLE_LCD_I80_BUS_WIDTH, .max_transfer_bytes = EXAMPLE_LCD_H_RES * 100 * sizeof(uint16_t), .psram_trans_align = EXAMPLE_PSRAM_DATA_ALIGNMENT, .sram_trans_align = 4, }; ESP_ERROR_CHECK(esp_lcd_new_i80_bus(&bus_config, &i80_bus)); esp_lcd_panel_io_handle_t io_handle = NULL; esp_lcd_panel_io_i80_config_t io_config = { .cs_gpio_num = EXAMPLE_PIN_NUM_CS, .pclk_hz = EXAMPLE_LCD_PIXEL_CLOCK_HZ, .trans_queue_depth = 10, .dc_levels = { .dc_idle_level = 0, .dc_cmd_level = 0, .dc_dummy_level = 0, .dc_data_level = 1, }, .flags = { .swap_color_bytes = !LV_COLOR_16_SWAP, // Swap can be done in LvGL (default) or DMA }, .on_color_trans_done = example_notify_lvgl_flush_ready, .user_ctx = &disp_drv, .lcd_cmd_bits = EXAMPLE_LCD_CMD_BITS, .lcd_param_bits = EXAMPLE_LCD_PARAM_BITS, }; ESP_ERROR_CHECK(esp_lcd_new_panel_io_i80(i80_bus, &io_config, &io_handle)); esp_lcd_panel_handle_t panel_handle = NULL; #if CONFIG_EXAMPLE_LCD_I80_CONTROLLER_ST7789 ESP_LOGI(TAG, "Install LCD driver of st7789"); esp_lcd_panel_dev_config_t panel_config = { .reset_gpio_num = EXAMPLE_PIN_NUM_RST, .rgb_endian = LCD_RGB_ENDIAN_RGB, .bits_per_pixel = 16, }; ESP_ERROR_CHECK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle)); esp_lcd_panel_reset(panel_handle); esp_lcd_panel_init(panel_handle); // Set inversion, x/y coordinate order, x/y mirror according to your LCD module spec // the gap is LCD panel specific, even panels with the same driver IC, can have different gap value esp_lcd_panel_invert_color(panel_handle, true); esp_lcd_panel_set_gap(panel_handle, 0, 20); #elif CONFIG_EXAMPLE_LCD_I80_CONTROLLER_NT35510 ESP_LOGI(TAG, "Install LCD driver of nt35510"); esp_lcd_panel_dev_config_t panel_config = { .reset_gpio_num = EXAMPLE_PIN_NUM_RST, .rgb_endian = LCD_RGB_ENDIAN_BGR, .bits_per_pixel = 16, }; ESP_ERROR_CHECK(esp_lcd_new_panel_nt35510(io_handle, &panel_config, &panel_handle)); esp_lcd_panel_reset(panel_handle); esp_lcd_panel_init(panel_handle); // Set inversion, x/y coordinate order, x/y mirror according to your LCD module spec // the gap is LCD panel specific, even panels with the same driver IC, can have different gap value esp_lcd_panel_swap_xy(panel_handle, true); esp_lcd_panel_mirror(panel_handle, true, false); #elif CONFIG_EXAMPLE_LCD_I80_CONTROLLER_ILI9341 // ILI9341 is NOT a distinct driver, but a special case of ST7789 // (essential registers are identical). A few lines further down in this code, // it's shown how to issue additional device-specific commands. ESP_LOGI(TAG, "Install LCD driver of ili9341 (st7789 compatible)"); esp_lcd_panel_dev_config_t panel_config = { .reset_gpio_num = EXAMPLE_PIN_NUM_RST, .rgb_endian = LCD_RGB_ENDIAN_BGR, .bits_per_pixel = 16, }; ESP_ERROR_CHECK(esp_lcd_new_panel_st7789(io_handle, &panel_config, &panel_handle)); esp_lcd_panel_reset(panel_handle); esp_lcd_panel_init(panel_handle); // Set inversion, x/y coordinate order, x/y mirror according to your LCD module spec // the gap is LCD panel specific, even panels with the same driver IC, can have different gap value esp_lcd_panel_swap_xy(panel_handle, true); esp_lcd_panel_invert_color(panel_handle, false); // ILI9341 is very similar to ST7789 and shares the same driver. // Anything unconventional (such as this custom gamma table) can // be issued here in user code and need not modify the driver. esp_lcd_panel_io_tx_param(io_handle, 0xF2, (uint8_t[]) { 0 }, 1); // 3Gamma function disable esp_lcd_panel_io_tx_param(io_handle, 0x26, (uint8_t[]) { 1 }, 1); // Gamma curve 1 selected esp_lcd_panel_io_tx_param(io_handle, 0xE0, (uint8_t[]) { // Set positive gamma 0x0F, 0x31, 0x2B, 0x0C, 0x0E, 0x08, 0x4E, 0xF1, 0x37, 0x07, 0x10, 0x03, 0x0E, 0x09, 0x00 }, 15); esp_lcd_panel_io_tx_param(io_handle, 0xE1, (uint8_t[]) { // Set negative gamma 0x00, 0x0E, 0x14, 0x03, 0x11, 0x07, 0x31, 0xC1, 0x48, 0x08, 0x0F, 0x0C, 0x31, 0x36, 0x0F }, 15); #endif // user can flush pre-defined pattern to the screen before we turn on the screen or backlight ESP_ERROR_CHECK(esp_lcd_panel_disp_on_off(panel_handle, true)); ESP_LOGI(TAG, "Turn on LCD backlight"); gpio_set_level(EXAMPLE_PIN_NUM_BK_LIGHT, EXAMPLE_LCD_BK_LIGHT_ON_LEVEL); #if CONFIG_EXAMPLE_LCD_TOUCH_ENABLED esp_lcd_touch_handle_t tp = NULL; esp_lcd_panel_io_handle_t tp_io_handle = NULL; ESP_LOGI(TAG, "Initialize I2C"); const i2c_config_t i2c_conf = { .mode = I2C_MODE_MASTER, .sda_io_num = EXAMPLE_I2C_SDA, .scl_io_num = EXAMPLE_I2C_SCL, .sda_pullup_en = GPIO_PULLUP_ENABLE, .scl_pullup_en = GPIO_PULLUP_ENABLE, .master.clk_speed = 400000, }; /* Initialize I2C */ ESP_ERROR_CHECK(i2c_param_config(EXAMPLE_I2C_NUM, &i2c_conf)); ESP_ERROR_CHECK(i2c_driver_install(EXAMPLE_I2C_NUM, i2c_conf.mode, 0, 0, 0)); #if CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_GT911 esp_lcd_panel_io_i2c_config_t tp_io_config = ESP_LCD_TOUCH_IO_I2C_GT911_CONFIG(); #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_TT21100 esp_lcd_panel_io_i2c_config_t tp_io_config = ESP_LCD_TOUCH_IO_I2C_TT21100_CONFIG(); #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_FT5X06 esp_lcd_panel_io_i2c_config_t tp_io_config = ESP_LCD_TOUCH_IO_I2C_FT5x06_CONFIG(); #endif ESP_LOGI(TAG, "Initialize touch IO (I2C)"); /* Touch IO handle */ ESP_ERROR_CHECK(esp_lcd_new_panel_io_i2c((esp_lcd_i2c_bus_handle_t)EXAMPLE_I2C_NUM, &tp_io_config, &tp_io_handle)); esp_lcd_touch_config_t tp_cfg = { .x_max = EXAMPLE_LCD_V_RES, .y_max = EXAMPLE_LCD_H_RES, .rst_gpio_num = -1, .int_gpio_num = -1, .flags = { .swap_xy = 1, .mirror_x = 1, .mirror_y = 0, }, }; /* Initialize touch */ #if CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_GT911 ESP_LOGI(TAG, "Initialize touch controller GT911"); ESP_ERROR_CHECK(esp_lcd_touch_new_i2c_gt911(tp_io_handle, &tp_cfg, &tp)); #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_TT21100 ESP_LOGI(TAG, "Initialize touch controller TT21100"); ESP_ERROR_CHECK(esp_lcd_touch_new_i2c_tt21100(tp_io_handle, &tp_cfg, &tp)); #elif CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_FT5X06 ESP_LOGI(TAG, "Initialize touch controller FT5X06"); ESP_ERROR_CHECK(esp_lcd_touch_new_i2c_ft5x06(tp_io_handle, &tp_cfg, &tp)); #endif #endif ESP_LOGI(TAG, "Initialize LVGL library"); lv_init(); // alloc draw buffers used by LVGL // it's recommended to choose the size of the draw buffer(s) to be at least 1/10 screen sized lv_color_t *buf1 = NULL; lv_color_t *buf2 = NULL; #if CONFIG_EXAMPLE_LCD_I80_COLOR_IN_PSRAM buf1 = heap_caps_aligned_alloc(EXAMPLE_PSRAM_DATA_ALIGNMENT, EXAMPLE_LCD_H_RES * 100 * sizeof(lv_color_t), MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT); #else buf1 = heap_caps_malloc(EXAMPLE_LCD_H_RES * 100 * sizeof(lv_color_t), MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL); #endif assert(buf1); #if CONFIG_EXAMPLE_LCD_I80_COLOR_IN_PSRAM buf2 = heap_caps_aligned_alloc(EXAMPLE_PSRAM_DATA_ALIGNMENT, EXAMPLE_LCD_H_RES * 100 * sizeof(lv_color_t), MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT); #else buf2 = heap_caps_malloc(EXAMPLE_LCD_H_RES * 100 * sizeof(lv_color_t), MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL); #endif assert(buf2); ESP_LOGI(TAG, "buf1@%p, buf2@%p", buf1, buf2); // initialize LVGL draw buffers lv_disp_draw_buf_init(&disp_buf, buf1, buf2, EXAMPLE_LCD_H_RES * 100); ESP_LOGI(TAG, "Register display driver to LVGL"); lv_disp_drv_init(&disp_drv); disp_drv.hor_res = EXAMPLE_LCD_H_RES; disp_drv.ver_res = EXAMPLE_LCD_V_RES; disp_drv.flush_cb = example_lvgl_flush_cb; disp_drv.draw_buf = &disp_buf; disp_drv.user_data = panel_handle; lv_disp_t *disp = lv_disp_drv_register(&disp_drv); ESP_LOGI(TAG, "Install LVGL tick timer"); // Tick interface for LVGL (using esp_timer to generate 2ms periodic event) const esp_timer_create_args_t lvgl_tick_timer_args = { .callback = &example_increase_lvgl_tick, .name = "lvgl_tick" }; esp_timer_handle_t lvgl_tick_timer = NULL; ESP_ERROR_CHECK(esp_timer_create(&lvgl_tick_timer_args, &lvgl_tick_timer)); ESP_ERROR_CHECK(esp_timer_start_periodic(lvgl_tick_timer, EXAMPLE_LVGL_TICK_PERIOD_MS * 1000)); #if CONFIG_EXAMPLE_LCD_TOUCH_ENABLED static lv_indev_drv_t indev_drv; // Input device driver (Touch) lv_indev_drv_init(&indev_drv); indev_drv.type = LV_INDEV_TYPE_POINTER; indev_drv.disp = disp; indev_drv.read_cb = example_lvgl_touch_cb; indev_drv.user_data = tp; lv_indev_drv_register(&indev_drv); #endif ESP_LOGI(TAG, "Display LVGL animation"); example_lvgl_demo_ui(disp); while (1) { // raise the task priority of LVGL and/or reduce the handler period can improve the performance vTaskDelay(pdMS_TO_TICKS(10)); // The task running lv_timer_handler should have lower priority than that running `lv_tick_inc` lv_timer_handler(); } }