MZ-2500/2800 Interface Clavier
Presentation
Le mz25key est une interface clavier dediee pour les ordinateurs Sharp MZ-2500 et MZ-2800, basee sur le microcontroleur ESP32 double coeur. Elle traduit les claviers PS/2 et Bluetooth HID modernes en protocole matriciel natif MZ-2500/MZ-2800. Le mz25key partage son code source avec le projet SharpKey multi-hote mais est construit avec une configuration simplifiee ciblant uniquement le MZ-2500 ou MZ-2800. Note : Ce document contient du contenu technique complet (protocoles, diagrammes de timing, schemas, nomenclatures, blocs de code) qui reste en anglais. Consultez la version anglaise pour le contenu complet.
Le design est base sur l’ESP-32S WROOM, un SoC double coeur 240MHz WiFi/BT.
Firmware
Le firmware est ecrit avec le systeme de build Espressif IDF (gcc(++), git, CMake et Ninja). Le systeme de build fonctionne sous Windows, Linux ou MacOS. Le composant de compatibilite Arduino est installe car la bibliotheque PS/2 a ete ecrite a l’origine pour Arduino. Le firmware est ecrit dans un melange de C et de C++, le C++ etant le langage principal.
Configuration et build automatises (recommande)
La maniere la plus simple de compiler le firmware mz25key est le script de configuration automatise pour votre plateforme. Chaque script est autonome — copiez simplement le fichier unique correspondant a votre plateforme et executez-le. Il installe la chaine d’outils ESP-IDF v4.4, clone le depot avec les deux bibliotheques de composants requises, et peut compiler le firmware, le tout de maniere interactive avec des valeurs par defaut sensees que vous pouvez accepter en appuyant sur Entree. Les etapes manuelles d’installation et de compilation ci-dessous restent disponibles pour les utilisateurs avances et les rebuilds partiels.
macOS / Linux / WSL — setup_mz25key.sh
chmod +x setup_mz25key.sh
./setup_mz25key.sh
Ceci detecte automatiquement votre systeme d’exploitation. Il prefere Docker (l’image officielle espressif/idf:v4.4, un telechargement unique de ~3 Go) et bascule vers une installation native d’ESP-IDF v4.4 lorsque Docker n’est pas disponible.
Windows 10 / 11 — setup_mz25key_windows.ps1 (natif, sans WSL ni Docker)
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup_mz25key_windows.ps1
Le script Windows utilise winget pour installer Git et (si necessaire) Python 3.10 dans un environnement virtuel isole, puis installe la chaine d’outils native ESP-IDF v4.4 pour Windows et compile le firmware. Apres une execution reussie, l’image du firmware se trouve dans build/main.bin. Pour les executions sans surveillance, MZ25KEY_REPO_URL definit l’URL du depot et MZ25KEY_BUILD force la methode de build (docker ou native).
Note : Les etapes detaillees d’installation manuelle du firmware et de configuration du materiel restent en anglais. Consultez la version anglaise pour le contenu complet.
Remerciements
L’environnement Espressif IDF et les materiaux ESP-32S ont ete utilises.
Licences
Sous GNU Public Licence v3. Aucune utilisation commerciale sans autorisation.