ESP32 KY-006 Passive Buzzer Module

🛠️ KY-006 Passive Buzzer Module Troubleshooting

This guide outlines a systematic approach to troubleshoot and resolve common problems with the . Start by confirming that the hardware connections are correct, as wiring mistakes are the most frequent cause of issues. If you are sure the connections are correct, follow the below steps to debug common issues.

🔇 No Sound from Buzzer

⚠️ Distorted or Unintended Sounds

💻 Code Examples

Below you can find code examples of KY-006 Passive Buzzer Module with ESP32 in several frameworks:

• Arduino IDE
• ESP-IDF
• ESPHome
• PlatformIO
• MicroPython

If you encounter issues while using the KY-006 Passive Buzzer Module, check the Common Issues Troubleshooting Guide.

ESP32 KY-006 Arduino IDE Code Example

Example in Arduino IDE

Fill in your main Arduino IDE sketch file with the following code to use the KY-006 Passive Buzzer Module:

#define BUZZER_PIN 8

void setup() {
    pinMode(BUZZER_PIN, OUTPUT);
}

void loop() {
    tone(BUZZER_PIN, 1000); // Play tone at 1000 Hz
    delay(500);
    noTone(BUZZER_PIN);     // Stop tone
    delay(500);
}

This Arduino code uses the tone() function to generate a 1000 Hz sound from the KY-006 passive buzzer connected to pin 8. The buzzer plays the tone for 500 milliseconds, then stops for 500 milliseconds, creating a beeping effect.

Connect your ESP32 to your computer via a USB cable, Ensure the correct Board and Port are selected under Tools, Click the "Upload" button in the Arduino IDE to compile and upload the code to your ESP32.

ESP32 KY-006 ESP-IDF Code Example

Example in Espressif IoT Framework (ESP-IDF)

This ESP-IDF code sets up the KY-006 passive buzzer on GPIO18 using the LEDC PWM module. It generates a 2 kHz tone by setting the duty cycle to 50% (512 out of 1024) and uses a hardware timer to control the frequency. The buzzer will continue to emit the tone until the duty cycle is set to 0 or the program stops.

ESP32 KY-006 ESPHome Code Example

Example in ESPHome (Home Assistant)

Fill in this configuration in your ESPHome YAML configuration file (example.yml) to integrate the KY-006 Passive Buzzer Module

output:
  - platform: ledc
    pin: GPIO18
    id: buzzer_pwm

switch:
  - platform: template
    name: "KY-006 Buzzer"
    turn_on_action:
      - output.set_frequency:
          id: buzzer_pwm
          frequency: 2000Hz
      - output.set_level:
          id: buzzer_pwm
          level: 50%
    turn_off_action:
      - output.set_level:
          id: buzzer_pwm
          level: 0%

This ESPHome configuration sets up the KY-006 passive buzzer on GPIO18 using the LEDC module for PWM control. The buzzer emits a 2 kHz tone when turned on and stops when turned off.

Upload this code to your ESP32 using the ESPHome dashboard or the esphome run command.

ESP32 KY-006 PlatformIO Code Example

Example in PlatformIO Framework

For PlatformIO, make sure to configure the platformio.ini file with the appropriate environment and libraries, and then proceed with the code.

Configure platformio.ini

First, your platformio.ini should look like below. You might need to include some libraries as shown. Make sure to change the board to your ESP32:

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino

ESP32 KY-006 PlatformIO Example Code

Write this code in your PlatformIO project under the src/main.cpp file to use the KY-006 Passive Buzzer Module:

#include <Arduino.h>

#define BUZZER_PIN 18

void setup() {
    pinMode(BUZZER_PIN, OUTPUT);
}

void loop() {
    tone(BUZZER_PIN, 2000); // Generate 2 kHz tone
    delay(500);
    noTone(BUZZER_PIN);
    delay(500);
}

This PlatformIO code initializes the KY-006 passive buzzer on GPIO18. It generates a 2 kHz tone for 500ms, then stops for 500ms, creating a beeping effect.

Upload the code to your ESP32 using the PlatformIO "Upload" button in your IDE or the pio run --target upload command.

ESP32 KY-006 MicroPython Code Example

Example in Micro Python Framework

Fill in this script in your MicroPython main.py file (main.py) to integrate the KY-006 Passive Buzzer Module with your ESP32.

import machine
import time

BUZZER_PIN = machine.Pin(18, machine.Pin.OUT)
PWM = machine.PWM(BUZZER_PIN)
PWM.freq(2000)

while True:
    PWM.duty(512)  # 50% duty cycle
    time.sleep(0.5)
    PWM.duty(0)
    time.sleep(0.5)

This MicroPython script configures the KY-006 passive buzzer on GPIO18 using PWM. It sets the frequency to 2 kHz and alternates between 50% duty cycle (sound on) and 0% duty cycle (sound off) every 500ms.

Upload this code to your ESP32 using a MicroPython-compatible IDE, such as Thonny, uPyCraft, or tools like ampy.