Framework (A-Z)

Reference for Wiring version 1.0 Build 0100+ If you have a previous version, use the reference included with your software. If see any errors or have any comments, let us know.



void setup() {
  // generates a 400Hz tone in output pin 8 with 2000ms of duration
  tone(8, 400, 2000); 

void loop() {


void setup() {
  // generates a 415Hz tone in output pin 8 with infinite duration
  tone(8, NOTE_GS4); 

void loop() {

Description The tone() generates a tone of a determined frequency in hertz on a specific pin for a specified duration. The tone command uses timer resources to generate the tone accurately. Use a negative number in duration for infinite duration. If a previous tone command is playing, and a new pin is specified, and tonePolyphony has been set to > 1, and there are available timers, a simultaneous tone will be played on the new pin.
tone(pin, frequency, duration)
tone(pin, frequency)
pin int the output pin number in which the tone will be generated.
frequency int: the frequency for the pulse in Hertz. The following pitch frequencies are predefined to use with tone: NOTE_B0=31, NOTE_C1=33, NOTE_CS1=35, NOTE_D1=37, NOTE_DS1=39, NOTE_E1=41, NOTE_F1=44, NOTE_FS1=46, NOTE_G1=49, NOTE_GS1=52, NOTE_A1=55, NOTE_AS1=58, NOTE_B1=62, NOTE_C2=65, NOTE_CS2=69, NOTE_D2=73, NOTE_DS2=78, NOTE_E2=82, NOTE_F2=87, NOTE_FS2=93, NOTE_G2=98, NOTE_GS2=104, NOTE_A2=110, NOTE_AS2=117, NOTE_B2=123, NOTE_C3=131, NOTE_CS3=139, NOTE_D3=147, NOTE_DS3=156, NOTE_E3=165, NOTE_F3=175, NOTE_FS3=185, NOTE_G3=196, NOTE_GS3=208, NOTE_A3=220, NOTE_AS3=233, NOTE_B3=247, NOTE_C4=262, NOTE_CS4=277, NOTE_D4=294, NOTE_DS4=311, NOTE_E4=330, NOTE_F4=349, NOTE_FS4=370, NOTE_G4=392, NOTE_GS4=415, NOTE_A4=440, NOTE_AS4=466, NOTE_B4=494, NOTE_C5=523, NOTE_CS5=554, NOTE_D5=587, NOTE_DS5=622, NOTE_E5=659, NOTE_F5=698, NOTE_FS5=740, NOTE_G5=784, NOTE_GS5=831, NOTE_A5=880, NOTE_AS5=932, NOTE_B5=988, NOTE_C6=1047, NOTE_CS6=1109, NOTE_D6=1175, NOTE_DS6=1245, NOTE_E6=1319, NOTE_F6=1397, NOTE_FS6=1480, NOTE_G6=1568, NOTE_GS6=1661, NOTE_A6=1760, NOTE_AS6=1865, NOTE_B6=1976, NOTE_C7=2093, NOTE_CS7=2217, NOTE_D7=2349, NOTE_DS7=2489, NOTE_E7=2637, NOTE_F7=2794, NOTE_FS7=2960, NOTE_G7=3136, NOTE_GS7=3322, NOTE_A7=3520, NOTE_AS7=3729, NOTE_B7=3951, NOTE_C8=4186, NOTE_CS8=4435, NOTE_D8=4699 and NOTE_DS8=4978.
duration int: the tone duration in milliseconds or nothing to play infinitely (until noTone() method called, or new tone() called)
Returns None
Usage Application
Related tone()
Updated on July 07, 2011 11:09:15pm PDT

Creative Commons License