playTone

Play tone on piezo speaker using digital pin

Add-On Required: This feature requires the MATLAB Support Package for Arduino Hardware add-on.

Syntax

playTone(a,pin,frequency,duration)

playTone(a,pin)

playTone(a,pin,frequency)

Description

playTone(a,pin,frequency,duration) plays a tone on a piezo speaker attached to the digital pin on Arduino^® hardware at the specified pin and frequency for the specified duration.

example

playTone(a,pin) plays a tone on a piezo speaker attached to the digital pin on Arduino hardware.

playTone(a,pin,frequency) plays a tone on a piezo speaker attached to the digital pin on Arduino hardware at the specified pin and frequency.

Examples

collapse all

Play a Tone on a Piezo Speaker

This example uses:

MATLAB Support Package for Arduino Hardware MATLAB Support Package for Arduino Hardware

Open Live Script

Play a tone connected to digital pin 5 on the Arduino hardware for 10 seconds at 2400Hz.

a = arduino();
playTone(a,'D5',2400,10);

Input Arguments

collapse all

`a` — Arduino hardware connection
object

Arduino hardware connection created using arduino, specified as an object.

`pin` — Digital pin number
character vector

Digital pin number on the physical hardware, specified as a character vector.

`frequency` — Frequency of tone
1000 (default) | numeric

Frequency of tone to be played, specified as a number between the frequency range 0 and 32767Hz.

`duration` — Duration of tone
1 (default) | numeric

Duration of tone to be played specified as a number, which represents the number of seconds. Valid values are between 0 and 60.

Limitations

This function is not supported on the Arduino Due, MKR1000, MKR1010, MKR Zero, Nano33IoT, Nano33BLE and ESP32 boards.

Version History

Introduced in R2014b