openqore

BES 칩셋을 기반으로 한 헤드폰의 펌웨어를 패치, 수정, 개선하기 위한 오픈소스 툴킷입니다 (원래 soundcore Q35에서 시작되었으며, 향후 다른 모델 지원도 계획 중입니다).

참고: 이 프로젝트는 하드웨어 리버스 엔지니어링과 임베디드 시스템의 세계로 떠나는 저의 개인적인 여정입니다. 버그, 실수, 그리고 많은 재미를 기대해 주세요. 모든 기여와 조언을 환영합니다!

중요 정보! (빠른 탐색)

다음을 원하시나요:

• 헤드폰 펌웨어를 패치하고 싶다면? -> qorepatcher (이 저장소, 빠른 시작은 아래를 참고하세요)
• 커스텀 펌웨어를 설치/개발하고 싶다면? (현재 bes2300p 기반 soundcore 기기만 해당) -> openqore SDK
• 업데이트를 플래시하거나 커스텀 펌웨어를 무선으로 설치하고 싶다면? (OTA) -> BES 기기용 OTA 파일 및 besota - BES OTA 플래셔
• UART를 통해 업데이트를 플래시하거나, 잘못된 업데이트 후 복구하거나, 백업을 만들고 싶다면? -> 하드웨어 플래싱 가이드

저는 또한 DOOMBuds 프로젝트를 기반으로 한 DOOM 포팅 데모 프로젝트도 만들었습니다. 그것도 한번 확인해 보세요! =)

qorepatcher

📚 전체 문서 읽기 📚

지원 기기

이 프로젝트는 soundcore Life Q35로 시작되었습니다. 새로운 모델의 테스트나 지원 추가를 돕고 싶으시다면, 이슈를 열거나 저에게 DM을 보내주세요 (연락처를 참고하세요)!

칩 및 모델 지원 현황은 로드맵과 모델을 참고하세요.

프로젝트 로드맵

• 사운드 교체를 위한 초기 펌웨어 패처.
• 모든 bes2300* 칩셋과 호환되도록 패처 개선 (경고! 테스트 필요)
• 모든 (또는 대부분의) BES 칩셋과 호환되도록 패처 개선
• 패처를 위한 사용자 친화적인 GUI 제작.
• 무선 플래싱을 위한 OTA (over-the-air) 업데이트 프로토콜 리버스 엔지니어링. (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 (over-the-air)를 통한 플래시 읽기는 향후 업데이트에서 계획되어 있습니다. (가능하다면 :D)

4. 축하합니다!

사용 방법은 여기에서 확인할 수 있습니다.

FAQ

1. qorepatcher에서 펌웨어 옵션 (OTA 부트 없이 또는 포함) 중 어떤 것을 선택해야 하나요?

헤드폰의 플래시 덤프를 패치하는 경우, "with OTA boot" 옵션을 선택하세요.

공식 업데이트 서버에서 OTA 업데이트 이미지를 다운로드한 경우, "without OTA boot" 옵션을 선택하세요.

참고: OTA 부트 없이 펌웨어를 패치한 경우, UART를 통한 플래싱 (bestool) 전에 OTA 부트 오프셋을 추가해야 합니다. besota 스크립트를 사용하는 경우에는 이것이 필요하지 않습니다!

기여하기

기여는 오픈 소스 커뮤니티를 배우고, 영감을 주고, 창조하는 놀라운 장소로 만드는 원동력입니다. 여러분이 해주시는 모든 기여는 크게 감사드립니다.

또한 모듈 제작 가이드를 확인해 보세요!

이 프로젝트를 더 좋게 만들 제안이 있으시다면, 저장소를 포크하고 풀 리퀘스트를 생성해 주세요. "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. 풀 리퀘스트를 엽니다.

연락처 & 커뮤니티

❤️ 프로젝트 후원

이 프로젝트가 도움이 되었고 향후 개발을 지원하고 싶으시다면, boosty를 통해 저에게 커피나 간식을 사주실 수 있습니다! 모든 기여는 크게 감사드리며, openqore에 더 많은 시간을 할애하는 데 도움이 됩니다.

감사의 글

이 프로젝트는 AI 기반 코딩 어시스턴트를 광범위하게 활용하여 탄생했습니다. 핵심 리버스 엔지니어링, 연구, 아키텍처 결정은 작성자가 수행했지만, AI는 개발 과정을 가속화하고, 보일러플레이트 코드를 작성하고, 디버깅하는 데 중요한 역할을 했습니다.

이것은 현대적인 도구로 만들어진 현대적인 프로젝트입니다.

라이선스

이 프로젝트는 GPLv3 라이선스에 따라 라이선스가 부여됩니다. 전체 라이선스 텍스트는 license 파일에서 확인할 수 있습니다.