# Using Piezo Buzzers with WipperSnapper ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/117/322/medium800/adafruit_io_ksnip_20230104-161956.png?1672867356) Piezo buzzers are simple devices that can generate basic beeps and tones. They work by using a piezo crystal, a special material that changes shape when voltage is applied to it. If the crystal pushes against a diaphragm, like a tiny speaker cone, it can generate a pressure wave that the human ear picks up as sound. Simply change the frequency of the voltage sent to the piezo and it will start generating sounds by changing shape very quickly! This guide will explore how to generate tones with a piezo buzzer, code-free, with Adafruit IO WipperSnapper. It will also explore how to use a piezo buzzer as an alarm for a temperature sensor. ## What is WipperSnapper WipperSnapper is a firmware designed to turn any WiFi-capable board into an Internet-of-Things device without programming a single line of code. WipperSnapper connects to [Adafruit IO](https://io.adafruit.com/), a web platform designed ([by Adafruit!](https://www.adafruit.com/about)) to _display_, _respond_, and _interact_ with your project's data. Simply load the WipperSnapper firmware onto your board, add credentials, and plug it into power. Your board will automatically register itself with your Adafruit IO account. From there, you can add _components_ to your board such as buttons, switches, potentiometers, sensors, and more! Components are _dynamically _added to hardware, so you can immediately start interacting, logging, and streaming the data your projects produce without writing code. ## Parts ### Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM [Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM](https://www.adafruit.com/product/5400) One of our star Feathers is the [Adafruit HUZZAH32 ESP32 Feather](https://www.adafruit.com/product/3405) - with the fabulous ESP32 WROOM module on there, it makes quick work of WiFi and Bluetooth® projects that take advantage of Espressifs most popular chipset. Recently we had... In Stock [Buy Now](https://www.adafruit.com/product/5400) [Related Guides to the Product](https://learn.adafruit.com/products/5400/guides) ![Top view of black rectangle-shaped microcontroller.](https://cdn-shop.adafruit.com/640x480/5400-13.jpg) ### Large Enclosed Piezo Element w/Wires [Large Enclosed Piezo Element w/Wires](https://www.adafruit.com/product/1739) This large (30mm diameter) piezo element is nicely enclosed with mounting holes so you can attach easily. Piezo elements convert vibration to voltage or voltage to vibration. That means you can use this as a buzzer for making beeps, tones and alerts AND you can use it as a sensor, to detect... Out of Stock [Buy Now](https://www.adafruit.com/product/1739) [Related Guides to the Product](https://learn.adafruit.com/products/1739/guides) ![Large Enclosed Piezo Element with two Wires](https://cdn-shop.adafruit.com/640x480/1739-00.jpg) ### Piezo Buzzer [Piezo Buzzer](https://www.adafruit.com/product/160) Piezo buzzers are used for making beeps, tones and alerts. This one is petite but loud! Drive it with 3-30V peak-to-peak square wave. To use, connect one pin to ground (either one) and the other pin to a square wave out from a timer or microcontroller. For the loudest tones, stay around 4 KHz,... In Stock [Buy Now](https://www.adafruit.com/product/160) [Related Guides to the Product](https://learn.adafruit.com/products/160/guides) ![Bread-board friendly Piezo Buzzer](https://cdn-shop.adafruit.com/640x480/160-01.jpg) ### Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor [Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor](https://www.adafruit.com/product/5187) Take a deep breath in...now slowly breathe out. Mmm isn't it wonderful? All that air around us, which we bring into our lungs, extracts oxygen from and then breathes out carbon dioxide. CO2 is essential for life on this planet we call Earth - we and plants take turns using and... In Stock [Buy Now](https://www.adafruit.com/product/5187) [Related Guides to the Product](https://learn.adafruit.com/products/5187/guides) ![Angled shot of Adafruit SCD-40 - NDIR CO2 Temperature and Humidity Sensor.](https://cdn-shop.adafruit.com/640x480/5187-08.jpg) ### Adafruit IO+ Subscription Pass – One Year [Adafruit IO+ Subscription Pass – One Year](https://www.adafruit.com/product/3792) The all-in-one Internet of Things service from Adafruit you know and love is now _even better_ with IO+. The 'plus' stands for MORE STUFF! More feeds, dashboards, storage, speed. Power up your [Adafruit IO](https://io.adafruit.com/) with the $99 pass for 1 year of the... In Stock [Buy Now](https://www.adafruit.com/product/3792) [Related Guides to the Product](https://learn.adafruit.com/products/3792/guides) ![Text image that reads "IO+"](https://cdn-shop.adafruit.com/640x480/3792-01.jpg) ### Part: Half Size Breadboard and 78 Piece Jumper Wire in various lengths Half Size Breadboard + 78 Piece 22AWG Jumper Wire Bundle quantity: 1 Set [Half Size Breadboard and 78 Piece Jumper Wire in various lengths Half Size Breadboard + 78 Piece 22AWG Jumper Wire Bundle](https://www.adafruit.com/product/3314) ### Part: STEMMA QT / Qwiic Cable quantity: 1 JST SH 4-Pin Cable - 50mm Long [STEMMA QT / Qwiic Cable](https://www.adafruit.com/product/4399) ### Part: USB A to micro B Cable quantity: 1 Fully Reversible, Pink/Purple, 1m long [USB A to micro B Cable](https://www.adafruit.com/product/4111) # Using Piezo Buzzers with WipperSnapper ## Wiring # Wiring To connect a piezo buzzer you just need to connect one leg of the buzzer to your board ground, and another leg to a PWM-capable or analog-out output of your board. Here's how to wire a piezo to a Feather ESP32 V2: ![](https://cdn-learn.adafruit.com/assets/assets/000/117/313/medium800/adafruit_io_piezo.png?1672863217) - **One leg of the piezo buzzer** (or black wire) to **board GND**. - **The other leg of the piezo buzzer** (or red wire) to **board D14**  (or any other PWM-capable output). # Using Piezo Buzzers with WipperSnapper ## WipperSnapper Setup Warning: ## What is WipperSnapper WipperSnapper is a firmware designed to turn any WiFi-capable board into an Internet-of-Things device without programming a single line of code. WipperSnapper connects to [Adafruit IO](https://io.adafruit.com/), a web platform designed ([by Adafruit!](https://www.adafruit.com/about)) to _display_, _respond_, and _interact_ with your project's data. Simply load the WipperSnapper firmware onto your board, add credentials, and plug it into power. Your board will automatically register itself with your Adafruit IO account. From there, you can add _components_ to your board such as buttons, switches, potentiometers, sensors, and more! Components are _dynamically _added to hardware, so you can immediately start interacting, logging, and streaming the data your projects produce without writing code. ## Sign up for Adafruit.io You will need an Adafruit IO account to use WipperSnapper on your board. If you do not already have one, head over to [io.adafruit.com](https://io.adafruit.com/) to create a _free_ account. ## Add a New Device to Adafruit IO Log into your [Adafruit IO](https://io.adafruit.com/) account. Click the _New Device_ button at the top of the page. ![](https://cdn-learn.adafruit.com/assets/assets/000/112/548/medium800/wippersnapper_setup__board_selector__web__new_device_1.png?1655919766) After clicking New Device, you should be on the _board selector_ page. This page displays every board that is compatible with the WipperSnapper firmware. ![](https://cdn-learn.adafruit.com/assets/assets/000/112/550/medium800/wippersnapper_setup__board_selector__web__selector_maion.png?1655920178) In the board selector page's search bar, search for the _Feather ESP32 V2. _Once you've located the board you'd like to install WipperSnapper on,_ _click the _Choose Board_ button to bring you to the self-guided installation wizard. ![](https://cdn-learn.adafruit.com/assets/assets/000/112/890/medium800/adafruit_products_v2_new_board.png?1657137703) Follow the step-by-step instructions on the page to install Wippersnapper on your device and connect it to Adafruit IO. ![](https://cdn-learn.adafruit.com/assets/assets/000/120/544/medium800/adafruit_products_feather_esp32_v2_ss.png?1682710725) If the installation was successful, a popover should appear displaying that your board has successfully been detected by Adafruit IO. Give your board a name and click "Continue to Device Page". ![](https://cdn-learn.adafruit.com/assets/assets/000/112/921/medium800/adafruit_products_io_device_detected_v2.png?1657212598) You should be brought to your board's device page. ![](https://cdn-learn.adafruit.com/assets/assets/000/112/922/medium800/adafruit_products_io_device_page_v2.png?1657212608) ## Feedback Adafruit.io WipperSnapper is in **beta** and you can help improve it! If you have  suggestions or general feedback about the installation process - visit [https://io.adafruit.com/support](https://io.adafruit.com/support), click _"Contact Adafruit IO Support"_ and select _"I have feedback or suggestions for the WipperSnapper Beta"._ ## Troubleshooting If you encountered an issue during installation, please try the steps below first. If you're still unable to resolve the issue, or if your issue is not listed below, get in touch with us directly at [https://io.adafruit.com/support](https://io.adafruit.com/support "https://io.adafruit.com/support"). Make sure to click  _"Contact Adafruit IO Support"_ and select "_There is an issue with WipperSnapper. Something is broken!"_ ### First, make sure that you selected the correct board on the board selector. Next, please make sure that you entered your WiFi credentials properly, there are no spaces/special characters in either your network name (SSID) or password, and that you are connected to a 2.4GHz wireless network. If you're still unable to connect your board to WiFi, please [make a new post on the WipperSnapper technical support forum with the error you're experiencing, the LED colors which are blinking, and the board you're using.](https://forums.adafruit.com/viewforum.php?f=66) ### Try hard-resetting your board by unplugging it from USB power and plugging it back in. If the error is still occurring, please [make a new post on the WipperSnapper technical support forum with information about what you're experiencing, the LED colors which are blinking (if applicable), and the board you're using.](https://forums.adafruit.com/viewforum.php?f=66) ## "Uninstalling" WipperSnapper  WipperSnapper firmware is an application that is loaded onto your board. There is nothing to "uninstall". However, you may want to "move" your board from running WipperSnapper to running Arduino or CircuitPython. You also may need to restore your board to the state it was shipped to you from the Adafruit factory.  ### Moving from WipperSnapper to CircuitPython Follow the steps on the [Installing CircuitPython page](https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython) to install CircuitPython on your board running WipperSnapper. - If you are unable to double-tap the RST button to enter the UF2 bootloader, follow the _"Factory Resetting a WipperSnapper Board"_ instructions below. Uploading this sketch will overwrite WipperSnapper. If you want to re-install WipperSnapper, follow the instructions at the top of this page. ### Moving from WipperSnapper to Arduino If you want to use your board with Arduino, you will use the Arduino IDE to load _any_ sketch onto your board. First, follow the page below to set up your Arduino IDE environment for use with your board. [Setup Arduino IDE](https://learn.adafruit.com/adafruit-esp32-feather-v2/arduino-ide-setup) Then, follow the page below to upload the "Arduino Blink" sketch to your board. [Upload Arduino "Blink" Sketch](https://learn.adafruit.com/adafruit-esp32-feather-v2/blink) Uploading this sketch will overwrite WipperSnapper. If you want to re-install WipperSnapper, follow the instructions at the top of this page. ### Factory Resetting a WipperSnapper Board Sometimes, hardware gets into a state that requires it to be "restored" to the original state it shipped in. If you'd like to get your board back to its original factory state, follow the guide below. [Factory Reset your Adafruit Feather HUZZAH ESP32-V2](https://learn.adafruit.com/adafruit-esp32-feather-v2/factory-reset) # Using Piezo Buzzers with WipperSnapper ## Usage ## Usage Assuming you have already gone through the WipperSnapper Setup page and connected your board to WipperSnapper, **[navigate to the WipperSnapper board list](https://io.adafruit.com/wippersnapper).** On this page,  **select the WipperSnapper board you just connected**. - If you do not see your board listed - go back to the WipperSnapper Setup Page and make sure it registers with Adafrut.io ![](https://cdn-learn.adafruit.com/assets/assets/000/117/315/medium800/adafruit_io_ksnip_20221214-141506.png?1672865424) On the device page, quickly  **check that your device is online and is running the latest version of the WipperSnapper firmware**. The device tile on the left indicates the version number of the firmware running on the connected board. - **If the firmware version is green with a checkmark -**  continue with this guide. - **If the firmware version is red with an "X" -**  [update to the latest WipperSnapper firmware](https://learn.adafruit.com/quickstart-adafruit-io-wippersnapper) on your board before continuing. ![adafruit_io_ksnip_20221214-141639.png](https://cdn-learn.adafruit.com/assets/assets/000/117/316/medium640/adafruit_io_ksnip_20221214-141639.png?1672865458) **Click the New Component button or the + button ** to bring up the component picker. ![](https://cdn-learn.adafruit.com/assets/assets/000/117/317/medium800/adafruit_io_ksnip_20221214-142536.png?1672865491) Under _PWM Components_, select the Piezo Buzzer. ![](https://cdn-learn.adafruit.com/assets/assets/000/117/319/medium800/adafruit_io_ksnip_20230104-155516.png?1672865729) Next, Select Pin D14 as the Piezo Buzzer Pin. WipperSnapper matches musical notes to frequencies, in Hertz. Select the musical note you'd like the Piezo to play when it's activated. - There's [a handy hertz-to-note table on this website](https://pages.mtu.edu/~suits/notefreqs.html)! Click **Create Component** ![](https://cdn-learn.adafruit.com/assets/assets/000/117/320/medium800/adafruit_io_ksnip_20230104-155735.png?1672865862) The device page displays a new piezo buzzer component. Clicking the switch will cause the Piezo buzzer to play the note you selected within the component setup - piezo buzzer component. Setting the switch to the "off" position will stop the Piezo buzzer. ![](https://cdn-learn.adafruit.com/assets/assets/000/117/321/medium800thumb/adafruit_io_ezgif.com-gif-maker_%282%29.jpg?1672866561) ## Modifying the Piezo Buzzer's Note Is your buzzer's tone too high-pitched or too quiet? To modify the note played by the buzzer, click the cog on the top-right of the Wippersnapper piezo component and select a new tone from the dropdown labeled  **Note**. ![](https://cdn-learn.adafruit.com/assets/assets/000/117/338/medium800thumb/temperature___humidity_ezgif.com-gif-maker_%283%29.jpg?1672945204) # Using Piezo Buzzers with WipperSnapper ## Temperature alarm with WipperSnapper Follow the guide below to set up the AHT20 on the same device you've been using. The sensor board is connected to the Feather board using a Stemma QT cable - plug and play. [AHT20 WipperSnapper Setup](https://learn.adafruit.com/adafruit-aht20/wippersnapper) Now, you should have both sensors on the same device page. Click the gear on one of the AHT20's sensors. ![](https://cdn-learn.adafruit.com/assets/assets/000/118/092/medium800/temperature___humidity_ksnip_20230203-135716.png?1675450650) Disable all the sensors except for temperature sensor you're going to use. In this example, I'm using the Fahrenheit feed. ![](https://cdn-learn.adafruit.com/assets/assets/000/118/093/medium800/temperature___humidity_ksnip_20230203-135847.png?1675450739) Now click 'Update Component'. ![](https://cdn-learn.adafruit.com/assets/assets/000/118/094/medium800/temperature___humidity_ksnip_20230203-135922.png?1675450788) Click the tab labeled  **Actions ** and then click  **New Action**. Click the tab labeled  **Actions** and then click  **New Action**. Choose the  **Reactive Action ** option. ![adafruit_io_ksnip_20230104-171102.png](https://cdn-learn.adafruit.com/assets/assets/000/117/326/medium640/adafruit_io_ksnip_20230104-171102.png?1672871152) ![adafruit_io_ksnip_20230104-171131.png](https://cdn-learn.adafruit.com/assets/assets/000/117/327/medium640/adafruit_io_ksnip_20230104-171131.png?1672871177) ![adafruit_io_ksnip_20230104-171149.png](https://cdn-learn.adafruit.com/assets/assets/000/117/328/medium640/adafruit_io_ksnip_20230104-171149.png?1672871233) Fill out the options for this action like so. You can set whatever number you want for the  **comparison value or feed.** I chose 80 so it'd let me know when my apartment is getting a bit hot. The value you set the feed to is the note it will play. I'm setting it to 785 (Hertz), which is G5 on the musical scale. ![temperature___humidity_ksnip_20230203-140207.png](https://cdn-learn.adafruit.com/assets/assets/000/118/097/medium640/temperature___humidity_ksnip_20230203-140207.png?1675450985) Make another reactive action and this time set it up so that it's less than or equal to the comparison value you set above and that it sets the feed to 0, or off. ![temperature___humidity_ksnip_20230203-140402.png](https://cdn-learn.adafruit.com/assets/assets/000/118/098/medium640/temperature___humidity_ksnip_20230203-140402.png?1675451055) Now, whenever the temperature goes above 80 degrees, the alarm will play until the temperature is lower. ![temperature___humidity_ksnip_20230203-140623.png](https://cdn-learn.adafruit.com/assets/assets/000/118/099/medium640/temperature___humidity_ksnip_20230203-140623.png?1675451209) ![temperature___humidity_ksnip_20230203-140626.png](https://cdn-learn.adafruit.com/assets/assets/000/118/100/medium640/temperature___humidity_ksnip_20230203-140626.png?1675451219) ## Featured Products ### Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM [Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM](https://www.adafruit.com/product/5400) One of our star Feathers is the [Adafruit HUZZAH32 ESP32 Feather](https://www.adafruit.com/product/3405) - with the fabulous ESP32 WROOM module on there, it makes quick work of WiFi and Bluetooth® projects that take advantage of Espressifs most popular chipset. Recently we had... In Stock [Buy Now](https://www.adafruit.com/product/5400) [Related Guides to the Product](https://learn.adafruit.com/products/5400/guides) ### Large Enclosed Piezo Element w/Wires [Large Enclosed Piezo Element w/Wires](https://www.adafruit.com/product/1739) This large (30mm diameter) piezo element is nicely enclosed with mounting holes so you can attach easily. Piezo elements convert vibration to voltage or voltage to vibration. That means you can use this as a buzzer for making beeps, tones and alerts AND you can use it as a sensor, to detect... Out of Stock [Buy Now](https://www.adafruit.com/product/1739) [Related Guides to the Product](https://learn.adafruit.com/products/1739/guides) ### Piezo Buzzer [Piezo Buzzer](https://www.adafruit.com/product/160) Piezo buzzers are used for making beeps, tones and alerts. This one is petite but loud! Drive it with 3-30V peak-to-peak square wave. To use, connect one pin to ground (either one) and the other pin to a square wave out from a timer or microcontroller. For the loudest tones, stay around 4 KHz,... In Stock [Buy Now](https://www.adafruit.com/product/160) [Related Guides to the Product](https://learn.adafruit.com/products/160/guides) ### Half Size Breadboard + 78 Piece 22AWG Jumper Wire Bundle [Half Size Breadboard + 78 Piece 22AWG Jumper Wire Bundle](https://www.adafruit.com/product/3314) This is a cute half-size breadboard with an assortment of small jumper wires, great for prototyping. The breadboard is 2.2" x 3.4" (5.5 cm x 8.5 cm) with a standard double-strip in the middle and two power rails on both sides. Power rails can be pulled off easily to make the... Out of Stock [Buy Now](https://www.adafruit.com/product/3314) [Related Guides to the Product](https://learn.adafruit.com/products/3314/guides) ### Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor [Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor](https://www.adafruit.com/product/5187) Take a deep breath in...now slowly breathe out. Mmm isn't it wonderful? All that air around us, which we bring into our lungs, extracts oxygen from and then breathes out carbon dioxide. CO2 is essential for life on this planet we call Earth - we and plants take turns using and... In Stock [Buy Now](https://www.adafruit.com/product/5187) [Related Guides to the Product](https://learn.adafruit.com/products/5187/guides) ### STEMMA QT / Qwiic JST SH 4-Pin Cable - 50mm Long [STEMMA QT / Qwiic JST SH 4-Pin Cable - 50mm Long](https://www.adafruit.com/product/4399) This 4-wire cable is 50mm / 1.9" long and fitted with JST SH female 4-pin connectors on both ends. Compared with the chunkier JST PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove. In Stock [Buy Now](https://www.adafruit.com/product/4399) [Related Guides to the Product](https://learn.adafruit.com/products/4399/guides) ### Fully Reversible Pink/Purple USB A to micro B Cable - 1m long [Fully Reversible Pink/Purple USB A to micro B Cable - 1m long](https://www.adafruit.com/product/4111) This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also fully reversible! That's right, you will save _seconds_ a day by not having to flip the cable around. First let's talk about the cover and over-molding. We got these... In Stock [Buy Now](https://www.adafruit.com/product/4111) [Related Guides to the Product](https://learn.adafruit.com/products/4111/guides) ### Adafruit IO+ Subscription Pass – One Year [Adafruit IO+ Subscription Pass – One Year](https://www.adafruit.com/product/3792) The all-in-one Internet of Things service from Adafruit you know and love is now _even better_ with IO+. The 'plus' stands for MORE STUFF! More feeds, dashboards, storage, speed. Power up your [Adafruit IO](https://io.adafruit.com/) with the $99 pass for 1 year of the... In Stock [Buy Now](https://www.adafruit.com/product/3792) [Related Guides to the Product](https://learn.adafruit.com/products/3792/guides) ## Related Guides - [Adafruit SCD-40 and SCD-41](https://learn.adafruit.com/adafruit-scd-40-and-scd-41.md) - [Adafruit ESP32 Feather V2](https://learn.adafruit.com/adafruit-esp32-feather-v2.md) - [No-Code Counters and Email Reports with Adafruit IO Actions](https://learn.adafruit.com/no-code-counters-and-email-reports-with-adafruit-io-actions.md) - [itsaSNAP Apple Health Status Board](https://learn.adafruit.com/itssnap-apple-fitness-status-board.md) - [Quickstart: Adafruit IO WipperSnapper ](https://learn.adafruit.com/quickstart-adafruit-io-wippersnapper.md) - [Monitor Your Greenhouse with a No-Code Environmental Sensor](https://learn.adafruit.com/monitor-your-greenhouse-with-a-no-code-environmental-sensor.md) - [Welcome to Adafruit IO](https://learn.adafruit.com/welcome-to-adafruit-io.md) - [Where's My Friend? A Location-Aware Display with PyPortal and ItsASnap](https://learn.adafruit.com/where-s-my-friend-a-location-display-frame-with-pyportal.md) - [Raspberry Pi Azure IoT Hub Dashboard with CircuitPython](https://learn.adafruit.com/raspberry-pi-iot-dashboard-with-azure-and-circuitpython.md) - [Edge-Lit Tavern Sign with WLED - Control with WiFi or IR Remote](https://learn.adafruit.com/edge-lit-tavern-sign-with-wled-control-with-wifi-or-ir-remote.md) - [Quick Start: Pico W / 2W with WipperSnapper](https://learn.adafruit.com/quick-start-the-pico-w-with-wippersnapper.md) - [No-Code Battery Monitoring with WipperSnapper](https://learn.adafruit.com/no-code-battery-monitoring-with-wippersnapper.md) - [Holiday Lights: Easy DIY Christmas Wreath & Garland with WLED](https://learn.adafruit.com/holiday-garland-decor-app-control-with-no-coding.md) - [Memento Photo Capture with itsaSNAP](https://learn.adafruit.com/memento-photo-capture-with-itsasnap.md) - [Adafruit IO Basics: Analog Output](https://learn.adafruit.com/adafruit-io-basics-analog-output.md) - [DIY Trinkey No-Soldering USB Air Quality Monitor](https://learn.adafruit.com/diy-trinkey-no-solder-air-quality-monitor.md) - [Ikea Vindriktning Hack with QT Py ESP32-S3 and Adafruit IO](https://learn.adafruit.com/ikea-vindriktning-hack-with-qt-py-esp32-s3-and-adafruit-io.md)