Luma3DS

Luma3ds

Nintendo 3DS "Firmware Kustom"

Keterangan

LUMA3DS menambal dan mengimplementasikan kembali bagian -bagian penting dari perangkat lunak sistem yang berjalan pada semua model keluarga konsol Nintendo 3DS. Ini bertujuan untuk sangat meningkatkan pengalaman pengguna dan mendukung 3DS jauh melampaui kehidupannya. Fitur meliputi:

• Dukungan kelas satu untuk aplikasi homebrew
• Rosalina , menu overlay (dipicu oleh L+Down+SELECT secara default), memungkinkan hal -hal seperti:
  • Mengambil tangkapan layar saat bermain
  • Filter lampu biru dan filter layar lainnya
  • Input pengalihan untuk bermain dengan perangkat eksternal, seperti pengontrol
  • Menggunakan kode cheat
  • Mengatur waktu dan tanggal secara akurat dari jaringan (NTP)
  • ... dan banyak lagi!
• Banyak fitur modding game , seperti, tetapi tidak terbatas pada:
  • Plugin game (dalam format 3GX)
  • Permukaan bahasa per game ("emulasi lokal")
  • Pengalihan Jalur Konten Aset ("LayeredFs")
• Dukungan untuk tambalan yang disediakan pengguna dan/atau penggantian "modul sistem" penuh , fitur penting untuk penggantian jaringan Nintendo (di antara proyek lainnya)
• Rintisan GDB yang sepenuhnya , memungkinkan pengembang homebrew dan engineer terbalik untuk bekerja lebih efisien
• Kemampuan untuk menguatkan file firmware lainnya, termasuk versi lain dari dirinya sendiri
• ... dan banyak lagi!

Instalasi dan Tingkatkan

LUMA3DS membutuhkan boot9strap untuk dijalankan.

Setelah boot9strap telah diinstal, cukup unduh arsip rilis terbaru dan ekstrak arsip ke akar kartu SD Anda untuk "menginstal" atau untuk meningkatkan luma3ds di samping menu homebrew dan bundel sertifikat dikirim dengannya. Ganti file yang ada dan gabungkan folder yang ada jika perlu.

Penggunaan dasar

Menu konfigurasi LUMA3DS utama dapat diakses dengan menekan SELECT saat boot. File konfigurasi disimpan di /luma/config.ini pada kartu SD (atau /rw/luma/config.ini pada partisi Ctrnand jika Luma3DS telah diluncurkan dari partisi CTRNAND, yang terjadi ketika kartu SD hilang).

Menu ChainLoader diakses dengan menekan start saat boot, atau dari menu konfigurasi. Payload diharapkan berlokasi di /luma/payloads dengan ekstensi .firm ; Jika hanya ada satu muatan seperti itu, menu pilihan di atas akan dilewati. Hotkeys dapat ditugaskan ke muatan, misalnya x_test.firm akan dianek ketika x ditekan saat boot.

Menu overlay, Rosalina , memiliki kombinasi tombol default: L+Down+SELECT . Untuk flexbility yang lebih besar, sebagian besar pengaturan menu Rosalina tidak disimpan secara otomatis, maka opsi "Simpan Pengaturan".

Port GDB , saat diaktifkan, adalah 4000-4002 untuk port normal. Penggunaan attach dalam Mode "Extended-Remote", di samping info os processes didukung dan didorong (untuk rekayasa balik, juga periksa monitor getmemregions ). Port untuk fitur Break-on-Start adalah 4003 tanpa "Extended-Remote". Kedua GDB dan IDA Pro yang ditampilkan devkyararm (tanpa "dukungan loncatan" diaktifkan) didukung secara aktif.

Kami memiliki wiki, namun saat ini sangat usang.

Komponen

LUMA3DS terdiri dari beberapa komponen. Sementara gaya kode dalam setiap komponen sebagian besar konsisten, komponen -komponen ini telah ditulis selama bertahun -tahun dan mungkin tidak mencerminkan bagaimana pemelihara akan menulis kode baru dalam komponen/proyek baru:

• ARM9 , ARM11 : Menu Pengaturan Utama Baremetal, rantai muat dan loader firmware. Selain menunjukkan pengaturan dan berantai ke file firmware homebrew lainnya sesuai permintaan, itu bertanggung jawab untuk menambal firmware resmi untuk memodifikasi kode Process9 dan untuk menyuntikkan semua komponen khusus lainnya. Ini adalah komponen pertama yang pernah ditulis untuk proyek ini, pada tahun 2015
• K11_Extension : Kode Memperluas Kernel ARM11 NATIVE_FIRM ( Kernel11 ). Ini disuntikkan oleh loader baremetal yang disebutkan di atas ke dalam kernel dengan mengaitkan kode startupnya, kemudian mengaitkan dirinya ke seluruh kernel. Fitur -fiturnya termasuk Hooking System Calls (SVCS), memperkenalkan SVC baru dan mengaitkan ke dalam komunikasi interproses, untuk memotong keterbatasan dalam desain sistem Nintendo. Ini adalah komponen yang memungkinkan Rosalina untuk menjeda proses lain pada entri menu overlay, misalnya. Ini ditulis pada saat kami tidak sepenuhnya merekayasa kernel, dan awalnya dirilis pada 2017 bersama Rosalina. Pengait lebih lanjut untuk dukungan "plugin game" telah digabungkan pada tahun 2023
• Sysmodules : Implementasi "Modul Sistem" (Proses) OS 3DS (kecuali untuk Rosalina adalah khusus), saat ini hanya proses awal yang dimuat langsung dalam memori oleh kernel ("Proses Awal Kernel", atau Kip Singkat), singkatnya)
  • Loader : Proses yang memuat proses non-KIP dari penyimpanan. Karena ini adalah tempat yang sempurna untuk menambal/mengganti kode yang dapat dieksekusi, di sinilah semua patch proses dilakukan, memungkinkan khususnya fitur "modding game". Ini juga merupakan sysmodule yang menangani pemuatan homebrew 3dsx. Diperkenalkan pada tahun 2016
  • Rosalina : Komponen terpenting dari LUMA3DS dan KIP Kustom: Menu Overlay, Server GDB, err:f (Layar Kesalahan Fatal) Implementasi, dan banyak lagi. Diperkenalkan pada pertengahan 2017, dan terus mengalami perubahan dan menerima banyak kontribusi eksternal sejak itu
  • PXI : ARM11 <> KIP komunikasi ARM9, diimplementasikan hanya demi itu. Diperkenalkan akhir 2017
  • SM : Manajer Layanan KIP, diimplementasikan untuk menghapus pembatasan kontrol akses layanan. Diperkenalkan akhir 2017
  • PM : Manajer Proses KIP Berhubungan dengan proses awal/penghentian dan menginstruksikan loader untuk memuatnya. Reimplemen ini memungkinkan fitur GDB break-on-start di Rosalina, serta mengangkat pembatasan kontrol akses FS dengan cara yang tepat. Diperkenalkan pada 2019

Pemelihara

• @Tuxsh : Pengembang utama, membuat dan memelihara sebagian besar fitur proyek. Bergabung pada 2016
• @Aurorawright : Penulis proyek, mengimplementasikan fitur inti (sebagian besar menu Pengaturan Boot Baremetal dan kode pemuatan firmware) dengan keputusan desain yang berhasil yang membuat proyek menjadi populer. Membuat proyek pada tahun 2015, saat ini tidak aktif
• @Pablomk7 : Pemelihara fitur loader plugin digabungkan untuk rilis V13.0. Bergabung pada tahun 2023

Peta jalan

Masih ada lebih banyak fitur dan konsolidasi yang direncanakan untuk luma3DS! Berikut adalah daftar apa yang saat ini ada di toko:

• Implementasi penuh TwlBg dan AgbBg . Ini akan memungkinkan jauh lebih baik, dan lebih dapat dikonfigurasi, naik untuk layar atas di game DS dan GBA (kecuali pada 2DS lama). Ini saat ini sedang dikembangkan secara pribadi di C ++ 23 (tidak ada ETA). Meskipun ini merupakan upaya yang cukup sulit karena ini membutuhkan penulisan ulang seluruh tumpukan pengemudi di semi-bar (kernel terbatas tanpa IPC), ini adalah fitur paling kritis untuk dimiliki Luma3DS dan akan membuat pengunduran diri Sysmodule pengemudi ulang sepele driver
• Implementasi Process9 untuk TWL_FIRM DAN AGB_FIRM untuk memungkinkan lebih banyak fitur dalam mode kompatibilitas DS dan GBA (yang memerlukan akses file)
• Akhirnya, penerimaan ulang Kernel11 lengkap

Masalah yang diketahui

• Mesin cheat macet dengan beberapa aplikasi, khususnya permainan Pokémon : ada kondisi balapan di Kernel11 Nintendo yang berkaitan dengan melampirkan KDebugThread baru ke KThread pada penciptaan utas, dan utas lain yang merosotkan thread->debugThread . Ini menyebabkan mesin cheat crash crash yang membuat dan menghancurkan banyak utas sepanjang waktu (seperti Pokémon).
  • Untuk game -game ini, memiliki "plugin game" khusus adalah satu -satunya alternatif sampai Kernel11 disimpulkan.
• Aplikasi bereaksi terhadap kombo menu rosalina : Rosalina hanya input tombol jajak pendapat pada interval untuk mengetahui kapan harus menampilkan menu. Ini berarti bahwa kombo menu Rosalina kadang -kadang dapat diproses oleh permainan/proses yang akan dijeda.
  • Anda dapat mengubah kombo menu di submenu "Lain -lain Opsi" (lalu simpan dengan "Simpan Pengaturan" di menu utama) untuk mengatasi ini.

Membangun dari sumber

Untuk membangun luma3ds, berikut ini diperlukan:

• git
• Makerom di $PATH
• FirmTool terpasang
• DevKIkanM dan libctru terkini:
  • Instal dkp-pacman (atau, untuk distribusi yang sudah menyediakan Pacman, tambahkan repositori): https://devkitpro.org/wiki/devkitpro_pacman
  • Instal Paket dari 3ds-dev Metapackage: sudo dkp-pacman -S 3ds-dev --needed
  • Saat rilis libctru dan luma3ds disimpan secara sinkron, Anda mungkin harus membangun libctru dari sumber untuk komitmen luma3ds non-rilis

Sementara rilis LUMA3DS dibundel dengan 3ds-hbmenu , LUMA3DS sebenarnya dikompilasi menjadi satu file tunggal: boot.firm . Cukup salin ke akar kartu SD Anda (FTPD adalah cara termudah untuk melakukannya), dan Anda selesai.

Lisensi

Perangkat lunak ini dilisensikan berdasarkan ketentuan GPLV3. Anda dapat menemukan salinan lisensi di file lisensi.txt.

File dalam rintisan GDB sebaliknya dilisensikan triple sebagai MIT atau "GPLV2 atau versi selanjutnya", dalam hal ini ditentukan dalam header file. PM, SM, reimplementasi PXI juga dilisensikan di bawah MIT.

Kredit

LUMA3DS tidak akan menjadi apa adanya tanpa kontribusi dan umpan balik konstruktif banyak orang. Kami ingin berterima kasih khususnya:

• @DevKitPro (terutama @fincs , @wintermute dan @mtheall ) untuk memberikan toolchains yang berkualitas dan mudah digunakan dengan GCC tepi pendarahan, dan untuk saran teknis mereka yang berkelanjutan
• @Nanquitas untuk versi awal kode loader plugin game serta kontribusi yang sangat berguna untuk rintisan GDB
• @piepie62 untuk implementasi mesin cheat Rosalina saat ini, Duckbill untuk implementasinya yang asli
• @panicbit untuk implementasi asli filter layar di Rosalina
• @JasondellAluce untuk berlapis -lapis
• @Liquidfenrir untuk pemirsa memori di dalam "daftar proses" Rosalina "
• Chan untuk Fatfs
• Setiap orang yang telah berkontribusi pada repositori LUMA3DS
• Setiap orang yang telah membantu pemecahan masalah pengguna akhir
• Setiap orang yang telah memberikan umpan balik konstruktif kepada luma3ds