Documentation

// MP3-TF-16P / DFPlayer Mini - Arduino Example
// TX->D10, RX->D11 via 1k | Library: "DFRobotDFPlayerMini"

#include <SoftwareSerial.h>
#include <DFRobotDFPlayerMini.h>

SoftwareSerial mp3Serial(10, 11);   // RX, TX
DFRobotDFPlayerMini player;

void setup() {
  Serial.begin(115200);
  mp3Serial.begin(9600);

  if (!player.begin(mp3Serial)) {
    Serial.println("DFPlayer not responding - check card and wiring");
    while (1);
  }
  player.volume(20);            // 0-30
  player.play(1);               // play 0001.mp3
  Serial.println("Playing track 1");
}

void loop() {
  // next track every 10 seconds as a demo
  delay(10000);
  player.next();
  Serial.println("Next track");
}

// MP3-TF-16P - ESP32 sound-effect trigger
// TX->GPIO16, RX->GPIO17 via 1k, button GPIO 0 (BOOT) plays a random clip

#include <DFRobotDFPlayerMini.h>

DFRobotDFPlayerMini player;
const int NUM_TRACKS = 5;          // 0001.mp3 .. 0005.mp3 on the card

void setup() {
  Serial.begin(115200);
  Serial2.begin(9600, SERIAL_8N1, 16, 17);
  pinMode(0, INPUT_PULLUP);

  if (!player.begin(Serial2)) {
    Serial.println("DFPlayer not responding");
    while (1) delay(10);
  }
  player.volume(22);
  Serial.println("Press BOOT for a random sound");
}

void loop() {
  if (digitalRead(0) == LOW) {
    int track = random(1, NUM_TRACKS + 1);
    player.play(track);
    Serial.printf("Playing %04d.mp3\n", track);
    delay(400);                    // debounce
  }
}

#!/usr/bin/env python3
# MP3-TF-16P - Raspberry Pi Example (raw 10-byte frames)
# TX->GPIO15, RX(via 1k)->GPIO14 | Install: pip3 install pyserial

import serial, time

port = serial.Serial("/dev/serial0", 9600)

def cmd(command, param=0):
    hi, lo = (param >> 8) & 0xFF, param & 0xFF
    frame = [0x7E, 0xFF, 0x06, command, 0x00, hi, lo]
    checksum = -sum(frame[1:]) & 0xFFFF
    frame += [(checksum >> 8) & 0xFF, checksum & 0xFF, 0xEF]
    port.write(bytes(frame))
    time.sleep(0.2)

cmd(0x3F)          # init
time.sleep(1)
cmd(0x06, 20)      # volume 20 (0-30)
cmd(0x03, 1)       # play track 0001.mp3
print("Playing track 1 for 15 s...")
time.sleep(15)

cmd(0x0E)          # pause
print("Paused. Next track...")
time.sleep(1)
cmd(0x01)          # next
time.sleep(10)
cmd(0x16)          # stop
print("Done.")

# MP3-TF-16P - Pico MicroPython Example (raw frames + BUSY pin)
# TX->GP1, RX(via 1k)->GP0, BUSY->GP2

from machine import UART, Pin
import time

uart = UART(0, baudrate=9600, tx=Pin(0), rx=Pin(1))
busy = Pin(2, Pin.IN, Pin.PULL_UP)     # LOW while playing

def cmd(command, param=0):
    hi, lo = (param >> 8) & 0xFF, param & 0xFF
    frame = [0x7E, 0xFF, 0x06, command, 0x00, hi, lo]
    checksum = -sum(frame[1:]) & 0xFFFF
    frame += [(checksum >> 8) & 0xFF, checksum & 0xFF, 0xEF]
    uart.write(bytes(frame))
    time.sleep_ms(200)

cmd(0x3F)              # init
time.sleep(1)
cmd(0x06, 18)          # volume
cmd(0x03, 1)           # play 0001.mp3
print("Playing...")

while busy.value() == 0:      # wait until the track finishes
    time.sleep_ms(100)
print("Track finished - playing track 2")
cmd(0x03, 2)