readme.md
Markdown · 54 lines
# ESP32 ILI9341 Matrix Captive Portal Display

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