3.5 inch SPI TFT Liquid Crystal Display Module Touch Screen ILI9488 /6 /1 Driver 320X480 COM52 R36

Description

• 3.5-inch color screen, supports 65K color display, rich display colors
• 480X320 HD resolution, optional touch function
• Using SPI serial bus, only a few IOs are needed to light up the display
• With SD card slot for convenient expansion experiments
• Provide rich sample programs
• Military-grade process standards, long-term stable work
• Provide underlying driver technical support

Product Description

• TFT_eSPI
• XPT2046_Touchscreen

After adding TFT_eSPI library to your IDE, you will need to make some modifications to User_Setup.h file to make everything work. In this repository, there is a copy of User_Setup.h with modifications. The following are some modification made to the file:

1. Defining driver [one to be defined the other ones must be commented out] (line 45-64)

   // #define ILI9341_DRIVER       // Generic driver for common displays
   ...
   #define ILI9488_DRIVER     // WARNING: Do not connect ILI9488 display SDO to MISO if other devices share the SPI bus (TFT SDO does NOT tristate when CS is high)
   ...

2. Defining the pins that are used to interface with the display here (line 112)
   • Comment out ESP8266 NodeMCU pins and uncomment ESP32 pins

   #define TFT_MISO 19
   #define TFT_MOSI 23
   #define TFT_SCLK 18
   #define TFT_CS   15  // Chip select control pin
   #define TFT_DC    2  // Data Command control pin
   #define TFT_RST   4  // 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 21     // Chip select pin (T_CS) of touch screen 
   ...

3. Define the ESP32 SPI port to use (line 374)
   • As we are using Virtual SPI (VSPI) port, we need to uncomment this line

     #define USE_HSPI_PORT

With the Touch_Calibration sketch, the min/max values (TS_MINX, TS_MAXX, TS_MINY, TS_MAXY) will be available in the serial monitor for direct use in your touchscreen mapping logic.

In you sketch you will need to replace these values with the one you have got:

#define TS_MINX 200
#define TS_MAXX 3700
#define TS_MINY 240
#define TS_MAXY 3800

Note: This is tested on ILI9488_DRIVER. If you have different type, update the User_Setup.h file

The On/Off Button Example is designed to toggle an LED connected to pin 12. However, you might encounter a “flipping” issue, where the touch input does not align with the location of the desired effect on the screen. This issue arises because the raw touchscreen coordinates do not correspond directly to the screen’s orientation or dimensions. To resolve this, calibration is required to map the raw touch coordinates accurately to the display area, accounting for any flipping or mismatches.

Here are some key areas you may change in your codes

1. Screen dimensions

   ...
   #define SCREEN_WIDTH 320
   #define SCREEN_HEIGHT 480
   ...

2. Screen rotation

   touchscreen.setRotation(0);  // Match screen rotation
   ...
   tft.setRotation(0);  // Portrait orientation
   ...

3. Mapping raw touch coordinates to screen coordinates

   ...
   int touchX = map(p.x, TS_MAXX, TS_MINX, 0, SCREEN_WIDTH);
   int touchY = map(p.y, TS_MINY, TS_MAXY, 0, SCREEN_HEIGHT);
   ...

Upload the codes into your board and you will be getting the same screen as shown below: