openqore

一个用于修补、修改和增强 soundcore Q 系列耳机固件的开源工具包，未来计划支持其他型号。

**注意：**这个项目是我个人踏入硬件逆向工程和嵌入式系统世界的旅程。它由一个青少年创建，我边做边学。请做好遇到 bug、错误和许多乐趣的心理准备。欢迎所有贡献和建议！

重要信息！

这个项目分为两个部分：

1. openqore SDK - 基于 bes2300p SoC 的 soundcore 耳机固件 SDK
2. qorepatcher - 耳机原厂固件的补丁工具（本仓库）
   

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

qorepatcher

📚 阅读完整文档 📚

支持的设备

这个项目是从 soundcore life q35 开始的。如果你想帮助测试或为新型号添加支持，请提交一个 issue！

支持其他型号是未来的目标！

**注意：**基于 bes2300*、bes1502*、bes1600 芯片组的设备最有可能成为未来支持的对象。

路线图

openqore 刚刚起步。以下是大致的未来计划：

• 用于替换提示音的基础固件补丁工具。
• 解锁系统提示音的 48khz 音频支持。
• 研究并解锁系统提示音的立体声支持。
• 使补丁工具适用于所有 bes2300 芯片组（警告！需要测试）
• 使补丁工具适用于所有（或大多数）bes 芯片组
• 实现耳机名称和 MAC 地址修改的补丁。
• 移除部分型号 aux 输入（耳机插孔连接）上的低音量限制器/门限。
• 为补丁工具创建用户友好的图形界面。
• 逆向工程 ota（空中下载）更新协议，实现无线刷写。
• 编写固件结构和关键函数的文档。
• 开发一个社区创建的提示音包库。

快速开始

本指南假设你的系统已安装 python 和 git。

1. 从 releases 下载并解压 zip 压缩包

2. 安装依赖

补丁工具需要 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. 获取你的固件文件

你可以在这里下载 OTA 镜像，或者通过 UART 读取闪存：

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

通过 ota（空中下载）读取闪存计划在未来的更新中实现。（如果可能的话 :D）

4. 恭喜！

你可以在这里找到使用说明

常见问题

技术深入解析

贡献

贡献正是让开源社区成为学习、启发和创造的绝佳之地。你做出的任何贡献都非常感谢。

如果你有能改进这个项目的建议，请 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 投入更多时间。

致谢

这个项目的诞生离不开对人工智能编程助手（如 claude 和 chatgpt）的大量使用。虽然核心逆向工程、研究以及架构决策均由作者完成，但人工智能在加速开发过程、编写样板代码和调试方面发挥了关键作用。

这是一个用现代工具打造的现代项目。

许可证

本项目采用 mit 许可证。你可以在 license 文件中找到完整的许可证文本。