DFPlayer Mini Arduino Kullanımı: MP3 Çalma, SD Kart ve Hoparlör

DFPlayer Mini, Arduino ile MP3 çalmanın en ucuz ve en kolay yoludur: microSD karttaki ses dosyalarını kendi başına çözer, üzerindeki küçük amfiyle bir hoparlörü doğrudan sürer ve Arduino'dan yalnızca iki kabloluk bir seri bağlantıyla komut alır. Buzzer'ın bip seslerinin aksine şarkı, konuşma, kapı zili melodisi ya da "Kapı açık kaldı" gibi sesli uyarılar çalabilirsin. Modülü ilk kez bağlayanların çoğu aynı sorunlarla karşılaşır: ses gelmez, hoparlör cızırdar, dosyalar yanlış sırada çalar ya da Seri Monitör'de "Unable to begin" yazar. Bu rehber bu sorunların hepsini nedenleriyle birlikte çözüyor.

Önce modülün pinlerini ve RX hattına neden 1 kΩ direnç konduğunu öğreneceksin. Ardından SD kartı FAT32 olarak hazırlamayı, dosyaları 0001.mp3 ve 01 klasörü düzeniyle adlandırmayı, DFRobotDFPlayerMini kütüphanesiyle ilk sesi çalmayı, ses seviyesini ve EQ'yu ayarlamayı, butonlarla parça değiştirmeyi ve doğru hoparlörü ya da harici amfiyi seçmeyi göreceksin. Son bölümlerde "Unable to begin" hatasının adım adım çözümü, ESP32 ile web sayfasından kontrol edilen bir MP3 çalar ve Raspberry Pi Pico için kütüphanesiz bir MicroPython örneği var. Yalnızca bip sesi ya da basit bir melodi yetiyorsa buzzer daha basit bir seçenektir.

DFPlayer Mini nedir, nasıl çalışır?

DFPlayer Mini; MP3 çözücü (decoder) yonga, 24 bitlik DAC, microSD kart yuvası ve küçük bir mono amfiden oluşan, kendi başına çalışan bir MP3 çalardır. Arduino'nun görevi yalnızca "3 numaralı parçayı çal" ya da "sesi 20 yap" gibi kısa komutlar göndermektir; dosyayı karttan okumak, sıkıştırılmış sesi çözmek ve hoparlörü sürmek modülün işidir. Bu yüzden 2 KB RAM'li bir Arduino Uno bile rahatça müzik çalabilir. Komutlar 9600 baud hızında, her biri 10 bayttan oluşan paketlerle gönderilir; modül de bir parça bittiğinde, kart takılıp çıkarıldığında ya da bir hata olduğunda aynı biçimde bildirim yollar. Kartların üzerindeki yonga üreticiye göre değişir (YX5200-24SS, MH2024K-24SS, GD3200B gibi). Hepsi aynı komutları anlar ama yanıt süreleri farklı olabilir; bu ayrıntı ileride "Unable to begin" hatasında önemli olacak. Modül üç yolla yönetilebilir: seri port (UART), IO düğmeleri ve ADKEY direnç merdiveni.

DFPlayer Mini pinleri

Seri portla kullanırken yalnızca VCC, GND, RX, TX ve hoparlör pinleri gerekir. BUSY pini, parçanın bitip bitmediğini seri haberleşmeye gerek kalmadan anlamanı sağlar; kartın üzerindeki küçük LED de çalma sırasında yanar. IO_1 ve IO_2 pinleri ise modülün Arduino olmadan da çalışabilmesini sağlar: bu pinlerle GND arasına bağlanan birer butona kısa basınca parça değişir, uzun basınca ses ayarlanır. ADKEY pinlerine farklı değerli dirençlerle bağlanan butonlar da belirli parçaları çalabilir. Böylece pil, hoparlör ve iki butonla mikrodenetleyicisiz bir kapı zili ya da sesli oyuncak yapabilirsin. USB+ ve USB− pinleri SD kart yerine bir USB bellekten çalmak içindir ve çoğu projede boş kalır.

DFPlayer Mini Arduino bağlantısı ve RX hattındaki 1k direnç

Veri hatları çapraz bağlanır: modülün TX'i kartın RX'ine, RX'i de kartın TX'ine gider. Uno'nun D0 ve D1'deki donanım seri portu USB üzerinden kod yüklemek ve Seri Monitör için kullanıldığından modülü SoftwareSerial ile D10 (RX) ve D11 (TX) pinlerine bağlıyoruz. Modülün RX girişine seri bağlanan 1 kΩ direnç önemsiz bir ayrıntı değildir. DFPlayer'ın yongası 3,3 V lojik seviyesiyle çalışır, Uno'nun TX pini ise 5 V verir. Direnç olmadan aradaki fark, yonganın giriş koruma diyotları üzerinden akım akıtır; bu akım hem yongayı zorlar hem de seri haberleşme sırasında hoparlörde duyulan cızırtı ve tıkırtılara yol açar. Ohm kanunu ile hesaplarsan 1 kΩ'un bu akımı yaklaşık 1–2 mA ile sınırladığını görürsün; 9600 baud'luk sinyal ise bundan etkilenmez. 10 kΩ gibi çok daha büyük bir direnç sinyali zayıflatıp haberleşmeyi kesebilir. Modülün TX çıkışı Uno'ya doğrudan bağlanır, çünkü Uno 3,3 V'u HIGH olarak okur (eşik yaklaşık 3,0 V).

SD kart hazırlığı: FAT32, klasörler ve 0001.mp3 adlandırma

DFPlayer Mini, en fazla 32 GB'lık microSD kartları FAT16 ya da FAT32 dosya sistemiyle okur. 64 GB ve üzeri kartlar fabrikadan exFAT biçimiyle gelir ve modül bu biçimi okumaz; birkaç yüz parça için 1–16 GB'lık bir kart fazlasıyla yeterlidir. MP3'leri 128–192 kbps ve 44,1 kHz ile kaydetmek hem uyumluluk hem de kart okuma hızı açısından en güvenli seçimdir. Modül dosyaları adlarıyla değil numaralarıyla tanır; hangi fonksiyonla çalacağına göre klasör ve dosya adlarının belirli bir düzene uyması gerekir:

1. Kartı bilgisayarda FAT32 olarak biçimlendir (Windows'ta sağ tık > Biçimlendir, macOS'te Disk İzlencesi > Sil > MS-DOS (FAT)).
2. Kök dizinde mp3 adlı bir klasör ve gerekiyorsa 01, 02 gibi numaralı klasörler oluştur.
3. Dosyaları 0001.mp3, 0002.mp3 biçiminde (numaralı klasörlerde 001.mp3) yeniden adlandır. Numaradan sonra açıklama ekleyebilirsin: 0001_merhaba.mp3 gibi; modül yalnızca baştaki rakamlara bakar.
4. Kök dizindeki dosyaları play() ile çalacaksan onları tek tek ve sırayla kopyala; toplu kopyalamada sıra karışabilir.
5. Kartı bilgisayardan güvenle çıkar ve modüle güç yokken tak; çalışırken takıp çıkarmak dosyaları bozabilir.

DFRobotDFPlayerMini kütüphanesi ve ilk test kodu

1. Arduino IDE'de Kütüphane Yöneticisi'ni aç, DFRobotDFPlayerMini yaz ve DFRobot'un kütüphanesini kur. Kurulumun ayrıntıları Arduino'ya kütüphane ekleme yazısında.
2. SD kartın kök dizinine en az bir MP3 kopyala, kartı modüle tak ve devreyi tablodaki gibi kur.
3. Aşağıdaki kodu yükle ve Seri Monitör'ü 115200 baud hızında aç.
4. Birkaç saniye içinde "DFPlayer Mini online." yazısını ve karttaki dosya sayısını görmeli, ardından ilk parçayı duymalısın.

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

Ses seviyesi, EQ ve BUSY pini ile sıralı anons

Ses seviyesi 0 ile 30 arasında ayarlanır. Küçük bir hoparlörde 15–20 arası çoğu oda için yeterlidir; 25'in üstünde, özellikle zayıf bir beslemede ses bozulmaya (clipping) ve modül resetlenmeye başlayabilir. EQ ayarı bas ve tiz dengesini değiştirir; küçük hoparlörlerde BASS modu sesi boğuklaştırabilir, bu yüzden NORMAL ile başla. Numaralı klasörler konuşan projelerde çok işe yarar: 01 klasörüne "Sıcaklık" ve "derece" kelimelerini, 02 klasörüne de 001.mp3'ten 100.mp3'e kadar sayıları koyarsan Arduino sayıları cümle hâlinde söyleyebilir. Bir dosyanın bittiğini anlamanın en güvenilir yolu BUSY pinidir: modül çalarken bu pin LOW, boştayken HIGH olur. Aşağıdaki kod BUSY'yi D5'ten okuyarak dosyaları birbirinin üstüne binmeden arka arkaya çalar:

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}
41

playAndWait() önce komutu gönderir, BUSY'nin LOW'a inmesini en fazla 1 saniye bekler (modülün çalmaya başlaması birkaç yüz milisaniye sürer), ardından parça bitene kadar bekler. Ses dosyalarını kendi sesinle kaydedebilir ya da bir metin-ses (TTS) aracıyla üretebilirsin; dosyaların başındaki ve sonundaki sessizliği kırpmak anonsun daha doğal akmasını sağlar. Çalan bir müziği kesip kısa bir uyarı vermek istiyorsan advertise(n) fonksiyonunu kullan: modül /advert klasöründeki anonsu çalar, sonra müziğe kaldığı yerden devam eder. Bu komut yalnızca bir parça çalarken çalışır; modül boştayken çağrılırsa hata döner.

Butonla parça değiştirme ve potansiyometreyle ses ayarı

Şimdi kendi MP3 çalarını yapalım: üç buton önceki parça, oynat/duraklat ve sonraki parça görevini görsün, bir potansiyometre de sesi ayarlasın. Butonları D2, D3 ve D4 ile GND arasına bağla; dahili pull-up dirençleri kullandığımız için harici dirence gerek yok (nedenini buton nasıl bağlanır yazısında anlattık). Potansiyometrenin kenar uçları 5V ve GND'ye, orta ucu A0'a gider. Bir parça bittiğinde kod otomatik olarak sonrakine geçer.

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

Hoparlör seçimi (3 W) ve harici amfi

DFPlayer'ın kendi amfisi (çoğu kartta 8002 tipi bir yonga), 3 W'tan küçük ve 4 Ω ya da 8 Ω empedanslı bir hoparlörü doğrudan sürer. En dengeli sonuç 8 Ω, 1–3 W'lık bir hoparlörle alınır; 0,5 W'lık küçük hoparlörler de çalışır ama yüksek seste zorlanır. 3 W, amfinin 5 V besleme ve 4 Ω yükteki, bozulmanın belirginleştiği üst sınırıdır; günlük kullanımda alacağın temiz güç bunun altındadır. Hoparlörü bir kutuya ya da en azından bir panele yerleştirmek bas sesleri belirgin biçimde artırır, çünkü hoparlörün önünden ve arkasından çıkan sesler birbirini sönümlemez. Yüksek seste modül anlık olarak birkaç yüz miliamper çekebilir; bilgisayar USB'sinden beslenen bir Arduino'da bu, gerilim düşmesine, cızırtıya ve resetlenmeye yol açabilir. Daha güçlü ya da stereo ses istiyorsan DAC_L ve DAC_R hat çıkışlarını harici bir amfiye bağla:

Cızırtı, parazit ve tık sesi nasıl giderilir?

• Komut gönderirken cızırtı ve tıkırtı: RX hattındaki 1 kΩ direnç eksik. Direnci Arduino'nun TX pini ile modülün RX pini arasına koy.
• Sürekli hışırtı ya da uğultu: Besleme gürültülü ya da yetersiz. DFPlayer'ı ayrı bir 5 V kaynaktan besle, VCC ile GND arasına kondansatör ekle ve tüm GND'leri birleştir.
• Açılışta "pat" sesi: begin() fonksiyonunun gönderdiği reset komutundan kaynaklanır. Rahatsız ediyorsa player.begin(dfSerial, true, false) ile reset adımını atla.
• ESP32'de vızıltı: Wi-Fi yayını sırasındaki akım darbeleri beslemeye ve oradan sese karışır. DFPlayer'ın beslemesine kondansatör ekle, mümkünse ayrı bir kaynak kullan.
• Yüksek seste çatlak, bozuk ses: Hoparlör ya da amfi sınırda çalışıyor. Sesi 20–25 civarına indir, daha verimli bir hoparlör seç ya da harici amfiye geç.
• Çalma yokken hafif hışırtı: Kart üzerindeki amfinin kendi gürültüsüdür ve küçük modüllerde tamamen yok olmaz. Sessizliğin önemli olduğu projelerde DAC çıkışını kaliteli bir harici amfiye bağlamak en iyi sonucu verir.

"Unable to begin" hatası ve çözümü

Seri Monitör'de Unable to begin: ve ardından 1.Please recheck the connection! ile 2.Please insert the SD card! satırlarını görüyorsan kütüphanenin örnek kodundaki begin() kontrolü başarısız olmuş demektir. begin() modüle bir reset komutu gönderir ve 2 saniye içinde "kart hazır" (card online) mesajının gelmesini bekler; mesaj gelmezse false döner. Yani hatanın kaynağı kablolama, SD kart, besleme ya da modülün yanıt verme biçimi olabilir. Sorunu aşağıdaki sırayla ele al:

ESP32 ile DFPlayer Mini: web sayfasından MP3 kontrolü

ESP32'de SoftwareSerial'a gerek yoktur; üç donanım UART'ından biri istediğin pinlere atanabilir. Aşağıdaki kodda UART2, GPIO 16 (RX) ve GPIO 17 (TX) pinlerinde çalışır ve DFPlayer, ESP32 kartının 5V (VIN) pininden beslenir. ESP32'nin 3,3 V'luk TX sinyali modülle doğrudan uyumludur, ama 1 kΩ direnci parazite karşı yine de kullan. Ters yönde DFRobot modülün lojik seviyesinin 3,3 V olduğunu belirtir; yine de bazı klon kartlarda 5 V beslemede TX hattında daha yüksek gerilim ölçülmüştür. Bağlamadan önce TX ile GND arasını multimetreyle ölç; 3,6 V'un üzerindeyse araya 1 kΩ + 2 kΩ'luk bir gerilim bölücü koy. Kod ev ağına bağlanır ve telefonundan açabileceğin bir sayfa sunar; sayfadaki düğmeler parça değiştirir, duraklatır ve sesi ayarlar.

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}
62

Kodu yükledikten sonra Seri Monitör'de görünen adresi (ör. 192.168.1.42) telefonunun tarayıcısına yaz; telefonla ESP32'nin aynı Wi-Fi ağında olması gerekir. Bağlantı kurulamıyorsa ESP32 Wi-Fi'ye bağlanmıyor yazısındaki adımlara bak. ESP32-WROVER modüllü kartlarda GPIO 16 ve 17 dahili PSRAM'e ayrıldığı için UART'ı 26 ve 27 gibi başka pinlere taşı; bunun için yalnızca dfSerial.begin() satırındaki pin numaralarını değiştirmen yeterli. Hoparlör yüksek seste çalarken ESP32 kendiliğinden yeniden başlıyorsa sorun beslemededir; ayrıntılar ESP32 brownout yazısında.

Raspberry Pi Pico ve MicroPython ile DFPlayer Mini (UART)

Raspberry Pi Pico'da hazır bir kütüphane aramak yerine modülün seri protokolünü doğrudan kullanmak hem kolay hem de öğreticidir. Her komut 10 baytlık bir pakettir: başlangıç baytı 0x7E, sürüm 0xFF, uzunluk 0x06, komut kodu, geri bildirim (0 = onay isteme), iki baytlık parametre, iki baytlık sağlama toplamı ve bitiş baytı 0xEF. Sağlama toplamı, sürümden parametrenin son baytına kadar olan altı baytın toplamının 16 bitlik eksi değeridir. Örneğin kök dizindeki 1. parçayı çalan paket 7E FF 06 03 00 00 01 FE F7 EF olur. Modül de parça bittiğinde 0x3D, kart hazır olduğunda 0x3F, hata olduğunda 0x40 kodlu bildirimler gönderir. Pico'nun 3,3 V'luk UART'ı modüle doğrudan uyar; ESP32 bölümündeki TX gerilimi uyarısı burada da geçerlidir, çünkü Pico'nun pinleri de 5 V'a dayanıklı değildir. Modülü Pico'nun VBUS (USB 5 V) pininden besle.

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)
69

Kodu Thonny ile Pico'ya main.py adıyla kaydedersen Pico her açıldığında bir MP3 çalar gibi çalışır; MicroPython'a yeni başlıyorsan MicroPython temelleri yazısına göz at. GP14'teki buton sonraki parçaya geçer, GP15'teki buton duraklatır ve devam ettirir; butonların diğer ucu GND'ye gider. events() fonksiyonu gelen baytları bir tamponda biriktirir ve 0x7E ile başlayıp 0xEF ile biten paketleri ayıklar. Parça bitti (0x3D) mesajı gelince kod sıradaki dosyaya geçer, son dosyadan sonra da başa döner. TRACKS değişkenini /mp3 klasöründeki dosya sayısına göre değiştirmeyi unutma.

DFPlayer Mini ile proje fikirleri

• Melodili kapı zili: Butona basılınca rastgele bir melodi çalan, gece saatlerinde sesini kısan bir zil.
• Hoş geldin sistemi: Bir PIR hareket sensörü biri geldiğinde selamlama anonsu yapsın.
• Kartlı müzik kutusu: Her RFID kartı farklı bir klasörü çalsın; çocuklar için ekransız bir müzik çalar.
• Konuşan saat: Bir RTC saat modülü ile saati sesli söyleyen ya da her saat başı haber veren bir saat.
• Uzaktan kumandalı MP3 çalar: IR alıcı ve kumanda ile parça ve ses kontrolü.
• Cadılar Bayramı süsü ya da şaka kutusu: HC-SR04 biri yaklaştığını algılayınca korkutucu bir ses çalsın.
• Sesli alarm ve uyarılar: Gaz, su baskını ya da açık kalan kapı gibi durumlarda bip yerine "Mutfakta gaz algılandı" gibi anlaşılır cümleler.
• Ekranlı MP3 çalar: Parça numarasını ve ses seviyesini bir OLED ekranda göster.

DFPlayer Mini; doğru adlandırılmış bir SD kart, RX hattındaki 1 kΩ direnç ve sağlam bir 5 V beslemeyle Arduino projelerine dakikalar içinde gerçek ses kazandırır. Sorun yaşarsan önce kartı ve kabloları, sonra beslemeyi kontrol et; hataların neredeyse tamamı bu üç noktadan çıkar. Seri haberleşmenin temellerini merak ediyorsan UART seri haberleşme yazısı iyi bir sonraki adım olur. BlueGrays uygulamasında buzzer ile melodi çalma, İstiklal Marşı, basit piyano, hareket sensörlü kapı zili ve ESP32 ile melodi gibi ses projelerini devre şemaları ve adım adım kodlarıyla bulabilir, sonra bu projelere DFPlayer Mini ile gerçek ses ekleyebilirsin.