Aprender

Una melodía de Arduino con tone(): una canción en un piezo

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: una melodía en un piezoen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Himno a la alegría en un piezo en el pin 8, con una lámpara en el pin 13 por cada nota, en un ATmega328P simulado.

Un piezo pasivo y dos líneas de código bastan para tocar una melodía en un Arduino. tone() produce una nota, noTone() la detiene, y una lista de notas y duraciones convierte eso en una canción. Esta página construye una desde cero: de dónde salen los números de las notas, cómo llevar el tiempo y por qué cada nota necesita un silencio corto después.

El circuito de arriba es un Uno tocando el inicio del "Himno a la alegría" de Beethoven en un piezo en el pin 8, con una lámpara en el pin 13 que se enciende con cada nota. Funciona en tu navegador con el sketch de abajo. El monitor serie imprime cada tono mientras suena, y el piezo simulado mide la frecuencia que realmente recibe, así puedes comprobar cada nota.

Lo que necesitas

  • Un Arduino Uno
  • Un zumbador piezo pasivo (no uno activo)
  • Un LED y una resistencia de 220 ohm
  • Una protoboard y cables jumper

Cableado

Componente y pinVa aNota
Piezo, una pataPin 8Cualquier pata; un piezo no tiene polaridad
Piezo, otra pataGND
Ánodo del LED, con 220 ohmiosPin 13La lámpara que se enciende con cada nota
Cátodo del LEDGND

Una nota es una frecuencia

Cada nota musical es una vibración a una cantidad fija de veces por segundo. El La sobre el Do central es 440 hertz, y cada paso hacia arriba en el piano es alrededor de 6 por ciento más alto, así que una octava arriba la duplica. El Do central es 262 Hz, el Mi sobre él es 330 y el Sol es 392. tone(8, 330) hace que el pin 8 se encienda y apague 330 veces por segundo, y el piezo convierte eso en un Mi.

tone() inicia la nota y regresa de inmediato. La nota sigue sonando en segundo plano, desde uno de los temporizadores de hardware del Uno, hasta que llamas a noTone() o inicias otra nota. Así que el sketch decide cuánto dura una nota con su propio delay().

El temporizador solo puede dividir el reloj de 16 MHz del Uno en pasos enteros, así que la mayoría de las notas salen con una diferencia mínima. Ejecuta el circuito y el piezo mide 330.7 Hz para el Mi de 330 Hz. Nadie puede oír esa diferencia.

El sketch, paso a paso

La melodía son dos listas de la misma longitud. NOTES guarda el tono de cada nota en hertz, y BEATS guarda cuánto dura cada una. Las duraciones se cuentan en medios tiempos, así que 2 es un tiempo, 3 es un tiempo y medio y 4 son dos tiempos. Así se mantienen como números enteros.

loop() recorre ambas listas a la vez. Por cada nota imprime el tono, enciende la lámpara, inicia el tono, espera la duración de la nota menos 30 milisegundos, luego detiene el tono y espera esos 30 milisegundos en silencio. Después de la última nota dice "otra vez en dos segundos" y empieza de nuevo.

TEMPO_MS es la duración de medio tiempo, aquí 200 milisegundos, así que un tiempo es 400 ms: 150 tiempos por minuto. Hazlo más pequeño y toda la melodía se acelera, sin ningún otro cambio.

El sketch de la melodía, recortado
const int PIEZO = 8;
const int LAMP = 13;

const unsigned int C4 = 262;
const unsigned int D4 = 294;
const unsigned int E4 = 330;
const unsigned int F4 = 349;
const unsigned int G4 = 392;

const unsigned int NOTES[] = {
  E4, E4, F4, G4, G4, F4, E4, D4, C4, C4, D4, E4, E4, D4, D4,
};
// Length in beats, times two, so a half beat is 1.
const unsigned char BEATS[] = {
  2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 1, 4,
};
const int COUNT = sizeof(BEATS);

const unsigned long TEMPO_MS = 200;  // half a beat
const unsigned long GAP_MS = 30;     // the silence between notes

void loop() {
  for (int i = 0; i < COUNT; i++) {
    unsigned long length = TEMPO_MS * BEATS[i];
    Serial.print("note ");
    Serial.print(NOTES[i]);
    Serial.println(" Hz");
    digitalWrite(LAMP, HIGH);
    tone(PIEZO, NOTES[i]);
    delay(length - GAP_MS);
    noTone(PIEZO);
    digitalWrite(LAMP, LOW);
    delay(GAP_MS);
  }
  Serial.println("again in two seconds");
  delay(2000);
}

Por qué cada nota necesita un espacio

The tune starts with two E’s in a row. Play them back to back with no gap and you hear one long E, because the pin never stops switching. The 30 milliseconds of silence after every note is what makes two notes of the same pitch sound like two. It is also why the lamp blinks off between them.

El ejemplo toneMelody de Arduino hace lo mismo de otra forma: llama a tone(pin, note, duration) y luego espera alrededor de 30 por ciento más que la nota. Cualquiera de las dos formas funciona. Lo importante es que el silencio esté ahí.

Escribe tu propia canción

No tienes que buscar frecuencias. #include "pitches.h" te da nombres para cada nota desde NOTE_B0 (31 Hz) hasta NOTE_DS8 (4978 Hz), los mismos números que usa el ejemplo del IDE de Arduino, así que NOTE_A4 es 440. Mokxi tiene el archivo integrado, así que el include funciona sin agregar una pestaña.

Luego escribe la melodía como dos listas: las notas y las duraciones. Usa 0 para un silencio, y toca un silencio con noTone() y un delay en lugar de un tono. Copia una melodía de una partitura nota por nota, comprueba que el conteo de ambas listas sea el mismo y presiona Ejecutar.

En el editor, prueba cambiar TEMPO_MS a 150 para una melodía más rápida, o GAP_MS a 0 para oír los dos Mi juntos. Agrega 12 notas a cada lista y el loop las toca, porque COUNT se calcula a partir de la lista.

Errores comunes

Usar un zumbador activo. Tiene su propio oscilador y toca un solo tono sin importar lo que le envíes. Una melodía necesita un piezo pasivo o una bocina pequeña.

Sin espacio entre notas, así que las notas repetidas se mezclan en una sola.

Listas de longitudes distintas. Si BEATS es más corta que NOTES, el ciclo lee más allá de su final y toca duraciones sin sentido. Cuéntalas, o deja que el compilador cuente una de ellas como lo hace este sketch.

PWM que se detiene en los pines 3 y 11. En un Uno, tone() usa el temporizador 2, el mismo que controla el PWM en esos dos pines, así que analogWrite() en ellos deja de funcionar mientras suena una nota. Usa los pines 5, 6, 9 o 10 para lo que quieras atenuar.

Intentar tocar dos notas a la vez. tone() funciona en un pin a la vez. Inicia una nota en un segundo pin y la primera se detiene.

Una tierra floja. Con la segunda pata del piezo desconectada, el piezo aquí se queda en silencio, como uno real.

Abre este circuito en el editor. Arduino Uno: una melodía en un piezo, con el cableado tal como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Cómo toco una canción en un zumbador de Arduino?

Usa un piezo pasivo, pon las notas de la canción en un arreglo y sus duraciones en otro, y recórrelos llamando tone(pin, nota), delay(duración), luego noTone(pin) y un delay corto. El sketch de esta página hace exactamente eso.

¿Cuál es la diferencia entre tone(pin, freq) y tone(pin, freq, duration)?

Ambas regresan de inmediato. Con una duración, la nota se detiene sola después de esos milisegundos, pero el sketch no la espera, así que aun así necesitas un delay antes de la siguiente nota.

¿Dónde consigo pitches.h?

En el Arduino IDE es una pestaña del ejemplo toneMelody (Archivo, Ejemplos, 02.Digital). En Mokxi está integrado: #include "pitches.h" funciona por sí solo.

¿Puede tone() producir sonido en cualquier pin?

Sí, en cualquier pin digital de un Uno. Usa el temporizador 2 sin importar qué pin elijas, por eso el PWM en los pines 3 y 11 se pausa mientras suena.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.