ESP8266 - Mini Lecteur Mp3
L'ESP8266 (NodeMCU, Wemos D1 Mini et cartes similaires) est un microcontrôleur WiFi populaire fonctionnant à 3,3V. L'associer avec le module DIYables Mini Mp3 Player vous donne un dispositif audio compatible WiFi avec seulement quelques fils et une micro carte SD.
Dans ce tutoriel, vous allez :
- Câbler le Mini Mp3 Player à l'ESP8266 — sans résistance nécessaire.
- Formater la carte SD et nommer correctement les fichiers.
- Programmer l'ESP8266 pour lire, mettre en pause, reprendre et arrêter les pistes mp3.
- Ajouter le contrôle du volume via des boutons.
- Configurer les boucles, la lecture aléatoire et la lecture par dossier.
- Interroger le module pour les informations de piste et le volume.

Composants Requis
Ou vous pouvez acheter les kits suivants:
| 1 | × | Kit de Capteurs DIYables (18 capteurs/écrans) |
Aucune résistance nécessaire. L'ESP8266 utilise la logique 3,3V — une correspondance parfaite avec le module.
Présentation du Module
Le module DIYables Mini Mp3 Player encapsule la puce décodeur mp3 YX5200-24SS. Il lit les fichiers mp3 depuis une micro carte SD et sort l'audio via un amplificateur intégré (haut-parleur 3W max) ou des broches DAC pour une amplification externe.
Vous le contrôlez via UART à 9600 bauds. L'ensemble de fonctionnalités comprend :
- Lecture, pause, reprise, arrêt, suivant, précédent
- Contrôle du volume : 0 à 30
- 6 préréglages EQ (Normal, Pop, Rock, Jazz, Classique, Basses)
- Boucler une piste, boucler un dossier, boucler tout, ou lecture aléatoire
- Lecture depuis des dossiers numérotés
- Interruptions de publicité
- Lectures d'état (piste actuelle, volume, état de lecture)
Broches du Module
| Broche | Description |
|---|---|
| VCC | Alimentation 3,2V – 5,0V |
| GND | Masse |
| RX | Entrée série depuis TX de l'ESP8266 |
| TX | Sortie série vers RX de l'ESP8266 |
| SPK_1 | Haut-parleur + (ampli intégré, 3W max) |
| SPK_2 | Haut-parleur − |
| DAC_R | Sortie ligne droite |
| DAC_L | Sortie ligne gauche |
| BUSY | LOW pendant la lecture |
| IO_1 | Appui court = préc., appui long = vol− |
| IO_2 | Appui court = suiv., appui long = vol+ |

Câblage sur l'ESP8266
L'ESP8266 n'a qu'un seul UART matériel qui est utilisé par le pont USB-Série. Pour le module mp3, nous utilisons SoftwareSerial sur deux broches GPIO disponibles.
| Mini Mp3 Player | ESP8266 (NodeMCU) | Notes |
|---|---|---|
| VCC | 3.3V | |
| GND | GND | |
| RX | D7 (GPIO 13) | Sans résistance — déjà en 3,3V |
| TX | D5 (GPIO 14) | |
| SPK_1 | Haut-parleur + | |
| SPK_2 | Haut-parleur − |

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Pour plus d'informations, consultez Brochage ESP8266. et Comment alimenter l'ESP8266..
Voici le même câblage sans plaque d'essai :

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Évitez GPIO 0, 2 et 15 pour les lignes série mp3 — ces broches affectent le comportement au démarrage. D5 et D7 sont des broches à usage général sûres.
Préparation de votre Carte SD
- Formatez en FAT16 ou FAT32.
- Ajoutez des fichiers mp3 avec des noms à zéros de tête :
- Pour les dossiers :
Points à retenir :
- La numérotation commence à 1, pas à 0.
- L'ordre des pistes dépend de la séquence de copie, pas des noms de fichiers. Formatez d'abord, puis copiez les fichiers un par un.
- Dossiers : 01–99. Fichiers dans les dossiers : 001–255.
Installation de la Bibliothèque
- Branchez l'ESP8266 dans votre ordinateur via USB.
- Dans l'IDE Arduino, sélectionnez votre carte (par ex. NodeMCU 1.0) et le port.
- Allez dans Bibliothèques dans la barre latérale.
- Recherchez "DIYables_MiniMp3" et installez-la.

Aucune autre bibliothèque n'est nécessaire.
Modèle de Code de Base
La bibliothèque SoftwareSerial de l'ESP8266 fonctionne de manière fiable à 9600 bauds. Appelez toujours delay(1000) après begin() pour laisser le module s'initialiser.
Code ESP8266 — Lire une Piste
Pour Commencer
- Préparez la carte SD, insérez-la et câblez le module comme indiqué.
- Ouvrez l'IDE Arduino, sélectionnez votre carte ESP8266 et téléversez.
- La piste 001.mp3 joue immédiatement.
Contrôles de Transport
| Fonction | Explication | Code |
|---|---|---|
| play(n) | Démarrer la piste n | mp3.play(1) |
| playNext() | Passer à la suivante | mp3.playNext() |
| playPrevious() | Revenir à la précédente | mp3.playPrevious() |
| pause() | Mettre en pause la sortie | mp3.pause() |
| resume() | Continuer la piste mise en pause | mp3.resume() |
| stop() | Terminer la lecture | mp3.stop() |
Code ESP8266 — Plusieurs Pistes
Code ESP8266 — Boutons de Volume
Contrôles de Volume
| Fonction | Ce qu'elle fait | Code |
|---|---|---|
| setVolume(v) | Régler à un niveau spécifique | mp3.setVolume(20) |
| volumeUp() | Augmenter d'un niveau | mp3.volumeUp() |
| volumeDown() | Diminuer d'un niveau | mp3.volumeDown() |
| getVolume() | Lire le volume actuel | mp3.getVolume() |
Code ESP8266 — Suivant/Précédent
Code ESP8266 — Pause/Reprise
Code ESP8266 — Boucler une Piste
Boucle & Lecture Aléatoire
| Fonction | Comportement | Code |
|---|---|---|
| loopTrack(n) | Répéter une piste | mp3.loopTrack(1) |
| loopFolder(f) | Répéter le contenu d'un dossier | mp3.loopFolder(1) |
| loopAll() | Répéter tout | mp3.loopAll() |
| stopLoop() | Annuler la boucle | mp3.stopLoop() |
| shuffle() | Ordre aléatoire | mp3.shuffle() |
Code ESP8266 — Lecture par Dossier
Fonctions de Dossier
| Fonction | Utilisation | Code |
|---|---|---|
| playFolder(f, t) | Dossier f, piste t | mp3.playFolder(1, 1) |
| playLargeFolder(f, t) | Mode grand dossier | mp3.playLargeFolder(1, 500) |
| playFromMP3Folder(t) | Dossier /mp3 | mp3.playFromMP3Folder(1) |
Code ESP8266 — Contrôle via le Moniteur Série
Préréglages d'Égaliseur
| Constante | Valeur | Profil Sonore |
|---|---|---|
| DIYables_MiniMp3::EQ_NORMAL | 0 | Plat |
| DIYables_MiniMp3::EQ_POP | 1 | Pop |
| DIYables_MiniMp3::EQ_ROCK | 2 | Rock |
| DIYables_MiniMp3::EQ_JAZZ | 3 | Jazz |
| DIYables_MiniMp3::EQ_CLASSIC | 4 | Classique |
| DIYables_MiniMp3::EQ_BASS | 5 | Graves accentués |
Lecture de l'État du Module
Chaque requête est bloquante (jusqu'à 100 ms). Retourne −1 en cas d'échec.
| Fonction | Retourne | Signification |
|---|---|---|
| isPlaying() | bool | true = audio actif |
| getVolume() | int16_t | 0–30 |
| getEQ() | int16_t | 0–5 |
| getTrackCount() | int16_t | Toutes les pistes sur la carte |
| getCurrentTrack() | int16_t | Numéro de piste actif |
| getFolderCount() | int16_t | Nombre de dossiers |
| getTrackCountInFolder(f) | int16_t | Pistes dans le dossier f |