DFPlayer Mini Arduino ilə istifadə: MP3 oxutma, SD kart və dinamik
DFPlayer Mini Arduino-ya necə qoşulur? RX-ə 1k rezistor, SD kart və 0001.mp3 adlandırma, kitabxana kodu, düymə ilə trek dəyişmə, dinamik, ESP32 və Pico nümunəsi.
DFPlayer Mini Arduino ilə MP3 oxutmağın ən ucuz və ən asan yoludur: microSD kartdakı səs fayllarını özü dekod edir, üzərindəki kiçik gücləndiricisi ilə dinamiki birbaşa idarə edir və Arduino-dan yalnız iki naqilli serial əlaqə ilə komanda alır. Buzzer-in bip səslərindən fərqli olaraq mahnı, nitq, qapı zəngi melodiyası və ya "Qapı açıq qaldı" kimi səsli xəbərdarlıqlar oxuda bilərsən. Modulu ilk dəfə qoşanların çoxu eyni problemlərlə qarşılaşır: səs gəlmir, dinamik cızıldayır, fayllar səhv ardıcıllıqla oxunur və ya Serial Monitor-da "Unable to begin" yazılır. Bu bələdçi həmin problemlərin hamısını səbəbləri ilə birlikdə həll edir.
Əvvəlcə modulun pinlərini və RX xəttinə niyə 1 kΩ rezistor qoyulduğunu öyrənəcəksən. Sonra SD kartı FAT32 kimi hazırlamağı, faylları 0001.mp3 və 01 qovluğu düzəni ilə adlandırmağı, DFRobotDFPlayerMini kitabxanası ilə ilk səsi oxutmağı, səs səviyyəsini və EQ-nu tənzimləməyi, düymələrlə trek dəyişməyi və düzgün dinamiki ya da xarici gücləndiricini seçməyi görəcəksən. Son bölmələrdə "Unable to begin" xətasının addım-addım həlli, ESP32 ilə veb səhifədən idarə olunan MP3 pleyer və Raspberry Pi Pico üçün kitabxanasız MicroPython nümunəsi var. Yalnız bip səsi və ya sadə melodiya kifayətdirsə, buzzer daha sadə seçimdir.

DFPlayer Mini nədir, necə işləyir?
DFPlayer Mini; MP3 dekoder çipi, 24 bitlik DAC, microSD kart yuvası və kiçik mono gücləndiricidən ibarət, müstəqil işləyən MP3 pleyerdir. Arduino-nun vəzifəsi yalnız "3 nömrəli treki oxut" və ya "səsi 20 et" kimi qısa komandalar göndərməkdir; faylı kartdan oxumaq, sıxılmış səsi açmaq və dinamiki idarə etmək modulun işidir. Buna görə 2 KB RAM-lı Arduino Uno belə rahatlıqla musiqi oxuda bilər. Komandalar 9600 baud sürətlə, hər biri 10 baytdan ibarət paketlərlə göndərilir; modul da trek bitəndə, kart taxılıb çıxarılanda və ya xəta olanda eyni formatda bildiriş göndərir. Platanın üzərindəki çip istehsalçıya görə dəyişir (YX5200-24SS, MH2024K-24SS, GD3200B və s.). Hamısı eyni komandaları başa düşür, amma cavab müddətləri fərqli ola bilər; bu təfərrüat sonra "Unable to begin" xətasında önəmli olacaq. Modulu üç yolla idarə etmək olar: serial port (UART), IO düymələri və ADKEY rezistor nərdivanı.
| Xüsusiyyət | Dəyər |
|---|---|
| Dəstəklənən fayllar | MP3, WAV, WMA |
| Nümunələmə tezliyi | 8 / 11,025 / 12 / 16 / 22,05 / 24 / 32 / 44,1 / 48 kHz |
| DAC | 24 bit; 90 dB dinamik diapazon, 85 dB siqnal/küy nisbəti |
| Yaddaş | microSD (TF) kart, ən çoxu 32 GB, FAT16 və ya FAT32; USB yaddaş dəstəyi də var |
| Qovluq tutumu | 100 qovluğa qədər, hər qovluqda 255 fayl |
| Səs səviyyəsi | 30 pillə (0–30) |
| Ekvalayzer (EQ) | 6 rejim: Normal, Pop, Rock, Jazz, Classic, Bass |
| Dinamik çıxışı | Daxili mono gücləndirici, 3 W-dan kiçik dinamik |
| Xətt çıxışı | DAC_L və DAC_R: stereo, qulaqlıq və ya xarici gücləndirici üçün |
| Qida | 3,2–5,0 V (tipik 4,2 V) |
| Gözləmə cərəyanı | Təxminən 20 mA |
| Əlaqə | UART, 9600 baud, 8N1 |
| Ölçü | 20 × 20 mm |
DFPlayer Mini pinləri
| Pin | Ad | Vəzifəsi |
|---|---|---|
| 1 | VCC | Qida girişi, 3,2–5,0 V |
| 2 | RX | Serial giriş: platanın TX pininə 1 kΩ rezistorla qoşulur |
| 3 | TX | Serial çıxış: platanın RX pininə gedir |
| 4 | DAC_R | Sağ kanal xətt çıxışı (qulaqlıq və ya gücləndirici) |
| 5 | DAC_L | Sol kanal xətt çıxışı (qulaqlıq və ya gücləndirici) |
| 6 və 8 | SPK_1, SPK_2 | Dinamik çıxışı: 3 W-dan kiçik dinamikin iki ucu bura qoşulur |
| 7 | GND | Torpaq |
| 9 | IO_1 | GND-yə qısa basış: əvvəlki trek; uzun basış: səs azalır |
| 10 | GND | Torpaq |
| 11 | IO_2 | GND-yə qısa basış: növbəti trek; uzun basış: səs artır |
| 12 | ADKEY1 | Rezistor nərdivanı ilə çoxlu düymə girişi |
| 13 | ADKEY2 | İkinci rezistor nərdivanı girişi |
| 14 | USB+ | USB yaddaş üçün D+ |
| 15 | USB− | USB yaddaş üçün D− |
| 16 | BUSY | Oxuyanda LOW, boşda HIGH |
Serial portla istifadə edəndə yalnız VCC, GND, RX, TX və dinamik pinləri lazımdır. BUSY pini trekin bitib-bitmədiyini serial əlaqəyə ehtiyac olmadan bilməyə imkan verir; platanın üzərindəki kiçik LED də oxutma zamanı yanır. IO_1 və IO_2 pinləri isə modulun Arduino olmadan da işləməsini təmin edir: bu pinlərlə GND arasına qoşulan hər düyməyə qısa basanda trek dəyişir, uzun basanda səs tənzimlənir. ADKEY pinlərinə müxtəlif dəyərli rezistorlarla qoşulan düymələr də müəyyən trekləri oxuda bilər. Beləliklə, batareya, dinamik və iki düymə ilə mikrokontrollersiz qapı zəngi və ya səsli oyuncaq düzəldə bilərsən. USB+ və USB− pinləri SD kart əvəzinə USB yaddaşdan oxutmaq üçündür və əksər layihələrdə boş qalır.
DFPlayer Mini Arduino qoşulması və RX xəttindəki 1k rezistor
| DFPlayer pini | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 5V | 5V (VIN) | VBUS (USB 5 V, pin 40) |
| GND | GND | GND | GND |
| RX | 1 kΩ rezistor üzərindən D11 | 1 kΩ rezistor üzərindən GPIO 17 (TX2) | 1 kΩ rezistor üzərindən GP0 (UART0 TX) |
| TX | D10 | GPIO 16 (RX2) | GP1 (UART0 RX) |
| SPK_1 və SPK_2 | Dinamikin iki ucu | Dinamikin iki ucu | Dinamikin iki ucu |
| BUSY (könüllü) | D5 | İstifadə olunmur | İstifadə olunmur |



Data xətləri çarpaz qoşulur: modulun TX-i platanın RX-inə, RX-i isə platanın TX-inə gedir. Uno-nun D0 və D1-dəki aparat serial portu USB ilə kod yükləmək və Serial Monitor üçün istifadə olunduğundan modulu SoftwareSerial ilə D10 (RX) və D11 (TX) pinlərinə qoşuruq. Modulun RX girişinə ardıcıl qoşulan 1 kΩ rezistor əhəmiyyətsiz təfərrüat deyil. DFPlayer-in çipi 3,3 V məntiq səviyyəsi ilə işləyir, Uno-nun TX pini isə 5 V verir. Rezistor olmadan bu fərq çipin giriş qoruyucu diodları üzərindən cərəyan axıdır; bu cərəyan həm çipi yorur, həm də serial əlaqə zamanı dinamikdə eşidilən cızıltı və klik səslərinə səbəb olur. Om qanunu ilə hesablasan, 1 kΩ-un bu cərəyanı təxminən 1–2 mA ilə məhdudlaşdırdığını görərsən; 9600 baudluq siqnal isə bundan təsirlənmir. 10 kΩ kimi daha böyük rezistor siqnalı zəiflədib əlaqəni kəsə bilər. Modulun TX çıxışı Uno-ya birbaşa qoşulur, çünki Uno 3,3 V-u HIGH kimi oxuyur (hədd təxminən 3,0 V).
SD kartın hazırlanması: FAT32, qovluqlar və 0001.mp3 adlandırma
DFPlayer Mini ən çoxu 32 GB-lıq microSD kartları FAT16 və ya FAT32 fayl sistemi ilə oxuyur. 64 GB və daha böyük kartlar zavoddan exFAT formatında gəlir və modul bu formatı oxumur; bir neçə yüz trek üçün 1–16 GB-lıq kart kifayətdən artıqdır. MP3-ləri 128–192 kbps və 44,1 kHz ilə yazmaq həm uyğunluq, həm də kartın oxuma sürəti baxımından ən etibarlı seçimdir. Modul faylları adı ilə yox, nömrəsi ilə tanıyır; hansı funksiya ilə oxudacağına görə qovluq və fayl adları müəyyən düzənə uyğun olmalıdır:
| Kartda yer | Nümunə | Kitabxana funksiyası | Qayda |
|---|---|---|---|
| Kök qovluq | /0001.mp3, /0002.mp3 | play(1) | Adına görə yox, faylların karta köçürülmə ardıcıllığı ilə oxuyur |
| Nömrəli qovluqlar | /01/001.mp3 … /99/255.mp3 | playFolder(1, 1) | Qovluq adı 2 rəqəm (01–99), fayl adı 3 rəqəm (001–255) |
| mp3 qovluğu | /mp3/0001.mp3 | playMp3Folder(1) | Fayl adı 4 rəqəm; fayl adındakı nömrə ilə tapılır |
| advert qovluğu | /advert/0001.mp3 | advertise(1) | Oxunan treki kəsir, anons bitəndə qaldığı yerdən davam edir |
| Böyük qovluqlar | /01/0001.mp3 … /15/3000.mp3 | playLargeFolder(1, 1) | Ən çoxu 15 qovluq, hər qovluqda 3000 fayl, 4 rəqəmli adlar |
- Kartı kompüterdə FAT32 kimi formatla (Windows-da sağ klik > Format, macOS-də Disk Utility > Erase > MS-DOS (FAT)).
- Kök qovluqda mp3 adlı qovluq və lazım gələrsə 01, 02 kimi nömrəli qovluqlar yarat.
- Faylları 0001.mp3, 0002.mp3 formatında (nömrəli qovluqlarda 001.mp3) yenidən adlandır. Nömrədən sonra izah əlavə edə bilərsən: 0001_salam.mp3 kimi; modul yalnız əvvəlki rəqəmlərə baxır.
- Kök qovluqdakı faylları play() ilə oxudacaqsansa, onları bir-bir və ardıcıllıqla köçür; topdan köçürmədə sıra qarışa bilər.
- Kartı kompüterdən təhlükəsiz çıxar və modula qida yoxkən tax; işləyərkən taxıb çıxarmaq faylları poza bilər.
DFRobotDFPlayerMini kitabxanası və ilk test kodu
- Arduino IDE-də Library Manager-i aç, DFRobotDFPlayerMini yaz və DFRobot-un kitabxanasını quraşdır. Quraşdırmanın təfərrüatları Arduino-ya kitabxana əlavə etmək yazısındadır.
- SD kartın kök qovluğuna ən azı bir MP3 köçür, kartı modula tax və dövrəni cədvəldəki kimi qur.
- Aşağıdakı kodu yüklə və Serial Monitor-u 115200 baud sürətlə aç.
- Bir neçə saniyə ərzində "DFPlayer Mini online." yazısını və kartdakı fayl sayını görməli, sonra ilk treki eşitməlisə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| Funksiya | Nə edir? |
|---|---|
| begin(serial, isACK, doReset) | Modulu işə salır; susmaya görə reset göndərir və kartın hazır olduğunu bildirən mesajı gözləyir |
| volume(0–30) | Səs səviyyəsini tənzimləyir; volumeUp() və volumeDown() bir pillə dəyişir |
| EQ(DFPLAYER_EQ_POP) | Ekvalayzer: NORMAL, POP, ROCK, JAZZ, CLASSIC, BASS |
| play(n) | Kök qovluqdakı n-ci faylı (köçürmə ardıcıllığına görə) oxudur |
| next() / previous() | Növbəti / əvvəlki trek |
| pause() / start() | Fasilə verir / qaldığı yerdən davam etdirir |
| stop() | Oxutmanı dayandırır |
| loop(n) | n-ci treki fasiləsiz təkrarlayır |
| enableLoopAll() / randomAll() | Bütün trekləri dövrədə / qarışıq ardıcıllıqla oxudur |
| readState() / readVolume() / readFileCounts() | Vəziyyəti, səs səviyyəsini və kartdakı fayl sayını sorğulayır |
| available() / readType() / read() | Moduldan gələn bildirişi (trek bitdi, xəta, kart çıxarıldı) oxuyur |
Səs səviyyəsi, EQ və BUSY pini ilə ardıcıl anons
Səs səviyyəsi 0 ilə 30 arasında tənzimlənir. Kiçik dinamikdə 15–20 arası əksər otaqlar üçün kifayətdir; 25-dən yuxarı, xüsusilə zəif qidada səs təhrif olunmağa (clipping) və modul resetlənməyə başlaya bilər. EQ tənzimi bas və tiz balansını dəyişir; kiçik dinamiklərdə BASS rejimi səsi boğuqlaşdıra bilər, ona görə NORMAL ilə başla. Nömrəli qovluqlar danışan layihələrdə çox işə yarayır: 01 qovluğuna "Temperatur" və "dərəcə" sözlərini, 02 qovluğuna isə 001.mp3-dən 100.mp3-ə qədər rəqəmləri qoysan, Arduino rəqəmləri cümlə şəklində deyə bilər. Faylın bitdiyini bilməyin ən etibarlı yolu BUSY pinidir: modul oxuyanda bu pin LOW, boşda HIGH olur. Aşağıdakı kod BUSY-ni D5-dən oxuyaraq faylları üst-üstə düşmədən ardıcıl oxudur:
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() əvvəlcə komandanı göndərir, BUSY-nin LOW-a enməsini ən çoxu 1 saniyə gözləyir (modulun oxumağa başlaması bir neçə yüz millisaniyə çəkir), sonra trek bitənə qədər gözləyir. Səs fayllarını öz səsinlə yaza və ya mətn-səs (TTS) aləti ilə yarada bilərsən; faylların əvvəlindəki və sonundakı səssizliyi kəsmək anonsun daha təbii axmasını təmin edir. Oxunan musiqini kəsib qısa xəbərdarlıq vermək istəyirsənsə, advertise(n) funksiyasından istifadə et: modul /advert qovluğundakı anonsu oxuyur, sonra musiqiyə qaldığı yerdən davam edir. Bu komanda yalnız trek oxunarkən işləyir; modul boşda çağırılarsa, xəta qaytarır.
Düymə ilə trek dəyişmə və potensiometrlə səs tənzimi
İndi öz MP3 pleyerimizi düzəldək: üç düymə əvvəlki trek, oxut/fasilə və növbəti trek vəzifəsini görsün, potensiometr isə səsi tənzimləsin. Düymələri D2, D3 və D4 ilə GND arasına qoş; daxili pull-up rezistorlardan istifadə etdiyimiz üçün xarici rezistora ehtiyac yoxdur (səbəbini düymə necə qoşulur yazısında izah etmişik). Potensiometrin kənar ucları 5V və GND-yə, orta ucu A0-a gedir. Trek bitəndə kod avtomatik növbətiyə keçir.
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| Kod hissəsi | Nəyə yarayır? |
|---|---|
| pressed() | Yalnız düyməyə basılan anı tutur və 50 ms içindəki sıçrayışları nəzərə almır; düymə basılı qalsa da tək komanda gedir |
| abs(raw - lastRaw) > 20 | Potensiometr oxunuşundakı kiçik titrəmələr modula fasiləsiz komanda göndərib klik səsinə səbəb olmasın deyə səsi yalnız nəzərə çarpan dəyişikliklərdə yeniləyir |
| map(raw, 0, 1023, 0, 30) | 0–1023 arasındakı analoq dəyəri DFPlayer-in 0–30 səs diapazonuna çevirir |
| paused | Eyni düymə həm fasilə versin, həm davam etdirsin deyə oxutma vəziyyətini saxlayır |
| DFPlayerPlayFinished | Trek bitəndə gələn bildiriş; kod növbəti treka keçir |
| millis() - lastFinish > 1000 | Bəzi klon modullar bitməni iki dəfə bildirir; bu yoxlama trekin atlanmasının qarşısını alır |
Dinamik seçimi (3 W) və xarici gücləndirici
DFPlayer-in öz gücləndiricisi (əksər platalarda 8002 tipli çip) 3 W-dan kiçik və 4 Ω ya da 8 Ω impedanslı dinamiki birbaşa idarə edir. Ən balanslı nəticə 8 Ω, 1–3 W-lıq dinamikdən alınır; 0,5 W-lıq kiçik dinamiklər də işləyir, amma yüksək səsdə çətinlik çəkir. 3 W gücləndiricinin 5 V qida və 4 Ω yükdə, təhrifin nəzərə çarpdığı yuxarı həddidir; gündəlik istifadədə alacağın təmiz güc bundan aşağıdır. Dinamiki qutuya və ya ən azı panelə yerləşdirmək bas səsləri nəzərəçarpacaq dərəcədə artırır, çünki dinamikin önündən və arxasından çıxan səslər bir-birini söndürmür. Yüksək səsdə modul anlıq bir neçə yüz milliamper çəkə bilər; kompüterin USB-sindən qidalanan Arduino-da bu, gərginlik düşməsinə, cızıltıya və resetlənməyə səbəb ola bilər. Daha güclü və ya stereo səs istəyirsənsə, DAC_L və DAC_R xətt çıxışlarını xarici gücləndiriciyə qoş:
| Çıxış yolu | Qoşulma | Nə vaxt? |
|---|---|---|
| Daxili gücləndirici | SPK_1 və SPK_2 → 4–8 Ω, 3 W-a qədər dinamik | Qapı zəngi, oyuncaq, səsli xəbərdarlıq kimi kiçik layihələr |
| Qulaqlıq | DAC_L, DAC_R və GND → 3,5 mm jak | Şəxsi dinləmə; səsi aşağı səviyyədən başlat |
| PAM8403 gücləndirici modulu | DAC_L, DAC_R və GND → gücləndiricinin L, R və GND girişləri; gücləndirici 5 V ilə qidalanır | 2 × 3 W stereo, batareya ilə işləyən portativ dinamik |
| PAM8610 ya da TPA3116 gücləndirici | DAC çıxışları → gücləndirici girişi; gücləndirici 12 V ilə qidalanır | Daha yüksək güc: 2 × 10 W və yuxarı |
| Aktiv dinamik (AUX) | DAC_L, DAC_R və GND → aktiv dinamikin AUX girişi | Hazır kompüter dinamikindən istifadə etmək |
Cızıltı, küy və klik səsi necə aradan qaldırılır?
- Komanda göndərərkən cızıltı və klik: RX xəttində 1 kΩ rezistor çatışmır. Rezistoru Arduino-nun TX pini ilə modulun RX pini arasına qoy.
- Daimi xışıltı və ya uğultu: Qida küylüdür və ya kifayət etmir. DFPlayer-i ayrı 5 V mənbədən qidalandır, VCC ilə GND arasına kondensator əlavə et və bütün GND-ləri birləşdir.
- Açılışda "pop" səsi: begin() funksiyasının göndərdiyi reset komandasından qaynaqlanır. Narahat edirsə, player.begin(dfSerial, true, false) ilə reset addımını keç.
- ESP32-də vızıltı: Wi-Fi yayımı zamanı cərəyan impulsları qidaya, oradan da səsə qarışır. DFPlayer-in qidasına kondensator əlavə et, mümkünsə ayrı mənbədən istifadə et.
- Yüksək səsdə çatlayan, təhrif olunmuş səs: Dinamik və ya gücləndirici həddində işləyir. Səsi 20–25 civarına endir, daha səmərəli dinamik seç və ya xarici gücləndiriciyə keç.
- Oxutma yoxkən zəif xışıltı: Platadakı gücləndiricinin öz küyüdür və kiçik modullarda tamamilə yox olmur. Səssizliyin vacib olduğu layihələrdə DAC çıxışını keyfiyyətli xarici gücləndiriciyə qoşmaq ən yaxşı nəticə verir.
"Unable to begin" xətası və həlli
Serial Monitor-da Unable to begin: və ardınca 1.Please recheck the connection! ilə 2.Please insert the SD card! sətirlərini görürsənsə, kitabxananın nümunə kodundakı begin() yoxlaması uğursuz olub deməkdir. begin() modula reset komandası göndərir və 2 saniyə içində "kart hazırdır" (card online) mesajının gəlməsini gözləyir; mesaj gəlməsə, false qaytarır. Yəni xətanın mənbəyi naqil bağlantısı, SD kart, qida və ya modulun cavab vermə tərzi ola bilər. Problemi aşağıdakı ardıcıllıqla araşdır:
| Mümkün səbəb | Yoxlama və həll |
|---|---|
| TX və RX düz qoşulub | Modulun TX-i D10-a (SoftwareSerial RX), RX-i 1 kΩ üzərindən D11-ə (SoftwareSerial TX) getməlidir; koddakı SoftwareSerial(10, 11) ardıcıllığı (RX, TX) ilə eyni olmalıdır |
| GND ortaq deyil | Modulun GND-si Arduino-nun GND-sinə qoşulmalıdır; ayrı mənbə istifadə edirsənsə də GND-ləri birləşdir |
| SD kart oxunmur | Kart taxılıb? FAT32-dir? 32 GB-dan kiçikdir? İçində ən azı bir səs faylı var? Kartı yenidən formatla və ya başqa kartla yoxla |
| Yanlış rezistor | RX xəttində 1 kΩ olmalıdır; 10 kΩ kimi böyük dəyərlər siqnalı zəiflədir |
| Qida kifayət etmir | VCC-də 4–5 V olmalıdır; dinamiki müvəqqəti sök, gərginliyi multimetrlə ölç və kondensator əlavə et |
| Yanlış baud sürəti | dfSerial.begin(9600) olmalıdır; Serial Monitor sürəti (115200) ilə qarışdırma |
| D0 və D1 istifadə olunub | Uno-da aparat serial portu USB ilə paylaşılır; modulu SoftwareSerial pinlərinə köçür |
| Klon çip gec cavab verir | begin()-dən əvvəl delay(1000) əlavə et; olmasa, begin(dfSerial, true, false) ilə resetdən sonrakı gözləməni keç |
| DFPlayerError kodu | Kitabxanadakı adı | Mənası |
|---|---|---|
| 1 | Busy | Modul məşğuldur və ya kart tapılmadı (işə salma bitmədi) |
| 2 | Sleeping | Modul yuxu rejimindədir |
| 3 | SerialWrongStack | Serial data pozulmuş gəldi |
| 4 | CheckSumNotMatch | Paketin yoxlama cəmi uyğun gəlmədi |
| 5 | FileIndexOut | İstənilən trek nömrəsi kartdakı diapazondan kənardadır |
| 6 | FileMismatch | İstənilən fayl tapılmadı; adlandırmanı yoxla |
| 7 | Advertise | Anons (advert) xətası; məsələn, oxutma yoxkən advertise() çağırılıb |
ESP32 ilə DFPlayer Mini: veb səhifədən MP3 idarəsi
ESP32-də SoftwareSerial-a ehtiyac yoxdur; üç aparat UART-ından biri istədiyin pinlərə təyin oluna bilər. Aşağıdakı kodda UART2 GPIO 16 (RX) və GPIO 17 (TX) pinlərində işləyir və DFPlayer ESP32 platasının 5V (VIN) pinindən qidalanır. ESP32-nin 3,3 V-luq TX siqnalı modulla birbaşa uyğundur, amma 1 kΩ rezistoru küyə qarşı yenə də istifadə et. Əks istiqamətdə DFRobot modulun məntiq səviyyəsinin 3,3 V olduğunu bildirir; yenə də bəzi klon platalarda 5 V qidada TX xəttində daha yüksək gərginlik ölçülüb. Qoşmazdan əvvəl TX ilə GND arasını multimetrlə ölç; 3,6 V-dan yuxarıdırsa, araya 1 kΩ + 2 kΩ-luq gərginlik bölücü qoy. Kod ev şəbəkəsinə qoşulur və telefonundan aça biləcəyin səhifə təqdim edir; səhifədəki düymələr trek dəyişir, fasilə verir və səsi tənzimləyir.
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}
62Kodu yüklədikdən sonra Serial Monitor-da görünən ünvanı (məs., 192.168.1.42) telefonunun brauzerinə yaz; telefon ilə ESP32 eyni Wi-Fi şəbəkəsində olmalıdır. Qoşulmaq alınmırsa, ESP32 Wi-Fi-a qoşulmur yazısındakı addımlara bax. ESP32-WROVER modullu platalarda GPIO 16 və 17 daxili PSRAM üçün ayrıldığından UART-ı 26 və 27 kimi başqa pinlərə köçür; bunun üçün yalnız dfSerial.begin() sətrindəki pin nömrələrini dəyişmək kifayətdir. Dinamik yüksək səslə oxuyarkən ESP32 öz-özünə yenidən başlayırsa, problem qidadadır; təfərrüatlar ESP32 brownout yazısındadır.
Raspberry Pi Pico və MicroPython ilə DFPlayer Mini (UART)
Raspberry Pi Pico-da hazır kitabxana axtarmaq əvəzinə modulun serial protokolundan birbaşa istifadə etmək həm asan, həm də öyrədicidir. Hər komanda 10 baytlıq paketdir: başlanğıc baytı 0x7E, versiya 0xFF, uzunluq 0x06, komanda kodu, geri bildiriş (0 = təsdiq istəmə), iki baytlıq parametr, iki baytlıq yoxlama cəmi və bitiş baytı 0xEF. Yoxlama cəmi versiyadan parametrin son baytına qədər olan altı baytın cəminin 16 bitlik mənfi dəyəridir. Məsələn, kök qovluqdakı 1-ci treki oxudan paket 7E FF 06 03 00 00 01 FE F7 EF olur. Modul da trek bitəndə 0x3D, kart hazır olanda 0x3F, xəta olanda 0x40 kodlu bildirişlər göndərir. Pico-nun 3,3 V-luq UART-ı modula birbaşa uyğundur; ESP32 bölməsindəki TX gərginliyi xəbərdarlığı burada da keçərlidir, çünki Pico-nun pinləri də 5 V-a davamlı deyil. Modulu Pico-nun VBUS (USB 5 V) pinindən qidalandır.
| Komanda | Kod | Parametr |
|---|---|---|
| Növbəti / əvvəlki trek | 0x01 / 0x02 | Yoxdur |
| Kökdəki n-ci treki oxut | 0x03 | 1–2999 |
| Səs səviyyəsi | 0x06 | 0–30 |
| EQ | 0x07 | 0–5 |
| Reset | 0x0C | Yoxdur |
| Davam et / fasilə | 0x0D / 0x0E | Yoxdur |
| Qovluqdan oxut | 0x0F | Yuxarı bayt qovluq (1–99), aşağı bayt fayl (1–255) |
| mp3 qovluğundan oxut | 0x12 | Fayl nömrəsi (0001.mp3 üçün 1) |
| Anons (advert) | 0x13 | Fayl nömrəsi |
| Dayandır | 0x16 | Yoxdur |
| Trek bitdi (moduldan gəlir) | 0x3D | Bitən trekin nömrəsi |
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)
69Kodu Thonny ilə Pico-ya main.py adı ilə yadda saxlasan, Pico hər açılanda MP3 pleyer kimi işləyəcək; MicroPython-a təzə başlayırsansa, MicroPython əsasları yazısına bax. GP14-dəki düymə növbəti treka keçir, GP15-dəki düymə fasilə verir və davam etdirir; düymələrin digər ucu GND-yə gedir. events() funksiyası gələn baytları buferdə toplayır və 0x7E ilə başlayıb 0xEF ilə bitən paketləri ayırır. Trek bitdi (0x3D) mesajı gələndə kod növbəti fayla keçir, son fayldan sonra isə başa qayıdır. TRACKS dəyişənini /mp3 qovluğundakı fayl sayına görə dəyişməyi unutma.
DFPlayer Mini ilə layihə ideyaları
- Melodiyalı qapı zəngi: Düyməyə basılanda təsadüfi melodiya oxuyan, gecə saatlarında səsini azaldan zəng.
- Xoş gəldin sistemi: PIR hərəkət sensoru kimsə gələndə salamlama anonsu etsin.
- Kartlı musiqi qutusu: Hər RFID kartı fərqli qovluğu oxutsun; uşaqlar üçün ekransız musiqi pleyeri.
- Danışan saat: RTC saat modulu ilə vaxtı səslə deyən və ya hər saat başı xəbər verən saat.
- Uzaqdan idarəli MP3 pleyer: IR qəbuledici və pult ilə trek və səs idarəsi.
- Halloween bəzəyi və ya zarafat qutusu: HC-SR04 kiminsə yaxınlaşdığını hiss edəndə qorxunc səs oxutsun.
- Səsli siqnal və xəbərdarlıqlar: Qaz, su basması və ya açıq qalan qapı kimi hallarda bip əvəzinə "Mətbəxdə qaz aşkarlandı" kimi anlaşılan cümlələr.
- Ekranlı MP3 pleyer: Trek nömrəsini və səs səviyyəsini OLED ekranda göstər.
DFPlayer Mini; düzgün adlandırılmış SD kart, RX xəttindəki 1 kΩ rezistor və etibarlı 5 V qida ilə Arduino layihələrinə dəqiqələr içində real səs qazandırır. Problem yaşasan, əvvəlcə kartı və naqilləri, sonra qidanı yoxla; xətaların demək olar ki, hamısı bu üç nöqtədən çıxır. Serial əlaqənin əsaslarını maraqlandırırsansa, UART serial əlaqə yazısı yaxşı növbəti addım olar. BlueGrays tətbiqində buzzer ilə melodiya oxutma, Türkiyənin dövlət himni (İstiklal Marşı), sadə piano, hərəkət sensorlu qapı zəngi və ESP32 ilə melodiya kimi səs layihələrini dövrə sxemləri və addım-addım kodları ilə tapa, sonra bu layihələrə DFPlayer Mini ilə real səs əlavə edə bilərsən.
Tez-tez verilən suallar
DFPlayer Mini neçə GB SD kartı dəstəkləyir?
DFPlayer Mini ən çoxu 32 GB-lıq microSD kartları FAT16 və ya FAT32 fayl sistemi ilə oxuyur. 64 GB və daha böyük kartlar exFAT formatında gəldiyi üçün modul onları görmür. Bir neçə yüz MP3 üçün 1–16 GB-lıq kart kifayətdən artıqdır.
DFPlayer Mini niyə səs vermir?
Əvvəlcə Serial Monitor-da "online" yazısını gördüyündən əmin ol; görmürsənsə, problem naqil bağlantısında və ya SD kartdadır. Modul başladığı halda səs yoxdursa, səs səviyyəsinin 0 olmadığını, dinamikin SPK_1 və SPK_2-yə qoşulduğunu və fayl adlarının çağırdığın funksiyaya uyğun olduğunu yoxla. Platadakı LED-in yanması modulun həqiqətən oxuduğunu göstərir.
DFPlayer Mini-də RX pininə niyə 1k rezistor taxılır?
Modulun çipi 3,3 V ilə işləyərkən Arduino Uno-nun TX pini 5 V verir. RX xəttinə ardıcıl qoşulan 1 kΩ rezistor çipə axan cərəyanı məhdudlaşdırır və serial əlaqə zamanı dinamikdə eşidilən cızıltını azaldır. ESP32 və Pico kimi 3,3 V-luq platalarda da küyə qarşı taxılması tövsiyə olunur.
DFPlayer Mini Arduino olmadan işləyirmi?
Bəli. IO_1 və IO_2 pinlərini düymələrlə GND-yə qoşanda qısa basış trek dəyişir, uzun basış səsi tənzimləyir. ADKEY pinlərinə rezistorlarla qoşulan düymələr də müəyyən trekləri oxuda bilər. Beləliklə, batareya, dinamik və bir neçə düymə ilə mikrokontrollersiz MP3 pleyer və ya zəng düzəldə bilərsən.
DFPlayer Mini-yə hansı dinamik qoşulur?
SPK_1 və SPK_2 pinlərinə 4 Ω ya da 8 Ω impedanslı, 3 W-dan kiçik dinamik birbaşa qoşulur; ən balanslı nəticəni 8 Ω, 1–3 W-lıq dinamiklər verir. Dinamikin heç bir ucunu GND-yə qoşma. Daha yüksək və ya stereo səs üçün DAC_L və DAC_R çıxışlarını PAM8403 kimi gücləndiriciyə qoş.
DFPlayer Mini faylları niyə səhv ardıcıllıqla oxuyur?
play(n) funksiyası fayl adına yox, faylların karta köçürülmə ardıcıllığına baxır. Adına görə oxutmaq üçün faylları /mp3/0001.mp3 formatında adlandırıb playMp3Folder(), ya da /01/001.mp3 formatında adlandırıb playFolder() istifadə et. Kartı Mac-də hazırlamısansa, gizli ._ fayllarını da təmizlə.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
Buzzer istifadəsi
Qapı zəngi ya da həyəcan siqnalı necə səslənir, heç maraqlanmısan? Arduino kiçik buzzer-i qısa fasilələrlə səsləndirir: bip, sus, bip, sus.

Buzzer ilə İstiklal Marşı
Düyməyə basanda kiçik buzzer Türkiyənin dövlət himni İstiklal Marşı-nı not-not çalmağa başlayır.

Buzzer ilə tezlik tənzimi
Dörd düymə ilə buzzer-dən çıxan səsi idarə edirsən: biri səsi başladır, biri susdurur, digər ikisi səsi incəldir və qalınlaşdırır.

ESP32 Buzzer ilə melodiya çalmaq
Passiv buzzer ilə sadə melodiya (Twinkle Twinkle Little Star) çalmaq. Arduino-dakı kimi tone() və noTone() funksiyaları ilə nota çalırıq — ESP32 Arduino Core 3.0+ ilə eyni sintaksis işləyir. Passiv buzzer istifadə olunmalıdır (aktiv buzzer melodiya çalmır).

IR qəbuledici, pult və buzzer ilə hazır melodiya çalma
Televizor pultunun düymələri ilə melodiya çalan musiqi qutusu düzəlt. İnfraqırmızı qəbuledici pultdan gələn siqnalı tutur; bir düyməyə basanda hərəkətli oyun musiqisi, ikincisində tanış uşaq mahnısı…

Buzzer və düymə ilə sadə piano
Səkkiz düymə ilə öz kiçik pianonu qur. Hər düymə bir nota uyğundur: qalından incəyə do, re, mi, fa, sol, la, si və incə do.

Hərəkət sensoru ilə qapı zəngi və işıq
Qapına kimsə yaxınlaşanda zəngə basmamış xəbər tutursan. Hərəkət sensoru kimisə hiss edən kimi LED yanır və buzzer incədən qalına üç notluq zəng səsi çalır; melodiya bitəndə işıq sönür və sensor…
Digər yazılar
BlueGrays tətbiqi
Bu dövrəni telefonunda addım-addım qur
Dövrə sxemi, kod və hissə siyahısı bir ekranda. 500-dən çox Arduino, ESP32 və Pico layihəsi səni gözləyir.
Telefonunla skan et
Kameranı koda tut; telefonunun tətbiq mağazası açılır.
ya da mağazada aç

