# Introduction [

](https://www.dfrobot.com/product-1121.html "DFPlayer(SKU:DFR0299)") The **[DFPlayer Mini MP3 Player For Arduino](https://www.dfrobot.com/product-1121.html)** is a small and low cost MP3 module with an simplified output directly to the speaker. The module can be used as a stand alone module with attached battery, speaker and push buttons or used in combination with microcontrollers such as [Arduino](https://www.dfrobot.com/topic-277.html), [ESP32](https://www.dfrobot.com/topic-302.html "ESP32"), [Raspberry Pi](https://www.dfrobot.com/topic-272.html "Raspberry Pi") and any microcontrollers with Uart. ## Specification - Sampling rates (kHz): 8/11.025/12/16/22.05/24/32/44.1/48 - 24 -bit DAC output, support for dynamic range 90dB , SNR support 85dB - Fully supports FAT16 , FAT32 file system, maximum support 32G of the TF card, support 32G of U disk, 64M bytes NORFLASH - A variety of control modes, I/O control mode, serial mode, [AD button](https://www.dfrobot.com/product-2267.html) control mode - advertising sound waiting function, the music can be suspended. when advertising is over in the music continue to play - audio data sorted by folder, supports up to 100 folders, every folder can hold up to 255 songs - 30 level adjustable volume, 6 -level EQ adjustable - Working voltage: DC3.2~5V - Size: 20mm*20mm - Weight: 20g ## Application - Car navigation voice broadcast; - Road transport inspectors, toll stations voice prompts; - Railway station, bus safety inspection voice prompts; - Electricity, communications, financial business hall voice prompts; - Vehicle into and out of the channel verify that the voice prompts; - The public security border control channel voice prompts; - Multi-channel voice alarm or equipment operating guide voice; - The electric tourist car safe driving voice notices; - Electromechanical equipment failure alarm; - Fire alarm voice prompts; - The automatic broadcast equipment, regular broadcast. ## Pin Map ![DFR0299 PIN MAP](https://dfimg.dfrobot.com/nobody/wiki/77048a25b85b6e29438244020e7237e1.png "DFR0299 PIN MAP") --------- ![DFR0299 PIN MAP](https://dfimg.dfrobot.com/nobody/wiki/c0ee0e83de43022bd0c17fe640290ed3.png "DFR0299 PIN MAP") ## Dimensions ![](https://img.dfrobot.com.cn/wikicn/5ea64bf6cf1d8c7738ad2881/7301e9f8e883f54ec538c6cfecfee921.png) ## Work Mode ### 1. Serial Mode Support for asynchronous serial communication mode via PC serial sending commands Communication Standard:9600 bps Data bits :1 Checkout :none Flow Control :none - Instruction Description ![DFR0299 instructiao](https://dfimg.dfrobot.com/nobody/wiki/96788daf8e13dc647325e4ba5562d1b1.png) - Serial Control Cmd ![DFR0188 control cmd](https://dfimg.dfrobot.com/nobody/wiki/dcaac11a4962395a53e7f553204a6eae.png "DFR0188 control cmd") - Serial Query Cmd ![DFR0299 query cmd](https://dfimg.dfrobot.com/nobody/wiki/c5f235de98133465f34c7a9516199bda.png "DFR0299 query cmd") ### 2. AD KEY Mode We use the AD module keys, instead of the traditional method of matrix keyboard connection, it is to take advantage of increasingly powerful MCU AD functionality, Our module default configuration 2 AD port, 20 key resistance distribution. Get [**AD Button**](https://www.dfrobot.com/product-2267.html) from DFRobot Store or [**DFRobot Distributor**.](https://www.dfrobot.com/distributor) - Refer diagram DFR0299 adkey_control

### 3. I/O Mode Here comes the most simple way to use this module. - Refer diagram DFR0299 speaker

**note: short time press means pre/next,and long time press means vol- ,vol +** ## Connection Diagram ![DFR0299 connection diagram](https://dfimg.dfrobot.com/nobody/wiki/1aa1326d5f595dc1ad13be8f3fc52a33.png "DFR0299 connection diagram") Note: The operating voltage of DFPlayer mini is 3.3 V, while most of the Arduino's operating voltage is 5 V. After our test, although it is possible to play music normally by directly connecting the Arduino directly to DFPlayer mini, there may be abnormal noises appearing. We recommend you to connect a 1k resistor in series with the RX pin of DFPlayer for voltage divider. ## Copy your mp3 into you micro SD card **NOTE**: The order you copy the mp3 into micro SD card will affect the order mp3 played , which means play(1) function will play the first mp3 copied into micro SD card. ### For Mac User

NOTE: If you are using Mac OS X to copy the mp3, the file system will automatically add hidden files like: "._0001.mp3" for index, which this module will handle as valid mp3 files. It is really annoying. So you can run following command in terminal to eliminate those files.

dot_clean /Volumes/<SDVolumeName>

Please replace the to the volume name of your SD card.

## Sample Code We've created an Arduino library for DFPlayer Mini to simplify the method for you to make it work. Connect the hardware as the picture above shown and play with the sample code. You can download the latest library here: [DFRobotDFPlayerMini](https://github.com/DFRobot/DFRobotDFPlayerMini). #### Sample code "GetStarted", switching to next song every 3 seconds ``` cpp /*************************************************** DFPlayer - A Mini MP3 Player For Arduino *************************************************** 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 for details. All above must be included in any redistribution ****************************************************/ /***********Notice and Trouble shooting*************** 1.Connection and Diagram can be found here 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 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; } } ``` #### Sample code "FullFunction", including all the functions. Please read the comments and documents in detail ``` cpp /*************************************************** DFPlayer - A Mini MP3 Player For Arduino *************************************************** This example shows the all the function of library for DFPlayer. Created 2016-12-07 By [Angelo qiao](Angelo.qiao@dfrobot.com) GNU Lesser General Public License. See for details. All above must be included in any redistribution ****************************************************/ /***********Notice and Trouble shooting*************** 1.Connection and Diagram can be found here 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 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); } Serial.println(F("DFPlayer Mini online.")); myDFPlayer.setTimeOut(500); //Set serial communictaion time out 500ms //----Set volume---- myDFPlayer.volume(10); //Set volume value (0~30). myDFPlayer.volumeUp(); //Volume Up myDFPlayer.volumeDown(); //Volume Down //----Set different EQ---- myDFPlayer.EQ(DFPLAYER_EQ_NORMAL); // myDFPlayer.EQ(DFPLAYER_EQ_POP); // myDFPlayer.EQ(DFPLAYER_EQ_ROCK); // myDFPlayer.EQ(DFPLAYER_EQ_JAZZ); // myDFPlayer.EQ(DFPLAYER_EQ_CLASSIC); // myDFPlayer.EQ(DFPLAYER_EQ_BASS); //----Set device we use SD as default---- // myDFPlayer.outputDevice(DFPLAYER_DEVICE_U_DISK); myDFPlayer.outputDevice(DFPLAYER_DEVICE_SD); // myDFPlayer.outputDevice(DFPLAYER_DEVICE_AUX); // myDFPlayer.outputDevice(DFPLAYER_DEVICE_SLEEP); // myDFPlayer.outputDevice(DFPLAYER_DEVICE_FLASH); //----Mp3 control---- // myDFPlayer.sleep(); //sleep // myDFPlayer.reset(); //Reset the module // myDFPlayer.enableDAC(); //Enable On-chip DAC // myDFPlayer.disableDAC(); //Disable On-chip DAC // myDFPlayer.outputSetting(true, 15); //output setting, enable the output and set the gain to 15 //----Mp3 play---- myDFPlayer.next(); //Play next mp3 delay(1000); myDFPlayer.previous(); //Play previous mp3 delay(1000); myDFPlayer.play(1); //Play the first mp3 delay(1000); myDFPlayer.loop(1); //Loop the first mp3 delay(1000); myDFPlayer.pause(); //pause the mp3 delay(1000); myDFPlayer.start(); //start the mp3 from the pause delay(1000); myDFPlayer.playFolder(15, 4); //play specific mp3 in SD:/15/004.mp3; Folder Name(1~99); File Name(1~255) delay(1000); myDFPlayer.enableLoopAll(); //loop all mp3 files. delay(1000); myDFPlayer.disableLoopAll(); //stop loop all mp3 files. delay(1000); myDFPlayer.playMp3Folder(4); //play specific mp3 in SD:/MP3/0004.mp3; File Name(0~65535) delay(1000); myDFPlayer.advertise(3); //advertise specific mp3 in SD:/ADVERT/0003.mp3; File Name(0~65535) delay(1000); myDFPlayer.stopAdvertise(); //stop advertise delay(1000); myDFPlayer.playLargeFolder(2, 999); //play specific mp3 in SD:/02/004.mp3; Folder Name(1~10); File Name(1~1000) delay(1000); myDFPlayer.loopFolder(5); //loop all mp3 files in folder SD:/05. delay(1000); myDFPlayer.randomAll(); //Random play all the mp3. delay(1000); myDFPlayer.enableLoop(); //enable loop. delay(1000); myDFPlayer.disableLoop(); //disable loop. delay(1000); //----Read imformation---- Serial.println(myDFPlayer.readState()); //read mp3 state Serial.println(myDFPlayer.readVolume()); //read current volume Serial.println(myDFPlayer.readEQ()); //read EQ setting Serial.println(myDFPlayer.readFileCounts()); //read all file counts in SD card Serial.println(myDFPlayer.readCurrentFileNumber()); //read current play file number Serial.println(myDFPlayer.readFileCountsInFolder(3)); //read file counts in folder SD:/03 } 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; } } ``` **NOTE**: The folder name needs to be mp3, placed under the SD card root directory, and the mp3 file name needs to be 4 digits, for example, "0001.mp3", placed under the mp3 folder. If you want to name it in Both English and Chinese, you can add it after the number, for example, "0001hello.mp3" or "0001后来.mp3".

Searching "DFR0299" got 2 result(s)

Contents