Wiring guide

How to wire a buzzer to an ESP32-S3

To wire a buzzer to an ESP32-S3, connect 1 to GPIO 5 and 2 to G. A small passive piezo runs straight from a 3.3 V pin with its other leg on ground; it is a little quieter than at 5 V. The sketch below uses no library beyond what the board includes. It plays a four-note phrase and repeats it, printing Playing once and Again after each phrase.

  • 3.3 V logic
  • Library: none
  • 2 wires
ESP32-S3 · buzzerlive0.000 s 0.00x
Click to open it in the editor
The circuit itself, running on the simulator with the sketch below. Press what can be pressed; click anything else to open it in the editor.
Pin to pin

Buzzer to ESP32-S3 wiring table

Every wire in the circuit above, with the part’s pin names and the board’s own labels. The wire colors are the ones the circuit uses; on a real bench any colors work.

Buzzer pinESP32-S3 pinWire colorWhy
Pin 1GPIO 5ambertone() puts a square wave at the note’s frequency on this pin.
Pin 2GblueGround. A passive piezo has no polarity.
Voltage

Power and logic levels for buzzer and ESP32-S3

Logic level

The ESP32-S3’s GPIO pins are 3.3 V logic and are not 5 V tolerant. Nothing wired to a pin may go above 3.3 V.

This pair

A small passive piezo runs straight from a 3.3 V pin; it is quieter than at 5 V. On an ESP32-S3 DevKitC-1 tone() makes the square wave in hardware (LEDC), so the core is free while a note plays. A magnetic buzzer draws more than a pin should give, so drive one through a transistor.

Pins to leave alone

GPIO 19 and 20 are the USB port’s data lines, GPIO 35 to 37 belong to the PSRAM on octal-PSRAM boards such as the N8R8, and GPIO 0, 3, 45 and 46 are strapping pins.

The sketch

The working code for the ESP32-S3

Library: none, the sketch makes the note with tone(). This is the sketch the circuit above runs.

Tones on ESP32-S3 GPIO 5
const int BUZZER_PIN = 5;   // GPIO 5

// C, E, G, C: an arpeggio, a quarter second a note.
const int NOTES[] = {523, 659, 784, 1047};

void setup() {
  Serial.begin(115200);
  Serial.println("Playing");
}

void loop() {
  for (int i = 0; i < 4; i++) {
    tone(BUZZER_PIN, NOTES[i], 200);   // returns at once; the note plays on
    delay(250);
  }
  noTone(BUZZER_PIN);
  Serial.println("Again");
  delay(500);
}
Output

What you should see

The buzzer plays a short four-note phrase and then plays it again. The serial monitor, at 115200 baud, prints Playing at the start and Again after each phrase.

A buzzer that clicks once but never sounds a note is an active buzzer: it ignores tone() and needs only a HIGH level.

The serial monitor prints this, recorded from the circuit above running for two seconds:

Playing
Again
Pitfalls

Common mistakes wiring a buzzer to an ESP32-S3

An active buzzer

An active buzzer has its own oscillator and beeps at one pitch whenever it has power, so tone() cannot change its note. For melodies you need a passive one; the two look the same, but the active kind usually has a sticker on top.

No delay between notes

tone() does not wait for the note to finish. Call it twice in a row and only the second note plays. Wait at least as long as the note, as the sketch does.

Using the USB or PSRAM pins

GPIO 19 and 20 are the USB port’s data lines and GPIO 35 to 37 belong to the PSRAM on N8R8 boards. Wire the buzzer to one of those and the USB socket or the memory stops working on a real board, even though the simulator carries on. Stay on GPIO 4 to 18.

Build your own buzzer project

Open this circuit in the editor, change the wiring or the code, and keep your version in a free account.