ActuatorsBuzzer / Piezo
Passive Piezo Buzzer
Piezo buzzer that requires PWM — play melodies and variable-pitch tones, not just fixed beeps.
Wiring & code for
Passive Buzzer practical reference
A piezo buzzer that requires a driven PWM signal, allowing variable-pitch tones and simple melody playback rather than a fixed beep.
Key specifications
- Operating voltage: 3V - 5V DC
- Control: Requires a driven square wave (PWM or the Arduino tone() function) — pitch equals drive frequency
- Usable frequency range: ~2kHz - 5kHz for clearly audible tones (piezo response falls off outside this band)
- Silent when idle: No internal oscillator — a constant HIGH or LOW produces no sound, unlike an active buzzer
Pinout and connection notes
tone() on Arduino drives this directly from a digital pin with no extra hardware; on ESP32 use the ledc PWM API instead since tone() isn't implemented the same way there.
- VCC / I/O: Signal input on breakout modules with 3 pins — a raw 2-lead piezo just has + and -
- GND: Ground
- I/O: On 3-pin modules: the driven PWM/tone signal; on bare 2-lead piezos, drive across the two leads directly
Integration checklist
- Confirm the exact part number and breakout-board revision.
- Verify supply voltage, current demand, logic levels, and signal direction against the datasheet.
- Check controller pin assignments and bus address or interface mode against the example code.
- Power up with external loads disconnected, then test signals before full integration.
- If readings or communication fail, check power and ground first, then pin mapping, interface settings, and library initialization.
Troubleshooting and reproducibility
Record the board used, wiring, library/version, supply arrangement, and measured behavior. Use the selected board-specific wiring example as the source of truth. Never assume visually similar modules share identical voltage tolerance or pin order.