LittlevGL project for ESP32

Get started

Install the ESP32 SDK

1. Install ESP-IDF: http://esp-idf.readthedocs.io/en/latest/
2. Get this projects: git clone --recurse-submodules https://github.com/littlevgl/esp32_ili9341.git

Add LittlevGL to the build

To link LittlevGL (lvgl) and lv_examples with ESP-IDF you need to add a component.mk file to each directory.

Espressif recommends to add third party software into a directory named components, so lvgl and lv_examples directories are located in a directory named components.

Next to this README file you find two component.mk template files:

• lvgl_component.mk
• lv_example_component.mk

Rename lvgl_component.mk to component.mk and move it to the lvgl directory, then rename lv_example_component.mk to component.mk and move it to the lv_examples directory, remember lvgl and lv_examples directories are located into the components directory.

Then also move the lv_conf.h and lv_ex_conf.h files into the components directory.

Assign the correct pinout depending on your ESP32 dev board

There are several development boards based on the ESP32 chip, make sure you assign the correct pin numbers to the signals that interface with the TFT display board, below are some examples:

ESP32 Dev Board as the picture above

This project comes with an ILI9341 display driver and an XPT2046 resistive touchpad driver. Both devices are communicating via SPI.

ILI9341

For ILI9341 HSPI is used, modify the pin configuration in components/drv/disp_spi.h to:

#define DISP_SPI_MOSI 13
#define DISP_SPI_CLK  14
#define DISP_SPI_CS   5

and components/drv/ili9341.h to:

#define ILI9341_DC   19
#define ILI9341_RST  18
#define ILI9341_BCKL 23

XPT2046

For XPT2046 VSPI is used, modify the pin configuration in components/drv/tp_spi.h to:

#define TP_SPI_MOSI 32
#define TP_SPI_MISO 35
#define TP_SPI_CLK  26
#define TP_SPI_CS   33

and components/drv/xpt2046.h to:

#define XPT2046_IRQ 25

ESP32 DevKit v1 with 30 GPIOS

There is another development kit with only 30 GPIOs available:

ILI9341

For ILI9341 HSPI is used, modify the pin configuration in components/drv/disp_spi.h to:

#define DISP_SPI_MOSI 13
#define DISP_SPI_CLK  14
#define DISP_SPI_CS   15

and components/drv/ili9341.h to:

#define ILI9341_DC   2
#define ILI9341_RST  4
#define ILI9341_BCKL 21

XPT2046

For XPT2046 VSPI is used, modify the pin configuration in components/drv/tp_spi.h to:

#define TP_SPI_MOSI 23
#define TP_SPI_MISO 19
#define TP_SPI_CLK  18
#define TP_SPI_CS   5

and components/drv/xpt2046.h to:

#define XPT2046_IRQ 25

Flash to ESP32

1. Go to the project's directory: cd esp32_ili9431
2. Build the project: make
3. Upload the application to your board: make flash