openqore

BESチップセットを搭載したヘッドフォンのファームウェアをパッチ、改造、強化するためのオープンソースツールキットです（元々はsoundcore Q35から始まり、将来的には他のモデルのサポートも計画しています）。

注意: このプロジェクトは、ハードウェアリバースエンジニアリングと組み込みシステムの世界への私自身の個人的な旅です。バグや間違い、そしてたくさんの楽しさを期待してください。すべての貢献とアドバイスを歓迎します！

重要なお知らせ！（クイックナビゲーション）

あなたがしたいことは:

• ヘッドフォンのファームウェアをパッチする？ -> qorepatcher（このリポジトリ、クイックスタートは以下を参照）
• カスタムファームウェアをインストール／開発する？（現在はbes2300pベースのsoundcoreデバイスのみ） -> openqore SDK
• アップデートをフラッシュ／カスタムファームウェアをOTA（無線）でインストールする？ -> BESデバイス用OTAファイル と besota - BES OTAフラッシャー
• UART経由でアップデートをフラッシュ／不正なアップデート後の復元、またはバックアップを作成する？ -> ハードウェアフラッシュガイド

また、デモプロジェクトも作成しました - DOOMBudsプロジェクトをベースにしたDOOMポートです。ぜひチェックしてみてください！ =)

qorepatcher

📚 完全なドキュメントを読む 📚

対応デバイス

このプロジェクトはsoundcore Life Q35から始まりました。新しいモデルのテストやサポート追加に協力したい場合は、issueを開くか私にDMしてください（連絡先を参照）！

チップとモデルのサポート状況については、ロードマップとモデルをお読みください。

プロジェクトロードマップ

• サウンド置き換え用の初期ファームウェアパッチャー。
• すべてのbes2300*チップセットで動作するパッチャー（警告！テストが必要）
• すべての（またはほとんどの）besチップセットで動作するパッチャー
• パッチャー用のユーザーフレンドリーなGUIの作成。
• 無線フラッシュ用のOTA（無線）アップデートプロトコルのリバースエンジニアリング。（besotaを参照）
• ファームウェア構造と主要機能の文書化。
• コミュニティ作成のサウンドパックライブラリの開発。

クイックスタート

このガイドは、Linuxを使用している場合、またはCLIモードを使用している場合に、システムにpythonとgitがインストールされていることを前提としています。

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」をクリックしてファームウェアをダウンロードします（またはCLIで「patch firmware」->「download from online archive」オプションを選択します）。

また、OTAイメージをこちらからダウンロードするか、UARTでフラッシュを読み取ることもできます：

➡️ ハードウェアガイド：UART経由での接続

OTA（無線）経由でのフラッシュ読み取りは将来のアップデートで計画されています。（可能であれば :D）

4. おめでとうございます！

使用方法についてはこちらをご覧ください。

faq

1. qorepatcherでファームウェアのどのオプション（OTAブートなし、またはあり）を選択すればよいですか？

ヘッドフォンのフラッシュダンプをパッチする場合は、「with OTA boot」オプションを選択してください。

公式アップデートサーバーからOTAアップデートイメージをダウンロードした場合は、「without OTA boot」オプションを選択してください。

注意: OTAブートなしでファームウェアをパッチした場合、UART経由でのフラッシュ（bestool）の前にOTAブートオフセットを追加する必要があります。besotaスクリプトを使用している場合はこれは不要です！

コントリビューション

コントリビューションは、オープンソースコミュニティを学び、刺激を受け、創造するための素晴らしい場所にするものです。あなたのコントリビューションは大いに感謝されます。

また、モジュール作成ガイドもご覧ください！

これを改善するための提案がある場合は、リポジトリをフォークしてプルリクエストを作成してください。「enhancement」タグを付けてissueを開くこともできます。 プロジェクトにスターを付けるのを忘れないでください！改めて感謝します！

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. プルリクエストを開きます。

連絡先 & コミュニティ

❤️ プロジェクトを支援する

このプロジェクトが役に立ち、今後の開発を支援したい場合は、boostyを通じてコーヒーやおやつをご馳走いただけます！すべての貢献は大いに感謝され、openqoreにより多くの時間を費やすことができます。

謝辞

このプロジェクトは、AIを活用したコーディングアシスタントを多用して実現しました。コアとなるリバースエンジニアリング、調査、アーキテクチャの決定は著者が行いましたが、AIは開発プロセスの加速、ボイラープレートコードの作成、デバッグにおいて重要な役割を果たしました。

これは現代のツールで構築された現代的なプロジェクトです。

ライセンス

このプロジェクトはGPLv3ライセンスの下でライセンスされています。完全なライセンステキストはlicenseファイルにあります。