samples/boards/bbc_microbit/sound/README.rst

.. _microbit_sound:

BBC micro:bit sound
###################

Overview
********

This sample demonstrates how to use a piezo buzzer connected
to port P0 on the edge connector of the **BBC micro:bit v1** or
using the on-board buzzer on the **BBC micro:bit v2**.

Requirements
************

Using **BBC micro:bit v1**, a separate piezo buzzer must be connected to the board.
One example is the MI:Power board that has a piezo buzzer in addition to a
coin-cell battery. Resellers of this board can be fairly easily found using online search.

The upgraded **BBC micro:bit v2** board does not need a separate buzzer as it has one
built-in on the backside of the board (marked as 'speaker').


Building and running
********************

The sample can be built as follows:

Building for a BBC micro:bit v1
-------------------------------

.. zephyr-app-commands::
   :zephyr-app: samples/boards/bbc_microbit/sound
   :board: bbc_microbit
   :goals: build flash
   :compact:

Building for a BBC micro:bit v2
-------------------------------

.. zephyr-app-commands::
   :zephyr-app: samples/boards/bbc_microbit/sound
   :board: bbc_microbit_v2
   :goals: build flash
   :compact:

Sample Output
=============

This sample outputs sounds through a piezo buzzer based on
button presses of the two main buttons. For each press the current
output frequency will be printed on the 5x5 LED display.