flipperdevices/flipperzero-firmwareبرنامج ثابت (Firmware) لجهاز محمول لاختراق العتاد مع دعم RFID/NFC، وترددات sub-GHz، والأشعة تحت الحمراء، وتقنية BLE لاختبار الأمان اللاسلكي ومحاكاة الإشارات.
هدفنا الأساسي هو بناء مجتمع صحي ومستدام حول Flipper، لذلك نحن منفتحون على أي أفكار ومساهمات جديدة. لدينا أيضًا بعض القواعد والمحظورات هنا، لذا يرجى قراءة هذه الصفحة ومدونة قواعد السلوك الخاصة بنا بعناية.
أفضل مكان للبحث عن إجابات هو وثائق المستخدم. إذا لم تجد الإجابة هناك، تحقق من خادم Discord الخاص بنا. إذا كنت تريد المساهمة في تطوير البرنامج الثابت أو تعديله لتلبية احتياجاتك الخاصة، يمكنك أيضًا الاطلاع على وثائق المطوّرين.
إذا وجدت مشكلة وتريد الإبلاغ عنها، فيرجى مراجعة صفحة المشكلات الخاصة بنا. تأكد من أن الوصف يتضمن معلومات حول إصدار البرنامج الثابت الذي تستخدمه، ومنصتك، وشرحًا واضحًا للخطوات اللازمة لإعادة إنتاج المشكلة.
إذا كان لديك طلب ميزة أو تريد التصويت على ميزة قائمة، فيرجى استخدام المناقشات واتباع إرشادات المناقشة الخاصة بنا.
قبل فتح طلب سحب (PR)، يرجى التأكد من أن تغييراتك يجب أن تكون ضمن البرنامج الثابت. يمكن تنفيذ العديد من الأفكار بسهولة كتطبيقات خارجية ونشرها في كتالوج تطبيقات Flipper. إذا لم تكن متأكدًا، تواصل معنا على خادم Discord أو صفحة المشكلات، وسنساعدك في العثور على المكان المناسب لرمزك.
أيضًا، يرجى قراءة دليل المساهمة وأسلوب البرمجة الخاص بنا، والتأكد من أن رمزك متوافق مع رخصة المشروع.
أخيرًا، افتح طلب سحب وتأكد من أن جميع حالات CI/CD خضراء.
البرنامج الثابت لـ Flipper Zero مكتوب بلغة C، مع بعض الأجزاء المكتوبة بلغة C++ ولغة التجميع armv7m. يُنصح بمستوى متوسط من المعرفة بلغة C للبرمجة بشكل مريح. لغات C وC++ ولغة التجميع armv7m مدعومة لتطبيقات Flipper.
منصات التطوير المدعومة:
مصححات الأخطاء داخل الدارة المدعومة (اختيارية ولكن يُنصح بها بشدة):
سيتولى نظام بناء Flipper العناية بجميع التبعيات الأخرى.
تأكد من امتلاكك مساحة كافية ثم استنسخ الكود المصدري:
git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git
ابنِ البرنامج الثابت باستخدام أداة بناء Flipper:
./fbt
وصّل مصحح الأخطاء داخل الدارة بجهاز Flipper وومّض البرنامج الثابت باستخدام أداة بناء Flipper:
./fbt flash
تأكد من أن جهاز Flipper قيد التشغيل وأن البرنامج الثابت يعمل بشكل صحيح. وصّل جهاز Flipper بكابل USB وومّض البرنامج الثابت باستخدام أداة بناء Flipper:
./fbt flash_usb
applications - التطبيقات والخدمات المستخدمة في البرنامج الثابتapplications_users - مكان لتطبيقاتك وخدماتك الإضافيةassets - الأصول المستخدمة بواسطة التطبيقات والخدماتdocumentation - إعدادات نظام توليد الوثائق وملفات الإدخالfuri - Furi Core: البدائيات والمساعدات على مستوى نظام التشغيلlib - مكتباتنا ومكتبات الطرف الثالث، والسائقون، والأدوات، وغيرها...site_scons - إعدادات نظام البناء ووحداتهscripts - البرامج النصية التكميلية ومكتبات بايثون المختلفةtargets - أهداف البرنامج الثابت: كود خاص بالمنصةأيضًا، راجع ملفات ReadMe.md داخل تلك الدلائل لمزيد من التفاصيل.