Luma3DS

LUMA3DS

Nintendo 3DS "البرامج الثابتة المخصصة"

وصف

تصحيحات LUMA3DS وإعادة تنفيذ أجزاء مهمة من برنامج النظام تعمل على جميع طرز عائلة Nintendo 3DS من لوحات المفاتيح. ويهدف إلى تحسين تجربة المستخدم بشكل كبير ودعم 3DS إلى ما هو أبعد من نهاية العمر. تشمل الميزات:

• دعم من الدرجة الأولى لتطبيقات البيرة
• Rosalina ، قائمة تراكب (ناتجة عن L+Down+Select افتراضيًا) ، مما يسمح بأشياء مثل:
  • أخذ لقطات شاشة أثناء وجودها في اللعبة
  • مرشحات الضوء الأزرق ومرشحات الشاشة الأخرى
  • إعادة توجيه المدخلات للعب مع الأجهزة الخارجية ، مثل وحدات التحكم
  • باستخدام رموز الغش
  • تحديد الوقت والتاريخ بدقة من الشبكة (NTP)
  • ... وأكثر من ذلك بكثير!
• العديد من ميزات تعديل اللعبة ، مثل ، على سبيل المثال لا الحصر:
  • ملحقات اللعبة (بتنسيق 3GX)
  • كل لعبة تتجاوز اللغة ("محاكاة المحطة")
  • إعادة توجيه مسار محتوى الأصول ("layeredfs")
• دعم للبقع التي يقدمها المستخدم و/أو "وحدات النظام" الكاملة ، وهي ميزة أساسية لاستبدال شبكة Nintendo (من بين مشاريع أخرى)
• كعب GDB بالكامل ، مما يتيح للمطورين المنزليين ومهندسي العكسيين على حد سواء العمل بشكل أكثر كفاءة
• القدرة على ربط ملفات البرامج الثابتة الأخرى ، بما في ذلك الإصدارات الأخرى بحد ذاتها
• ... وأكثر من ذلك بكثير!

التثبيت والترقية

يتطلب LUMA3DS BOOT9STRAP لتشغيله.

بمجرد تثبيت Boot9Strap ، ما عليك سوى تنزيل أحدث أرشيف الإصدار واستخراج الأرشيف على جذر بطاقة SD الخاصة بك إلى "تثبيت" أو لترقية Luma3ds إلى جانب القائمة الرئيسية وشحن حزمة Certs معها. استبدل الملفات الموجودة ودمج المجلدات الموجودة إذا لزم الأمر.

الاستخدام الأساسي

يمكن الوصول إلى قائمة تكوين LUMA3DS الرئيسية عن طريق الضغط على SELECT AT BOOT. يتم تخزين ملف التكوين في /luma/config.ini على بطاقة SD (أو /rw/luma/config.ini على قسم Ctrnand إذا تم إطلاق Luma3DS من قسم Ctrnand ، والذي يحدث عندما تكون بطاقة SD مفقودة).

يتم الوصول إلى قائمة Sainloader عن طريق الضغط على START في التمهيد ، أو من قائمة التكوين. من المتوقع أن تكون الحمولة في /luma/payloads مع ملحق .firm ؛ إذا لم يكن هناك سوى حمولة واحدة من هذا القبيل ، فسيتم تخطي قائمة الاختيار المذكورة أعلاه. يمكن تعيين مفاتيح hotkeys إلى الحمولة ، على سبيل المثال x_test.firm سيتم تحميلها عند الضغط على X عند التمهيد.

قائمة التراكب ، Rosalina ، لديها مزيج زر افتراضي: L+Down+SELECT . للحصول على قدر أكبر من المرونة ، لا يتم حفظ معظم إعدادات قائمة Rosalina تلقائيًا ، وبالتالي خيار "حفظ الإعدادات".

منافذ GDB ، عند تمكينها ، هي 4000-4002 للمنافذ العادية. استخدام attach في وضع "Remote" ، إلى جانب info os processes يتم دعمها وتشجيعها (من أجل الهندسة العكسية ، تحقق أيضًا من monitor getmemregions ). ميناء ميزة Break-On-Start هو 4003 بدون "Remote الموسعة". يتم دعم كل من GDB و IDA Pro المحصور Devkitarm (دون دعم "STEPPING" الممكّن) بشكل نشط.

لدينا ويكي ، ومع ذلك فهي قديمة للغاية حاليًا.

عناصر

يتكون LUMA3DS من مكونات متعددة. على الرغم من أن نمط الكود داخل كل مكون متسق في الغالب ، فقد تمت كتابة هذه المكونات على مدار سنوات عديدة وقد لا تعكس كيفية كتابة المشرفين عن رمز جديد في مكونات/مشاريع جديدة:

• ARM9 ، ARM11 : قائمة الإعدادات الرئيسية BareMetal ، وسلسلة التحميل والبرامج الثابتة. بصرف النظر عن إظهار الإعدادات وتحميل السلسلة إلى ملفات البرامج الثابتة الرئيسية الأخرى عند الطلب ، فهي مسؤولة عن تصحيح البرامج الثابتة الرسمية لتعديل رمز Process9 ولضخ جميع المكونات المخصصة الأخرى. كان هذا أول مكون مكتوب على الإطلاق لهذا المشروع ، في عام 2015
• k11_extension : رمز تمديد ARM11 NATIVE_FIRM kernel ( Kernel11 ). يتم حقنه بواسطة اللودر الباريمي المذكور أعلاه في kernel عن طريق تثبيت رمز بدء التشغيل الخاص به ، ثم يربط نفسه في بقية النواة. تشمل ميزاتها ربط مكالمات النظام (SVCs) ، وتقديم SVCs جديدة والتواصل في اتصالات Interprocess ، لتجاوز القيود في تصميم نظام Nintendo. هذا هو المكون الذي يسمح لـ Rosalina بإيقاف عمليات أخرى على إدخال قائمة التراكب ، على سبيل المثال. تمت كتابة هذا في وقت لم نقم فيه بتصنيع kernel ، وتم إصداره في الأصل في عام 2017 إلى جانب Rosalina. تم دمج المزيد من السنانير لدعم "البرنامج المساعد" في عام 2023
• sysmodules : إعادة تخطيط "وحدات النظام" (العمليات) لنظام التشغيل 3DS (باستثناء كون روزالينا مخصصة) ، حاليًا فقط العمليات الأولية التي يتم تحميلها مباشرة في الذاكرة بواسطة kernel ("العملية الأولية kernel" ، أو KIP باختصار)
  • المحمل : العملية التي تقوم بتحميل العمليات غير KIP من التخزين. نظرًا لأن هذا هو المكان المثالي لتصحيح/استبدال التعليمات البرمجية القابلة للتنفيذ ، فهذا هو المكان الذي تتم فيه جميع تصحيحات العملية ، مما يمكّن ميزات "تعديل اللعبة" بشكل خاص. هذا هو أيضا sysmodule التعامل مع 3DSX تحميل homebrew. تم تقديمه في عام 2016
  • Rosalina : العنصر الأكثر أهمية في LUMA3DS و Custom KIP: قائمة تراكب ، خادم GDB ، err:f (شاشة الخطأ المميتة) إعادة تنفيذ ، وأكثر من ذلك بكثير. تم تقديمه في منتصف عام 2017 ، وقد خضع بشكل مستمر لتغييرات وتلقى العديد من المساهمات الخارجية منذ ذلك الحين
  • PXI : ARM11 <> ARM9 Communication KIP ، تم إعادة تنفيذه فقط من أجله. قدم أواخر عام 2017
  • SM : مدير الخدمة KIP ، تم إعادة تنفيذه لإزالة قيود التحكم في الوصول إلى الخدمة. قدم أواخر عام 2017
  • PM : مدير العمليات KIP REFECIPED لبدء/إنهاء العمليات وتوجيه loader لتحميلها. يتيح إعادة تخصيص ميزة GDB عملية التشغيل في Rosalina ، بالإضافة إلى رفع قيود التحكم في الوصول إلى FS بالطريقة المناسبة. تم تقديمه في عام 2019

المشرفون

• tuxsh : مطور رئيسي ، تم إنشاؤه ويحافظ على معظم ميزات المشروع. انضم في عام 2016
• اورورايرايت : مؤلف المشروع ، نفذ الميزات الأساسية (معظم قائمة إعدادات التمهيد البارميتال ورمز تحميل البرامج الثابتة) مع قرارات التصميم الناجحة التي جعلت المشروع شائعًا. أنشأ المشروع في عام 2015 ، غير نشط حاليًا
• @Pablomk7 : تم دمج Maintainer لميزة تحميل البرنامج المساعد لإصدار V13.0. انضم في عام 2023

خريطة الطريق

لا يزال هناك الكثير من الميزات والتوحيد المخطط له ل LUMA3DS! فيما يلي قائمة بما هو موجود حاليًا:

• إعادة تنفيذ كاملة من TwlBg و AgbBg . سيتيح ذلك زيادة أفضل بكثير وأكثر قابلية للتكوين ، في ألعاب DS و GBA (باستثناء 2DS القديمة). يتم تطوير هذا حاليًا بشكل خاص في C ++ 23 (لا ETA). على الرغم من أن هذا مسعى صعب للغاية لأن هذا يتطلب إعادة كتابة مكدس السائق بأكمله في شبه معدن (kernel محدودة بدون IPC) ، فإن هذه هي الميزة الأكثر أهمية لـ LUMA3DS التي تجعلها تثيرًا لتثبيط نظام التشغيل ، وسوف تجعل سائق Sysmodule Trivial Trivial
• إعادة تنفيذ Process9 لـ TWL_FIRM و AGB_FIRM للسماح بمزيد من الميزات في وضع توافق DS و GBA (تلك التي تتطلب الوصول إلى الملف)
• في نهاية المطاف ، إعادة تنفيذ Kernel11 الكاملة

القضايا المعروفة

• تحطم محرك الغش مع بعض التطبيقات ، ولا سيما ألعاب Pokémon : هناك حالة سباق في Kernel11 من Nintendo المتعلقة بتوصيل KDebugThread جديد إلى KThread على إنشاء مؤشر الترابط ، وخيط آخر خيط خالي من thread->debugThread . يؤدي هذا إلى تعطل محرك الغش في الألعاب التي تخلق وتدمير العديد من الخيوط طوال الوقت (مثل بوكيمون).
  • بالنسبة لهذه الألعاب ، فإن وجود "مكون من" لعبة مكون "مخصصة هو البديل الوحيد حتى يتم إعادة تنفيذ Kernel11 .
• كومبو على التطبيقات التي تتفاعل مع روزالينا كومبو : روزالينا مجرد إدخال زر استطلاعات الرأي في فاصل زمني لمعرفة متى تُظهر القائمة. هذا يعني أنه يمكن في بعض الأحيان معالجة التحرير والسرد في قائمة Rosalina بواسطة اللعبة/العملية التي سيتم إيقافها.
  • يمكنك تغيير التحرير والسرد في القائمة الفرعية "الخيارات المتنوعة" (ثم حفظه مع "حفظ الإعدادات" في القائمة الرئيسية) للعمل حول هذا.

بناء من المصدر

لبناء luma3ds ، ما يلي مطلوب:

• غيت
• Makerom في $PATH
• FirmTool مثبتة
• محدث Devkitarm و Libctru:
  • تثبيت dkp-pacman (أو ، لتوزيعات توفر بالفعل Pacman ، إضافة مستودعات): https://devkitpro.org/wiki/DevKitpro_pacman
  • تثبيت الحزم من metapackage 3ds-dev : sudo dkp-pacman -S 3ds-dev --needed
  • في حين أن إصدارات libctru و luma3ds يتم الاحتفاظ بها في متزامنة ، فقد تضطر إلى بناء libctru من مصدر للاشتراك luma3ds غير النشر

بينما يتم تجميع إصدارات LUMA3DS مع 3ds-hbmenu ، فإن LUMA3DS يجمع فعليًا في ملف واحد: boot.firm . ما عليك سوى نسخه إلى جذر بطاقة SD الخاصة بك (FTPD هي أسهل طريقة للقيام بذلك) ، وقد انتهيت.

الترخيص

هذا البرنامج مرخص بموجب شروط GPLV3. يمكنك العثور على نسخة من الترخيص في ملف الترخيص.

يتم تخصيص الملفات الموجودة في كعب GDB بدلاً من معهد MIT أو "GPLv2 أو أي إصدار لاحق" ، وفي هذه الحالة يتم تحديدها في رأس الملف. PM ، SM ، تعويضات PXI مرخصة أيضًا بموجب معهد ماساتشوستس للتكنولوجيا.

الاعتمادات

لن يكون LUMA3DS ما هو عليه بدون مساهمات وردود فعل بناء للكثيرين. نود أن نشكر على وجه الخصوص:

• devkitpro (خاصة fincs ، wintermute و mtheall ) لتوفير أدوات أدوات عالية الجودة وسهلة الاستخدام مع GCC حافة النزيف ، ونصائحهم الفنية المستمرة
• @nanquitas للإصدار الأولي من رمز تحميل البرنامج المساعد بالإضافة إلى مساهمات مفيدة للغاية في كعب GDB
• @piepie62 للتنفيذ الحالي لمحرك الغش في Rosalina ، Duckbill لتنفيذها الأصلي
• panicbit للتنفيذ الأصلي لمرشحات الشاشة في روزالينا
• jasondellaluce للطبقة
• liquidfenrir لمشاهد الذاكرة داخل "قائمة العمليات" في Rosalina
• تشان ل fatfs
• كل من ساهم في مستودع LUMA3DS
• كل من ساعد في استكشاف أخطاء المستخدمين النهائيين
• كل من قدم ردود فعل بناء إلى LUMA3DS