Waveshare ESP32-S3-ETH
ESP32-S3R8 board with W5500 wired Ethernet, an optional PoE module, a DVP camera connector, TF card slot and a Pico-compatible 40-pin header.
Waveshare ESP32-S3-ETH Pinout
40 pins · 2.54 mm pitch
| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | - | VBUS | power | - | USB bus 5V (Pico VBUS position) |
| 2 | - | VSYS | power | - | 5V system supply pin (Pico VSYS position) |
| 3 | - | GND | ground | - | Ground |
| 4 | - | 3V3_EN | control | - | 3.3V regulator enable (Pico 3V3_EN position) |
| 5 | - | 3V3 | power | - | 3.3V output from the onboard regulator |
| 6 | 21 | IO21GPIO21 | safe | pwm | Drives the onboard WS2812 RGB LED |
| 7 | 17 | IO17GPIO17 | safe | adc · pwm | ADC2 - not usable while Wi-Fi is active |
| 8 | - | GND | ground | - | Ground |
| 9 | 16 | IO16GPIO16 | safe | adc · pwm | ADC2 - not usable while Wi-Fi is active |
| 10 | 18 | IO18GPIO18 | safe | adc · pwm | ADC2; camera D7 when a camera is fitted |
| 11 | - | RUNCHIP_UPEN | control | - | Chip enable / reset input (Pico RUN position) |
| 12 | 15 | IO15GPIO15 | safe | adc · pwm | ADC2; camera D6 when a camera is fitted |
| 13 | - | GND | ground | - | Ground |
| 14 | 3 | IO3GPIO3 | strapping | adc · touch · pwm | ADC1, touch; camera XCLK when a camera is fitted |
| 15 | 2 | IO2GPIO2 | safe | adc · touch · pwm | ADC1, touch; camera HREF when a camera is fitted |
| 16 | 1 | IO1GPIO1 | safe | adc · touch · pwm | ADC1, touch; camera VSYNC when a camera is fitted |
| 17 | 0 | IO0GPIO0 | strapping | pwm | Wired to the BOOT button |
| 18 | - | GND | ground | - | Ground |
| 19 | 44 | IO44GPIO44UART0 RX | uart | uart · pwm | UART0 RX |
| 20 | 43 | IO43GPIO43UART0 TX | uart | uart · pwm | UART0 TX |
| 21 | 20 | IO20GPIO20D_P | usb | - | Native USB D+, wired to the USB-C port |
| 22 | 19 | IO19GPIO19D_N | usb | - | Native USB D-, wired to the USB-C port |
| 23 | - | GND | ground | - | Ground |
| 24 | 48 | IO48GPIO48 | strapping | pwm | Camera SIOD (SCCB data) when a camera is fitted |
| 25 | 47 | IO47GPIO47 | strapping | pwm | Camera SIOC (SCCB clock) when a camera is fitted |
| 26 | 46 | IO46GPIO46 | strapping | pwm | Camera D2 when a camera is fitted |
| 27 | 45 | IO45GPIO45 | strapping | pwm | Camera D1 when a camera is fitted |
| 28 | - | GND | ground | - | Ground |
| 29 | 42 | IO42GPIO42 | strapping | pwm | Camera D3 when a camera is fitted; JTAG MTMS |
| 30 | 41 | IO41GPIO41 | strapping | pwm | Camera D0 when a camera is fitted; JTAG MTDI |
| 31 | 40 | IO40GPIO40 | strapping | pwm | Camera D4 when a camera is fitted; JTAG MTDO |
| 32 | 39 | IO39GPIO39 | strapping | pwm | Camera PCLK when a camera is fitted; JTAG MTCK |
| 33 | - | GND | ground | - | Ground |
| 34 | 38 | IO38GPIO38 | safe | pwm | Camera D5 when a camera is fitted |
| 35 | 37 | IO37GPIO37 | strapping | - | Reserved by the octal PSRAM - not usable as GPIO |
| 36 | 36 | IO36GPIO36 | strapping | - | Reserved by the octal PSRAM - not usable as GPIO |
| 37 | 35 | IO35GPIO35 | strapping | - | Reserved by the octal PSRAM - not usable as GPIO |
| 38 | - | GND | ground | - | Ground |
| 39 | 34 | IO34GPIO34 | strapping | - | Reserved by the octal PSRAM - not usable as GPIO |
| 40 | 33 | IO33GPIO33 | strapping | - | Reserved by the octal PSRAM - not usable as GPIO |
Start with these
8 pins with no boot or system involvementFreely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.
Fine - with a little care
12 pins · 11 things to knowIO3 Bootstrapping pin (controls JTAG signal source) Strapping
Sampled at reset to select JTAG interface (USB Serial/JTAG controller vs. external pins). Improper use can disable external JTAG or alter debug interface.
IO0 Bootstrapping pin (Chip boot mode selection) Strapping
Must be pulled high (default) or low (to enter UART download mode) at reset. Using it for other functions can interfere with boot mode configuration.
IO44 UART0 receive pin (U0RXD), default serial console RX UART
Used for bootloader input (download mode via serial). If repurposed, you cannot use the default UART0 download mode for programming the chip.
IO43 UART0 transmit pin (U0TXD), default serial console TX UART
Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).
IO48IO47 Octal SPI differential clock legs (SPICLK_P/N_DIFF), used only by the 1.8 V octal flash/PSRAM variants Other
Only the 1.8 V octal parts (ESP32-S3R8V, ESP32-S3R16V) run the differential memory clock here, and on those the pin works at 1.8 V instead of 3.3 V. On the common 3.3 V modules it is a normal GPIO - several devkits drive their RGB LED from GPIO48.
- IO48Octal SPI differential clock negative leg (SPICLK_N_DIFF), used only by the 1.8 V octal flash/PSRAM variants
- IO47Octal SPI differential clock positive leg (SPICLK_P_DIFF), used only by the 1.8 V octal flash/PSRAM variants
IO46 Bootstrapping pin (used with GPIO0 for boot mode; controls ROM log output) Strapping
Must be at a defined level during reset (with GPIO0) to select normal or download boot and UART/USB print mode. This pin is input-only (no output drive), so it should be left for its intended strapping function.
IO45 Bootstrapping pin (selects VDD_SPI flash voltage) Strapping
Determines flash/PSRAM power voltage (3.3 V vs 1.8 V) at boot. Must match hardware configuration; using as GPIO can upset flash supply setting.
IO42 JTAG test mode select pin (MTMS) JTAG
Default JTAG TMS signal for debugging. Using this pin for other purposes will disable the JTAG interface (unless JTAG is rerouted to USB).
IO41 JTAG test data in pin (MTDI) JTAG
Default JTAG TDI input for debugging. Should be reserved for JTAG or left unused if JTAG is to remain available.
IO40 JTAG test data out pin (MTDO) JTAG
Default JTAG TDO output for debugging. Using it as GPIO will interfere with JTAG debugging functionality.
IO39 JTAG test clock (MTCK); IO MUX alternates CLK_OUT3 and SUBSPICS1 (chip select on the alternative SUBSPI memory bus, unused on standard modules) JTAG
Default JTAG TCK - keep it free if you debug over JTAG. It is not a flash or PSRAM line on standard modules: those sit on GPIO26-37.
Only if you know the tricks
7 pins · 2 things to knowIO20IO19 USB OTG differential data pair (D- and D+) USB
By default connected to the on-chip USB Serial/JTAG controller. Using it as general GPIO without reconfiguring IO MUX will interfere with USB functionality.
- IO20USB OTG positive differential data line (USB_D+)
- IO19USB OTG negative differential data line (USB_D-)
IO37IO36IO35IO34IO33 Octal (8-line) flash/PSRAM data and strobe lines on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts Flash
The datasheet keeps GPIO33-37 for "the higher 4 bits data line interface and DQS interface for the SPI0/1 interface in 8-line SPI mode", so octal-PSRAM modules (N16R8 and friends) consume it and do not break it out. On quad-PSRAM or PSRAM-less parts it is an ordinary GPIO - check which variant your module carries.
- IO37Octal (8-line) flash/PSRAM data strobe DQS/DM on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts
- IO36Octal (8-line) flash/PSRAM data line DQ7 on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts
- IO35Octal (8-line) flash/PSRAM data line DQ6 on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts
- IO34Octal (8-line) flash/PSRAM data line DQ5 on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts
- IO33Octal (8-line) flash/PSRAM data line DQ4 on R8/R16V modules; free on quad-PSRAM and PSRAM-less parts
The Waveshare ESP32-S3-ETH pinout brings out 40 pins at a 2.54 mm pitch - 25 usable GPIO alongside the VBUS, VSYS, GND and 3V3 power rails.
Beyond plain digital I/O you get 7 ADC-capable pins for sensors and battery monitoring, PWM on 20 pins and 3 capacitive-touch inputs.
12 of the exposed pins carry boot-time or system duties on the ESP32-S3 (IO3, IO0, IO44 and 9 more) - check the guidance above before wiring anything to them. IO21, IO17, IO16, IO18 and 4 more are free of any such role - the safest first picks.
Pinout notes The 40-pin header copies the Raspberry Pi Pico layout: VBUS, VSYS, 3V3_EN and RUN sit where the Pico puts them, and a ground pin falls at every fifth position.…
The 40-pin header copies the Raspberry Pi Pico layout: VBUS, VSYS, 3V3_EN and RUN sit where the Pico puts them, and a ground pin falls at every fifth position. The I/O positions carry ESP32-S3 GPIO numbers rather than Pico GP numbers, so a Pico HAT may fit but firmware written for the RP2040 numbering needs remapping.
On the left side, IO21 drives the WS2812 LED, IO15 to IO18 are ADC2 inputs that cannot be read while Wi-Fi is active, IO1 to IO3 are ADC1 and touch pins, IO0 is the BOOT button, and IO43/IO44 are UART0. On the right, IO19/IO20 are the native USB data lines already wired to the USB-C port, IO39 to IO42 double as JTAG, and IO33 to IO37 are taken by the octal PSRAM - they are on the header but cannot be used as GPIO, which leaves 20 free I/O pins rather than 25.
Three peripherals live on pins that never reach the header: the W5500 on IO9 to IO14 (SCLK 13, MOSI 11, MISO 12, CS 14, INT 10, RST 9), the TF card on IO4 to IO7 (CS 4, MISO 5, MOSI 6, SCLK 7) and the camera power gate on IO8. The camera data path, however, shares 14 header pins - VSYNC 1, HREF 2, XCLK 3, PCLK 39, SIOD 48, SIOC 47 and D7-D0 on 18, 15, 38, 40, 42, 46, 45, 41 - so with a camera plugged in those pins are no longer free.
Getting started
flash your first firmware in ~2 minutesBoard: ESP32S3 Dev Module USB CDC On Boot: Enabled Flash Size: 16MB (128Mb) Flash Mode: QIO PSRAM: OPI PSRAM Partition Scheme: Huge APP (3MB No OTA/1MB SPIFFS) Upload Speed: 921600
// toggle GPIO21 - wire an LED and resistor to it
void setup() {
pinMode(21, OUTPUT);
}
void loop() {
digitalWrite(21, HIGH); delay(500);
digitalWrite(21, LOW); delay(500);
}[env:waveshare-esp32-s3-eth]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.arduino.memory_type = qio_opi
build_flags = -DBOARD_HAS_PSRAMesp32-s3-devkitc-1 - or type it after board =.esp32:
board: esp32-s3-devkitc-1
variant: esp32s3
framework:
type: esp-idf
psram:
mode: octal
speed: 80MHz
# blink - GPIO21
output:
- platform: gpio
pin: 21
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesp32-s3-devkitc-1 (same ids as PlatformIO).esptool.py --chip esp32s3 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x0 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Good to know
board-specific quirks worth 60 secondsThe u.FL socket does nothing until you move a resistor. Out of the box the RF path goes to the ceramic antenna, selected by a 0 ohm resistor that is mounted vertically. To use an external antenna on the IPEX Gen 1 (u.FL) socket, re-solder that resistor horizontally so it routes the signal to the connector. Plugging an antenna in without the change has no effect.
Camera power is gated by GPIO8, which is not on the header. Until GPIO8 is driven low before the camera driver starts, the sensor stays undetected and the driver returns ESP_ERR_NOT_FOUND (0x105). In Arduino assign GPIO8 as the PWDN pin; in ESPHome add a gpio switch on GPIO8 with a higher setup priority so it is set before the camera initialises.
Downloads
Free for non-commercial use, credit espboards.dev · License
Board illustration
The bare Waveshare ESP32-S3-ETH board drawn to scale at 72.8 × 21 mm, with no pin labels on it. Made for slide decks, wiring diagrams and project write-ups where a photo is too busy. Take the scalable SVG for print or editing, the high-resolution PNG to drop straight in, or the transparent PNG when you need it with no background behind it.
Pinout diagram
Every pin on both sides of the board with its functions, drawn by ESPboards from the ESP32-S3 Series Datasheet v2.2 - the same sheet shown at the top of this page. The PNG is a high-resolution image for screens, the SVG is vector so it stays sharp at any size, and the PDF is laid out to print on A4 or Letter.
Yours to use, share and adapt for non-commercial work, as long as you credit espboards.dev - the full terms and ready-made credit lines are here.
Specifications
ESP32-S3 · 72.8 × 21 mm · vs other ESP32 chips →Dimensions
About this board
Inside sits the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.
At $16.99 it's cheaper than most ESP32-S3 boards, which usually run around $29.
Around the module: 8MB (OPI) PSRAM, a microSD slot, an addressable RGB LED (GPIO21), wired Ethernet (W5500), status LEDs (ACT, LINK) and Boot/Reset buttons.
It flashes over native USB - no serial-converter driver needed, which isn't a given among ESP32-S3 boards.
The Waveshare ESP32-S3-ETH is an ESP32-S3R8 board built around wired networking. A W5500 Ethernet controller with an H1102NLT transformer sits on the board, and a header takes Waveshare's optional IEEE 802.3af PoE module, which comes fitted on the -POE- SKUs. The chip brings 8 MB of octal PSRAM, a W25Q128 provides 16 MB of flash, and the S3's own radio uses a ceramic antenna with a u.FL socket beside it.
Beyond the Ethernet jack the board carries a DVP camera connector (OV5640-compatible, camera sold separately or bundled in the CAM-KIT SKUs), a TF card slot, a WS2812 RGB LED on GPIO21, Boot and Reset buttons, and ACT and LINK Ethernet LEDs. The single USB-C port goes straight to the S3's native USB, so there is no separate serial bridge. Power comes from 5V over USB-C or the header, or from 44-57V PoE with the module.
The 40-pin header follows the Raspberry Pi Pico footprint, so some Pico expansion boards fit mechanically, and the board is sold bare or with headers pre-soldered (ESP32-S3-ETH-M). At 21 x 72.8 mm it is a long, narrow board. It suits wired or PoE-powered nodes - a camera, a sensor gateway, an ESPHome or Tasmota device - where a Wi-Fi link is not wanted. The trade-off is pin budget: the TF card and the W5500 take GPIO4-7 and GPIO9-14 internally, a fitted camera consumes 14 header pins, and GPIO33-37 on the header are reserved by the PSRAM, so plan the I/O before buying.
- Pico-compatible 40-pin header - some Raspberry Pi Pico expansion boards fit
- DVP camera connector (OV5640-compatible), camera sold separately or in the CAM-KIT SKUs
- PoE expansion header - IEEE 802.3af module fitted on the -POE- SKUs
- H1102NLT Ethernet transformer and W25Q128 16MB flash
- Sold bare (ESP32-S3-ETH) or with pre-soldered headers (ESP32-S3-ETH-M)
FAQ
6 common questionsWhich pins does the W5500 Ethernet controller use?›
Can I use GPIO33 to GPIO37 on the right-hand header?›
Can I power the board over PoE and USB at the same time?›
Which camera sensor comes with the CAM-KIT?›
How do I set the board up in the Arduino IDE?›
Where is the TF card slot wired?›
Where to buy
prices are typical street pricesResources
Similar boards
