openqore

открытый набор инструментов для патчинга, модификации и улучшения прошивки наушников на базе чипсетов BES (изначально проект начинался с soundcore Q35), с планами поддержки других моделей в будущем.

примечание: этот проект — моё личное путешествие в мир аппаратного реверс-инжиниринга и встраиваемых систем. ожидайте багов, ошибок и много веселья. любые вклады и советы приветствуются!

важная информация! (быстрая навигация)

вы хотите:

• пропатчить прошивку ваших наушников? -> qorepatcher (этот репозиторий, смотрите ниже для быстрого старта)
• установить / разрабатывать кастомную прошивку? (только soundcore devices based on bes2300p на данный момент) -> openqore SDK
• прошить обновление / установить кастомную прошивку по воздуху? (OTA) -> OTA files for BES devices и besota - BES OTA flasher
• прошить обновление через UART / восстановить после неудачного обновления или сделать бэкап? -> hardware flashing guide

я также создал демо-проект — порт DOOM на основе проекта DOOMBuds. тоже посмотрите! =)

qorepatcher

📚 читайте полную документацию 📚

поддерживаемые устройства

этот проект начинался с soundcore Life Q35. если вы хотите помочь с тестированием или добавить поддержку новой модели, пожалуйста, откройте issue или напишите мне (читайте контакты)!

читайте дорожные карты и модели для статуса поддержки чипов и моделей.

дорожная карта проекта

• начальный патчер прошивки для замены звука.
• сделать патчер работающим со всеми чипсетами bes2300* (внимание! требует тестирования)
• сделать патчер работающим со всеми (или большинством) чипсетами bes
• создать удобный GUI для патчера.
• реверс-инжиниринг протокола OTA (over-the-air) обновления для беспроводной прошивки. (см. besota)
• задокументировать структуру прошивки и ключевые функции.
• разработать библиотеку звуковых пакетов, созданных сообществом.

быстрый старт

это руководство предполагает, что у вас установлены python и git в вашей системе, если вы на linux или используете режим CLI.

1. скачайте последний релиз из releases и откройте .exe файл.

2. установите зависимости (только для CLI, linux и сборки)

патчеру требуется FFmpeg для конвертации аудио и 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. получите файл прошивки

нажмите на "Browse firmware archive" и скачайте прошивку (или выберите опцию "patch firmware" -> "download from online archive" в CLI).

также вы можете скачать OTA-образ здесь или считать flash через UART:

➡️ руководство по железу: подключение через UART

считывание flash через ota (over-the-air) запланировано в будущем обновлении. (если это возможно :D)

4. поздравляем!

инструкции по использованию можно найти здесь

faq

1. какую опцию прошивки (без OTA boot или с ней) в qorepatcher мне выбрать?

если вы патчите дамп flash наушников, выберите опцию "with OTA boot".

если вы скачали OTA-образ обновления с официальных серверов обновлений, выберите опцию "without OTA boot".

примечание: если вы пропатчили прошивку без OTA boot, вам нужно добавить смещение OTA boot перед прошивкой через UART (bestool). вам это НЕ нужно, если вы используете скрипт besota!

участие в разработке

вклады — это то, что делает сообщество открытого исходного кода таким удивительным местом для обучения, вдохновения и творчества. любые ваши вклады очень ценятся.

также ознакомьтесь с руководством по созданию модулей!

если у вас есть предложение, которое сделает это лучше, пожалуйста, форкните репозиторий и создайте pull request. вы также можете просто открыть issue с тегом "enhancement". не забудьте поставить проекту звезду! ещё раз спасибо!

1. форкните проект.
2. создайте свою ветку функции (git checkout -b feature/amazing-feature).
3. закоммитьте свои изменения (git commit -m 'feat: add some amazing feature').
4. запушьте в ветку (git push origin feature/amazing-feature).
5. откройте pull request.

контакты и сообщество

❤️ поддержите проект

если вы находите этот проект полезным и хотите поддержать его будущее развитие, вы можете угостить меня кофе или снеками через boosty! любой вклад очень ценится и помогает мне уделять больше времени openqore.

благодарности

этот проект был воплощён в жизнь с активным использованием помощников по программированию на базе ИИ. хотя основной реверс-инжиниринг, исследования и архитектурные решения были сделаны автором, ИИ сыграл решающую роль в ускорении процесса разработки, написании шаблонного кода и отладке.

это современный проект, созданный с помощью современных инструментов.

лицензия

этот проект лицензирован под лицензией GPLv3. полный текст лицензии можно найти в файле license.