Back to Explorer

esp32-ILI9341

Project Information

Author

Mikrobot.pl

Board

ESP32 Dev Module

SDK Version

3.3.6

Platform

ESP32

Created

Updated

Description

ESP32 creates an open Wi-Fi Access Point (no password) with a captive portal. From the portal you can set a text that is displayed centered on a 2.8" ILI9341 TFT (320×240). In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.

Flash to Device

Login required: You need to login or create an account to flash this project.

Sorry, your browser doesn't support Web Serial.Web Serial requires HTTPS.

README

ESP32 ILI9341 Matrix Captive Portal Display

Example usage

Short description

ESP32 creates an open Wi-Fi Access Point (no password) with a captive portal.
From the portal you can set a text that is displayed centered on a 2.8" ILI9341 TFT (320×240).
In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.


Wiring (ESP32 ↔ ILI9341 SPI 2.8" 320×240)

This setup uses ESP32 VSPI hardware pins (recommended).

ILI9341 / TFT pin ESP32 pin Notes
VCC 3.3V TFT logic power
GND GND Ground
CS GPIO 5 Chip Select
DC GPIO 2 Data/Command
RESET / RST GPIO 4 Reset (can be tied to ESP32 EN, but GPIO recommended)
SCK / CLK GPIO 18 SPI clock (VSPI SCK)
MOSI / SDA GPIO 23 SPI MOSI (VSPI MOSI)
MISO / SDO GPIO 19 SPI MISO (VSPI MISO)
LED / BL VIN (5V) Backlight power (as requested)

Notes

  • Ensure your TFT module supports 3.3V logic on SPI lines (most ILI9341 SPI modules do).
  • LED/BL to VIN (5V) is common, but if your module has no current limiting, consider powering BL from 3.3V or through a resistor/transistor.
  • If you also use microSD on the same module, it shares SPI lines; you’ll need a separate SD_CS pin (not used in this project).

Required libraries

Install these via Arduino Library Manager:

  • Adafruit GFX Library
  • Adafruit ILI9341

ESP32 core built-ins (no extra install):

  • WiFi
  • WebServer
  • DNSServer

How to use

  1. Flash the firmware to ESP32 using FlashESP.
  2. Power up ESP32 + TFT.
  3. Connect your phone/PC to Wi-Fi network: ESP32_Display (open network).
  4. Captive portal should open automatically (if not, open any site or go to http://192.168.4.1).
  5. Enter a text and press Display.
  6. The text appears centered while Matrix background continues.

Default text on boot: mikrobot.pl