2.8 inch SPI Screen Module TFT Interface 240 x 320 without Touch

• The Voltage Problem: The Arduino Uno operates on 5V logic, but the ILI9341 driver chip communicates using 3.3V logic.
• The Consequence: Connecting the data lines directly from the Uno to the display will cause the screen to overheat, glitch, or fail permanently.
• The Fix: You must place a 1kΩ resistor inline (in series) on every data pin to drop the current and protect the display logic lines.

1. Open your Arduino IDE.
2. Go to Tools ➔ Manage Libraries… (or press Ctrl + Shift + I).
3. In the search bar, type Adafruit ILI9341 and click Install.
4. Next, search for Adafruit GFX Library and click Install.
5. If a prompt asks to install dependencies (like Adafruit BusIO), select Install All. [6, 7, 8, 9]

#include "SPI.h"
#include "Adafruit_GFX.h"
#include "Adafruit_ILI9341.h"

// Define the custom pins for Software (Bit-Banged) SPI
// Software SPI is highly reliable on the Uno and eliminates bus conflicts
#define TFT_CS    10
#define TFT_DC     9
#define TFT_RST    8
#define TFT_MOSI  11  
#define TFT_CLK   13  

// Instantiate the display constructor using Software SPI pins
Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_MOSI, TFT_CLK, TFT_RST, 12);

void setup() {
  // Initialize the screen driver
  tft.begin();
  
  // Set Orientation: 0 = Portrait (240x320), 1 = Landscape (320x240)
  tft.setRotation(1); 
  
  // Flash a solid background to wipe any boot-up noise
  tft.fillScreen(ILI9341_BLACK);
}

void loop() {
  // --- TEST 1: DISPLAY TEXT CHANNELS ---
  tft.fillScreen(ILI9341_NAVY); // Deep Blue Background
  
  // Print a Main Header Title
  tft.setCursor(40, 40);             // Coordinates (X, Y)
  tft.setTextColor(ILI9341_YELLOW);  // Text Color
  tft.setTextSize(3);                // Size Scale (1 is small, 3 is large)
  tft.println("RYTRONICS.IN");
  
  // Print a Subheading
  tft.setCursor(40, 90);
  tft.setTextColor(ILI9341_WHITE);
  tft.setTextSize(2);
  tft.println("ILI9341 Tutorial");

  // Print Status with Background Color Block (Prevents Text Flickering)
  tft.setCursor(40, 150);
  // Syntax: setTextColor(TextColor, BackgroundColor)
  tft.setTextColor(ILI9341_GREEN, ILI9341_NAVY); 
  tft.setTextSize(2);
  tft.println("Status: SYSTEM OK");
  
  delay(3000); // Hold layout for 3 seconds

  // --- TEST 2: DISPLAY GEOMETRIC SHAPES ---
  tft.fillScreen(ILI9341_BLACK); // Clear to Black
  
  // 1. Draw a white hollow bounding border frame
  // Parameters: drawRect(startX, startY, width, height, color)
  tft.drawRect(5, 5, 310, 230, ILI9341_WHITE);
  
  // 2. Draw a filled solid red rectangle block
  // Parameters: fillRect(startX, startY, width, height, color)
  tft.fillRect(30, 40, 80, 50, ILI9341_RED);
  
  // 3. Draw a hollow cyan circle
  // Parameters: drawCircle(centerX, centerY, radius, color)
  tft.drawCircle(220, 70, 30, ILI9341_CYAN);
  
  // 4. Draw a filled solid green circle
  // Parameters: fillCircle(centerX, centerY, radius, color)
  tft.fillCircle(220, 160, 25, ILI9341_GREEN);
  
  // 5. Draw a simple diagonal line crossing the canvas
  // Parameters: drawLine(startX, startY, endX, endY, color)
  tft.drawLine(30, 180, 150, 180, ILI9341_MAGENTA);

  delay(3000); // Hold geometry display for 3 seconds
}

• The Screen is Completely White: This means the screen is getting backlight power, but no data. Check if your SDI (MOSI) and SCK wires are mixed up or plugged into the wrong pin rows on your breadboard. [11]
• Text is Flickering Rapidly: If you update sensor data inside the loop() function, do not use tft.fillScreen() right before writing the text. Instead, use tft.setTextColor(TEXT_COLOR, BACKGROUND_COLOR). This draws a solid block over the old numbers, wiping them cleanly without a visible flash.
• Text Strings Mirror-Inverted or Upside Down: Change the value inside tft.setRotation(1). Cycling through parameters 0, 1, 2, or 3 rotates the display driver matrix by 90-degree increments until it fits your casing design perfectly. [12]