Waveshare ESP32-Touch-LCD-3.5

3.5" 320x480 IPS LCD (ST7796S, SPI), FT6336U touch, ES8311 audio, TF card, AXP2101, PCF85063.

Building for it

A project is made for one toolchain, picked when you start it. All three can drive this board:

At a glance

Display pins

ST7796 / ST7796S on SPI (4-wire serial): SPI clock 40 MHz, host SPI3_HOST, BGR colour order, inversion on.

Touch pins

FT6236 / FT6336U: I2C address 0x38, 400 kHz, shares the display bus.

Also on the board

• I2C (GPIO 21 / 22) - SDA GPIO 21, SCL GPIO 22
• TCA9554PWR I/O expander at 0x20, driving the lines marked above

The preset adds these to the Hardware tab with the board, so a sensor can go straight onto the connector.

Designing for it in LCD Wizard

• Choose Waveshare ESP32-Touch-LCD-3.5 on the Hardware tab (or use the button above) and every pin on this page is filled in. The export writes the sketch, lcd_pins.h, the GFX Library for Arduino configuration, lv_conf.h and platformio.ini - a project that builds for this board as it comes.
• The FT6236 / FT6336U is capacitive and needs no calibration. The firmware resets it and checks it answers on every boot.
• The backlight is dimmable: give a slider or a button a Set backlight action.
• With PSRAM the LVGL memory pool can live there, leaving internal RAM for everything else.
• Screens are designed for 320 x 480 px in either orientation, with LVGL 9 or LVGL 8.

The parts

ST7796 / ST7796S. The usual 4.0" 320x480 controller. Faster than ILI9488 over SPI (true RGB565).

FT6236 / FT6336U. Register-compatible with the FT6206. Very common on 2.8"-3.5" capacitive TFTs.

ESP32 (WROOM / WROVER). No native RGB parallel peripheral - use SPI or an 8/16-bit i80 bus.

GFX Library for Arduino. Moshi Liu's library. Best QSPI/AMOLED and RGB coverage. Configured in code.

The pinout on one page

Every pin above, laid out to print and keep beside the bench. Generated from this preset, so it says exactly what the designer writes into lcd_pins.h.

Download the pinout (PNG)Open it as SVG

From the people who made it

The board’s own documentation. Pinouts on vendor pages do sometimes disagree with the hardware in front of you - where this page and that one differ, trust your board and tell us.

• The vendor’s product page
• Vendor documentation
• Schematic (PDF)
• Waveshare demo code (pins read from here)

Designs for this board

Nobody has published a design for this board yet. Publish yours from the designer and it appears here and in the gallery.

Similar boards

ESP32 + ILI9341 2.8" SPIThe classic breadboard combination: ESP32 DevKit, 2.8" ILI9341, XPT2046 resistive touch on the same SPI bus.ESP32 · ILI9341 240 x 320 · XPT2046 touchESP32-2432S028R "Cheap Yellow Display"2.8" 240x320 ILI9341 with XPT2046 resistive touch on a second SPI bus. The cheapest way into LVGL.ESP32 · ILI9341 320 x 240 · XPT2046 touchESP32-2432S028C (capacitive CYD)Capacitive variant of the Cheap Yellow Display: same ILI9341, CST820 touch over I2C.ESP32 · ILI9341 320 x 240 · CST820 touchLCDWIKI 2.8" ESP32-32E (E32R28T)A Cheap Yellow Display alternative: 2.8" 320x240 ILI9341V with XPT2046 resistive touch, an RGB LED, a speaker amplifier and battery charging. The LED and audio pins are not the Sunton board's.ESP32 · ILI9341 320 x 240 · XPT2046 touch

Next

• Quick start - from an empty screen to firmware on the board
• Boards and displays - presets, controllers, pins and touch in the designer
• Flashing and configuration - PlatformIO, the Arduino IDE and first-boot checks
• Troubleshooting - a white screen, mirrored image or touch that misses