البرنامج الثابت لـ Flipper Zero

• الموقع الرسمي لـ Flipper Zero - طريقة بسيطة لشرح ما يمكن أن يفعله Flipper Zero لأصدقائك.
• تحديث البرنامج الثابت لـ Flipper Zero - تحسينات لدولفينك: أحدث إصدارات البرنامج الثابت، وأدوات الترقية لأجهزة الكمبيوتر والأجهزة المحمولة.
• وثائق المستخدم - تعرّف على المزيد عن دولفينك: المواصفات، وأدلة الاستخدام، وأي شيء تريد سؤاله.
• وثائق المطوّرين - اغوص في الكود المصدري للبرنامج الثابت لـ Flipper Zero: نظام البناء، وهيكل البرنامج الثابت، والمزيد.

المساهمة

هدفنا الأساسي هو بناء مجتمع صحي ومستدام حول Flipper، لذلك نحن منفتحون على أي أفكار ومساهمات جديدة. لدينا أيضًا بعض القواعد والمحظورات هنا، لذا يرجى قراءة هذه الصفحة ومدونة قواعد السلوك الخاصة بنا بعناية.

أحتاج المساعدة

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

أريد الإبلاغ عن مشكلة

إذا وجدت مشكلة وتريد الإبلاغ عنها، فيرجى مراجعة صفحة المشكلات الخاصة بنا. تأكد من أن الوصف يتضمن معلومات حول إصدار البرنامج الثابت الذي تستخدمه، ومنصتك، وشرحًا واضحًا للخطوات اللازمة لإعادة إنتاج المشكلة.

أريد اقتراح ميزة جديدة

إذا كان لديك طلب ميزة أو تريد التصويت على ميزة قائمة، فيرجى استخدام المناقشات واتباع إرشادات المناقشة الخاصة بنا.

أريد المساهمة بالكود

قبل فتح طلب سحب (PR)، يرجى التأكد من أن تغييراتك يجب أن تكون ضمن البرنامج الثابت. يمكن تنفيذ العديد من الأفكار بسهولة كتطبيقات خارجية ونشرها في كتالوج تطبيقات Flipper. إذا لم تكن متأكدًا، تواصل معنا على خادم Discord أو صفحة المشكلات، وسنساعدك في العثور على المكان المناسب لرمزك.

أيضًا، يرجى قراءة دليل المساهمة وأسلوب البرمجة الخاص بنا، والتأكد من أن رمزك متوافق مع رخصة المشروع.

أخيرًا، افتح طلب سحب وتأكد من أن جميع حالات CI/CD خضراء.

التطوير

البرنامج الثابت لـ Flipper Zero مكتوب بلغة C، مع بعض الأجزاء المكتوبة بلغة C++ ولغة التجميع armv7m. يُنصح بمستوى متوسط من المعرفة بلغة C للبرمجة بشكل مريح. لغات C وC++ ولغة التجميع armv7m مدعومة لتطبيقات Flipper.

المتطلبات

منصات التطوير المدعومة:

• Windows 10+ مع PowerShell وGit (x86_64)
• macOS 12+ مع أدوات سطر الأوامر (x86_64, arm64)
• Ubuntu 20.04+ مع build-essential وGit (x86_64)

مصححات الأخطاء داخل الدارة المدعومة (اختيارية ولكن يُنصح بها بشدة):

• Flipper Zero Wi-Fi Development Board
• متوافق مع CMSIS-DAP: Raspberry Pi Debug Probe وغيرها...
• ST-Link (v2, v3, v3mods)
• J-Link

سيتولى نظام بناء Flipper العناية بجميع التبعيات الأخرى.

استنساخ الكود المصدري

تأكد من امتلاكك مساحة كافية ثم استنسخ الكود المصدري:

git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git

البناء

ابنِ البرنامج الثابت باستخدام أداة بناء Flipper:

./fbt

وميض البرنامج الثابت باستخدام مصحح أخطاء داخل الدارة

وصّل مصحح الأخطاء داخل الدارة بجهاز Flipper وومّض البرنامج الثابت باستخدام أداة بناء Flipper:

./fbt flash

وميض البرنامج الثابت عبر USB

تأكد من أن جهاز Flipper قيد التشغيل وأن البرنامج الثابت يعمل بشكل صحيح. وصّل جهاز Flipper بكابل USB وومّض البرنامج الثابت باستخدام أداة بناء Flipper:

./fbt flash_usb

الوثائق

• أداة بناء Flipper - بناء برمجيات Flipper ووميضها وتصحيح أخطائها
• التطبيقات، بيان التطبيق - تطوير تطبيقات Flipper وبناؤها ونشرها وتصحيح أخطائها
• توافيق الأزرار وإزالة التعطيل - استعادة جهاز Flipper من أصعب المواقف
• تنسيقات ملفات Flipper - كل ما يتعلق بكيفية تخزين Flipper لبياناتك وكيف يمكنك التعامل معها
• أجهزة التحكم الشاملة - المساهمة بجهاز التحكم بالأشعة تحت الحمراء الخاص بك في قاعدة بيانات أجهزة التحكم الشاملة
• والمزيد الكثير في وثائق المطوّرين

هيكل المشروع

• applications - التطبيقات والخدمات المستخدمة في البرنامج الثابت
• applications_users - مكان لتطبيقاتك وخدماتك الإضافية
• assets - الأصول المستخدمة بواسطة التطبيقات والخدمات
• documentation - إعدادات نظام توليد الوثائق وملفات الإدخال
• furi - Furi Core: البدائيات والمساعدات على مستوى نظام التشغيل
• lib - مكتباتنا ومكتبات الطرف الثالث، والسائقون، والأدوات، وغيرها...
• site_scons - إعدادات نظام البناء ووحداته
• scripts - البرامج النصية التكميلية ومكتبات بايثون المختلفة
• targets - أهداف البرنامج الثابت: كود خاص بالمنصة

أيضًا، راجع ملفات ReadMe.md داخل تلك الدلائل لمزيد من التفاصيل.

الروابط

• Discord: flipp.dev/discord
• Reddit: reddit.com/r/flipperzero
• الموقع الإلكتروني: flipper.net
• Kickstarter: kickstarter.com

أدوات SAST

• PVS-Studio - محلل ثابت لرمز C وC++ وC# وJava.