nnonickreal/openqoreLibérez toute la puissance de vos soundcores ! :)
une boîte à outils open source pour patcher, modifier et améliorer le firmware des casques soundcore de la série q, avec la prise en charge future d'autres modèles prévue.
note: ce projet est mon parcours personnel dans le monde de la rétro-ingénierie matérielle et des systèmes embarqués. il a été créé par un adolescent et j'apprends en cours de route. attendez-vous à des bugs, des erreurs et beaucoup de plaisir. toutes les contributions et tous les conseils sont les bienvenus !
ce projet est divisé en deux parties :
j'ai aussi créé un projet de démonstration - un port de DOOM basé sur le projet DOOMBuds. allez y jeter un œil aussi ! =)
📚 lisez la documentation complète 📚
ce projet a été lancé avec le soundcore life q35. si vous voulez aider à tester ou à ajouter la prise en charge d'un nouveau modèle, ouvrez une issue !
la prise en charge d'autres modèles est un objectif futur !
note: les appareils basés sur les chipsets
bes2300*, bes1502*, bes1600sont les candidats les plus probables pour une future prise en charge.
openqore ne fait que commencer. voici un plan approximatif de ce qui va suivre :
ce guide suppose que vous avez python et git installés sur votre système.
1. téléchargez et extrayez l'archive zip depuis les releases
2. installez les dépendances
le patcher nécessite ffmpeg pour la conversion audio et pybluez :
windows:
pip install git+https://github.com/pybluez/pybluez.git
winget install ffmpeg
macos:
pip install git+https://github.com/pybluez/pybluez.git
brew install ffmpeg
ubuntu/debian:
pip install git+https://github.com/pybluez/pybluez.git
sudo apt install ffmpeg
3. obtenez votre fichier de firmware
vous pouvez télécharger l'image OTA ici ou lire la flash avec UART :
➡️ guide matériel : connexion via UART
la lecture de la flash via ota (over-the-air) est prévue pour une future mise à jour. (si c'est possible :D)
4. félicitations !
vous trouverez les instructions d'utilisation ici
si vous avez téléchargé l'image de mise à jour ota depuis les serveurs de mise à jour officiels, sélectionnez l'option « sans ota boot »
note: si vous avez patché le firmware sans ota boot, vous devez l'ajouter à l'en-tête du firmware patché avant de flasher via UART. vous n'en avez PAS besoin si vous utilisez le script besota !
cette section contient certaines des premières découvertes issues de la rétro-ingénierie du firmware du q35.
les casques disposent de plusieurs modes de test cachés. certains d'entre eux pourraient être utiles pour de futures mises à jour ou pour le débogage.
mode ingénierie : pour entrer dans ce mode, maintenez le bouton d'alimentation enfoncé, connectez les casques à un pc via usb-c avant qu'ils ne s'allument, et attendez qu'ils démarrent.
rfcomm : les casques ont deux ports de communication série. l'un d'eux est inscriptible. jusqu'à présent, la seule fonction que j'ai réussi à déclencher via ce port est une UFR (explication ci-dessous). cela semble être une mesure de sécurité, car elle a été déclenchée par force brute sur divers codes hex plutôt que par une commande spécifique. curieusement, ce n'est pas la réinitialisation standard (alimentation + vol+) mais quelque chose de différent.
mode test : ce mode s'active de la même manière que le mode ingénierie, mais vous devez relâcher le bouton d'alimentation immédiatement après le premier flash de la led blanche, avant la lumière bleue. les casques apparaissent alors sur le pc comme un périphérique avec une erreur « device descriptor request failed ». vous pouvez confirmer que vous êtes dans ce mode grâce à la led blanche, qui clignote plus vite que d'habitude. son but est probablement lié au flashage du firmware. de plus, dans ce mode, les casques peuvent être allumés pendant la charge !
réinitialisation d'usine non documentée (UFR) : une réinitialisation d'usine cachée peut être déclenchée en appuyant rapidement plusieurs fois sur le bouton d'alimentation pendant que les casques sont allumés ou en envoyant quelque chose sur le port com virtuel (ci-dessus). cela fera geler le firmware puis forcera un redémarrage après environ 30 secondes. notez que cette action effacera toutes les données utilisateur, y compris les réglages de l'égaliseur, les appariements bluetooth et d'autres configurations.
le firmware semble être un binaire monolithique divisé en plusieurs sections. chaque section critique est protégée par une somme de contrôle . de futurs patchers recalculeront automatiquement ces sommes de contrôle après toute modification pour éviter les échecs de démarrage.
les contributions sont ce qui fait de la communauté open source un endroit incroyable pour apprendre, inspirer et créer. toutes les contributions que vous apportez sont grandement appréciées.
si vous avez une suggestion qui pourrait améliorer ce projet, veuillez forker le dépôt et créer une pull request. vous pouvez aussi simplement ouvrir une issue avec le tag « enhancement ». n'oubliez pas de laisser une étoile au projet ! merci encore !
git checkout -b feature/amazing-feature).git commit -m 'feat: add some amazing feature').git push origin feature/amazing-feature).
si vous trouvez ce projet utile et souhaitez soutenir son développement futur, vous pouvez m'offrir un café ou quelques en-cas via boosty ! chaque contribution est grandement appréciée et m'aide à consacrer plus de temps à openqore.
ce projet a vu le jour grâce à l'utilisation intensive d'assistants de codage propulsés par l'IA (comme claude et chatgpt). bien que la rétro-ingénierie, la recherche et les décisions architecturales essentielles aient été réalisées par l'auteur, l'IA a joué un rôle crucial dans l'accélération du processus de développement, l'écriture de code générique et le débogage.
c'est un projet moderne construit avec des outils modernes.
ce projet est sous licence mit. vous pouvez trouver le texte complet de la licence dans le fichier licence.
| modèle | chipset | statut |
|---|
| soundcore life q35 | bes2300p | ✅ pris en charge |
| soundcore life q30 | bes2300p | ❔ devrait fonctionner mais nécessite des tests |
| soundcore life tune pro | bes2300p | ❔ devrait fonctionner mais nécessite des tests |
| soundcore life tune | bes2300p | ❔ devrait fonctionner mais nécessite des tests |
| soundcore life q20i | bes2300p | ❔ devrait fonctionner mais nécessite des tests |
| soundcore space one | bes1502x | ❌ en cours |
crc3216khz, mono, SBC.48khz, stéréo. cela améliore considérablement la qualité des sons personnalisés.bes2300p. une fiche technique peut être trouvée en cherchant.uart est disponible sur le pcb, qui a été utilisé pour le débogage initial et constitue la principale méthode pour débriquer un appareil après un flash raté. la puce bes2300p elle-même possède deux ports uart, mais un seul est exposé sous forme de pastilles facilement accessibles sur le pcb.