Piano LED - les touches s'allument, il n'y a plus qu'à jouer
Un ruban de LED posé au-dessus de mon Yamaha MX49, un ESP32 caché dans un petit boîtier, et n'importe quel fichier MIDI devient une leçon : les touches à jouer s'allument, le clavier peut jouer le morceau tout seul ou attendre que je trouve la bonne note.
L'idée
Apprendre un morceau en lisant une partition, c'est long. Les vidéos où des notes tombent sur un clavier, c'est plus parlant, mais il faut sans cesse lever les yeux vers l'écran. Je voulais la même chose directement sur mon clavier : une lumière au-dessus de chaque touche, juste là où les doigts doivent aller.
Le principe :
j'envoie un fichier
.middepuis mon téléphone ou mon ordinateur ;je choisis la vitesse, de 25 % à 150 %, et la main que je travaille ;
le bandeau montre les touches à jouer : bleu pour la main droite, orange pour la gauche.
Le matériel
Élément | Rôle |
|---|---|
ESP32 DevKit V1 | le cerveau : Wi-Fi, lecture des fichiers, LED, MIDI |
Bandeau WS2812B, 144 LED/m | une à deux LED par touche |
SN74AHCT125 | passe le signal des LED de 3,3 V à 5 V |
Clone du SparkFun MIDI Shield | les prises MIDI IN et OUT |
Alimentation 5 V 3 A | commune au bandeau et à l'ESP32 |
Yamaha MX49 | le clavier, relié en MIDI dans les deux sens |
Tout tient dans un petit boîtier blanc imprimé en 3D, avec les deux prises MIDI sur le côté. Les fichiers STL de la boîte et du couvercle sont fournis avec le code.
Le MIDI va dans les deux sens. L'ESP32 écoute ce que je joue, pour savoir si j'ai appuyé sur la bonne touche, et il peut envoyer les notes du morceau au MX49, qui les joue avec ses propres sons.
Deux façons de travailler
Le mode démo joue le morceau en continu. Les touches s'allument au bon moment et, si je coche « Son sur le MX49 », c'est le clavier lui-même qui joue. C'est parfait pour écouter un passage en regardant où vont les doigts.
Le mode attente est le vrai mode d'apprentissage. La lecture s'arrête sur chaque note ou chaque accord, et les touches attendues clignotent doucement. Elle ne repart que quand j'ai enfoncé toutes les notes de l'accord en même temps. Une bonne note donne un flash vert, une mauvaise un flash rouge, et un compteur d'erreurs tient les comptes. Si je ne travaille que la main droite, le MX49 joue la main gauche pour moi.
Quelques réglages rendent l'exercice plus confortable :
l'anticipation : les notes qui arrivent dans la demi-seconde suivante s'allument faiblement, pour préparer la main ;
la boucle A-B : on répète un passage difficile autant qu'il faut ;
les mains : chaque piste du fichier reçoit une main. Le programme devine tout seul d'après le nom des pistes (« right », « left », « RH »…), sinon il met la partie la plus aiguë à droite.
Une interface web
Pas d'application à installer : l'ESP32 se connecte au Wi-Fi de la maison et sert une page sur pianoled.local. On y envoie les fichiers, on lance la lecture, on règle la vitesse en direct, on attribue les mains et on calibre le bandeau. S'il ne trouve pas le Wi-Fi, il crée son propre réseau, « PianoLED ».
Les boutons du clavier
Le MX49 a des boutons ▶ et ■ prévus pour piloter un logiciel de musique, le mode DAW REMOTE. En espionnant ce qui sortait de sa prise MIDI, j'ai vu qu'il les envoie sous forme de notes très particulières : note 94 pour ▶, note 93 pour ■, toujours à pleine force. Le bandeau les reconnaît maintenant : ▶ lance la lecture ou la met en pause, ■ arrête et revient au début. Plus besoin de toucher au téléphone pendant qu'on joue.
Les petites galères
Des couleurs au hasard. Au début, des pixels verts, jaunes ou roses apparaissaient sans raison. Ce n'était pas le câblage : la dernière version de la bibliothèque FastLED, avec la dernière version du cœur ESP32, envoyait parfois de mauvaises données. Revenir à des versions plus anciennes a tout réglé, et le bandeau est maintenant redessiné toutes les 50 ms, ce qui efface tout pixel parasite.
« MIDI data error ». À chaque redémarrage de l'ESP32, le MX49 affichait ce message. Pendant le démarrage, avant que le programme tourne, la broche qui envoie le MIDI « flotte » quelques instants et le clavier reçoit du bruit. Le programme la met au repos le plus tôt possible, et une résistance de 10 kΩ vers le 3,3 V devrait faire disparaître le message pour de bon.
La note coincée. Avec un morceau à 14 pistes, une note restait parfois tenue après l'arrêt. Plusieurs pistes jouaient la même note en même temps, et le clavier recevait deux « note allumée » pour un seul « note éteinte ». Le programme compte maintenant combien de pistes tiennent chaque note, et envoie un « tout couper » à chaque arrêt.
Aligner les LED. Le bandeau a 144 LED par mètre, les touches n'ont pas le même écartement. Une petite calibration (où commence le clavier, quelle note est la plus à gauche) suffit, et des boutons « Octave − / + » recalent tout quand je change l'octave du MX49.
J'ai fait ce projet avec Claude Code.
Le code
Tout est sur GitHub, sous licence MIT : github.com/labbej27/pianoled. Le README détaille le câblage, la compilation avec PlatformIO et toutes les commandes ; le dossier boitier contient les fichiers STL à imprimer. Le lecteur de fichiers MIDI est écrit en C++ pur et testé sur ordinateur, il peut servir dans d'autres projets.
Le firmware est pensé pour le MX49 et ses 49 touches, mais n'importe quel clavier de 49 touches avec une prise MIDI devrait fonctionner après calibration.