DFPlayer Mini接Arduino MP3语音播报

2026-11-18 07:33:16 47阅读 所属项目:ESP32 开发板

想给小项目加点声音,第一反应往往是蜂鸣器。但蜂鸣器只能滴滴滴,连一句完整的人话都说不出来。想让作品开口报状态、报提示,甚至放段背景音乐,就得换 MP3 模块上场了。

最近把 DFRobot 官方 wiki 上 DFPlayer Mini 这块小模块的文档从头到尾读了一遍,笔记理成这篇。它只有指甲盖大小,往串口上一挂就能播 TF 卡里的 MP3,下文参数全部按官方规格页核对,新手朋友可以放心照着做。

先说清楚:它和蜂鸣器不是一回事

蜂鸣器是发声器件,自己不会播内容,要靠主控不断翻转驱动频率才能挤出几个音调。DFPlayer Mini 是播放器,芯片自带解码,TF 卡里的音乐文件它能自己放,Arduino 只需要发几个字节的串口指令,告诉它放第几首、放多大声。

所以两者的分工完全不同:蜂鸣器适合报警、按键音这种单音场景;要做语音播报,比如电量不足请充电这类提示,就得靠 MP3 模块把提前录好的语音文件放出来。给机器人加音效、给小车加到站提示,都是它的主场。

还有个容易混淆的点:这块模块直推喇叭就行,官方引脚表写着 SPK1、SPK2 可以带动 3W 以下的喇叭,不用额外接功放;想接耳机或者外接功放,走 DAC_L、DAC_R 这两个脚。

参数与引脚:底细先摸清

按官方规格页的口径把关键参数抄一遍:工作电压 DC 3.2~5V;TF 卡最大支持 32G,文件系统要 FAT16 或 FAT32;采样率覆盖 8、11.025、12、16、22.05、24、32、44.1、48kHz 这九档;DAC 输出 24 位,官方标动态范围 90dB、信噪比 85dB。

容量方面,官方写的是音频数据按文件夹管理,最多支持 100 个文件夹,每个文件夹最多放 255 首。音量 30 级可调,EQ 有 6 档。尺寸规格表标 20×20mm,尺寸图上实际标注 20.55mm,焊盘间距 2.54mm,重量 20g。

DFPlayer Mini模块尺寸标注图

模块俯视图长这样,16 个引脚分列两侧,中间是 TF 卡座。

DFPlayer Mini模块引脚总览

新手真正常用的就几个脚:VCC 和 GND 供电,RX、TX 负责串口收发,SPK1、SPK2 接喇叭,BUSY 用来判断播放状态,低电平表示正在播。完整的引脚功能说明表如下,IO1、IO2、ADKEY1、ADKEY2 这几个脚后面讲独立玩法时会用到。

DFPlayer Mini引脚功能说明表

提示:芯片具体型号和模块单价,官方规格页没有公布,查不到的参数这里就不替官方猜了。

SD 卡曲目组织:四位编号是关键

这一步是新手最容易懵的地方,官方文档写得很明确:TF 卡根目录下建一个叫 mp3 的文件夹,文件名必须是四位数字,比如 0001.mp3、0002.mp3。想带英文名或中文名也行,把名字缀在编号后面就可以,比如 0001hello.mp3 或者 0001后来.mp3。

有个反直觉的规则要记住:play(1) 播放的不是编号 0001 的文件,而是最先拷进卡的那首。曲目的序号是按拷入顺序排的,不是按文件名排的。想固定顺序,就按想要的顺序一批拷进去。

Mac 用户还有个额外的坑:拷文件时系统会自动生成 ._0001.mp3 这类隐藏文件,模块可能把它当成正常 MP3,播出来就是空 track。官方给的解法是在终端跑 dot_clean /Volumes/卡卷名,把隐藏文件清掉再用。

另外官方 FAQ 特别提醒:TF 卡不建议热插拔,可能识别异常甚至损坏文件;卡要先格式化成 FAT16 或 FAT32 再拷歌。

接线与代码:串口模式跑起来

串口模式是跟 Arduino 联动的主流玩法,通信参数为 9600 波特率、无校验位、无流控。软件上准备两样:Arduino IDE,以及 DFRobotDFPlayerMini 这个库,官方 wiki 的示例页提供了库的下载入口。

接线只动三根线:VCC 接 5V,GND 接 GND,Arduino 的 TX 串一个 1kΩ 电阻接到模块的 RX。官方 FAQ 解释了这颗电阻的用处:模块工作电平约 3.3V,很多主控是 5V 逻辑,串个电阻做信号调理,还能减少杂音。模块的 TX 可以直接接回 Arduino 的 RX。

开跑之前记得把装好歌的 TF 卡插上,官方文档强调不插卡连串口通信都无法建立。下面是官方 GetStarted 示例,唯一一处改写是头文件:SoftwareSerial.h 的尖括号写法改成了引号写法 #include "SoftwareSerial.h",因为平台会剥掉尖括号,两种写法在 Arduino 里编译等价,其余代码逐字符保留。

/***************************************************
DFPlayer - A Mini MP3 Player For Arduino
 https://www.dfrobot.com/product-1121.html
 
 ***************************************************
 This example shows the basic function of library for DFPlayer.
 
 Created 2016-12-07
 By [Angelo qiao](Angelo.qiao@dfrobot.com)
 
 GNU Lesser General Public License.
 See http://www.gnu.org/licenses/ for details.
 All above must be included in any redistribution
 ****************************************************/

/***********Notice and Trouble shooting***************
 1.Connection and Diagram can be found here
 https://www.dfrobot.com/wiki/index.php/DFPlayer_Mini_SKU:DFR0299#Connection_Diagram
 2.This code is tested on Arduino Uno, Leonardo, Mega boards.
 ****************************************************/

#include "Arduino.h"
#include "DFRobotDFPlayerMini.h"

#if (defined(ARDUINO_AVR_UNO) || defined(ESP8266))   // Using a soft serial port
#include "SoftwareSerial.h"
SoftwareSerial softSerial(/*rx =*/10, /*tx =*/11);
#define FPSerial softSerial
#else
#define FPSerial Serial1
#endif

DFRobotDFPlayerMini myDFPlayer;
void printDetail(uint8_t type, int value);

void setup()
{
#if (defined ESP32)
  FPSerial.begin(9600, SERIAL_8N1, /*rx =*/D3, /*tx =*/D2);
#else
  FPSerial.begin(9600);
#endif

  Serial.begin(115200);

  Serial.println();
  Serial.println(F("DFRobot DFPlayer Mini Demo"));
  Serial.println(F("Initializing DFPlayer ... (May take 3~5 seconds)"));
  
  if (!myDFPlayer.begin(FPSerial, /*isACK = */true, /*doReset = */true)) {  //Use serial to communicate with mp3.
    Serial.println(F("Unable to begin:"));
    Serial.println(F("1.Please recheck the connection!"));
    Serial.println(F("2.Please insert the SD card!"));
    while(true){
      delay(0); // Code to compatible with ESP8266 watch dog.
    }
  }
  Serial.println(F("DFPlayer Mini online."));
  
  myDFPlayer.volume(10);  //Set volume value. From 0 to 30
  myDFPlayer.play(1);  //Play the first mp3
}

void loop()
{
  static unsigned long timer = millis();
  
  if (millis() - timer > 3000) {
    timer = millis();
    myDFPlayer.next();  //Play next mp3 every 3 second.
  }
  
  if (myDFPlayer.available()) {
    printDetail(myDFPlayer.readType(), myDFPlayer.read()); //Print the detail message from DFPlayer to handle different errors and states.
  }
}

void printDetail(uint8_t type, int value){
  switch (type) {
    case TimeOut:
      Serial.println(F("Time Out!"));
      break;
    case WrongStack:
      Serial.println(F("Stack Wrong!"));
      break;
    case DFPlayerCardInserted:
      Serial.println(F("Card Inserted!"));
      break;
    case DFPlayerCardRemoved:
      Serial.println(F("Card Removed!"));
      break;
    case DFPlayerCardOnline:
      Serial.println(F("Card Online!"));
      break;
    case DFPlayerUSBInserted:
      Serial.println("USB Inserted!");
      break;
    case DFPlayerUSBRemoved:
      Serial.println("USB Removed!");
      break;
    case DFPlayerPlayFinished:
      Serial.print(F("Number:"));
      Serial.print(value);
      Serial.println(F(" Play Finished!"));
      break;
    case DFPlayerError:
      Serial.print(F("DFPlayerError:"));
      switch (value) {
        case Busy:
          Serial.println(F("Card not found"));
          break;
        case Sleeping:
          Serial.println(F("Sleeping"));
          break;
        case SerialWrongStack:
          Serial.println(F("Get Wrong Stack"));
          break;
        case CheckSumNotMatch:
          Serial.println(F("Check Sum Not Match"));
          break;
        case FileIndexOut:
          Serial.println(F("File Index Out of Bound"));
          break;
        case FileMismatch:
          Serial.println(F("Cannot Find File"));
          break;
        case Advertise:
          Serial.println(F("In Advertise"));
          break;
        default:
          break;
      }
      break;
    default:
      break;
  }
  
}

代码逻辑不复杂:begin() 初始化时如果接线不对或者卡没插,串口监视器会直接打出 Unable to begin,并把两条可能原因列出来;volume() 设音量,范围 0 到 30;play(1) 放第一首。示例的 loop 每 3 秒切下一首,printDetail 把模块回传的状态全部打印,出错时看这一段就够了。

音量、插播与不用写代码的玩法

日常控制在官方全功能示例里都列了:volumeUp()、volumeDown() 增减音量;EQ() 六档,Normal、Pop、Rock、Jazz、Classic、Bass;pause() 暂停、start() 从暂停处继续;loop(1) 单曲循环,randomAll() 随机播放。指定曲目有两条路:用 playMp3Folder(4) 播 mp3 文件夹里的 0004.mp3;分文件夹管理就用 playFolder(15, 4),播 15 文件夹里的 004.mp3。

做语音播报最实用的是广告插播:把插播语音放进 ADVERT 文件夹命名 0003.mp3,advertise(3) 一发,当前音乐先停下播广告,播完自动接回原来的歌。官方规格页管这叫广告声等待功能,做循线小车的到站提示正好用得上。

懒得写代码也行。I/O 模式是最简单的玩法:IO1、IO2 各接一个按键到 GND,短按切上一首、下一首,长按就是音量加减,接上喇叭和电池就能独立当一台 MP3 用,下面是官方给的参考接线。

DFPlayer Mini独立IO模式按键接线图

进阶一点是 AD 按键模式:利用电阻分压识别按键,官方默认配 2 个 AD 口、20 键电阻分配,可以做多段语音触发,按不同键播不同提示语,适合语音导览这类需要多个触发点的项目。

DFPlayer Mini AD按键模式电阻分压接线图

最后留一份避坑清单:没声音先查供电,官方建议用 5V;再查音量是不是设成了 0、喇叭线有没有接反;串口杂音大就补那颗 1kΩ 电阻;卡不识别就确认 32G 以内、FAT16 或 FAT32 格式、四位编号命名。这些官方 FAQ 都点名了,按顺序排查基本能解决。


作者:菜鸟也想玩
链接:https://www.aiddithome.com/p/126b97a64cd052.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
电烙铁爱好者
1楼 · 2026-11-18 07:34:51

这块板子我抽屉里躺着好几片,当年也被曲目顺序坑过:明明文件名是0002,播出来却是另一首,后来才反应过来是按拷入顺序排的,文章这句划得很到位。补一个文中没展开的细节,喇叭尽量挑8欧3W以内的,音量拉到25以上偶尔会有破音,走DAC输出接个小功放会干净很多。另外那个1k欧电阻别省,我偷懒直连过一次,串口一直报校验错,老老实实串上就稳了。

参数党小马
2楼 · 2026-11-18 07:34:51

采样率九档和32G上限跟官方规格表逐项对得上,信噪比85dB在这个价位的模块里算实在的,考据派好评。

线比代码多
3楼 · 2026-11-18 07:34:51

线比代码多实锤了,三根线里两根是电源,剩下那根还要串个电阻,哈哈。

学生党玩机
4楼 · 2026-11-18 07:34:51

正在给毕业设计的小车加到站播报,advertise插播这个功能简直是量身定做,周末就去备张卡照着试。