DFPlayer Mini · DFRobot DFR0299
DFRobot · DFPlayer Mini DFR0299, модуль microSD/UART, 16 контактов
Автономное воспроизведение звуков с microSD по командам микроконтроллера.
Автор: SLDV LAB
Опубликовано · Обновлено
О МОДУЛЕ
Что делает DFPlayer Mini DFR0299, модуль microSD/UART, 16 контактов
DFPlayer Mini DFR0299 хранит звуки на microSD, декодирует их собственным процессором и воспроизводит через встроенный усилитель или линейные выходы. Микроконтроллер отправляет короткие команды: ему не нужно в реальном времени пересылать аудио. Это удобно для голосовых подсказок, музейных кнопок и игровых эффектов. Карта, динамик и внешний контроллер не входят в понятие самого модуля.
Название DFPlayer Mini используют и для внешне похожих плат с другими микросхемами. Подтверждённые команды здесь относятся к DFRobot DFR0299; у клонов возможны отличия задержек, ответов UART и порядка файлов. DFPlayer Pro с USB и внутренней памятью является другим устройством. Для предсказуемого запуска пример использует папку mp3 и файл 0001.mp3, а не зависимый от порядка копирования общий номер первого файла.
Питание проигрывателя и логические уровни UART — разные вещи. С 5-вольтовым Uno нужен корректный перевод уровня его TX на вход RX модуля; одиночный последовательный резистор не гарантирует безопасный уровень. Пример поэтому использует 3,3-вольтовую ESP32. Вставку карты под питанием избегают. Причины молчания проверяют по порядку: питание, FAT32/FAT16, имя файла, громкость, UART и нагрузка. Подтверждение команды не доказывает наличие исправного динамика или подходящего аудиофайла.
DFPlayer Mini DFRobot DFR0299 с припаянными гребёнками. Реальная фотография DFRobot; фон удалён без генеративной обработки. Лицензия повторного использования не установлена.
Источник изображения: wiki.dfrobot.com, исходный файл. Автор фотографии отдельно не указан. Условия повторного использования не установлены; открытая лицензия не заявляется. Исходные детали сохранены, фон отделён, выполнено равномерное масштабирование.
Справочник контактов: авторская схема SLDV LAB по документации wiki.dfrobot.com. Это справочник функций контактов; физическое расположение по перспективному фото не угадывается.
Характеристики
- Управление
- UART, 9600 бод, 8N1; также IO/ADKEY
- Максимальная карта по DFRobot
- 32 ГБ
- Файловая система
- FAT16 / FAT32; не exFAT
- Диапазон команды volume
- 0–30
- Выходы
- Мостовые SPK1/SPK2; отдельные аналоговые DAC_L/DAC_R
- Интерфейс
- UART
- Питание модуля
- DFRobot DFR0299: VCC 3,2–5 В; в примере отдельное питание 5 В. UART около 3,3 В; питание 5 В не делает RX/TX 5-вольтовыми.
ПРАКТИКА
Подключение
| Контакт модуля | Контакт платы | Назначение |
|---|---|---|
| 1 VCC | Отдельные 5 В | Стабилизированный низковольтный источник; не питать от GPIO. |
| 7 GND и 10 GND | GND ESP32 и источника | Общая земля, подключить оба GND при монтаже. |
| 2 RX | GPIO17 ESP32-DevKitC WROOM-32 через 1 кОм | TX контроллера → RX проигрывателя. Резистор подавляет помехи, не является универсальным преобразователем 5→3,3 В. |
| 3 TX | GPIO16 ESP32-DevKitC WROOM-32 | TX проигрывателя → RX контроллера. |
| SPK1 / SPK2 (контакты 6 и 8) | Динамик 8 Ом с запасом мощности, например 3 Вт | Ни один вывод динамика не соединять с GND. В PDF таблица и рисунок меняют SPK1/SPK2 местами; сверяйте подписи платы, для одного динамика порядок задаёт лишь фазу. |
| 4 DAC_R / 5 DAC_L | Не подключены | Для внешнего усилителя используют эти выходы и GND, а не SPK1/SPK2. |
| 16 BUSY | Не подключён | Сигнал состояния: не является доказательством слышимого звука. |
| 9 IO1 / 11 IO2 / 12 ADKEY1 / 13 ADKEY2 / 14 USB+ / 15 USB− | Не подключены в UART-примере | Не путать USB-пару с UART; microSD вставляют при отключённом питании. |
Подходит для ESP32, Arduino. Выберите контакты по документации своей платы.
ВАШ ПРОЕКТ · ВАШ ДАТЧИК
Интегрируйте модуль с ChatGPT
Скопируйте запрос в ChatGPT. Укажите свою плату и среду разработки — получите подключение и код для своего проекта.
Помоги интегрировать оригинальный DFRobot DFR0299. Сначала уточни точное исполнение компонента, модель контроллера, среду и версию ядра, питание и задачу. Не переноси распиновку и напряжения с похожих модулей. Подготовь согласованные подключение, зависимости, минимальный пример, обработку доступных ошибок и пошаговую проверку. Не называй пример испытанным на оборудовании, если нет протокола испытаний. Уточни точную маркировку проигрывателя, размер и формат microSD, имена файлов и тип аудиовыхода. Используй UART 9600 8N1, библиотеку DFRobotDFPlayerMini 1.0.6, проверку begin() и сообщений об ошибках. Не смешивай Mini с Pro и не соединяй SPK с землёй. Воспроизведение запускай явной командой пользователя, сначала на малой громкости.
Библиотеки
Установите библиотеку для своей среды и откройте пример из её документации.
Что именно прописать
- Библиотека
DFRobotDFPlayerMini 1.0.6Версия подтверждена library.properties; API сверены в официальном репозитории 06.10.2026.
- Заголовок
#include <DFRobotDFPlayerMini.h>Устанавливается через Arduino Library Manager.
- UART ESP32
Serial2.begin(9600, SERIAL_8N1, 16, 17)GPIO16 RX, GPIO17 TX; только WROOM-32, не WROVER с занятыми GPIO PSRAM.
- Файл
/mp3/0001.mp3FAT16/FAT32; player.playMp3Folder(1) адресует этот файл.
ESP32: MP3 по команде p, остановка s
cpp#include <Arduino.h>
#include <DFRobotDFPlayerMini.h>
DFRobotDFPlayerMini player;
void setup() {
Serial.begin(115200);
Serial2.begin(9600, SERIAL_8N1, 16, 17);
if (!player.begin(Serial2, true, true)) {
Serial.println("DFPlayer init failed: check power, UART and card");
while (true) delay(1000);
}
player.volume(5);
delay(200);
Serial.println("p = /mp3/0001.mp3, s = stop");
}
void loop() {
if (Serial.available()) {
char cmd = (char)Serial.read();
if (cmd == 'p') player.playMp3Folder(1);
if (cmd == 's') player.stop();
}
if (player.available()) {
uint8_t type = player.readType();
uint16_t value = player.read();
if (type == DFPlayerError || type == TimeOut || type == WrongStack)
Serial.printf("DFPlayer error type=%u value=%u\n", type, value);
else Serial.printf("DFPlayer event type=%u value=%u\n", type, value);
}
delay(10);
}
Полный скетч для ESP32-DevKitC с ESP32-WROOM-32, Arduino-ESP32 3.0.7. API сверены с исходниками; компиляция и проверка на оборудовании не выполнялись. Эти GPIO не являются универсальными для ESP32-C3/S3 и других плат. Дополнительно DFRobotDFPlayerMini 1.0.6. Проверьте файл и динамик до повышения громкости; коды событий расшифрованы в официальном GetStarted.
Проекты с этим компонентом
Все проектыСвязанные проекты пока не опубликованы.
