Outillage, Automatisations, Documentations du projet Smart Piano

Smart Piano fonctionne sur un ordinateur mono-carte (SBC) Raspberry Pi 4 Model B (Rev 1.1) sous la dernière version de Raspberry Pi OS (Debian 13 Trixie).

L’interaction avec l’utilisateur se fait bien évidemment avec un clavier MIDI, mais aussi via un écran tactile Joy-It RB-LCD-10-2, sur lequel est directement monté le Raspberry Pi 4 via un boitier-support VESA imprimé en 3D.

Certaines étapes de configuration sont nécessaires pour une meilleure expérience, à savoir avoir du son produit lors du jeu et une qualité d’image optimale.

Smart Piano utilise Raylib qui supporte bien les Raspberry Pi.

Configuration de Raspberry Pi OS pour Smart Piano

L’applicatif Smart Piano doit être présent sur la Raspberry Pi 4 pour pouvoir s’y exécuter. S’il est possible d’y cloner le dépôt Git et d’y construire Smart Piano directement, le plus simple est probablement d’utiliser le script de construction croisée cross-build.sh, qui permet de faire un applicatif à destination du Raspberry Pi 4 depuis la plupart des systèmes Linux.

Ce script génère les binaires engine et smart-piano-ui dans le répertoire deploy. Il faut envoyer ces binaires sur la cible, par exemple avec scp, en étant connecté au même réseau local (admettons que l’IP de la cible est 192.168.0.2).

scp deploy/* smart@192.168.0.2:

Ensuite, configurer ~/.config/autostart/smart-piano-ui.desktop pour que Smart Piano se lance au démarrage (considère que l’utilisateur s’appelle smart) :

[Desktop Entry]
Type=Application
Name=Smart Piano
Comment=Lance Smart Piano au démarrage
Exec=/home/smart/smart-piano-ui
StartupNotify=false
Terminal=false

Réglages Graphiques

Le moniteur tactile RB-LCD-10-2 semble avoir été pensé pour une version antérieure de Raspberry Pi OS. Pour que l’image soit nette ici, il faut "forcer" sa reconnaissance par Linux en ajoutant le paramètre noyau video=HDMI-A-2:1280x800M@60D à /boot/firmware/cmdline.txt, donnant par exemple :

console=serial0,115200 console=tty1 root=PARTUUID=e2f2b425-02 rootfstype=ext4 fsck.repair=yes rootwait quiet splash plymouth.ignore-serial-consoles cfg80211.ieee80211_regdom=FR video=HDMI-A-2:1280x800M@60D

Il faut aussi forcer la résolution à utiliser par le compositeur graphique Labwc dans ~/.config/labwc/autostart, et au passage lancer automatiquement Smart Piano au démarrage.

wlr-randr --output HDMI-A-2 --custom-mode 1280x800@60 &

Attention : Ces configurations rendront le premier port Micro USB-B (le plus proche du port USB-C d’alimentation) incapable d’émettre de la vidéo

Réglages Audio

Smart Piano n’est pas capable de produire du son par lui-même. Cette tâche est déléguée à un synthétiseur logiciel annexe tel que FluidSynth, qu’il faut donc installer avec apt.

sudo apt update && sudo apt install -y fluidsynth fluid-soundfont-gm alsa-utils
sudo usermod -aG audio $USER

Activer la possibilité pour l’utilisateur smart de lancer des services avant de s’être connecté :

sudo loginctl enable-linger smart

Ensuite, FluidSynth doit être configuré dans ~/.config/systemd/user/fluidsynth.service :

[Unit]
Description=FluidSynth Daemon (User Session)
After=pipewire.service wireplumber.service
Requires=pipewire.service

[Service]
Type=simple
ExecStart=/usr/bin/fluidsynth -a pulseaudio -m alsa_seq -g 2.5 -is /usr/share/sounds/sf2/FluidR3_GM.sf2
Restart=always

[Install]
WantedBy=default.target

Le clavier devrait automatiquement être routé vers le synthétiseur au lancement d’une partie.