How to Use Adafruit 2.0 inch 240x320 IPS TFT: Examples, Pinouts, and Specs

The Adafruit 2.0 inch 240x320 IPS TFT (Manufacturer Part ID: 4311) is a compact display module designed for embedded systems and portable devices. It features a 2.0-inch diagonal screen with a resolution of 240x320 pixels, utilizing In-Plane Switching (IPS) technology to deliver wide viewing angles and vibrant color reproduction. This display is ideal for applications requiring high-quality visuals in a small form factor, such as handheld devices, IoT interfaces, and custom user interfaces.

• Portable devices and handheld electronics
• IoT dashboards and control panels
• Wearable technology
• Embedded systems requiring graphical displays
• Prototyping and hobbyist projects

The Adafruit 2.0 inch 240x320 IPS TFT module has the following pinout:

1. Power Supply: Connect the VIN pin to a 3.3V or 5V power source and the GND pin to ground.
2. SPI Communication: Connect the SCK and MOSI pins to the corresponding SPI pins on your microcontroller.
3. Control Pins:
   • Connect the CS pin to a GPIO pin on your microcontroller to enable/disable communication.
   • Connect the DC pin to a GPIO pin to toggle between data and command modes.
   • Connect the RST pin to a GPIO pin or tie it to the reset line of your microcontroller.
4. Backlight Control: Connect the BL pin to a PWM-capable GPIO pin for adjustable brightness or tie it to VIN for full brightness.

• Voltage Levels: Ensure that the logic levels of your microcontroller are compatible with the display (3.3V logic; 5V-tolerant inputs).
• SPI Speed: Use an appropriate SPI clock speed (typically up to 10 MHz) to ensure reliable communication.
• Backlight Power: Avoid driving the backlight directly from a GPIO pin; use a transistor or PWM driver if needed.
• Reset Pin: If not using the RST pin, connect it to VIN through a pull-up resistor.

Below is an example of how to use the Adafruit 2.0 inch 240x320 IPS TFT with an Arduino UNO. This example uses the Adafruit GFX and Adafruit ST7789 libraries.

#include <Adafruit_GFX.h>    // Core graphics library
#include <Adafruit_ST7789.h> // Driver for the ST7789 display
#include <SPI.h>             // SPI library

// Define pin connections
#define TFT_CS   10  // Chip Select pin
#define TFT_DC    9  // Data/Command pin
#define TFT_RST   8  // Reset pin

// Initialize the display object
Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);

void setup() {
  // Initialize serial communication for debugging
  Serial.begin(9600);
  Serial.println("Adafruit 2.0 inch 240x320 IPS TFT Test");

  // Initialize the display
  tft.init(240, 320); // Initialize with width=240 and height=320
  tft.setRotation(1); // Set display orientation (0-3)

  // Fill the screen with a solid color
  tft.fillScreen(ST77XX_BLACK);

  // Display a message
  tft.setTextColor(ST77XX_WHITE);
  tft.setTextSize(2);
  tft.setCursor(10, 10);
  tft.println("Hello, World!");
}

void loop() {
  // Add your code here to update the display
}

• Install the Adafruit GFX and Adafruit ST7789 libraries via the Arduino Library Manager before running the code.
• Adjust the TFT_CS, TFT_DC, and TFT_RST pin definitions to match your wiring.

1. Display Not Turning On:

   • Verify the power connections (VIN and GND).
   • Ensure the RST pin is properly connected or tied high.

2. No Image or Incorrect Display:

   • Check the SPI connections (SCK, MOSI, CS, DC).
   • Ensure the correct initialization parameters (e.g., resolution) are used in the code.

3. Flickering or Dim Backlight:

   • Verify the backlight (BL) pin connection.
   • Use a stable power source for the backlight.

4. Incorrect Colors or Artifacts:

   • Ensure the SPI clock speed is within the recommended range.
   • Check for loose or poor-quality connections.

Q: Can I use this display with a 5V microcontroller?
A: Yes, the display's inputs are 5V-tolerant, but the logic level is 3.3V. Ensure proper connections.

Q: How do I adjust the brightness?
A: Connect the BL pin to a PWM-capable GPIO pin and use PWM to control brightness.

Q: What is the maximum SPI clock speed?
A: The display typically supports SPI clock speeds up to 10 MHz for reliable operation.

Q: Can I use this display in portrait and landscape modes?
A: Yes, the display orientation can be changed using the setRotation() function in the Adafruit ST7789 library.