Clément SAILLANT 2ba6845c16 readme
2025-03-26 17:13:02 +01:00
2025-03-25 22:46:37 +01:00
2025-03-26 17:13:02 +01:00
2021-03-08 21:48:22 +00:00
2021-01-31 00:23:37 +00:00
2025-03-26 17:13:02 +01:00
2025-03-26 17:13:02 +01:00

🍏 stm32-adb2usb

Setup du projet
Un aperçu de mon setup avec un clavier Apple d'époque et une souris ADB.

PlatformIO Licence Status

stm32-adb2usb : Parce que vos claviers et souris d'époque méritent une seconde vie ! 🕰️
Transformez vos périphériques Apple Desktop Bus (ADB) en périphériques USB modernes grâce à ce projet. Compatible avec les claviers et souris ADB des années 80 et 90, ce projet utilise une carte STM32F103 "Blue Pill" et repose sur PlatformIO. Et oui, ça fonctionne même avec les souris à un seul bouton ! 🖱️


🚀 Installation

  1. Clonez ce magnifique dépôt :

    git clone https://github.com/yourusername/stm32-adb2usb.git
    cd stm32-adb2usb
    
  2. Installez PlatformIO (si ce n'est pas déjà fait) :

    pip install platformio
    
  3. Compilez et téléversez le firmware sur votre STM32 :

    platformio run --target upload
    

🎮 Utilisation

  1. Branchez votre périphérique ADB à la carte STM32.
  2. Connectez la carte STM32 à votre ordinateur via USB.
  3. Admirez la magie : votre périphérique ADB fonctionne maintenant comme un périphérique USB !

🌟 Fonctionnalités actuelles

  • Clavier USB HID : Conversion des touches ADB en rapports HID USB, avec gestion des modificateurs (Shift, Ctrl, etc.) et des touches spéciales (Caps Lock, Num Lock).
  • Souris USB HID : Conversion des mouvements et clics ADB en rapports HID USB.
  • Gestion des LEDs : Les LEDs Caps Lock et Num Lock fonctionnent comme par magie.
  • Compatibilité HID : Utilisation de HID_Composite pour gérer les rapports HID.

📚 Bibliothèque ADB-pour-Framework-Arduino

Ce projet repose sur la bibliothèque ADB-pour-Framework-Arduino, créée pour améliorer la portabilité et permettre une utilisation sur plusieurs plateformes (STM32, ESP32, Arduino AVR, Teensy).

Pourquoi cette bibliothèque ?

Parce que je m'ennuyais, et que je voulais explorer les possibilités de GitHub Copilot pour compenser mes modestes compétences en programmation. Résultat : une bibliothèque qui fonctionne (presque) parfaitement et qui me fait passer pour un génie du code. Merci Copilot ! 🤖

  • Portabilité : Compatible avec plusieurs plateformes.
  • Modularité : Réutilisable dans d'autres projets.
  • Facilité de maintenance : Centralisation des mises à jour.

🤔 Pourquoi ce projet ?

Parce que je voulais retrouver le plaisir d'utiliser un ancien clavier Apple (et que j'avais ça qui traînait parmi tout mon bazar). Mais évidemment, il fallait bien le rendre compatible avec nos machines modernes. Alors, sur mon temps libre, j'ai fouillé sur le net pour voir ce que d'autres avaient déjà fait (parce qu'on est rarement le premier, soyons honnêtes !).

Mais voilà, je ne trouvais pas exactement ce que je voulais, et comme j'avais des devkits qui prenaient la poussière, je me suis dit : "Pourquoi pas ?" Résultat : ce projet est né, réalisé et partagé pendant mes moments de libre. Parce que, après tout, c'est toujours plus sympa de redonner vie à ces vieux périphériques d'époque que de les laisser dormir dans un carton. 😄


⌨️ Claviers compatibles

  • Apple Keyboard (1987) : Le clavier standard avec pavé numérique intégré. Simple, efficace, rétro.
  • Apple Extended Keyboard (19871990) : Le Saint Graal des claviers mécaniques Apple.
  • Apple Extended Keyboard II (19901994) : Une version améliorée, élégante et toujours aussi robuste.
  • Apple Adjustable Keyboard (1993) : Le clavier ergonomique avant-gardiste... mais un peu encombrant.

🖱️ Souris compatibles

  • Original ADB Mouse (1986) : La souris rectangulaire avec un seul bouton. Minimalisme à son apogée.
  • ADB Mouse II (1993) : Une version plus ergonomique, avec un bouton plus grand et une meilleure résolution.

🛠️ Autres périphériques compatibles

  • Tablettes graphiques : Wacom ADB, Kurta ADB.
  • Trackballs : Kensington Turbo Mouse, Microspeed MacTRAC.
  • Joysticks : Advanced Gravis MouseStick II.
  • Lecteurs de codes-barres : Datalogic Heron D130.
  • Claviers alternatifs : IntelliKeys.

🛑 État du projet

Ce projet est actuellement en beta.
Prochain objectif : transformer vos claviers d'époque en claviers Bluetooth grâce à un ESP32. Oui, on rêve grand. 🌈


🔮 Plans futurs

  • Concevoir un PCB pour une alimentation par batterie et une connectivité Bluetooth.
  • Étendre le support à d'autres plateformes comme ESP32.
  • Améliorer la gestion de l'alimentation pour les périphériques ADB exotiques.

📖 Ressources utiles


📝 TODO

  • Faire fonctionner le clavier.
  • Faire fonctionner la souris.
  • Ajouter le support Bluetooth.
  • Gérer plusieurs périphériques ADB simultanément.

💡 Remerciements

Un grand merci à GitHub Copilot pour son aide précieuse et ses suggestions parfois hilarantes. 🤖
Et bien sûr, merci à Szymon Łopaciuk pour l'inspiration initiale.


📜 Licence

Ce projet est sous licence GNU GPL v3. Voir le fichier LICENSE pour plus de détails.


S
Description
Apple Desktop Bus converter, adb to usb with stm32 or adb to Bluetooth with esp32
Readme GPL-3.0 441 KiB
Languages
C++ 99.3%
C 0.7%