Aprender

Uma melodia Arduino com tone(): uma música em um piezo

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: uma melodia em um piezoao vivo0.000 s 0.00x
Clique para abrir no editor
Ode à Alegria em um piezo no pino 8, com uma lâmpada no pino 13 para cada nota, em um ATmega328P simulado.

Um piezo passivo e duas linhas de código bastam para tocar uma melodia em um Arduino. tone() cria uma nota, noTone() a interrompe, e uma lista de notas e durações transforma isso em uma música. Esta página constrói uma do zero: de onde vêm os números das notas, como marcar o tempo e por que cada nota precisa de um breve silêncio depois dela.

O circuito acima é um Uno tocando a abertura da "Ode à Alegria" de Beethoven em um piezo no pino 8, com uma lâmpada no pino 13 que acende a cada nota. Ele roda no seu navegador com o sketch abaixo. O monitor serial imprime cada frequência à medida que toca, e o piezo simulado mede a frequência que realmente recebe, para você conferir cada nota.

O que você precisa

  • Um Arduino Uno
  • Um buzzer piezo passivo (não um ativo)
  • Um LED e um resistor de 220 ohms
  • Uma protoboard e jumpers

Ligação

Componente e pinoVai paraNota
Piezo, uma pernaPino 8Qualquer perna; um piezo não tem polaridade
Piezo, outra pernaGND
Anodo do LED, através de 220 ohmsPino 13A lâmpada que acende a cada nota
Cátodo do LEDGND

Uma nota é uma frequência

Toda nota musical é uma vibração em um número fixo de vezes por segundo. O lá acima do dó central é 440 hertz, e cada subida de tecla no piano é cerca de 6 por cento mais alta, então uma oitava acima dobra. O dó central é 262 Hz, o mi acima dele é 330 e o sol é 392. tone(8, 330) faz o pino 8 ligar e desligar 330 vezes por segundo, e o piezo transforma isso em um mi.

tone() inicia a nota e retorna imediatamente. A nota continua tocando em segundo plano, por um dos timers de hardware do Uno, até você chamar noTone() ou iniciar outra nota. Então o sketch decide quanto tempo uma nota dura com seu próprio delay().

O timer só consegue dividir o clock de 16 MHz do Uno em passos inteiros, então a maioria das notas sai um pouco desviada. Rode o circuito e o piezo mede 330,7 Hz para o mi de 330 Hz. Ninguém consegue ouvir essa diferença.

O sketch, passo a passo

A melodia são duas listas do mesmo comprimento. NOTES guarda a frequência de cada nota em hertz, e BEATS guarda quanto tempo cada uma dura. As durações são contadas em meio tempo, então 2 é um tempo, 3 é um tempo e meio e 4 são dois tempos. Isso as mantém números inteiros.

loop() percorre as duas listas juntas. Para cada nota, ele imprime a frequência, acende a lâmpada, inicia o tom, espera a duração da nota menos 30 milissegundos, depois interrompe o tom e espera esses 30 milissegundos em silêncio. Depois da última nota, ele diz "de novo em dois segundos" e recomeça.

TEMPO_MS é a duração de meio tempo, aqui 200 milissegundos, então um tempo é 400 ms: 150 tempos por minuto. Diminua-o e a melodia inteira acelera, sem nenhuma outra mudança.

O sketch da melodia, enxuto
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 que cada nota precisa de um intervalo

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.

O próprio exemplo toneMelody do Arduino faz a mesma coisa de outro jeito: ele chama tone(pin, note, duration) e espera cerca de 30 por cento a mais que a nota. Qualquer jeito funciona. O que importa é que o silêncio esteja lá.

Escreva sua própria música

Você não precisa procurar frequências. #include "pitches.h" dá nomes a cada nota de NOTE_B0 (31 Hz) a NOTE_DS8 (4978 Hz), os mesmos números que o exemplo da IDE do Arduino usa, então NOTE_A4 é 440. O Mokxi já tem o arquivo incluído, então o include funciona sem adicionar uma aba.

Depois escreva a melodia como duas listas: as notas e as durações. Use 0 para uma pausa, e toque uma pausa com noTone() e um delay em vez de um tone. Copie uma melodia de uma partitura nota por nota, confira se a contagem das duas listas é a mesma e aperte Rodar.

No editor, experimente mudar TEMPO_MS para 150 numa melodia mais rápida, ou GAP_MS para 0 para ouvir os dois mis se juntarem. Adicione 12 notas a cada lista e o loop as toca, porque COUNT é calculado a partir da lista.

Erros comuns

Usar um buzzer ativo. Ele tem oscilador próprio e toca uma única frequência, seja lá o que você envie. Uma melodia precisa de um piezo passivo ou de um alto-falante pequeno.

Nenhum intervalo entre as notas, então notas repetidas viram uma só.

Listas de comprimentos diferentes. Se BEATS for menor que NOTES, o loop lê além do fim e toca durações sem sentido. Conte-as, ou deixe o compilador contar uma delas, como este sketch faz.

O PWM parando nos pinos 3 e 11. Em um Uno, tone() usa o timer 2, o mesmo timer que controla o PWM nesses dois pinos, então analogWrite() neles para de funcionar enquanto uma nota toca. Use os pinos 5, 6, 9 ou 10 para qualquer coisa que você faça fade.

Tentar tocar duas notas ao mesmo tempo. tone() funciona em um pino por vez. Inicie uma nota em um segundo pino e a primeira para.

Um terra solto. Com a segunda perna do piezo desconectada, o piezo aqui fica mudo, como um real fica.

Abra este circuito no editor. Arduino Uno: uma melodia em um piezo, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Como toco uma música em um buzzer Arduino?

Use um piezo passivo, coloque as notas da música em um array e suas durações em outro, e percorra os arrays chamando tone(pin, nota), delay(duração), depois noTone(pin) e um pequeno delay. O sketch desta página faz exatamente isso.

Qual é a diferença entre tone(pin, freq) e tone(pin, freq, duração)?

Ambos retornam imediatamente. Com uma duração, a nota para sozinha depois dessa quantidade de milissegundos, mas o sketch não espera por ela, então você ainda precisa de um delay antes da próxima nota.

Onde consigo o pitches.h?

No Arduino IDE ele é uma aba no exemplo toneMelody (Arquivo, Exemplos, 02.Digital). No Mokxi ele já vem incluído: #include "pitches.h" funciona sozinho.

tone() pode tocar um som em qualquer pino?

Sim, qualquer pino digital em um Uno. Ele usa o timer 2 independente do pino escolhido, e por isso o PWM nos pinos 3 e 11 pausa enquanto ele toca.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.