zephyr/samples/boards/bbc_microbit/sound
Anas Nashif 3ae52624ff license: cleanup: add SPDX Apache-2.0 license identifier
Update the files which contain no license information with the
'Apache-2.0' SPDX license identifier.  Many source files in the tree are
missing licensing information, which makes it harder for compliance
tools to determine the correct license.

By default all files without license information are under the default
license of Zephyr, which is Apache version 2.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-04-07 08:45:22 -04:00
..
src all: Add 'U' suffix when using unsigned variables 2019-03-28 17:15:58 -05:00
CMakeLists.txt license: cleanup: add SPDX Apache-2.0 license identifier 2019-04-07 08:45:22 -04:00
prj.conf samples: boards: Rename microbit dir to bbc_microbit 2018-11-14 12:41:12 -05:00
README.rst samples: boards: Rename microbit dir to bbc_microbit 2018-11-14 12:41:12 -05:00
sample.yaml samples: add test identifier 2019-03-29 17:44:11 -04:00

.. _microbit_sound:

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

Overview
********

This is simple example demonstrating how to use a piezo buzzer connected
to port P0 on the edge connector of the BBC micro:bit board. Note that
the buzzer is not part of the main micro:bit board, rather it it needs
to be separately acquired and connected. A well working 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.

Building
********

The sample can be built as follows:

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

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

This sample outputs sounds through a connected 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.