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
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 pin | ESP32-C3 pin | Wire color | Why |
|---|---|---|---|
| Pin 1 | GPIO 5 | amber | tone() puts a square wave at the note’s frequency on this pin. |
| Pin 2 | GND | blue | Ground. A passive piezo has no polarity. |
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 working code for the ESP32-C3
Library: none, the sketch makes the note with tone(). This is the sketch the circuit above runs.
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);
}
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
AgainCommon 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.