Skip to content

Arduino Sketch, "ReadValuesModified", Experiments with DFPlayer #319

@ForrestErickson

Description

@ForrestErickson

Summary

An Arduino sketch for experimenting with DFPlayer Mini MP3 Library.

Code

//ReadValuesModified

/***************************************************
 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
 Modified 2018-08-15
 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 =*/4, /*tx =*/5);
SoftwareSerial softSerial(16, 17);
#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, 16, 17);
#else
  FPSerial.begin(9600);
#endif

  Serial.begin(115200);

  Serial.println();
  Serial.println(F("DFRobot DFPlayer Mini Demo"));
  Serial.print("Compiled at: ");
  Serial.println(F(__DATE__ " " __TIME__));  //compile date that is used for a unique identifier

  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 or USB drive!"));
    while (true) {
      delay(0);  // Code to compatible with ESP8266 watch dog.
    }
  }
  Serial.println(F("DFPlayer Mini online."));

  Serial.print("Files found: ");
  Serial.println(myDFPlayer.readFileCounts());

  Serial.print("Current file number: ");
  Serial.println(myDFPlayer.readCurrentFileNumber());
  //    value = myDFPlayer.readCurrentFileNumber(); //read current play file number


  Serial.print("Player State: ");
  Serial.println(myDFPlayer.readState());


  //    value = myDFPlayer.readState(); //read mp3 state
  //    value = myDFPlayer.readVolume(); //read current volume
  //    value = myDFPlayer.readEQ(); //read EQ setting
  //    value = myDFPlayer.readFileCounts(); //read all file counts in SD card
  //    value = myDFPlayer.readCurrentFileNumber(); //read current play file number
}

void loop() {
  static unsigned long timer = millis();

  if (millis() - timer > 3000) {
    timer = millis();

    int value;

    //    value = myDFPlayer.readState(); //read mp3 state
    //    value = myDFPlayer.readVolume(); //read current volume
    //    value = myDFPlayer.readEQ(); //read EQ setting
    //    value = myDFPlayer.readFileCounts(); //read all file counts in SD card
    //    value = myDFPlayer.readCurrentFileNumber(); //read current play file number
    value = myDFPlayer.readFileCountsInFolder(3);  //read file counts in folder SD:/03
    if (value == -1) {                             //Error while Reading.
      Serial.println("Error while Reading file count. ");

      printDetail(myDFPlayer.readType(), myDFPlayer.read());
    } else {  //Successfully get the result.
      Serial.print("File count: ");
      Serial.println(value);
    }
    if (myDFPlayer.available()) {
      printDetail(myDFPlayer.readType(), myDFPlayer.read());  //Print the detail message from DFPlayer to handle different errors and states.
    } else {
      Serial.println("myDFPlayer.available() not available");
    }
  }
}

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 Serial Monitor Output

10:21:41.836 -> ets Jul 29 2019 12:21:46
10:21:41.836 -> 
10:21:41.836 -> rst:0x1 (POWERON_RESET),boot:0x17 (SPI_FAST_FLASH_BOOT)
10:21:41.836 -> configsip: 0, SPIWP:0xee
10:21:41.836 -> clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
10:21:41.836 -> mode:DIO, clock div:1
10:21:41.836 -> load:0x3fff0030,len:4832
10:21:41.836 -> load:0x40078000,len:16460
10:21:41.836 -> load:0x40080400,len:4
10:21:41.836 -> load:0x40080404,len:3504
10:21:41.836 -> entry 0x400805cc
10:21:41.978 -> 
10:21:41.978 -> DFRobot DFPlayer Mini Demo
10:21:41.978 -> Compiled at: Dec 28 2025 10:17:31
10:21:42.003 -> Initializing DFPlayer ... (May take 3~5 seconds)
10:21:43.029 -> DFPlayer Mini online.
10:21:43.029 -> Files found: 9
10:21:43.067 -> Current file number: -1
10:21:43.594 -> Player State: 0
10:21:46.634 -> File count: 512
10:21:46.634 -> myDFPlayer.available() not available

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions