| .. _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. |