# esp32-ILI9488

> 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 3.5" ILI9488 TFT (320×480). In the background a Matrix-style falling characters animation runs continuously with more visible black space and random column activity.

- Author: Mikrobot.pl
- Platform: ESP32
- Board: ESP32 Dev Module (`esp32:esp32:esp32`)
- SDK version: 3.3.6
- Tags: #test, #esp32, #example, #captive portal, #wifi, #ili, #ili9488
- Created: 2026-10-14
- Updated: 2026-10-14
- Favorites: 1, forks: 0
- Project page (view, flash from the browser, fork): https://flashesp.com/explore/VSPY0Oy1gVjngHaxAvza1
- Download all sources (zip): https://flashesp.com/api/public-projects/VSPY0Oy1gVjngHaxAvza1/download-sources/

## Source files

- [libraries_lock.json (243 B)](https://flashesp.com/explore/VSPY0Oy1gVjngHaxAvza1/files/bSpJEGqqSa7iPcncPgoNa.md)
- [main.ino (5.5 KB)](https://flashesp.com/explore/VSPY0Oy1gVjngHaxAvza1/files/7LMkIeT8RPxIVmFa19G6k.md)
- readme.md (2.5 KB)

## README

# ESP32 ILI9488 Matrix Captive Portal Display

<p align="center">
  <img src="https://i.imgur.com/1Xs7AcH.jpeg" alt="Example usage" title="Example usage" width="500">
</p>

## 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 3.5" ILI9488 TFT (480×320).  
In the background a **Matrix-style falling characters** animation runs continuously with more visible black space and random column activity.

---

## Wiring (ESP32 ↔ ILI9488 SPI 3.5" 480×320)
> This setup uses ESP32 **VSPI** hardware pins (recommended).

| ILI9488 / TFT pin | ESP32 pin | Notes |
|---|---:|---|
| **VCC** | **3.3V** | TFT logic power |
| **GND** | **GND** | Ground |
| **CS** | **GPIO 5** | Chip Select |
| **DC / RS** | **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 ILI9488 SPI modules do; some 3.5" boards expect 5V logic and need level shifting).
- ILI9488 over SPI uses **18-bit color (RGB666, 3 bytes per pixel)** and tops out around **24 MHz** SPI. If you see artifacts, lower the clock with `tft.begin(16000000)`.
- 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. The library can also drive it from a GPIO via `tft.initBacklight(pin)` / `tft.setBacklight(0-255)`.
- 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:
- **DIYables TFT SPI** (provides the `DIYables_ILI9488_SPI` driver)
- **Adafruit GFX Library** (pulled in as a dependency)

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**
