openqore

一个开源工具包，用于修补、修改和增强基于 BES 芯片组的耳机固件（最初从 soundcore Q35 开始），未来计划支持其他型号。

注意： 这个项目是我个人探索硬件逆向工程和嵌入式系统世界的旅程。预计会有 bug、错误，以及很多乐趣。欢迎所有贡献和建议！

重要信息！（快速导航）

你想要：

• 修补你的耳机固件？-> qorepatcher（本仓库，查看下方的快速开始）
• 安装 / 开发自定义固件？（目前仅支持 基于 bes2300p 的 soundcore 设备）-> openqore SDK
• 通过无线方式刷入更新 / 安装自定义固件？（OTA）-> BES 设备的 OTA 文件 和 besota - BES OTA 刷写工具
• 通过 UART 刷入更新 / 在刷写失败后恢复或进行备份？-> 硬件刷写指南

我还创建了一个演示项目——一个基于 DOOMBuds 项目的 DOOM 移植版。也去看看！=)

qorepatcher

📚 阅读完整文档 📚

支持的设备

这个项目最初是从 soundcore Life Q35 开始的。如果你想帮助测试或添加对新型号的支持，请提交 issue 或私信我（阅读联系方式）！

阅读路线图和型号了解芯片和型号的支持状态。

项目路线图

• 用于声音替换的初始固件修补器。
• 使修补器兼容所有 bes2300* 芯片组（警告！需要测试）
• 使修补器兼容所有（或大多数）BES 芯片组
• 为修补器创建用户友好的 GUI。
• 逆向工程 OTA（无线）更新协议以实现无线刷写。（参见 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" 并下载固件（或在 CLI 中选择 "patch firmware" -> "download from online archive" 选项）。

此外，你可以在此下载 OTA 镜像，或通过 UART 读取 flash：

➡️ 硬件指南：通过 UART 连接

通过 OTA（无线）读取 flash 计划在未来的更新中实现。（如果可能的话 :D）

4. 恭喜！

你可以在此找到使用说明

常见问题

1. 在 qorepatcher 中我应该选择哪个固件选项（不带 OTA boot 还是带它）？

如果你修补的是耳机的 flash 转储，请选择 "with OTA boot" 选项。

如果你从官方更新服务器下载了 OTA 更新镜像，请选择 "without OTA boot" 选项。

注意： 如果你修补的固件不带 OTA boot，你需要在通过 UART 刷写（bestool）之前追加 OTA boot 偏移量。如果你使用 besota 脚本，则不需要这样做！

贡献

贡献正是让开源社区成为一个学习、启发和创造的绝佳场所的原因。你所做的任何贡献都备受赞赏。

另外，请查看模块创建指南！

如果你有改进建议，请 fork 仓库并创建 pull request。你也可以简单地提交一个带有 "enhancement" 标签的 issue。 别忘了给项目点个 star！再次感谢！

1. fork 项目。
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 中。

致谢

这个项目在大量使用 AI 驱动的编码助手的帮助下得以实现。虽然核心逆向工程、研究和架构决策由作者完成，但 AI 在加速开发过程、编写样板代码和调试方面发挥了关键作用。

这是一个用现代工具构建的现代项目。

许可证

本项目基于 GPLv3 许可证授权。你可以在 license 文件中找到完整的许可证文本。