frequency: the frequency of the tone in hertz - unsigned int

duration: the duration of the tone in milliseconds (optional) - unsigned long

• Tutorial: multiple tones

• Tutorial: multiple tones?

NOTE: if you want to play different pitches on multiple pins, you need to call noTone() on one pin before calling tone() on the next pin.

Use of the tone() function will interfere with PWM output on pins 3 and 11 (on boards other than the Mega).

• Tutorial:Tone

• Tutorial:Tone?
• Tutorial:Pitch follower
• Tutorial:Simple Keyboard

Only one tone can be generated at a time. If a tone is already playing on a different pin, the call to tone() will have no effect. If the tone is playing on the same pin, the call will set its frequency.

frequency: the frequency of the tone in hertz

tone()

Description

Generates a square wave of the specified frequency (and 50% duty cycle) on a pin. A duration can be specified, otherwise the wave continues until a call to noTone(). The pin can be connected to a piezo buzzer or other speaker to play tones.

On most Arduino boards, only one tone can be generated at a time. If a tone is already playing on a different pin, the call to tone() will have no effect. If the tone is playing on the same pin, the call will set its frequency.

Syntax

tone(pin, frequency)
tone(pin, frequency, duration)

Parameters

pin: the pin on which to generate the tone

frequency: the frequency in hertz of the tone

duration: the duration of the tone in milliseconds (optional)

Returns

nothing

See also

• noTone()
• analogWrite()
• Tutorial: PWM