---
tag: m0300
title: Play Tone
brief: Play a single tone, buzz, or beep.
author: thinkyhead

group: lcd
requires: SPEAKER

codes: [ M300 ]

notes:
- Requires `SPEAKER` to play tones (not just beeps).
- In Marlin 1.0.2, playing tones block the command queue. Marlin 1.1.0 uses a tone queue and background tone player to keep the command buffer from being blocked by playing tones.

parameters:

- tag: P
  optional: true
  description: Duration (1ms)
  values:
  - tag: ms
    type: int

- tag: S
  optional: true
  description: Frequency (260Hz)
  values:
  - tag: Hz
    type: int

example:
- pre: Play a short tune
  code:
  - M300 S440 P200
  - M300 S660 P250
  - M300 S880 P300

---

Add a tone to the tone queue.
