Drive ST7796 SPI TFT with XPT2046 Touch on ESP32-C3-DevKitM-1 (arduino-esp32), using TFT_eSPI.
This video show how to drive
4 inch 480x320 SPI TFT ST7796 with XPT2046 Touch
on
ESP32-C3-DevKitM-1
(arduino-esp32) using TFT_eSPI. Include prepare user setup file and touch
calibration.
TFT_eSPI can be installed using Arduino IDE Library Manager.
Check
the GitHub page of
TFT_eSPI,
it's Arduino and PlatformIO IDE compatible TFT library optimised for the
Raspberry Pi Pico (RP2040), STM32, ESP8266 and ESP32 that supports different
driver chips.
It's strongly recommended to follow the steps in Tips section in TFT_eSPI
page:
If you load a new copy of TFT_eSPI then it will overwrite your setups if
they are kept within the TFT_eSPI folder. One way around this is to create a
new folder in your Arduino library folder called "TFT_eSPI_Setups". You then
place your custom setup.h files in there. After an upgrade simply edit the
User_Setup_Select.h file to point to your custom setup file.
(The Touch part and TFT part share the same SPI interface)
ST7796 SPI ESP32-C3-DevKitM-1
# Pin
----------------------------------
1 VCC 3V3
2 GND GND
3 CS GPIO7 (SS)
4 RESET GPIO10
5 DC/RS GPIO9
6 SDI(MOSI) GPIO6 (MOSI)
7 SCK GPIO4 (SCK)
8 LED 3V3
9 SDO(MISO) GPIO5 (MISO)
10 T_CLK GPIO4 (SCK)
11 T_CS GPIO1
12 T_DIN GPIO6 (MOSI)
13 T_DO GPIO5 (MISO)
14 T_IRQ no connection
mySetup27_ST7796_ESP32.h, my setup.
// USER DEFINED SETTINGS
// Set driver type, fonts to be loaded, pins used and SPI control method etc
//
// See the User_Setup_Select.h file if you wish to be able to define multiple
// setups and then easily select which setup file is used by the compiler.
//
// If this file is edited correctly then all the library example sketches should
// run without the need to make any more changes for a particular hardware setup!
#define USER_SETUP_ID 27
// ##################################################################################
//
// Section 0. Call up the right driver file and any options for it
//
// ##################################################################################
// Display type - only define if RPi display
//#define RPI_DISPLAY_TYPE
// Only define one driver
#define ST7796_DRIVER
// ##################################################################################
//
// Section 1. Define the pins that are used to interface with the display here
//
// ##################################################################################
// >>>>> EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP32 SETUP <<<<<
// The ESP32 hardware SPI can be mapped to any pins, these are the recommended default
#define TFT_MISO 5
#define TFT_MOSI 6
#define TFT_SCLK 4
#define TFT_CS 7 // Chip select control pin
#define TFT_DC 9 // Data Command control pin
#define TFT_RST 10 // Reset pin (could connect to RST pin)
//#define TFT_RST -1 // Set TFT_RST to -1 if display RESET is connected to ESP32 board RST
#define TOUCH_CS 1 // Chip select pin (T_CS) of touch screen
// ##################################################################################
//
// Section 2. Not used for ESP32
//
// ##################################################################################
// ##################################################################################
//
// Section 3. Define the fonts that are to be used here
//
// ##################################################################################
// Comment out the #defines below with // to stop that font being loaded
// The ESP8366 and ESP32 have plenty of memory so commenting out fonts is not
// normally necessary. If all fonts are loaded the extra FLASH space required is
// about 17Kbytes. To save FLASH space only enable the fonts you need!
#define LOAD_GLCD // Font 1. Original Adafruit 8 pixel font needs ~1820 bytes in FLASH
#define LOAD_FONT2 // Font 2. Small 16 pixel high font, needs ~3534 bytes in FLASH, 96 characters
#define LOAD_FONT4 // Font 4. Medium 26 pixel high font, needs ~5848 bytes in FLASH, 96 characters
#define LOAD_FONT6 // Font 6. Large 48 pixel font, needs ~2666 bytes in FLASH, only characters 1234567890:-.apm
#define LOAD_FONT7 // Font 7. 7 segment 48 pixel font, needs ~2438 bytes in FLASH, only characters 1234567890:.
#define LOAD_FONT8 // Font 8. Large 75 pixel font needs ~3256 bytes in FLASH, only characters 1234567890:-.
//#define LOAD_FONT8N // Font 8. Alternative to Font 8 above, slightly narrower, so 3 digits fit a 160 pixel TFT
#define LOAD_GFXFF // FreeFonts. Include access to the 48 Adafruit_GFX free fonts FF1 to FF48 and custom fonts
// Comment out the #define below to stop the SPIFFS filing system and smooth font code being loaded
// this will save ~20kbytes of FLASH
#define SMOOTH_FONT
// ##################################################################################
//
// Section 4. Not used
//
// ##################################################################################
// ##################################################################################
//
// Section 5. Other options
//
// ##################################################################################
// Define the SPI clock frequency, this affects the graphics rendering speed. Too
// fast and the TFT driver will not keep up and display corruption appears.
// With an RPi ST7796 MH4.0 display 80MHz is OK for ESP32, 40MHz maximum for ESP8266
// #define SPI_FREQUENCY 20000000
#define SPI_FREQUENCY 40000000
// #define SPI_FREQUENCY 80000000
// The ESP32 has 2 free SPI ports i.e. VSPI and HSPI, the VSPI is the default.
// If the VSPI port is in use and pins are not accessible (e.g. TTGO T-Beam)
// then uncomment the following line:
//#define USE_HSPI_PORT
// The XPT2046 requires a lower SPI clock rate of 2.5MHz so we define that here:
#define SPI_TOUCH_FREQUENCY 2500000
Comments
Post a Comment