openqore

un kit de herramientas de código abierto para parchear, modificar y mejorar el firmware de auriculares basados en los chipsets BES (originalmente iniciado a partir del soundcore Q35), con soporte futuro planificado para otros modelos.

nota: este proyecto es mi viaje personal al mundo de la ingeniería inversa de hardware y los sistemas embebidos. espera errores, fallos y mucha diversión. ¡todas las contribuciones y consejos son bienvenidos!

¡información importante! (navegación rápida)

¿quieres:

• ¿parchear el firmware de tus auriculares? -> qorepatcher (este repositorio, mira abajo para el inicio rápido)
• ¿instalar / desarrollar el firmware personalizado? (soundcore devices based on bes2300p solo por ahora) -> openqore SDK
• ¿flashear una actualización / instalar firmware personalizado por aire? (OTA) -> archivos OTA para dispositivos BES y besota - flasheador OTA para BES
• ¿flashear una actualización vía UART / restaurar tras una mala actualización o hacer una copia de seguridad? -> guía de flasheo por hardware

también creé un proyecto de demostración - un port de DOOM basado en el proyecto DOOMBuds. ¡échale un vistazo también! =)

qorepatcher

📚 lee la documentación completa 📚

dispositivos compatibles

este proyecto se inició con el soundcore Life Q35. si quieres ayudar a probar o añadir soporte para un nuevo modelo, ¡abre un issue o envíame un DM (lee contacto)!

lee hojas de ruta y modelos para el estado de soporte de chips y modelos.

hoja de ruta del proyecto

• parcheador de firmware inicial para reemplazo de sonido.
• hacer que el parcheador funcione con todos los chipsets bes2300* (¡advertencia! necesita pruebas)
• hacer que el parcheador funcione con todos (o la mayoría) de los chipsets bes
• crear una GUI fácil de usar para el parcheador.
• ingeniería inversa del protocolo de actualización OTA (over-the-air) para flasheo inalámbrico. (ver besota)
• documentar la estructura del firmware y las funciones clave.
• desarrollar una biblioteca de paquetes de sonido creados por la comunidad.

inicio rápido

esta guía asume que tienes python y git instalados en tu sistema si estás en linux o usando el modo CLI.

1. descarga la última versión desde releases y abre el archivo .exe.

2. instala las dependencias (solo para CLI, linux y compilación)

el parcheador requiere FFmpeg para la conversión de audio y 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. obtén tu archivo de firmware

haz clic en "Browse firmware archive" y descarga el firmware (o selecciona la opción "patch firmware" -> "download from online archive" en la CLI).

también puedes descargar la imagen OTA aquí o leer el flash con UART:

➡️ guía de hardware: conexión vía UART

leer el flash vía ota (over-the-air) está planificado para una futura actualización. (si es posible :D)

4. ¡enhorabuena!

puedes encontrar las instrucciones de uso aquí

preguntas frecuentes

1. ¿qué opción del firmware (sin OTA boot o con él) debo seleccionar en qorepatcher?

si estás parcheando el volcado de flash de los auriculares, selecciona la opción "with OTA boot".

si has descargado la imagen de actualización OTA de los servidores oficiales de actualización, selecciona la opción "without OTA boot".

nota: si has parcheado el firmware sin OTA boot, necesitas añadir el offset de OTA boot antes de flashear vía UART (bestool). ¡NO necesitas esto si estás usando el script besota!

contribuir

las contribuciones son lo que hacen de la comunidad de código abierto un lugar tan increíble para aprender, inspirar y crear. cualquier contribución que hagas es enormemente apreciada.

además, ¡echa un vistazo a la guía de creación de módulos!

si tienes una sugerencia que pudiera mejorarlo, por favor haz un fork del repositorio y crea un pull request. también puedes simplemente abrir un issue con la etiqueta "enhancement". ¡no olvides darle una estrella al proyecto! ¡gracias de nuevo!

1. haz un fork del proyecto.
2. crea tu rama de funcionalidad (git checkout -b feature/amazing-feature).
3. haz commit de tus cambios (git commit -m 'feat: add some amazing feature').
4. haz push a la rama (git push origin feature/amazing-feature).
5. abre un pull request.

contacto y comunidad

❤️ apoya el proyecto

si encuentras este proyecto útil y quieres apoyar su desarrollo futuro, ¡puedes invitarme a un café o unos snacks vía boosty! cada contribución es enormemente apreciada y me ayuda a dedicar más tiempo a openqore.

agradecimientos

este proyecto cobró vida con el uso extensivo de asistentes de programación impulsados por IA. aunque la ingeniería inversa central, la investigación y las decisiones arquitectónicas fueron realizadas por el autor, la IA desempeñó un papel crucial en acelerar el proceso de desarrollo, escribir código repetitivo y depurar.

este es un proyecto moderno construido con herramientas modernas.

licencia