### Support for development kits with embedded TFT displays.
Several ESP32 evaluation kits are supported via preconfigurations.
- ESP Wrover Kit v4.1
- M5Stack
- M5Stick
- M5StickC
- Adafruit 3.5 Featherwing
- RPi MPI3501
- Wemos Lolin OLED
- ER-TFT035-6
- AIRcable ATAGv3
### Install this project as a library submodule in your own project
It is recommended to install this repo as a submodule in your IDF project's git repo. The configuration system has been designed so that you do not need to copy or edit any files in this repo. By keeping your submodule directory clean you can ensure reproducible builds and easy updates from this upstream repository.
From your project root (you can get the esp32 idf project template [here](https://github.com/espressif/esp-idf-template)):
4. Edit your CMake or Makefile to add this repo's components folder to the IDF components path.
#### CMake
The examples below are taken from the ESP-IDF [blink](https://github.com/espressif/esp-idf/tree/master/examples/get-started/blink) example which you can copy and use as the basis for your own project.
The project root CMakeLists.txt file needs one line added, just before the project to add the extra components directory to the path like this:
When adding this project as a component you need to update it's CMakeLists.txt file located at the root directory, like so (comment out the include line):
In the CMakeLists.txt file for your `/main` or for the component(s) using LVGL you need to add REQUIRES directives for this project's driver and lvgl itself to the `idf_component_register` function, it should look like this:
* SPI Bus: Choose what SPI bus is used to communicate with the tft controller.
![Touch SPI Bus](images/tft_spi_bus.png)
* Display resolution - set the height and width of the display
![TFT Resolution](images/tft_width_height.png)
* Invert display - if text and objects are backwards, you can enable this
* Enable backlight control via GPIO (vs hardwiring on)
* Backlight active high or low - some displays expect a high (1) signal to enable backlight, others expect (low) (default) - if your backlight doesn't come on try switching this
### 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. Its recommended to use a predefined configuration below, but you can also set individual pins for both display controller and touch controller.
For development kits that come with a display already attached, all the correct settings are already known and can be selected in `menuconfig` from the first option "Select predefined display configuration." Once selected all the other options will be defaulted and won't appear in the menu.