Wiring guide

How to wire a buzzer to an ESP32-C3

To wire a buzzer to an ESP32-C3, connect 1 to GPIO 5 and 2 to GND. 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-C3 · 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-C3 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-C3 pinWire colorWhy
Pin 1GPIO 5ambertone() puts a square wave at the note’s frequency on this pin.
Pin 2GNDblueGround. A passive piezo has no polarity.
Voltage

Power and logic levels for buzzer and ESP32-C3

Logic level

The ESP32-C3’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-C3 DevKitM-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 8 carries the onboard LED and GPIO 9 is the BOOT button, and both are also the default I2C pins. GPIO 2, 8 and 9 are strapping pins, and only GPIO 0 to 4 can read an analog voltage.

The sketch

The working code for the ESP32-C3

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

Tones on ESP32-C3 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-C3

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 GPIO 8 or 9

GPIO 8 drives the onboard LED and GPIO 9 is the BOOT button, and both are strapping pins read at power-on. Wired to the buzzer, either can stop a real board from booting. GPIO 4 and GPIO 5 are free of both.

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.