Source: https://mokxi.com/parts/dfplayer
Updated: 2026-11-16

Part

# DFPlayer Mini MP3 module

Numbered files from a microSD card, played on command over serial, with BUSY low while one plays.

See every part

- 16 pins
- 3 settings
- In 4 projects
- In 3 lessons

Drawn live by the editor's own code, at the size you see it.

At a glance

## The DFPlayer Mini MP3 module in brief

What it is, and every setting the properties panel gives it.

The DFPlayer Mini is a microSD slot, a decoder and a small amplifier on a 16-pin board, told what to play over a 9600 baud serial link. VCC takes 3.2 to 5 volts, the board sends on RX and listens on TX, usually through SoftwareSerial on an Uno, and BUSY goes low while a file plays. Its logic is 3.3 volts, so RX driven from a 5 volt pin wants a 1k resistor in series, and files play in the order they were copied to the card, not by name. Mokxi implements the manual’s ten-byte frames, 7E FF 06, the command, the ack flag, the parameter, a checksum and EF, and answers a bad checksum with an error. After power-up it spends 600 milliseconds reading the card and answers busy until then. Play by number and in folders, pause, loops, random play, volume from 0 to 30, EQ and the state and count queries all work through DFRobot’s library, and the end of each file is reported twice. There is no sound: the card is the tracks, folders and seconds properties, and the speaker outputs stay silent.

Family

Clocks and links

Pins

16

tracks

10

folders

2

seconds

20

Pins

## 16 pins

Named as the editor names them, so a wire lands where you expect it.

Pin

What it does

VCC

Supply, 3.2 to 5 V.

RX

Serial in, 3.3 V logic: put 1 k in series from a 5 V board.

TX

Serial out, 3.3 V logic.

DAC_R

The speaker and line outputs.

DAC_L

The speaker and line outputs.

SPK_1

The speaker and line outputs.

GND

Ground (two pins).

SPK_2

The speaker and line outputs.

BUSY

Low while a file plays.

USB-

USB and the resistor-ladder keys.

USB+

USB and the resistor-ladder keys.

ADKEY_2

USB and the resistor-ladder keys.

ADKEY_1

USB and the resistor-ladder keys.

IO_2

Buttons to ground: a short press plays the previous or next file, a long press steps the volume down or up.

GNDb

Ground (two pins).

IO_1

Buttons to ground: a short press plays the previous or next file, a long press steps the volume down or up.

How to use it

## How to use a DFPlayer Mini with an Arduino

Run a SoftwareSerial at 9600 baud on pins 10 and 11: TX from the module to pin 10, and pin 11 to RX through a 1k resistor, because its inputs are 3.3 V. BUSY on pin 3 reads LOW while a file plays. Give player.begin() the serial port and check what it returns before calling volume() and play().

The card here holds four files of three seconds each, set by the part’s tracks and seconds properties. To play files in turn, wait for player.available() and a DFPlayerPlayFinished report. The module sends that report twice, so check the file number before moving on, or the second report moves the sketch on a second time.

Part pin

Board pin

VCC

5 V

GND

GND

RX

Pin 11, through 1k

TX

Pin 10

BUSY

Pin 3

Click to open it in the editor

This is the simulator itself, running here. Click anything to open it in the editor.

Open this project in the editor Read the full tutorial

Playing the first file with DFRobot’s library

How it is modeled

## What is true about the DFPlayer Mini MP3 module, here

In its help article’s own words: what the simulation gets right, and where it stops.

### Modeled

From the DFPlayer Mini manual:

The frames: ten bytes, 7E FF 06, the command, the ack flag, the parameter, a
checksum and EF, at 9600 baud 8N1. A bad checksum or frame is answered with an
error.

Start-up: it reads the card, then reports it online; commands before then are
answered busy.

The commands: play by number, in folders and the MP3 folder, next and
previous, pause, resume and stop, looping one file or all, random play, volume, EQ,
sleep and reset, each acknowledged when asked. A file past the card is an error.

The queries: state, volume, EQ, file and folder counts, and the current file.

The end of a file is reported twice, as the module does, and BUSY is low
while one plays.

### Not modeled

Sound. There are no recordings in a simulator, so the speaker and DAC outputs stay
silent and the card is a count of files and a length. USB, the ADKEY ladder and
the advertisement feature are accepted and ignored.

From DFPlayer Mini, in full.

Projects

## See the DFPlayer Mini MP3 module in a project

4 built-in projects use it. Each opens in the editor, already wired.

Lessons

## Where it turns up in a lesson

3 lessons place it in their own circuits.

### Learn articles

3 lessons

- Arduino DFPlayer Mini MP3 Player: Wiring and Code
- Arduino Halloween Props to Build in Your Browser
- Arduino Christmas Lights to Build in Your Browser

Boards

## The boards it is shown on

This board has a built-in project with the DFPlayer Mini MP3 module in it.

- Arduino Uno R3

Libraries

## Arduino libraries for the DFPlayer Mini MP3 module

Built in, so the sketch compiles with nothing to install. Each page has the calls, the wiring and an example to run.

- DFRobotDFPlayerMini

More parts

## The rest of the bench

Every one of these is drawn and simulated the same way.

Full-size breadboard

A real 0.1 inch grid with the rails and the center channel, 63 columns wide.

Jumper wires

Drag from any pin or hole to any other. Corners snap, and you can drag them.

Power

A supply rail at the voltage you choose.

Ground

The other end of every circuit.

LED

Lights when current flows. Five colors, and the brightness is what your eye would see.

Filament lamp

A tungsten bulb in a holder: an inrush when it is switched on cold, tens of milliseconds to warm up, and dim on half its voltage.

Resistor

Any value you like, with the color bands drawn to match.

ESP32-C3-DevKitM-1

A RISC-V board that runs your firmware at 160 MHz on the real memory map.

Pushbutton

A 12 mm tactile switch. Hold it while the simulation runs.

Raspberry Pi Pico

The RP2040 board on our own Cortex-M0+ core. Pick a program and press Run.

Raspberry Pi Pico W

Raspberry Pi Pico W (RP2040). The same board and the same pinout as a Pico, with the CYW43439 on it. The WiFi is simulated (no radio; real internet through the Cloud panel’s switch), and the on-board LED, which hangs off that chip rather than off GP25, is driven through the same path. Everything else is the Pico.

Raspberry Pi 4 Model B

Raspberry Pi 4 Model B: the 40-pin header, driven by main.py with RPi.GPIO or gpiozero.

See every part

## Wire up the DFPlayer Mini MP3 module

Open the editor and push it into the breadboard. It is free, and it runs on your own machine.

Start building free Open the editor
