5.2 KiB
🔌 ADB2BLE Adapter pour ESP32
Ce projet permet de connecter des périphériques Apple Desktop Bus (ADB) comme les claviers et souris Apple vintage à des appareils modernes via Bluetooth Low Energy (BLE).
📋 Sommaire
- Fonctionnalités
- Prérequis
- Schéma de connexion
- Installation
- Utilisation
- Dépannage
- Détails techniques
- Licence et auteur
- Contributions
✨ Fonctionnalités
- ✅ Conversion des signaux ADB vers BLE HID
- ⌨️ Support des claviers ADB
- 🖱️ Support des souris ADB
- 🔍 Reconnaissance automatique des périphériques
- 🔄 Reconnnexion automatique en cas de déconnexion
- ⚡ Faible latence (50Hz de taux de rafraîchissement)
🛠️ Prérequis
Matériel
- ESP32 (testé sur ESP32-WROOM-32)
- Adaptateur de niveau logique 5V/3.3V ou simple résistance de 1kΩ
- Connecteur ADB (Mini-DIN 4 broches) ou adaptateur
- Câbles et connecteurs
Logiciel
- PlatformIO
- Arduino IDE (version 2.x ou supérieure)
- Bibliothèques requises:
- ADB (fournie dans ce dépôt)
- Arduino BLE HID (intégrée à l'ESP32)
🔌 Schéma de connexion
┌─────────┐ ┌─────────┐ │ │ │ │ │ ESP32 │ │ ADB │ │ │ │ │ ├─────────┤ ├─────────┤ │ GPIO21 ├───[Résistance 1kΩ]────────────────┤ DATA │ │ │ │ │ │ │ │ │ │ │ │ │ pull-up 4.7-10kΩ │ │ │ │ │ │ │ │ 3.3V ├───────────────────────────────────┤ +5V │ │ │ │ │ │ │ │ │ │ │ │ │ │ GND ├───────────────────────────────────┤ GND │ └─────────┘ └─────────┘
⚠️ Attention:
- Vérifiez la tolérance de votre ESP32 avant de connecter directement l'alimentation 5V d'ADB.
- Important: Une résistance de pull-up (entre 4.7kΩ et 10kΩ) doit être connectée entre la ligne DATA et +5V pour assurer le bon fonctionnement du bus ADB.
📥 Installation
-
Clonez ce dépôt:
git clone https://github.com/electron_rare/stm32-adb2usb.git cd stm32-adb2usb -
Ouvrez le projet dans PlatformIO IDE:
- Sélectionnez "Open Project"
- Naviguez jusqu'au dossier
stm32-adb2usb/lib/adb/examples/platformio_BLE_esp32_example
-
Compilez et téléversez le projet sur votre ESP32:
pio run --target upload
📝 Utilisation
- Connectez vos périphériques ADB à l'adaptateur
- Allumez l'ESP32
- Recherchez le périphérique Bluetooth "ADB2BLE Adapter" depuis votre ordinateur ou appareil mobile
- Connectez-vous à l'adaptateur
- Utilisez vos périphériques ADB comme des périphériques Bluetooth standard
❓ Dépannage
| Problème | Solution |
|---|---|
| Périphérique non détecté | Vérifiez les connexions ADB et assurez-vous que les périphériques sont alimentés |
| Mouvement de souris irrégulier | Ajustez les valeurs de conversion de mouvement dans le code |
| Touches de clavier incorrectes | Consultez la correspondance des touches dans la bibliothèque ADB |
📊 Détails techniques
- Taux de rafraîchissement: 50Hz (configurable via
POLL_INTERVAL) - Consommation électrique: ~30-50mA en fonctionnement normal
- Compatibilité: La plupart des périphériques ADB standards
📄 Licence et auteur
Développé par Clément SAILLANT - L'électron rare
Copyright (C) 2025 Clément SAILLANT
Ce projet est sous licence GNU GPL v3.
👥 Contributions
Les contributions sont les bienvenues! N'hésitez pas à:
- Ouvrir des issues
- Soumettre des pull requests
- Partager vos retours d'expérience
