Aprender

Toque arquivos MP3 a partir de um Arduino com um DFPlayer Mini

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: uma jukebox com DFPlayer Miniao vivo0.000 s 0.00x
Clique para abrir no editor
Um DFPlayer Mini nos pinos 10 e 11 do SoftwareSerial, com BUSY no pino 3, num ATmega328P simulado.

O DFPlayer Mini é um minúsculo tocador de MP3 numa placa: um slot de cartão microSD, um decodificador e um pequeno amplificador que alimenta um alto-falante diretamente. O Arduino nunca toca o áudio. Ele envia comandos de dez bytes por serial, "tocar arquivo 1" ou "volume 20", e o módulo faz o resto. Isso torna efeitos sonoros e falas fáceis até num Uno.

O circuito acima é um Uno com um DFPlayer Mini no SoftwareSerial, tocando os arquivos do cartão um depois do outro e esperando cada um terminar. A face do módulo mostra qual arquivo está tocando e em que ponto ele está. Não há gravações num simulador, então você não ouvirá nada, mas todo comando, resposta e pino funciona como na bancada.

O que você precisa

  • Um Arduino Uno
  • Um DFPlayer Mini
  • Um cartão microSD com arquivos MP3 (FAT32)
  • Um resistor de 1k
  • Um alto-falante pequeno, de 3 W ou menos, ou fones nos pinos DAC
  • Uma protoboard e jumpers

Ligação

Componente e pinoVai paraNota
VCC e GND do DFPlayer5 V e GNDFunciona de 3,2 a 5 V
RX do DFPlayerPino 11, através de 1kSuas entradas são de 3,3 V
TX do DFPlayerPino 10O pino de recepção do SoftwareSerial
BUSY do DFPlayerPino 3LOW enquanto um arquivo toca (opcional)
SPK_1 e SPK_2 do DFPlayerO alto-falanteNão ligue ao terra; o amplificador alimenta os dois

Ligando-o a um Uno

O módulo se comunica por serial a 9600 baud. A porta serial de hardware do Uno está ocupada com o monitor serial, então o sketch cria uma segunda nos pinos 10 e 11 com SoftwareSerial link(10, 11): o pino 10 recebe do TX do módulo, o pino 11 envia ao RX dele.

O RX do módulo é uma entrada de 3,3 V. Um resistor de 1k em série a partir do pino de 5 V mantém pequena a corrente que entra nele, que é a ligação que a DFRobot mostra. Sem ele, muitos módulos funcionam, mas geram um zumbido ou se comportam de forma estranha.

O sketch, passo a passo

player.begin(link) espera o módulo ler o cartão e responder. Se nada responder, o sketch imprime "Unable to begin: check the wiring and the card" e para. volume(20) define o volume numa escala de 0 a 30, e readFileCounts() pergunta quantos arquivos há no cartão. Este cartão tem quatro arquivos na raiz e duas pastas com quatro, então a primeira linha diz "Jukebox ready, 12 files". play(1) inicia o primeiro arquivo.

loop() observa duas coisas. BUSY no pino 3 fica LOW enquanto um arquivo toca, e o sketch imprime "playing" e "quiet" conforme muda. O módulo também envia uma mensagem quando um arquivo termina: available() e readType() == DFPlayerPlayFinished a capturam, read() dá o número do arquivo, e o sketch imprime "finished file 1" e toca o próximo, voltando ao início no fim. O módulo envia essa mensagem duas vezes por arquivo, como o de verdade faz, então o sketch só avança quando o número é o arquivo que está tocando.

O sketch da jukebox
#include <SoftwareSerial.h>
#include <DFRobotDFPlayerMini.h>

const int BUSY_PIN = 3;

SoftwareSerial link(10, 11);
DFRobotDFPlayerMini player;
int track = 1;
int files = 0;
bool wasBusy = false;

void setup() {
  Serial.begin(9600);
  link.begin(9600);
  pinMode(BUSY_PIN, INPUT);
  if (!player.begin(link)) {
    Serial.println("Unable to begin: check the wiring and the card");
    while (true) {
    }
  }
  player.volume(20);
  files = player.readFileCounts();
  Serial.print("Jukebox ready, ");
  Serial.print(files);
  Serial.println(" files");
  player.play(track);
}

void loop() {
  bool busy = digitalRead(BUSY_PIN) == LOW;
  if (busy != wasBusy) {
    wasBusy = busy;
    Serial.println(busy ? "playing" : "quiet");
  }
  // The module reports the end of a file twice; only the report for the
  // file that is playing moves on.
  if (player.available() && player.readType() == DFPlayerPlayFinished && (int)player.read() == track) {
    Serial.print("finished file ");
    Serial.println(track);
    track = track % files + 1;
    delay(200);
    player.play(track);
  }
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Nomeando os arquivos no cartão

play(n) não usa o nome do arquivo. O módulo numera os arquivos na ordem em que foram copiados para o cartão, então copie um por vez, em ordem, para um cartão recém-formatado. Para ter controle pelos nomes, coloque os arquivos em pastas chamadas 01, 02 e assim por diante, com nomes 001.mp3, 002.mp3, e use playFolder(pasta, arquivo). Ou coloque-os em uma pasta chamada mp3, com nomes 0001.mp3 em diante, e use playMp3Folder(n).

BUSY e a mensagem "finished" são duas formas de saber que um arquivo terminou. Retire o fio do BUSY neste circuito e o pino 3 fica flutuando: o sketch imprime "playing" e "quiet" aleatoriamente, várias vezes por segundo, porque uma entrada solta capta ruído e não é uma leitura confiável. Mas "finished file 1" ainda chega pela serial e o próximo arquivo ainda toca.

Uma montagem maior: a caveira que fala

O segundo circuito usa a mesma ligação do DFPlayer em uma decoração de Halloween. Um sensor PIR desperta uma caveira, seus olhos acendem e um servo move a mandíbula a partir de uma lista de comandos cronometrados escritos para acompanhar uma fala gravada. A caveira sabe que a fala acabou quando BUSY vai para alto, então uma gravação mais longa nunca deixa a mandíbula aberta.

Erros comuns

TX e RX invertidos. O TX do módulo vai para o pino de recepção do Uno, aqui o pino 10. Inverta-os neste circuito e o sketch imprime "Unable to begin: check the wiring and the card".

Sem o resistor de 1k no RX, o que pode causar um zumbido no alto-falante.

Arquivos na ordem errada, porque o cartão os numera pela ordem de cópia, e não pelo nome.

Um alto-falante ligado de SPK_1 ao terra. Ligue-o entre SPK_1 e SPK_2.

Alimentação fraca. O amplificador consome bastante em volume alto, e uma porta USB pode cair. Alimente o módulo com uma boa fonte de 5 V com o terra compartilhado e abaixe o volume durante os testes.

Um cartão que ele não consegue ler. Use FAT32 e 32 GB ou menos.

Abra este circuito no editor. Arduino Uno: uma jukebox com DFPlayer Mini, ligado como na execução no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Como conecto um DFPlayer Mini a um Arduino Uno?

VCC ao 5 V e GND ao GND, o TX do módulo ao pino 10 e seu RX ao pino 11 através de um resistor de 1k, e um alto-falante entre SPK_1 e SPK_2. Depois use SoftwareSerial nos pinos 10 e 11 a 9600 baud.

Por que preciso de um resistor de 1k no pino RX do DFPlayer?

Suas entradas funcionam a 3,3 V e os pinos do Uno são 5 V. O resistor limita a corrente no pino e costuma eliminar um zumbido no alto-falante.

Qual biblioteca o DFPlayer Mini usa?

DFRobotDFPlayerMini, da DFRobot. begin(), volume(), play(), playFolder(), next() e readFileCounts() são as chamadas de que a maioria dos sketches precisa. O Mokxi já a inclui.

Por que o DFPlayer toca o arquivo errado?

Porque ele numera os arquivos na ordem em que foram copiados para o cartão, e não pelos nomes. Formate o cartão de novo e copie os arquivos um por vez, ou use pastas numeradas com playFolder().

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.