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

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

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

提示:芯片具体型号和模块单价,官方规格页没有公布,查不到的参数这里就不替官方猜了。
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 用,下面是官方给的参考接线。

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

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











这块板子我抽屉里躺着好几片,当年也被曲目顺序坑过:明明文件名是0002,播出来却是另一首,后来才反应过来是按拷入顺序排的,文章这句划得很到位。补一个文中没展开的细节,喇叭尽量挑8欧3W以内的,音量拉到25以上偶尔会有破音,走DAC输出接个小功放会干净很多。另外那个1k欧电阻别省,我偷懒直连过一次,串口一直报校验错,老老实实串上就稳了。
采样率九档和32G上限跟官方规格表逐项对得上,信噪比85dB在这个价位的模块里算实在的,考据派好评。
线比代码多实锤了,三根线里两根是电源,剩下那根还要串个电阻,哈哈。
正在给毕业设计的小车加到站播报,advertise插播这个功能简直是量身定做,周末就去备张卡照着试。