openqore

مجموعة أدوات مفتوحة المصدر لتعديل وتغيير وتحسين البرامج الثابتة (firmware) لسماعات الرأس القائمة على شرائح BES (بدأت أصلاً من soundcore Q35)، مع دعم مخطط لطرازات أخرى في المستقبل.

ملاحظة: هذا المشروع هو رحلتي الشخصية إلى عالم الهندسة العكسية للأجهزة والأنظمة المدمجة. توقّع وجود أخطاء وأخطاء برمجية والكثير من المتعة. جميع المساهمات والنصائح مرحّب بها!

معلومات مهمة! (تنقل سريع)

هل تريد:

• تعديل البرنامج الثابت لسماعاتك؟ -> qorepatcher (هذا المستودع، انظر أدناه للبدء السريع)
• تثبيت / تطوير البرنامج الثابت المخصص؟ (أجهزة soundcore القائمة على bes2300p فقط في الوقت الحالي) -> openqore SDK
• تثبيت تحديث / تثبيت برنامج ثابت مخصص عبر الأثير؟ (OTA) -> ملفات OTA لأجهزة BES و besota - أداة تثبيت BES OTA
• تثبيت تحديث عبر UART / الاستعادة بعد تحديث سيئ أو إنشاء نسخة احتياطية؟ -> دليل التثبيت عبر الأجهزة

أنشأت أيضاً مشروعاً تجريبياً - منفذ DOOM مبني على مشروع DOOMBuds. ألقِ نظرة عليه أيضاً! =)

qorepatcher

📚 اقرأ الوثائق الكاملة 📚

الأجهزة المدعومة

بدأ هذا المشروع مع soundcore Life Q35. إذا كنت ترغب في المساعدة في اختبار أو إضافة دعم لطراز جديد، يرجى فتح issue أو مراسلتي مباشرة (اقرأ التواصل)!

اقرأ خرائط الطريق والطرازات لحالة دعم الشرائح والطرازات.

خارطة طريق المشروع

• أداة تعديل البرنامج الثابت الأولية لاستبدال الصوت.
• جعل أداة التعديل تعمل مع جميع شرائح bes2300* (تحذير! يحتاج إلى اختبار)
• جعل أداة التعديل تعمل مع جميع شرائح bes (أو معظمها)
• إنشاء واجهة رسومية سهلة الاستخدام لأداة التعديل.
• هندسة عكسية لبروتوكول التحديث عبر الأثير (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" وحمّل البرنامج الثابت (أو اختر خيار "patch firmware" -> "download from online archive" في CLI).

أيضاً، يمكنك تنزيل صورة OTA هنا أو قراءة الفلاش عبر UART:

➡️ دليل الأجهزة: الاتصال عبر UART

قراءة الفلاش عبر ota (عبر الأثير) مخطط لها في تحديث مستقبلي. (إذا كان ذلك ممكناً :D)

4. تهانينا!

يمكنك العثور على تعليمات الاستخدام هنا

الأسئلة الشائعة

1. أي خيار من البرنامج الثابت (بدون OTA boot أو معه) في qorepatcher يجب أن أختار؟

إذا كنت تقوم بتعديل نسخة الفلاش المفرّغة من سماعات الرأس، اختر خيار "with OTA boot".

إذا قمت بتنزيل صورة تحديث OTA من خوادم التحديث الرسمية، اختر خيار "without OTA boot".

ملاحظة: إذا قمت بتعديل البرنامج الثابت بدون OTA boot، فأنت بحاجة إلى إضافة إزاحة OTA boot قبل التثبيت عبر UART (bestool). أنت لا تحتاج إلى هذا إذا كنت تستخدم سكريبت besota!

المساهمة

المساهمات هي ما يجعل مجتمع المصادر المفتوحة مكاناً رائعاً للتعلّم والإلهام والإبداع. أي مساهمات تقدمها هي موضع تقدير كبير.

أيضاً، اطّلع على دليل إنشاء الوحدات!

إذا كان لديك اقتراح من شأنه تحسين هذا، يرجى عمل fork للمستودع وإنشاء pull request. يمكنك أيضاً ببساطة فتح issue بوسم "enhancement". لا تنسَ إعطاء المشروع نجمة! شكراً مرة أخرى!

1. اعمل fork للمشروع.
2. أنشئ فرع الميزة الخاص بك (git checkout -b feature/amazing-feature).
3. اعمل commit لتغييراتك (git commit -m 'feat: add some amazing feature').
4. ادفع إلى الفرع (git push origin feature/amazing-feature).
5. افتح pull request.

التواصل والمجتمع

❤️ ادعم المشروع

إذا وجدت هذا المشروع مفيداً وتريد دعم تطويره المستقبلي، يمكنك أن تكرمني بقهوة أو بعض الوجبات الخفيفة عبر boosty! كل مساهمة موضع تقدير كبير وتساعدني على تكريس المزيد من الوقت لـ openqore.

شكر وتقدير

أُخرج هذا المشروع إلى النور باستخدام مكثّف لمساعدي البرمجة المدعومين بالذكاء الاصطناعي. بينما اتخذ المؤلف قرارات الهندسة العكسية والبحث والتصميم المعماري الأساسية، لعب الذكاء الاصطناعي دوراً حاسماً في تسريع عملية التطوير وكتابة الكود النمطي وتصحيح الأخطاء.

هذا مشروع حديث مبني بأدوات حديثة.

الترخيص

هذا المشروع مرخّص بموجب رخصة GPLv3. يمكنك العثور على نص الترخيص الكامل في ملف license.