| .. zephyr:code-sample:: buzzer-tone |
| :name: Buzzer Tone |
| :relevant-api: buzzer_interface |
| |
| Play a short beep and a few tones through the buzzer device aliased as ``buzzer0``. |
| |
| Overview |
| ******** |
| |
| This application plays a short attention beep followed by three tones through the buzzer device |
| referenced by the ``buzzer0`` :ref:`devicetree <dt-guide>` alias, repeating once every three |
| seconds. |
| |
| The sample exercises the high-level :ref:`buzzer API <buzzer_api>` through :c:func:`buzzer_beep` |
| and :c:func:`buzzer_tone`, which drive both backends: |
| |
| * :dtcompatible:`pwm-buzzer` for passive piezo buzzers wired to a PWM channel. |
| * :dtcompatible:`gpio-buzzer` for active buzzers controlled by a single GPIO line. Pitch |
| information is ignored by this backend. |
| |
| Requirements |
| ************ |
| |
| The target board must expose a buzzer device through the ``buzzer0`` devicetree alias. Boards that |
| do not have a buzzer wired in their DTS can provide an :file:`<board>.overlay` file under |
| :file:`boards/`. |
| |
| Building and Running |
| ******************** |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/drivers/buzzer/tone |
| :goals: build flash |
