Boards / All-in-one boards

Waveshare ESP32-S3-Touch-LCD-3.5B

3.5" 320x480 AXS15231B over QSPI with touch in the same chip, an ES8311 codec with a microphone and speaker output, IMU, RTC, battery charging, a TF card and a camera connector.

Design a UI for this board Test my board Purchase this board Read the quick start

Affiliate link: LCD Wizard may earn a commission if you buy through it.

Building for it

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

Toolchain
Arduino (C++)	Every board, every widget and every peripheral here. The most control, and the most to set up. Start a project
MicroPython	Change a screen by editing a file on the board. No compiler once it is flashed. Start a project
ESPHome	No compiler to install, and the panel can join Home Assistant as real entities. Start a project
ESP-IDF (C)	Espressif's own framework: esp_lcd, the component registry and idf.py, with nothing of Arduino in it. Start a project

At a glance

Part	Detail
Maker	Waveshare
MCU	ESP32-S3 Xtensa LX7 dual-core @ 240 MHz, 512 KB SRAM (+ 2-16 MB PSRAM on most modules)
Display	Astra AXS15231B, 320 x 480 px, QSPI (quad SPI), 16-bit colour
Touch	Astra AXS15231B (touch half) (capacitive, I2C)
Backlight	GPIO 6, dimmable (PWM)
Memory	16 MB flash, 8 MB octal PSRAM (N16R8)
Graphics library	GFX Library for Arduino

Display pins

AXS15231B on QSPI (quad SPI): QSPI clock 40 MHz, host SPI2_HOST, RGB colour order, inversion off.

Signal	Pin
SCK	GPIO 5
D0 - D3	GPIO 1, 2, 3, 4
CS	GPIO 12
RESET	TCA9554 pin 1
Backlight	GPIO 6

Touch pins

AXS15231B (touch half): I2C address 0x3B, 400 kHz, shares the display bus.

Signal	Pin
SDA	GPIO 8
SCL	GPIO 7
RESET	not connected

Also on the board

I2C (GPIO 8 / 7, header pins 27 / 25) - SDA GPIO 8, SCL GPIO 7
TCA9554 I/O expander at 0x20, driving the lines marked above
Power - AXP2101, at 0x34, on I2C (GPIO 8 / 7, header pins 27 / 25)
IMU - QMI8658, at 0x6B, on I2C (GPIO 8 / 7, header pins 27 / 25)
RTC - PCF85063, at 0x51, on I2C (GPIO 8 / 7, header pins 27 / 25)
SDCard - SD card, CLK GPIO 11, CMD GPIO 10, D0 GPIO 9
Camera, on I2C (GPIO 8 / 7, header pins 27 / 25), XCLK GPIO 38, PCLK GPIO 41, VSYNC GPIO 17, HREF GPIO 18, D0 GPIO 45, D1 GPIO 47, D2 GPIO 48, D3 GPIO 46, D4 GPIO 42, D5 GPIO 40, D6 GPIO 39, D7 GPIO 21, PWDN TCA9554 pin 0 (arrives switched off in a new design)
The camera connector. It arrives switched off because only the "-C" version of this board has a camera fitted, and because its clock, sync and data lines are twelve of the header's pins. Its control lines are the board's I2C bus, and its power-down line is EXIO0.
Boot Button - input on GPIO 0

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

Check your revision. Panel reset (EXIO1), the speaker amplifier (EXIO7) and the TF card's DAT3 (EXIO3) are on the TCA9554 at 0x20; touch, the ES8311, the AXP2101, the QMI8658 and the PCF85063 share the I2C bus on GPIO 8/7. The panel ignores the row address over QSPI, so the export draws whole frames from a canvas in PSRAM. MCLK is GPIO44, which is also the header's RXD - leave it alone while audio is on. USB-C goes straight to the S3, so the serial log needs USB CDC On Boot (the export sets it). The microphone goes into the ES8311 and comes back on GPIO 14 - switch it on under Hardware > Audio. The camera connector is in the kit, switched off: only the "-C" version of the board has a camera fitted. Its clock, sync and data lines are GPIO 38, 41, 17, 18 and 45, 47, 48, 46, 42, 40, 39, 21 - header pins on a board with no camera - its control lines are the I2C bus, and its power-down is EXIO0.

Designing for it in LCD Wizard

Choose Waveshare ESP32-S3-Touch-LCD-3.5B 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 AXS15231B (touch half) 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

AXS15231B. Combined display + capacitive touch controller. Touch shares the same part. Drawn a whole frame at a time, so it needs PSRAM.

AXS15231B (touch half). The same silicon as the AXS15231B display controller; touch is read over I2C.

ESP32-S3. The only common Arduino target with a hardware RGB565 LCD peripheral. PSRAM is effectively required for RGB panels.

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

The same pins as data - board.json and pins.csv - are in the open pinout dataset on GitHub, free to reuse under CC BY 4.0.

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.

Designs for this board

Dashboard for waveshare 3.5by Volos

Clone any of them into the designer, or see every design for this board in the gallery.

Waveshare ESP32-S3-Touch-LCD-3.493.49" 172x640 IPS LCD (AXS15231B, QSPI), AXS15231B (integrated touch) touch, ES8311 speaker and ES7210 microphones, TF card, QMI8658, PCF85063, battery sense.ESP32-S3 · AXS15231B 172 x 640 · AXS15231B (touch half) touchPurchase this board

Guition JC3248W535 (3.5" capacitive, ESP32-S3)3.5" 320x480 AXS15231B over QSPI with touch in the same chip, ESP32-S3 with 16 MB flash and 8 MB PSRAM, a TF card, an I2S speaker amplifier and battery charging.ESP32-S3 · AXS15231B 320 x 480 · AXS15231B (touch half) touch

Waveshare ESP32-S3-AMOLED-1.91 / ESP32-S3-Touch-AMOLED-1.911.91" 240x536 AMOLED (RM67162, QSPI), FT3168 touch, TF card, QMI8658C, battery sense.ESP32-S3 · RM67162 240 x 536 · FT3168 / FT6146 touchPurchase this board

Waveshare ESP32-S3-AMOLED-1.91 / ESP32-S3-Touch-AMOLED-1.91 (V1 board)1.91" 240x536 AMOLED (RM67162, QSPI), FT3168 touch, QMI8658C, battery sense.ESP32-S3 · RM67162 240 x 536 · FT3168 / FT6146 touchPurchase this board

Waveshare ESP32-S3-Knob-Touch-LCD-1.81.8" 360x360 round IPS LCD (ST77916, QSPI), CST816D touch, PCM5100A speaker, TF card, battery sense.ESP32-S3 · ST77916 360 x 360 · CST816S touch

Waveshare ESP32-S3-Touch-AMOLED-1.321.32" 466x466 round AMOLED (CO5300, QSPI), CST820 touch, ES8311 speaker and microphone, battery sense.ESP32-S3 · CO5300 466 x 466 · CST820 touchPurchase this board

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