DF Player Pro¶

JAAM Fusion підтримує DF Player Pro на базі модуля DF1201S (MP3‑плеєр), який керується через UART.

Як це працює в прошивці¶

Модуль ініціалізується через Serial2 зі швидкістю 115200.
Прошивка перевіряє, що працює і RX, і TX (простою перевіркою setVol()/getVol()).
Гучність у веб‑інтерфейсі задається як 0–100%, а в DF1201S це мапиться у діапазон 0–30.
Після успішної ініціалізації прошивка читає кількість файлів і формує список доступних треків.

Note

У прошивці є ліміт на кількість файлів, з якими вона працює: до 50. Якщо на носії більше — модуль може ініціалізуватись, але прошивка відмовиться формувати список треків.

Підключення (UART)¶

Потрібно підключити перехресно:

DF Player TX → ESP32 RX (DF Player (RX) (пін) у налаштуваннях)
DF Player RX → ESP32 TX (DF Player (TX) (пін) у налаштуваннях)

Також:

VCC → відповідне живлення модуля
GND → GND

Important

Логічні рівні UART для ESP32 — 3.3V. Якщо ваш модуль/підключення працює на 5V‑логіці — потрібне узгодження рівнів.

Файли на носії¶

Прошивка очікує MP3‑файли у корені носія з іменами на кшталт:

/01.mp3
/02.mp3
/03.mp3

Частина треків має заздалегідь визначені “спеціальні” призначення (наприклад, годинникові сигнали та гімн), решта може використовуватись для подій через налаштування звуку.

Де налаштовується¶

1) Піни:

Апаратне забезпечення → DF Player (RX) (пін)
Апаратне забезпечення → DF Player (TX) (пін)

2) Джерело звуку:

Звук → Джерело звуку → DF Player Pro

3) Події (що саме відтворювати):

Перемикачі в секції Звук

Дивіться: Звук

Troubleshooting¶

DF Player не підʼєднався¶

Перевірте:

RX/TX не переплутані (має бути перехресно)
спільний GND
рівні логіки UART сумісні з ESP32 (3.3V)
у Звук → Джерело звуку обрано DF Player Pro
піни RX/TX задані не як -1

Є ініціалізація, але треки не доступні¶