Passive Buzzer: Piezo Assumptions and ESP32 Tones

Before you start

Board and software

Classic ESP32-WROOM-32/32E DevKit with the specified unused GPIOs exposed; Arduino IDE 2.x and Arduino-ESP32 3.x. Other families require their own pin map. Serial Monitor: 115200 baud. No extra library.

Supported hardware

A two-terminal external-drive piezo sounder rated for a 0–3.3 V square-wave drive, with its manufacturer-approved drive circuit. The illustration's passive label does not prove piezo construction, resonance or current. A magnetic sounder needs a separate documented driver and inductive protection.

Prerequisites and parts

Complete IDE setup. Qualified piezo sounder, known 1 kiloohm series resistor, wires and breadboard. Check the actual sounder's permitted voltage, frequency and driver requirements.

Expected result

A 2 kHz tone lasts 250 ms, followed by silence for one second. Serial prints TONE and SILENT. Volume depends on the sounder and the series resistor.

Verification limits

Documentation and automated content/browser checks only in this update. No ESP32 compilation or physical hardware testing. The approved image depicts a component family; it does not authenticate a model, rating or terminal order.

Overview

02Technical Specifications

Arduino library: Arduino-ESP32 3.x; no additional library

03Pinout

• Piezo drive terminal Use the actual documented drive terminal; artwork is not pin identification. GPIO25 through 1 kiloohm Use the actual documented drive terminal; artwork is not pin identification.
• Piezo return terminal Follow manufacturer polarity/drive instructions if present. ESP32 GND Follow manufacturer polarity/drive instructions if present.

04Wiring Diagram

Qualified piezo drive terminal → 1 kiloohm → GPIO25; return → GND. No magnetic or active sounder substitution.

Open wiring diagram at full size (new tab)

1. 1

   Disconnect power and confirm external-drive piezo construction and permitted waveform.

2. 2

   Wire the series resistor and common return; keep sounder away from ears.

3. 3

   Upload and open Serial Monitor; if silent, verify construction and frequency requirements before changing the circuit.

Wiring and matching Arduino code

Short tone with pin-based LEDC

Qualified piezo drive terminal → 1 kiloohm → GPIO25; return → GND. No magnetic or active sounder substitution.

#include <Arduino.h>
constexpr uint8_t BUZZER_PIN = 25;
bool ready = false;
void setup() {
  Serial.begin(115200);
  pinMode(BUZZER_PIN, OUTPUT);
  digitalWrite(BUZZER_PIN, LOW);
  ready = ledcAttach(BUZZER_PIN, 2000, 8);
  if (!ready) Serial.println("LEDC attach failed; check board and resources.");
}
void loop() {
  if (!ready) { delay(1000); return; }
  if (ledcWriteTone(BUZZER_PIN, 2000) == 0) {
    ledcWriteTone(BUZZER_PIN, 0);
    Serial.println("Tone setup failed.");
    delay(1000);
    return;
  }
  Serial.println("TONE");
  delay(250);
  ledcWriteTone(BUZZER_PIN, 0);
  Serial.println("SILENT");
  delay(1000);
}

Arduino-ESP32 3.x APIs take the pin, not an old channel number. No tone library required. Zero frequency sets duty to zero; sounder ratings must be checked separately.

How it works

Technical references

• Espressif GPIO API — Pin modes and digital output on Arduino-ESP32.
• Murata piezoelectric sound components — Manufacturer guidance on external versus self-drive sounders; not a model identification.
• Espressif LEDC API — ledcAttach, pin-based ledcWriteTone and zero-frequency behavior.