DFPlayer Mini Arduino-tutorial: mp3's afspelen met sd-kaart en speaker
Zo gebruik je de DFPlayer Mini met Arduino: de weerstand van 1 kΩ op RX, sd-kaart en bestandsnamen als 0001.mp3, bibliotheekcode, knoppen, speaker, plus voorbeelden voor ESP32 en Pico.
De DFPlayer Mini is de goedkoopste en makkelijkste manier om mp3's af te spelen met Arduino: hij decodeert de audiobestanden op een microSD-kaart zelf, stuurt met zijn kleine ingebouwde versterker direct een speaker aan en krijgt zijn commando's van de Arduino via een seriële verbinding met twee draden. Anders dan de piepjes van een buzzer kan hij liedjes, spraak, deurbelmelodieën of gesproken waarschuwingen afspelen, zoals "De deur staat nog open". De meeste mensen die hem voor het eerst aansluiten lopen tegen dezelfde problemen aan: er komt geen geluid, de speaker sist, de bestanden worden in de verkeerde volgorde afgespeeld of de Serial Monitor meldt "Unable to begin". Deze gids lost ze allemaal op en legt uit waarom ze ontstaan.
Eerst leer je de pins van de module kennen en waarom er een weerstand van 1 kΩ op de RX-lijn hoort. Daarna zie je hoe je de sd-kaart voorbereidt als FAT32, je bestanden benoemt volgens het schema met 0001.mp3 en map 01, je eerste geluid afspeelt met de bibliotheek DFRobotDFPlayerMini, het volume en de EQ instelt, nummers wisselt met knoppen en de juiste speaker of externe versterker kiest. De laatste delen behandelen een stapsgewijze oplossing voor de fout "Unable to begin", een mp3-speler die je met de ESP32 vanaf een webpagina bedient en een voorbeeld zonder bibliotheek in MicroPython voor de Raspberry Pi Pico. Heb je alleen een piep of een simpele melodie nodig, dan is een buzzer de eenvoudigere keuze.

Wat is de DFPlayer Mini en hoe werkt hij?
De DFPlayer Mini is een zelfstandige mp3-speler, opgebouwd uit een mp3-decoderchip, een 24-bits DAC, een microSD-kaartslot en een kleine mono-versterker. De Arduino hoeft alleen korte commando's te sturen, zoals "speel nummer 3" of "zet het volume op 20"; het bestand van de kaart lezen, de gecomprimeerde audio decoderen en de speaker aansturen doet de module zelf. Daarom kan zelfs een Arduino Uno met 2 KB RAM probleemloos muziek afspelen. Commando's gaan met 9600 baud in pakketten van elk 10 bytes, en de module meldt in hetzelfde formaat terug wanneer een nummer afloopt, een kaart wordt geplaatst of verwijderd, of er een fout optreedt. De chip op het board verschilt per fabrikant (YX5200-24SS, MH2024K-24SS, GD3200B en andere). Ze begrijpen allemaal dezelfde commando's, maar kunnen er verschillend lang over doen om te antwoorden, een detail dat later belangrijk wordt bij de fout "Unable to begin". De module is op drie manieren te bedienen: via de seriële poort (UART), met de IO-knoppen of met een ADKEY-weerstandsladder.
| Eigenschap | Waarde |
|---|---|
| Ondersteunde bestanden | MP3, WAV, WMA |
| Samplefrequenties | 8 / 11,025 / 12 / 16 / 22,05 / 24 / 32 / 44,1 / 48 kHz |
| DAC | 24 bit; 90 dB dynamisch bereik, 85 dB signaal-ruisverhouding |
| Opslag | microSD-kaart (TF) tot 32 GB, FAT16 of FAT32; usb-sticks worden ook ondersteund |
| Mapcapaciteit | Tot 100 mappen, 255 bestanden per map |
| Volume | 30 stappen (0–30) |
| Equalizer (EQ) | 6 standen: Normal, Pop, Rock, Jazz, Classic, Bass |
| Speakeruitgang | Ingebouwde mono-versterker, speakers onder 3 W |
| Lijnuitgang | DAC_L en DAC_R: stereo, voor een hoofdtelefoon of externe versterker |
| Voeding | 3,2–5,0 V (meestal 4,2 V) |
| Standby-stroom | Ongeveer 20 mA |
| Interface | UART, 9600 baud, 8N1 |
| Afmetingen | 20 × 20 mm |
Pinout van de DFPlayer Mini
| Pin | Naam | Functie |
|---|---|---|
| 1 | VCC | Voedingsingang, 3,2–5,0 V |
| 2 | RX | Seriële ingang: sluit via een weerstand van 1 kΩ aan op de TX-pin van het board |
| 3 | TX | Seriële uitgang: gaat naar de RX-pin van het board |
| 4 | DAC_R | Lijnuitgang rechterkanaal (hoofdtelefoon of versterker) |
| 5 | DAC_L | Lijnuitgang linkerkanaal (hoofdtelefoon of versterker) |
| 6 en 8 | SPK_1, SPK_2 | Speakeruitgang: hier sluit je de twee draden van een speaker onder 3 W aan |
| 7 | GND | Massa |
| 9 | IO_1 | Kort drukken naar GND: vorig nummer; lang drukken: volume omlaag |
| 10 | GND | Massa |
| 11 | IO_2 | Kort drukken naar GND: volgend nummer; lang drukken: volume omhoog |
| 12 | ADKEY1 | Ingang voor meerdere knoppen via een weerstandsladder |
| 13 | ADKEY2 | Tweede ingang voor een weerstandsladder |
| 14 | USB+ | D+ voor een usb-stick |
| 15 | USB− | D− voor een usb-stick |
| 16 | BUSY | LOW tijdens het afspelen, HIGH als de module stilstaat |
Als je de seriële poort gebruikt, heb je alleen de pins VCC, GND, RX, TX en de speakerpins nodig. De pin BUSY vertelt je zonder seriëel verkeer of een nummer is afgelopen, en ook het ledje op het board brandt tijdens het afspelen. Met de pins IO_1 en IO_2 werkt de module helemaal zonder Arduino: met een knop tussen elke pin en GND wisselt een korte druk het nummer en regelt een lange druk het volume. Knoppen die via weerstanden met verschillende waarden op de ADKEY-pins zijn aangesloten, kunnen ook specifieke nummers afspelen. Een batterij, een speaker en twee knoppen volstaan dus om een deurbel of een pratend speeltje te bouwen zonder microcontroller. De pins USB+ en USB− dienen om van een usb-stick af te spelen in plaats van van de sd-kaart en blijven in de meeste projecten onaangesloten.
Bedrading van de DFPlayer Mini met Arduino en de weerstand van 1 kΩ op RX
| DFPlayer-pin | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 5V | 5V (VIN) | VBUS (USB 5 V, pin 40) |
| GND | GND | GND | GND |
| RX | D11 via een weerstand van 1 kΩ | GPIO 17 (TX2) via een weerstand van 1 kΩ | GP0 (UART0 TX) via een weerstand van 1 kΩ |
| TX | D10 | GPIO 16 (RX2) | GP1 (UART0 RX) |
| SPK_1 en SPK_2 | De twee speakerdraden | De twee speakerdraden | De twee speakerdraden |
| BUSY (optioneel) | D5 | Niet gebruikt | Niet gebruikt |



De datalijnen zijn gekruist: de TX van de module gaat naar de RX van het board en zijn RX naar de TX van het board. De hardware-seriële poort van de Uno op D0 en D1 wordt gebruikt voor uploaden via usb en voor de Serial Monitor, dus sluiten we de module met SoftwareSerial aan op D10 (RX) en D11 (TX). De weerstand van 1 kΩ in serie met de RX-ingang van de module is geen detail. De chip van de DFPlayer werkt met 3,3V-logica, terwijl de TX-pin van de Uno 5 V uitgeeft. Zonder weerstand stuurt het spanningsverschil stroom door de beschermingsdiodes van de chipingang; die stroom belast de chip en veroorzaakt het sissen en de klikken die je tijdens seriële communicatie uit de speaker hoort. Reken je het na met de wet van Ohm, dan zie je dat 1 kΩ deze stroom beperkt tot ongeveer 1–2 mA, terwijl het signaal van 9600 baud er geen last van heeft. Een veel grotere weerstand, zoals 10 kΩ, kan het signaal verzwakken en de communicatie verstoren. De TX-uitgang van de module gaat rechtstreeks naar de Uno, omdat de Uno 3,3 V als HIGH leest (de drempel ligt rond 3,0 V).
De sd-kaart voorbereiden: FAT32, mappen en bestandsnamen als 0001.mp3
De DFPlayer Mini leest microSD-kaarten tot 32 GB die zijn geformatteerd als FAT16 of FAT32. Kaarten van 64 GB en groter worden als exFAT geleverd, en dat kan de module niet lezen; een kaart van 1–16 GB is meer dan genoeg voor een paar honderd nummers. Je mp3's coderen met 128–192 kbps en 44,1 kHz is de veiligste keuze, zowel voor compatibiliteit als voor de leessnelheid van de kaart. De module herkent bestanden aan hun nummer, niet aan hun naam, dus map- en bestandsnamen moeten een bepaald schema volgen, afhankelijk van de functie waarmee je ze afspeelt:
| Plek op de kaart | Voorbeeld | Bibliotheekfunctie | Regel |
|---|---|---|---|
| Hoofdmap | /0001.mp3, /0002.mp3 | play(1) | Speelt af in de volgorde waarin de bestanden naar de kaart zijn gekopieerd, niet op naam |
| Genummerde mappen | /01/001.mp3 … /99/255.mp3 | playFolder(1, 1) | Mapnaam 2 cijfers (01–99), bestandsnaam 3 cijfers (001–255) |
| Map mp3 | /mp3/0001.mp3 | playMp3Folder(1) | Bestandsnaam 4 cijfers; het bestand wordt gevonden via het nummer in de naam |
| Map advert | /advert/0001.mp3 | advertise(1) | Onderbreekt het huidige nummer en hervat het wanneer de mededeling klaar is |
| Grote mappen | /01/0001.mp3 … /15/3000.mp3 | playLargeFolder(1, 1) | Tot 15 mappen, 3000 bestanden per map, namen van 4 cijfers |
- Formatteer de kaart op je computer als FAT32 (op Windows: rechtsklikken > Formatteren; op macOS: Schijfhulpprogramma > Wis > MS-DOS (FAT)).
- Maak in de hoofdmap een map met de naam mp3 en, indien nodig, genummerde mappen zoals 01 en 02.
- Hernoem je bestanden naar 0001.mp3, 0002.mp3 (in genummerde mappen: 001.mp3). Je mag na het nummer een omschrijving toevoegen, zoals 0001_hallo.mp3; de module kijkt alleen naar de cijfers aan het begin.
- Als je de bestanden in de hoofdmap met play() afspeelt, kopieer ze dan één voor één, op volgorde; bij een bulkkopie kan de volgorde door elkaar raken.
- Werp de kaart veilig uit en plaats hem in de module terwijl de voeding uit staat; plaatsen of verwijderen tijdens het werken kan de bestanden beschadigen.
De bibliotheek DFRobotDFPlayerMini en een eerste testsketch
- Open in de Arduino IDE de Library Manager, typ DFRobotDFPlayerMini en installeer de bibliotheek van DFRobot. De installatiestappen worden uitgebreid uitgelegd in Een bibliotheek toevoegen aan Arduino.
- Kopieer minstens één mp3 naar de hoofdmap van de sd-kaart, plaats de kaart in de module en bouw de schakeling zoals in de tabel.
- Upload de onderstaande sketch en open de Serial Monitor op 115200 baud.
- Binnen een paar seconden zie je "DFPlayer Mini online." en het aantal bestanden op de kaart, en daarna hoor je het eerste nummer.
1#include <SoftwareSerial.h>
2#include <DFRobotDFPlayerMini.h>
3
4SoftwareSerial dfSerial(10, 11); // RX = D10 ← DFPlayer TX, TX = D11 → 1 kΩ → DFPlayer RX
5DFRobotDFPlayerMini player;
6
7void setup() {
8 Serial.begin(115200);
9 dfSerial.begin(9600); // DFPlayer her zaman 9600 baud / DFPlayer always uses 9600 baud
10 Serial.println(F("DFPlayer baslatiliyor / Starting DFPlayer..."));
11
12 if (!player.begin(dfSerial)) { // reset gönderir, kartı bekler / sends a reset, waits for the card
13 Serial.println(F("Unable to begin: kablolari ve SD karti kontrol et / check wiring and SD card"));
14 while (true) {} // burada dur / stop here
15 }
16 Serial.println(F("DFPlayer Mini online."));
17 Serial.print(F("Karttaki dosya / Files on card: "));
18 Serial.println(player.readFileCounts()); // gizli dosyalar da sayılır / hidden files are counted too
19
20 player.volume(20); // ses seviyesi 0-30 / volume 0-30
21 player.EQ(DFPLAYER_EQ_NORMAL); // ekolayzır: normal / equalizer: normal
22 player.play(1); // kökteki ilk dosya / first file in the root
23}
24
25void loop() {
26 if (player.available()) { // modülden bildirim geldi / a message arrived from the module
27 uint8_t type = player.readType();
28 int value = player.read();
29 if (type == DFPlayerPlayFinished) {
30 Serial.print(F("Parca bitti / Track finished: "));
31 Serial.println(value);
32 } else if (type == DFPlayerError) {
33 Serial.print(F("Hata kodu / Error code: "));
34 Serial.println(value); // kodların anlamı tabloda / meanings are in the table
35 } else if (type == DFPlayerCardRemoved) {
36 Serial.println(F("SD kart cikarildi / SD card removed"));
37 }
38 }
39}
40| Functie | Wat het doet |
|---|---|
| begin(serial, isACK, doReset) | Start de module; standaard stuurt hij een reset en wacht op het bericht dat de kaart klaar is |
| volume(0–30) | Stelt het volume in; volumeUp() en volumeDown() wijzigen het met één stap |
| EQ(DFPLAYER_EQ_POP) | Equalizer: NORMAL, POP, ROCK, JAZZ, CLASSIC, BASS |
| play(n) | Speelt het n-de bestand in de hoofdmap af (in kopieervolgorde) |
| next() / previous() | Volgend / vorig nummer |
| pause() / start() | Pauzeert / hervat vanaf waar het stopte |
| stop() | Stopt het afspelen |
| loop(n) | Herhaalt nummer n continu |
| enableLoopAll() / randomAll() | Speelt alle nummers in een lus / in willekeurige volgorde af |
| readState() / readVolume() / readFileCounts() | Vraagt de status, het volume en het aantal bestanden op de kaart op |
| available() / readType() / read() | Leest berichten van de module (nummer afgelopen, fout, kaart verwijderd) |
Volume, EQ en opeenvolgende mededelingen met de BUSY-pin
Het volume loopt van 0 tot 30. Met een kleine speaker is 15–20 voor de meeste kamers genoeg; boven 25, zeker met een zwakke voeding, kan het geluid gaan vervormen (clipping) en kan de module resetten. De EQ-instelling verandert de verhouding tussen bas en hoge tonen; op kleine speakers kan de stand BASS het geluid dof maken, dus begin met NORMAL. Genummerde mappen zijn erg handig voor pratende projecten: zet de woorden "Temperatuur" en "graden" in map 01 en de getallen van 001.mp3 tot 100.mp3 in map 02, en de Arduino kan getallen als zin uitspreken. De betrouwbaarste manier om te weten dat een bestand klaar is, is de pin BUSY: die is LOW terwijl de module afspeelt en HIGH als hij stilstaat. De onderstaande sketch leest BUSY op D5 en speelt de bestanden na elkaar af zonder dat ze overlappen:
1#include <SoftwareSerial.h>
2#include <DFRobotDFPlayerMini.h>
3
4SoftwareSerial dfSerial(10, 11); // RX = D10 ← DFPlayer TX, TX = D11 → 1 kΩ → DFPlayer RX
5DFRobotDFPlayerMini player;
6const byte BUSY_PIN = 5; // DFPlayer BUSY: çalarken LOW / LOW while playing
7
8// Klasör 01: 001.mp3 "Sıcaklık", 002.mp3 "derece" / folder 01: 001.mp3 "Temperature", 002.mp3 "degrees"
9// Klasör 02: 001.mp3 ... 100.mp3 = 1 ... 100 sayıları / folder 02: 001.mp3 ... 100.mp3 = numbers 1 ... 100
10
11void playAndWait(uint8_t folder, uint8_t file) {
12 player.playFolder(folder, file); // /01/001.mp3 gibi / e.g. /01/001.mp3
13 unsigned long start = millis();
14 while (digitalRead(BUSY_PIN) == HIGH && millis() - start < 1000) {} // çalma başlasın / wait for playback to start
15 while (digitalRead(BUSY_PIN) == LOW) {} // parça bitsin / wait for the track to end
16 delay(50);
17}
18
19void sayTemperature(int degrees) {
20 playAndWait(1, 1); // "Sıcaklık" / "Temperature"
21 if (degrees >= 1 && degrees <= 100) {
22 playAndWait(2, degrees); // sayıyı söyle / say the number
23 }
24 playAndWait(1, 2); // "derece" / "degrees"
25}
26
27void setup() {
28 pinMode(BUSY_PIN, INPUT);
29 Serial.begin(115200);
30 dfSerial.begin(9600);
31 if (!player.begin(dfSerial)) {
32 Serial.println(F("Unable to begin"));
33 while (true) {}
34 }
35 player.volume(22);
36 sayTemperature(23); // değer bir sensörden de gelebilir / the value can come from a sensor
37}
38
39void loop() {
40}
41playAndWait() stuurt eerst het commando, wacht maximaal 1 seconde tot BUSY LOW wordt (de module heeft een paar honderd milliseconden nodig om te starten) en wacht dan tot het nummer afloopt. Je kunt de audiobestanden met je eigen stem opnemen of genereren met een text-to-speech-tool (TTS); de stilte aan het begin en einde van elk bestand wegknippen laat de mededeling natuurlijker lopen. Wil je de muziek voor een korte waarschuwing onderbreken, gebruik dan advertise(n): de module speelt de mededeling uit de map /advert af en hervat daarna de muziek waar hij was gebleven. Dit commando werkt alleen terwijl een nummer speelt; als je het aanroept terwijl de module stilstaat, geeft het een fout.
Nummers wisselen met knoppen en het volume instellen met een potmeter
Nu bouwen we onze eigen mp3-speler: drie knoppen fungeren als vorig nummer, afspelen/pauzeren en volgend nummer, en een potentiometer stelt het volume in. Sluit de knoppen aan tussen D2, D3 en D4 en GND; omdat we de interne pull-upweerstanden gebruiken, zijn er geen externe weerstanden nodig (de reden staat in Een knop aansluiten). De buitenste pins van de potentiometer gaan naar 5V en GND, de middelste pin naar A0. Wanneer een nummer afloopt, gaat de sketch automatisch door naar het volgende.
1#include <SoftwareSerial.h>
2#include <DFRobotDFPlayerMini.h>
3
4SoftwareSerial dfSerial(10, 11); // RX = D10 ← DFPlayer TX, TX = D11 → 1 kΩ → DFPlayer RX
5DFRobotDFPlayerMini player;
6
7const byte BTN[3] = {2, 3, 4}; // önceki, oynat/duraklat, sonraki / previous, play/pause, next
8const byte POT_PIN = A0; // ses ayarı potu / volume potentiometer
9bool lastState[3] = {HIGH, HIGH, HIGH};
10unsigned long lastChange[3] = {0, 0, 0};
11bool paused = false;
12int lastRaw = -100; // ilk turda sesi mutlaka ayarla / always set the volume on the first pass
13unsigned long lastPotRead = 0;
14unsigned long lastFinish = 0;
15
16// Butona yeni basıldıysa true döner (50 ms sıçrama filtresi) / true on a new press (50 ms debounce)
17bool pressed(byte i) {
18 bool s = digitalRead(BTN[i]);
19 if (s != lastState[i] && millis() - lastChange[i] > 50) {
20 lastState[i] = s;
21 lastChange[i] = millis();
22 return s == LOW; // INPUT_PULLUP: basınca LOW / LOW when pressed
23 }
24 return false;
25}
26
27void setup() {
28 for (byte i = 0; i < 3; i++) pinMode(BTN[i], INPUT_PULLUP);
29 Serial.begin(115200);
30 dfSerial.begin(9600);
31 if (!player.begin(dfSerial)) {
32 Serial.println(F("Unable to begin"));
33 while (true) {}
34 }
35 player.play(1);
36}
37
38void loop() {
39 if (pressed(0)) { player.previous(); paused = false; }
40 if (pressed(2)) { player.next(); paused = false; }
41 if (pressed(1)) {
42 if (paused) player.start(); // kaldığı yerden devam / resume
43 else player.pause(); // duraklat / pause
44 paused = !paused;
45 }
46
47 if (millis() - lastPotRead > 100) { // potu saniyede 10 kez oku / read the pot 10 times per second
48 lastPotRead = millis();
49 int raw = analogRead(POT_PIN);
50 if (abs(raw - lastRaw) > 20) { // titremeyi yok say / ignore jitter
51 lastRaw = raw;
52 player.volume(map(raw, 0, 1023, 0, 30));
53 }
54 }
55
56 if (player.available() && player.readType() == DFPlayerPlayFinished) {
57 if (millis() - lastFinish > 1000) player.next(); // parça bitince sonrakine geç / go to the next track
58 lastFinish = millis(); // bazı modüller bitişi iki kez bildirir / some modules report the end twice
59 }
60}
61| Codedeel | Waar het voor dient |
|---|---|
| pressed() | Registreert alleen het moment waarop een knop wordt ingedrukt en negeert contactdender binnen 50 ms; de knop ingedrukt houden stuurt maar één commando |
| abs(raw - lastRaw) > 20 | Werkt het volume alleen bij duidelijke veranderingen bij, zodat kleine schommelingen in de potmeterwaarde de module niet overspoelen met commando's en klikken veroorzaken |
| map(raw, 0, 1023, 0, 30) | Zet de analoge waarde 0–1023 om naar het volumebereik 0–30 van de DFPlayer |
| paused | Onthoudt de afspeelstatus, zodat dezelfde knop kan pauzeren en hervatten |
| DFPlayerPlayFinished | Het bericht dat wordt verstuurd als een nummer afloopt; de sketch gaat door naar het volgende nummer |
| millis() - lastFinish > 1000 | Sommige kloonmodules melden het einde van een nummer twee keer; deze controle voorkomt dat een nummer wordt overgeslagen |
Een speaker (3 W) en een externe versterker kiezen
De eigen versterker van de DFPlayer (op de meeste boards een chip van het type 8002) stuurt een speaker onder 3 W met een impedantie van 4 Ω of 8 Ω direct aan. De beste balans krijg je met een speaker van 8 Ω en 1–3 W; kleine speakers van 0,5 W werken ook, maar hebben moeite op hoog volume. De 3 W is de bovengrens van de versterker bij 5 V voeding en een belasting van 4 Ω, op het punt waar vervorming duidelijk hoorbaar wordt; het schone vermogen dat je in het dagelijks gebruik krijgt, ligt lager. De speaker in een kastje monteren, of op zijn minst op een paneel, verbetert de bas merkbaar, omdat het geluid van de voor- en achterkant van de conus elkaar dan niet meer opheft. Op hoog volume kan de module kortstondig een paar honderd milliampère trekken; bij een Arduino die via de usb-poort van een computer wordt gevoed kan dat spanningsdalingen, sissen en resets veroorzaken. Wil je meer vermogen of stereogeluid, sluit dan de lijnuitgangen DAC_L en DAC_R aan op een externe versterker:
| Uitgangsroute | Aansluiting | Wanneer? |
|---|---|---|
| Ingebouwde versterker | SPK_1 en SPK_2 → speaker van 4–8 Ω tot 3 W | Kleine projecten zoals deurbellen, speelgoed en gesproken meldingen |
| Hoofdtelefoon | DAC_L, DAC_R en GND → 3,5 mm-jack | Persoonlijk luisteren; begin op laag volume |
| Versterkermodule PAM8403 | DAC_L, DAC_R en GND → de ingangen L, R en GND van de versterker; de versterker werkt op 5 V | 2 × 3 W stereo, draagbare speaker op batterijen |
| Versterker PAM8610 of TPA3116 | DAC-uitgangen → versterkeringang; de versterker werkt op 12 V | Meer vermogen: 2 × 10 W en meer |
| Actieve speaker (AUX) | DAC_L, DAC_R en GND → de AUX-ingang van de actieve speaker | Een bestaande computerspeaker gebruiken |
Van sissen, ruis en klikken af komen
- Sissen en klikken tijdens het sturen van commando's: De weerstand van 1 kΩ op de RX-lijn ontbreekt. Plaats hem tussen de TX-pin van de Arduino en de RX-pin van de module.
- Constant sissen of brommen: De voeding is ruisig of te zwak. Voed de DFPlayer met een aparte 5V-voeding, plaats een condensator tussen VCC en GND en verbind alle massa's met elkaar.
- Een "plop" bij het opstarten: Die komt van het resetcommando dat begin() verstuurt. Als het je stoort, sla je de reset over met player.begin(dfSerial, true, false).
- Gezoem bij de ESP32: Stroompulsen tijdens Wi-Fi-verzending komen in de voeding terecht en vandaar in de audio. Voeg een condensator toe aan de voeding van de DFPlayer en gebruik zo mogelijk een aparte voeding.
- Krakend, vervormd geluid op hoog volume: De speaker of versterker werkt op zijn limiet. Zet het volume terug naar ongeveer 20–25, kies een efficiëntere speaker of schakel over op een externe versterker.
- Zwak sissen als er niets speelt: Dit is de eigen ruis van de ingebouwde versterker en die verdwijnt op kleine modules nooit helemaal. In projecten waar stilte telt, geeft het aansluiten van de DAC-uitgang op een goede externe versterker het beste resultaat.
De fout "Unable to begin" en hoe je hem oplost
Als de Serial Monitor Unable to begin: toont, gevolgd door 1.Please recheck the connection! en 2.Please insert the SD card!, is de begin()-controle in de voorbeeldsketch van de bibliotheek mislukt. begin() stuurt de module een resetcommando en wacht 2 seconden op het bericht "card online"; komt dat bericht niet, dan geeft het false terug. De oorzaak kan dus de bedrading, de sd-kaart, de voeding of de manier zijn waarop de module antwoordt. Loop het in deze volgorde na:
| Mogelijke oorzaak | Controleren en oplossen |
|---|---|
| TX en RX niet gekruist | De TX van de module moet naar D10 (SoftwareSerial RX) en zijn RX via 1 kΩ naar D11 (SoftwareSerial TX); dit moet overeenkomen met de volgorde (RX, TX) in SoftwareSerial(10, 11) |
| Geen gemeenschappelijke GND | De GND van de module moet met de GND van de Arduino zijn verbonden; gebruik je een aparte voeding, verbind dan ook de massa's |
| Sd-kaart wordt niet gelezen | Zit de kaart erin, is hij FAT32, kleiner dan 32 GB en staat er minstens één audiobestand op? Formatteer hem opnieuw of probeer een andere kaart |
| Verkeerde weerstand | De RX-lijn heeft 1 kΩ nodig; grote waarden zoals 10 kΩ verzwakken het signaal |
| Te weinig voeding | VCC moet 4–5 V zijn; koppel de speaker tijdelijk los, meet de spanning met een multimeter en voeg een condensator toe |
| Verkeerde baudrate | Het moet dfSerial.begin(9600); zijn; verwar het niet met de snelheid van de Serial Monitor (115200) |
| D0 en D1 gebruikt | Op de Uno wordt de hardware-seriële poort gedeeld met usb; verplaats de module naar de SoftwareSerial-pins |
| Kloonchip antwoordt laat | Voeg delay(1000) toe vóór begin(); helpt dat niet, gebruik dan begin(dfSerial, true, false) om het wachten na de reset over te slaan |
| DFPlayerError-code | Naam in de bibliotheek | Betekenis |
|---|---|---|
| 1 | Busy | Module bezig of kaart niet gevonden (initialisatie niet klaar) |
| 2 | Sleeping | Module staat in slaapstand |
| 3 | SerialWrongStack | Beschadigde seriële data ontvangen |
| 4 | CheckSumNotMatch | De checksum van het pakket klopte niet |
| 5 | FileIndexOut | Het gevraagde nummer valt buiten het bereik op de kaart |
| 6 | FileMismatch | Het gevraagde bestand is niet gevonden; controleer de benaming |
| 7 | Advertise | Advert-fout, bijvoorbeeld advertise() aangeroepen terwijl er niets speelt |
DFPlayer Mini met de ESP32: mp3's bedienen vanaf een webpagina
Op de ESP32 heb je SoftwareSerial niet nodig; elk van de drie hardware-UART's kan aan de pins van je keuze worden toegewezen. In de onderstaande sketch draait UART2 op GPIO 16 (RX) en GPIO 17 (TX) en wordt de DFPlayer gevoed vanaf de 5V-pin (VIN) van het ESP32-board. Het 3,3V-TX-signaal van de ESP32 is rechtstreeks compatibel met de module, maar houd de weerstand van 1 kΩ toch aan als bescherming tegen ruis. In de andere richting geeft DFRobot op dat het logische niveau van de module 3,3 V is; toch is op de TX-lijn van sommige kloonboards op 5 V een hogere spanning gemeten. Meet vóór het aansluiten tussen TX en GND met een multimeter; ligt die boven 3,6 V, voeg dan een spanningsdeler van 1 kΩ + 2 kΩ toe. De sketch maakt verbinding met je thuisnetwerk en serveert een pagina die je op je telefoon kunt openen; met de knoppen wissel je nummers, pauzeer je en pas je het volume aan.
1#include <WiFi.h>
2#include <WebServer.h>
3#include <DFRobotDFPlayerMini.h>
4
5const char *WIFI_SSID = "WIFI_ADI"; // kendi ağ adın / your network name
6const char *WIFI_PASS = "WIFI_SIFRESI"; // kendi şifren / your password
7
8HardwareSerial dfSerial(2); // UART2
9DFRobotDFPlayerMini player;
10WebServer server(80);
11int volumeLevel = 15;
12
13const char PAGE[] = R"rawliteral(<!DOCTYPE html><html><head>
14<meta name="viewport" content="width=device-width,initial-scale=1"><title>ESP32 MP3</title>
15<style>body{font-family:sans-serif;text-align:center}button{font-size:22px;margin:6px;padding:10px 18px}</style>
16</head><body><h2>DFPlayer Mini</h2>
17<button onclick="c('prev')">Prev</button><button onclick="c('pause')">Pause</button>
18<button onclick="c('play')">Play</button><button onclick="c('next')">Next</button><br>
19<button onclick="c('down')">Vol -</button><button onclick="c('up')">Vol +</button>
20<p id="s"></p>
21<script>function c(x){fetch('/cmd?c='+x).then(r=>r.text()).then(t=>document.getElementById('s').innerText=t)}</script>
22</body></html>)rawliteral";
23
24void handleCmd() {
25 String c = server.arg("c");
26 if (c == "next") player.next();
27 else if (c == "prev") player.previous();
28 else if (c == "pause") player.pause();
29 else if (c == "play") player.start();
30 else if (c == "up" && volumeLevel < 30) player.volume(++volumeLevel);
31 else if (c == "down" && volumeLevel > 0) player.volume(--volumeLevel);
32 server.send(200, "text/plain", "Ses / Volume: " + String(volumeLevel));
33}
34
35void setup() {
36 Serial.begin(115200);
37 dfSerial.begin(9600, SERIAL_8N1, 16, 17); // RX = GPIO16 ← DFPlayer TX, TX = GPIO17 → 1 kΩ → DFPlayer RX
38 delay(1000); // modül kartı okusun / let the module read the card
39 if (!player.begin(dfSerial)) {
40 Serial.println("Unable to begin");
41 while (true) delay(10);
42 }
43 player.volume(volumeLevel);
44
45 WiFi.begin(WIFI_SSID, WIFI_PASS);
46 while (WiFi.status() != WL_CONNECTED) { // ağa bağlanana kadar bekle / wait for the network
47 delay(500);
48 Serial.print(".");
49 }
50 Serial.print("\nAdres / Address: http://");
51 Serial.println(WiFi.localIP());
52
53 server.on("/", []() { server.send(200, "text/html", PAGE); });
54 server.on("/cmd", handleCmd);
55 server.begin();
56 player.play(1);
57}
58
59void loop() {
60 server.handleClient(); // tarayıcı isteklerini işle / handle browser requests
61}
62Typ na het uploaden het adres dat de Serial Monitor toont (bijvoorbeeld 192.168.1.42) in de browser van je telefoon; je telefoon en de ESP32 moeten op hetzelfde Wi-Fi-netwerk zitten. Lukt het verbinden niet, volg dan de stappen in ESP32 maakt geen verbinding met Wi-Fi. Op boards met een ESP32-WROVER-module zijn GPIO 16 en 17 gereserveerd voor het interne PSRAM, dus verplaats de UART naar andere pins zoals 26 en 27; je hoeft alleen de pinnummers in de regel dfSerial.begin() te wijzigen. Als de ESP32 uit zichzelf herstart terwijl de speaker hard speelt, ligt het probleem bij de voeding; zie ESP32 Brownout voor details.
DFPlayer Mini met de Raspberry Pi Pico en MicroPython (UART)
Op de Raspberry Pi Pico is het rechtstreeks gebruiken van het seriële protocol van de module zowel makkelijk als leerzaam, in plaats van te zoeken naar een kant-en-klare bibliotheek. Elk commando is een pakket van 10 bytes: de startbyte 0x7E, de versie 0xFF, de lengte 0x06, de commandocode, de feedbackvlag (0 = geen bevestiging), een parameter van twee bytes, een checksum van twee bytes en de eindbyte 0xEF. De checksum is het 16-bits negatief van de som van de zes bytes van de versie tot en met de laatste parameterbyte. Het pakket dat het eerste nummer in de hoofdmap afspeelt is bijvoorbeeld 7E FF 06 03 00 00 01 FE F7 EF. De module stuurt op zijn beurt berichten met code 0x3D als een nummer klaar is, 0x3F als de kaart klaar is en 0x40 bij een fout. De 3,3V-UART van de Pico past direct bij de module; de waarschuwing over de TX-spanning uit het ESP32-gedeelte geldt hier ook, want ook de pins van de Pico zijn niet 5V-tolerant. Voed de module vanaf de VBUS-pin (usb 5 V) van de Pico.
| Commando | Code | Parameter |
|---|---|---|
| Volgend / vorig nummer | 0x01 / 0x02 | Geen |
| Het n-de nummer in de hoofdmap afspelen | 0x03 | 1–2999 |
| Volume | 0x06 | 0–30 |
| EQ | 0x07 | 0–5 |
| Reset | 0x0C | Geen |
| Hervatten / pauzeren | 0x0D / 0x0E | Geen |
| Afspelen uit een map | 0x0F | Hoge byte map (1–99), lage byte bestand (1–255) |
| Afspelen uit de map mp3 | 0x12 | Bestandsnummer (1 voor 0001.mp3) |
| Mededeling (advert) | 0x13 | Bestandsnummer |
| Stoppen | 0x16 | Geen |
| Nummer afgelopen (verstuurd door de module) | 0x3D | Nummer van het afgelopen nummer |
1from machine import UART, Pin
2import time
3
4# GP0 (UART0 TX) → 1 kΩ → DFPlayer RX, GP1 (UART0 RX) ← DFPlayer TX
5uart = UART(0, baudrate=9600, tx=Pin(0), rx=Pin(1))
6btn_next = Pin(14, Pin.IN, Pin.PULL_UP) # sonraki parça / next track
7btn_play = Pin(15, Pin.IN, Pin.PULL_UP) # oynat-duraklat / play-pause
8TRACKS = 5 # /mp3 klasöründeki dosya sayısı / number of files in /mp3
9
10def send(cmd, param=0):
11 # 10 baytlık komut paketi, onay istemeden / 10-byte command frame without ACK
12 frame = bytearray([0x7E, 0xFF, 0x06, cmd, 0x00, param >> 8, param & 0xFF, 0, 0, 0xEF])
13 checksum = -sum(frame[1:7]) & 0xFFFF # sağlama toplamı / checksum
14 frame[7] = checksum >> 8
15 frame[8] = checksum & 0xFF
16 uart.write(frame)
17 time.sleep_ms(30)
18
19buf = b""
20
21def events():
22 # gelen 10 baytlık bildirimlerin komut kodlarını döndür / return command codes of incoming messages
23 global buf
24 if uart.any():
25 buf += uart.read()
26 codes = []
27 while True:
28 start = buf.find(b"\x7e")
29 if start < 0:
30 buf = b""
31 break
32 if len(buf) - start < 10:
33 buf = buf[start:]
34 break
35 frame = buf[start:start + 10]
36 if frame[9] == 0xEF:
37 codes.append(frame[3])
38 buf = buf[start + 10:]
39 else:
40 buf = buf[start + 1:]
41 return codes
42
43def play_track(n):
44 send(0x12, n) # /mp3/000n.mp3 dosyasını çal / play /mp3/000n.mp3
45
46time.sleep(2) # modül kartı okusun / let the module read the card
47send(0x06, 18) # ses 18/30 / volume 18 of 30
48track = 1
49play_track(track)
50playing = True
51last_end = 0
52
53while True:
54 if btn_next.value() == 0:
55 track = track % TRACKS + 1 # son parçadan sonra başa dön / wrap after the last track
56 play_track(track)
57 playing = True
58 time.sleep_ms(300) # basit sıçrama önleme / simple debounce
59 if btn_play.value() == 0:
60 send(0x0E if playing else 0x0D) # 0x0E duraklat, 0x0D devam / 0x0E pause, 0x0D resume
61 playing = not playing
62 time.sleep_ms(300)
63 for code in events():
64 # 0x3D: SD karttaki parça bitti / 0x3D: track on the SD card finished
65 if code == 0x3D and time.ticks_diff(time.ticks_ms(), last_end) > 1000:
66 last_end = time.ticks_ms() # çift bildirimi yok say / ignore the duplicate message
67 track = track % TRACKS + 1
68 play_track(track)
69Sla je de code met Thonny op de Pico op als main.py, dan gedraagt de Pico zich bij elke start als een mp3-speler; ben je nieuw met MicroPython, bekijk dan MicroPython-basis. De knop op GP14 springt naar het volgende nummer en de knop op GP15 pauzeert en hervat; de andere kant van elke knop gaat naar GND. De functie events() verzamelt binnenkomende bytes in een buffer en haalt de pakketten eruit die met 0x7E beginnen en met 0xEF eindigen. Komt er een bericht dat een nummer klaar is (0x3D), dan gaat de code door naar het volgende bestand en begint na het laatste weer bij het eerste. Vergeet niet de variabele TRACKS in te stellen op het aantal bestanden in je map /mp3.
Projectideeën met de DFPlayer Mini
- Melodiedeurbel: Een deurbel die een willekeurige melodie speelt als je op de knop drukt en 's nachts zijn volume verlaagt.
- Welkomstsysteem: Een PIR-bewegingssensor activeert een begroeting als er iemand aankomt.
- Muziekdoos met kaarten: Elke RFID-kaart speelt een andere map af; een muziekspeler zonder scherm voor kinderen.
- Pratende klok: Met een RTC-klokmodule een klok die de tijd uitspreekt of elk uur omroept.
- Mp3-speler met afstandsbediening: Nummers en volume bedienen met een IR-ontvanger en afstandsbediening.
- Halloweenprop of grappendoos: Een HC-SR04 speelt een eng geluid af als hij iemand ziet naderen.
- Gesproken alarmen en meldingen: Duidelijke zinnen zoals "Gas gedetecteerd in de keuken" in plaats van een piep bij gas, wateroverlast of een open deur.
- Mp3-speler met display: Toon het nummer en het volume op een OLED-display.
Met een goed benoemde sd-kaart, de weerstand van 1 kΩ op de RX-lijn en een stabiele 5V-voeding geeft de DFPlayer Mini je Arduino-projecten in een paar minuten echt geluid. Gaat er iets mis, controleer dan eerst de kaart en de bedrading en daarna de voeding; bijna elk probleem komt van een van die drie. Ben je benieuwd naar de basis van seriële communicatie, dan is UART seriële communicatie een goede volgende stap. In de BlueGrays-app vind je geluidsprojecten zoals melodieën afspelen met een buzzer, een simpele piano, een deurbel met bewegingssensor en ESP32-melodieën, elk met schakelschema's en stap-voor-stapcode, en die kun je daarna met de DFPlayer Mini echt laten klinken.
Veelgestelde vragen
Welke grootte sd-kaart ondersteunt de DFPlayer Mini?
De DFPlayer Mini leest microSD-kaarten tot 32 GB die zijn geformatteerd als FAT16 of FAT32. Kaarten van 64 GB en groter zijn als exFAT geformatteerd, dus de module ziet ze niet. Een kaart van 1–16 GB is meer dan genoeg voor een paar honderd mp3's.
Waarom speelt mijn DFPlayer Mini geen geluid af?
Zorg er eerst voor dat je "online" in de Serial Monitor ziet; zo niet, dan zit het probleem in de bedrading of de sd-kaart. Start de module wel maar komt er geen geluid, controleer dan of het volume niet 0 is, of de speaker op SPK_1 en SPK_2 is aangesloten en of de bestandsnamen overeenkomen met de functie die je aanroept. Als het ledje op het board brandt, speelt de module echt af.
Waarom zet je een weerstand van 1 kΩ op de RX-pin van de DFPlayer Mini?
De chip van de module werkt op 3,3 V, terwijl de TX-pin van de Arduino Uno 5 V uitgeeft. Een weerstand van 1 kΩ in serie met de RX-lijn beperkt de stroom naar de chip en vermindert het sissen dat je tijdens seriële communicatie uit de speaker hoort. Op 3,3V-boards zoals de ESP32 en Pico wordt hij ook aanbevolen, als bescherming tegen ruis.
Kan de DFPlayer Mini zonder Arduino werken?
Ja. Als je de pins IO_1 en IO_2 via knoppen met GND verbindt, wisselt een korte druk het nummer en regelt een lange druk het volume. Knoppen die via weerstanden op de ADKEY-pins zijn aangesloten, kunnen ook specifieke nummers afspelen. Zo bouw je met alleen een batterij, een speaker en een paar knoppen een mp3-speler of deurbel, zonder microcontroller.
Welke speaker kan ik op de DFPlayer Mini aansluiten?
Een speaker van 4 Ω of 8 Ω met een vermogen onder 3 W sluit je direct aan op de pins SPK_1 en SPK_2; speakers van 8 Ω en 1–3 W geven de beste balans. Sluit nooit een van de speakerdraden aan op GND. Voor luider of stereogeluid sluit je de uitgangen DAC_L en DAC_R aan op een versterker zoals de PAM8403.
Waarom speelt de DFPlayer Mini bestanden in de verkeerde volgorde af?
De functie play(n) kijkt niet naar de bestandsnaam maar naar de volgorde waarin de bestanden naar de kaart zijn gekopieerd. Wil je op naam afspelen, geef de bestanden dan de naam /mp3/0001.mp3 en gebruik playMp3Folder(), of noem ze /01/001.mp3 en gebruik playFolder(). Heb je de kaart op een Mac voorbereid, verwijder dan ook de verborgen ._-bestanden.
Projecten om hierna te bouwen
Alle projecten bekijken
Een buzzer gebruiken
Heb je je ooit afgevraagd hoe een deurbel of alarm geluid maakt? De Arduino laat een kleine buzzer met korte tussenpozen piepen: piep, pauze, piep, pauze.

Turks volkslied met een buzzer
Druk op de knop en een kleine buzzer speelt noot voor noot het Turkse volkslied (İstiklal Marşı).

Frequentie instellen met een buzzer
Met vier knoppen bestuur je het geluid van een buzzer: één start het geluid, één stopt het en de andere twee maken het hoger of lager.

Melodie afspelen met een buzzer op de ESP32
Een eenvoudige melodie (Twinkle Twinkle Little Star) afspelen met een passieve buzzer. Net als op Arduino speel je noten met de functies tone() en noTone(); met ESP32 Arduino Core 3.0+ werkt dezelfde syntaxis. Je moet een passieve buzzer gebruiken (een actieve buzzer speelt geen melodie).

Melodieën afspelen met IR-afstandsbediening en buzzer
Bouw een muziekdoos die melodieën speelt met de knoppen van een tv-afstandsbediening.

Eenvoudige piano met buzzer en knoppen
Bouw je eigen kleine piano met acht knoppen. Elke knop is één noot, van laag naar hoog: do, re, mi, fa, sol, la, si en hoge do.

Deurbel en licht met bewegingssensor
Als iemand naar je deur loopt, weet je het al voordat er wordt aangebeld. Zodra de bewegingssensor iemand opmerkt, gaat de led branden en speelt de buzzer een beltoon van drie noten van hoog naar…
Meer artikelen
BlueGrays-app
Bouw deze schakeling stap voor stap op je telefoon
Schakelschema, code en onderdelenlijst op één scherm. Meer dan 500 Arduino-, ESP32- en Pico-projecten om te bouwen.
Scan met je telefoon
Richt je camera op de code en de appstore van je telefoon opent.
of open de store

