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 (ओवर-द-एयर) अपडेट प्रोटोकॉल को रिवर्स-इंजीनियर करें। (besota देखें)
• फर्मवेयर संरचना और मुख्य कार्यों का दस्तावेज़ीकरण करें।
• समुदाय-निर्मित साउंड पैक की एक लाइब्रेरी विकसित करें।

त्वरित शुरुआत

यह गाइड मानती है कि आपके सिस्टम पर python और git इंस्टॉल हैं यदि आप लिनक्स पर हैं या CLI मोड का उपयोग कर रहे हैं।

1. releases से नवीनतम रिलीज़ डाउनलोड करें और .exe फ़ाइल खोलें।

2. निर्भरताएँ इंस्टॉल करें (केवल CLI, लिनक्स और बिल्डिंग के लिए)

पैचर को ऑडियो रूपांतरण के लिए 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. बधाई हो!

आप उपयोग निर्देश यहाँ पा सकते हैं

सामान्य प्रश्न

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 फ़ाइल में पा सकते हैं।