1.. zephyr:code-sample:: bbc_microbit_sound
2   :name: Sound
3   :relevant-api: pwm_interface
4
5   Use the piezo buzzer on the BBC micro:bit board.
6
7Overview
8********
9
10This sample demonstrates how to use a piezo buzzer connected
11to port P0 on the edge connector of the **BBC micro:bit v1** or
12using the on-board buzzer on the **BBC micro:bit v2**.
13
14Requirements
15************
16
17Using **BBC micro:bit v1**, a separate piezo buzzer must be connected to the board.
18One example is the MI:Power board that has a piezo buzzer in addition to a
19coin-cell battery. Resellers of this board can be fairly easily found using online search.
20
21The upgraded **BBC micro:bit v2** board does not need a separate buzzer as it has one
22built-in on the backside of the board (marked as 'speaker').
23
24
25Building and running
26********************
27
28The sample can be built as follows:
29
30Building for a BBC micro:bit v1
31-------------------------------
32
33.. zephyr-app-commands::
34   :zephyr-app: samples/boards/bbc/microbit/sound
35   :board: bbc_microbit
36   :goals: build flash
37   :compact:
38
39Building for a BBC micro:bit v2
40-------------------------------
41
42.. zephyr-app-commands::
43   :zephyr-app: samples/boards/bbc/microbit/sound
44   :board: bbc_microbit_v2
45   :goals: build flash
46   :compact:
47
48Sample Output
49=============
50
51This sample outputs sounds through a piezo buzzer based on
52button presses of the two main buttons. For each press the current
53output frequency will be printed on the 5x5 LED display.
54