How to Use Adafruit 1.54inch 240x240 IPS TFT: Examples, Pinouts, and Specs

The Adafruit 1.54inch 240x240 IPS TFT (Manufacturer Part ID: 3787) is a compact, high-resolution display module designed for embedded systems and DIY electronics projects. Featuring a 240x240 pixel resolution with IPS (In-Plane Switching) technology, this display offers wide viewing angles and vibrant color reproduction. It is ideal for applications requiring a small yet high-quality display, such as wearable devices, IoT dashboards, and portable instruments.

• Wearable electronics (e.g., smartwatches)
• IoT devices and dashboards
• Portable measurement tools
• Compact user interfaces for embedded systems
• Gaming devices and retro consoles

Below are the key technical details of the Adafruit 1.54inch 240x240 IPS TFT:

The display module has a total of 7 pins. Below is the pinout and description:

To use the Adafruit 1.54inch 240x240 IPS TFT with an Arduino UNO, follow these steps:

1. Wiring the Display: Connect the display module to the Arduino UNO as shown below:

   Display Pin	Arduino UNO Pin
   VIN	5V
   GND	GND
   SCK	D13
   MOSI	D11
   CS	D10
   DC	D9
   RST	D8

2. Install Required Libraries:

   • Download and install the Adafruit_GFX and Adafruit_ST7789 libraries from the Arduino Library Manager.

3. Example Code: Use the following example code to initialize and display graphics on the screen:

   // Include necessary libraries
   #include <Adafruit_GFX.h>       // Core graphics library
   #include <Adafruit_ST7789.h>   // Driver for ST7789 display
   
   // Define pins for the display
   #define TFT_CS    10  // Chip Select pin
   #define TFT_DC    9   // Data/Command pin
   #define TFT_RST   8   // Reset pin
   
   // Create an instance of the display
   Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);
   
   void setup() {
     // Initialize the display
     tft.init(240, 240);  // Initialize with 240x240 resolution
     tft.setRotation(1);  // Set display orientation (1 = landscape)
   
     // Fill the screen with a solid color
     tft.fillScreen(ST77XX_BLACK);
   
     // Draw a rectangle with text
     tft.fillRect(50, 50, 140, 140, ST77XX_BLUE);
     tft.setTextColor(ST77XX_WHITE);
     tft.setTextSize(2);
     tft.setCursor(60, 100);
     tft.print("Hello!");
   }
   
   void loop() {
     // Nothing to do here
   }
   

• Ensure the power supply voltage matches the display's requirements (3.3V or 5V).
• Use level shifters if interfacing with a 5V logic system to avoid damaging the display.
• Avoid excessive bending or stress on the display module to prevent damage.
• Use the Adafruit_GFX library for advanced graphics functions like shapes, text, and images.

1. Display Not Turning On:

   • Cause: Incorrect wiring or insufficient power supply.
   • Solution: Double-check all connections and ensure the VIN pin is receiving 3.3V or 5V.

2. No Image or Incorrect Colors:

   • Cause: Incorrect initialization or library mismatch.
   • Solution: Verify that the Adafruit_GFX and Adafruit_ST7789 libraries are installed and up to date. Ensure the tft.init() function is called with the correct resolution.

3. Flickering or Artifacts:

   • Cause: SPI communication issues or loose connections.
   • Solution: Check the SPI clock speed and ensure all connections are secure.

4. Reset Pin Not Working:

   • Cause: RST pin not connected or improperly configured.
   • Solution: Ensure the RST pin is connected to the correct Arduino pin and is properly defined in the code.

Q: Can I use this display with a Raspberry Pi?
A: Yes, the display is compatible with Raspberry Pi. You can use the SPI interface and appropriate libraries like Pillow or ST7789 Python libraries.

Q: What is the maximum SPI clock speed supported?
A: The display supports SPI clock speeds up to 15 MHz for optimal performance.

Q: Can I use this display in outdoor environments?
A: While the display has a wide operating temperature range, it is not waterproof or sunlight-readable. Consider additional enclosures or filters for outdoor use.

Q: How do I display images on the screen?
A: Use the Adafruit_GFX library to load bitmap images. Convert images to a compatible format (e.g., 24-bit BMP) before displaying them.

This concludes the documentation for the Adafruit 1.54inch 240x240 IPS TFT. For further assistance, refer to the official Adafruit guide or community forums.