Luma3DS

Luma3ds

Nintendo 3DS "เฟิร์มแวร์ที่กำหนดเอง"

คำอธิบาย

Luma3ds แพทช์และการปรับปรุงส่วนที่สำคัญของซอฟต์แวร์ระบบที่ทำงานในทุกรุ่นของคอนโซล Nintendo 3DS มันมีจุดมุ่งหมายเพื่อปรับปรุงประสบการณ์ผู้ใช้อย่างมากและสนับสนุน 3DS ไกลเกินกว่าจุดสิ้นสุดของชีวิต คุณสมบัติรวมถึง:

• การสนับสนุนชั้นหนึ่งสำหรับแอปพลิเคชัน Homebrew
• Rosalina , เมนูซ้อนทับ (เรียกโดย L+Down+เลือก ตามค่าเริ่มต้น) อนุญาตให้สิ่งต่าง ๆ เช่น:
  • ถ่ายภาพหน้าจอขณะอยู่ในเกม
  • ตัวกรองแสงสีน้ำเงินและตัวกรองหน้าจออื่น ๆ
  • การเปลี่ยนเส้นทางอินพุตเพื่อเล่นกับอุปกรณ์ภายนอกเช่นคอนโทรลเลอร์
  • ใช้รหัสโกง
  • การตั้งค่าเวลาและวันที่อย่างถูกต้องจากเครือข่าย (NTP)
  • ... และอีกมากมาย!
• คุณสมบัติการดัดแปลงเกมมากมาย เช่น แต่ไม่ จำกัด เพียง:
  • ปลั๊กอินเกม (ในรูปแบบ 3GX)
  • การแทนที่ภาษาต่อเกม ("การจำลองสถานที่")
  • การเปลี่ยนเส้นทางเส้นทางเนื้อหาสินทรัพย์ ("layeredfs")
• รองรับแพตช์ที่ผู้ใช้ให้และ/หรือการเปลี่ยน "โมดูล" เต็มรูปแบบ ซึ่งเป็นคุณสมบัติที่สำคัญสำหรับการเปลี่ยนเครือข่าย Nintendo (ในโครงการอื่น ๆ )
• ต้นขั้ว GDB ที่เต็มเปี่ยม ช่วยให้นักพัฒนา Homebrew และเครื่องยนต์ย้อนกลับทำงานได้อย่างมีประสิทธิภาพมากขึ้น
• ความสามารถในการเชนไฟล์เฟิร์มแวร์อื่น ๆ รวมถึงเวอร์ชันอื่น ๆ ของตัวเอง
• ... และอีกมากมาย!

การติดตั้งและอัพเกรด

Luma3ds ต้องการให้ Boot9strap ทำงาน

เมื่อติดตั้ง boot9strap แล้วเพียงดาวน์โหลดคลังเก็บล่าสุดและแยกเก็บถาวรลงในรูทของการ์ด SD ของคุณเพื่อ "ติดตั้ง" หรืออัพเกรด Luma3ds ควบคู่ไปกับเมนู Homebrew แทนที่ไฟล์ที่มีอยู่และรวมโฟลเดอร์ที่มีอยู่หากจำเป็น

การใช้งานขั้นพื้นฐาน

เมนูการกำหนดค่า Luma3DS หลัก สามารถเข้าถึงได้โดยการกด เลือก ที่บูต ไฟล์การกำหนดค่าจะถูกเก็บไว้ใน /luma/config.ini บนการ์ด SD (หรือ /rw/luma/config.ini บนพาร์ติชัน ctrnand หาก Luma3DS เปิดตัวจากพาร์ติชัน Ctrnand ซึ่งเกิดขึ้นเมื่อการ์ด SD หายไป)

เมนู chainloader เข้าถึงได้โดยการกด เริ่มต้น ที่บูตหรือจากเมนูการกำหนดค่า น้ำหนักบรรทุกคาดว่าจะอยู่ใน /luma/payloads พร้อมส่วนขยาย .firm ; หากมีน้ำหนักบรรทุกเพียงครั้งเดียวเมนูการเลือกดังกล่าวจะถูกข้ามไป Hotkeys สามารถกำหนดให้ Payload ได้เช่น x_test.firm จะได้รับ chainloaded เมื่อกด X เมื่อทำการบู๊ต

เมนูซ้อนทับ Rosalina มีการรวมปุ่มเริ่มต้น: L+DOWN+SELECT สำหรับความยืดหยุ่นที่มากขึ้นการตั้งค่าเมนู Rosalina ส่วนใหญ่จะไม่ถูกบันทึกโดยอัตโนมัติดังนั้นตัวเลือก "บันทึกการตั้งค่า"

พอร์ต GDB เมื่อเปิดใช้งานคือ 4000-4002 สำหรับพอร์ตปกติ การใช้ attach ในโหมด "Extended-Remote" ควบคู่ไปกับ info os processes ได้รับการสนับสนุนและสนับสนุน (สำหรับวิศวกรรมย้อนกลับและตรวจสอบ monitor getmemregions ) พอร์ตสำหรับคุณลักษณะ break-on-start คือ 4003 โดยไม่ต้อง "Extended-Remote" ทั้ง DEVKITARM-PATCHED GDB และ IDA PRO (โดยไม่ต้องเปิดใช้งาน "การสนับสนุน" การสนับสนุน)) ได้รับการสนับสนุนอย่างแข็งขัน

เรามีวิกิ แต่ในปัจจุบันมันล้าสมัยมาก

ส่วนประกอบ

Luma3ds ประกอบด้วยหลายองค์ประกอบ ในขณะที่รูปแบบรหัสภายในแต่ละองค์ประกอบมีความสอดคล้องกันส่วนใหญ่ส่วนประกอบเหล่านี้ถูกเขียนมานานหลายปีและอาจไม่สะท้อนให้เห็นว่าผู้ดูแลจะเขียนโค้ดใหม่ในส่วนประกอบ/โครงการใหม่ได้อย่างไร:

• ARM9 , ARM11 : เมนูการตั้งค่าหลักของ Baremetal, chainloader และ firmware loader นอกเหนือจากการแสดงการตั้งค่าและ chainloading ไปยังไฟล์เฟิร์มแวร์ Homebrew อื่น ๆ ตามความต้องการแล้วยังรับผิดชอบในการแก้ไขเฟิร์มแวร์อย่างเป็นทางการเพื่อแก้ไขรหัส Process9 และเพื่อฉีดส่วนประกอบที่กำหนดเองอื่น ๆ ทั้งหมด นี่เป็นองค์ประกอบแรกที่เคยเขียนสำหรับโครงการนี้ในปี 2558
• K11_EXTENSION : รหัสขยายเคอร์เนล ARM11 NATIVE_FIRM ( Kernel11 ) มันถูกฉีดโดยรถตักบาเรนเดอร์ที่กล่าวถึงข้างต้นลงในเคอร์เนลโดยการเชื่อมต่อรหัสเริ่มต้นจากนั้นก็เชื่อมต่อกับเคอร์เนลที่เหลือ คุณสมบัติของมันรวมถึงการเรียกระบบเชื่อมต่อ (SVCs) แนะนำ SVCs ใหม่และการเชื่อมต่อกับการสื่อสารระหว่างกระบวนการเพื่อข้ามข้อ จำกัด ในการออกแบบระบบของ Nintendo นี่คือส่วนประกอบที่อนุญาตให้ Rosalina หยุดกระบวนการอื่น ๆ ในรายการเมนูซ้อนทับตัวอย่างเช่น สิ่งนี้เขียนขึ้นในช่วงเวลาที่เราไม่ได้กลับมาเป็นวิศวกรอย่างเต็มที่และเปิดตัวครั้งแรกในปี 2560 ควบคู่ไปกับ Rosalina ขอเพิ่มเติมสำหรับการสนับสนุน "ปลั๊กอินเกม" ได้ถูกรวมเข้าด้วยกันในปี 2566
• Sysmodules : การปรับปรุงใหม่ของ "โมดูลระบบ" (กระบวนการ) ของระบบปฏิบัติการ 3DS (ยกเว้น Rosalina ที่กำหนดเอง) ปัจจุบันกระบวนการเริ่มต้นที่โหลดโดยตรงในหน่วยความจำโดยเคอร์เนล ("กระบวนการเริ่มต้นเคอร์เนล" หรือ KIP สั้น ๆ )
  • ตัวโหลด : ประมวลผลที่โหลดกระบวนการที่ไม่ใช่ KIP จากที่เก็บข้อมูล เนื่องจากนี่เป็นสถานที่ที่สมบูรณ์แบบในการแก้ไข/แทนที่รหัสปฏิบัติการนี่คือที่ที่แพทช์กระบวนการทั้งหมดเสร็จสิ้นโดยเฉพาะอย่างยิ่งคุณลักษณะ "การดัดแปลงเกม" นี่คือการโหลด Sysmodule Homebrew Loading 3DSX เปิดตัวในปี 2559
  • Rosalina : ส่วนประกอบที่สำคัญที่สุดของ LUMA3DS และ Custom KIP: เมนูซ้อนทับ, เซิร์ฟเวอร์ GDB, err:f (หน้าจอข้อผิดพลาดร้ายแรง) การปรับแต่งใหม่และอื่น ๆ อีกมากมาย เปิดตัวในช่วงกลางปี ​​2560 และได้รับการเปลี่ยนแปลงอย่างต่อเนื่องและได้รับการสนับสนุนจากภายนอกมากมายนับตั้งแต่นั้นมา
  • PXI : ARM11 <> arm9 การสื่อสาร kip, reimplemented เพียงเพื่อประโยชน์ของมัน เปิดตัวปลายปี 2560
  • SM : Service Manager KIP ได้รับการปรับปรุงใหม่เพื่อลบข้อ จำกัด การควบคุมการเข้าถึงบริการ เปิดตัวปลายปี 2560
  • PM : Process Manager KIP ได้รับการรับรองกระบวนการเริ่มต้น/ยกเลิกและสั่งให้ loader โหลด การปรับปรุงใหม่ช่วยให้คุณลักษณะ GDB เริ่มต้นใน Rosalina รวมถึงการยกข้อ จำกัด การควบคุมการเข้าถึง FS ในวิธีที่เหมาะสม เปิดตัวในปี 2562

ผู้ดูแล

• @tuxsh : นักพัฒนานำสร้างและรักษาคุณสมบัติส่วนใหญ่ของโครงการ เข้าร่วมในปี 2559
• @AurorAwright : ผู้แต่งโครงการนำไปใช้คุณสมบัติหลัก (ส่วนใหญ่ของเมนูการตั้งค่าการบูต Baremetal และรหัสการโหลดเฟิร์มแวร์) ด้วยการตัดสินใจออกแบบที่ประสบความสำเร็จซึ่งทำให้โครงการเป็นที่นิยม สร้างโครงการในปี 2558 ปัจจุบันไม่ทำงาน
• @pablomk7 : ผู้ดูแลคุณสมบัติของปลั๊กอินโหลดเดอร์ที่รวมเข้าด้วยกันสำหรับการเปิดตัว V13.0 เข้าร่วมในปี 2566

แผนงาน

ยังมีคุณสมบัติและการรวมที่วางแผนไว้สำหรับ Luma3DS มากขึ้น! นี่คือรายการของสิ่งที่อยู่ในร้าน:

• การปรับปรุงใหม่อย่างเต็มรูปแบบของ TwlBg และ AgbBg สิ่งนี้จะช่วยให้ดีขึ้นและกำหนดค่าได้มากขึ้นการเพิ่มอัตราการเพิ่มขึ้นสำหรับหน้าจอด้านบนในเกม DS และ GBA (ยกเว้นใน 2DS เก่า) ขณะนี้กำลังได้รับการพัฒนาเป็นการส่วนตัวใน C ++ 23 (ไม่มี ETA) ในขณะที่นี่เป็นความพยายามที่ยากลำบากเนื่องจากต้องมีการเขียนใหม่ทั้งหมดของไดรเวอร์สแต็กในโลหะกึ่ง-โลหะ (เคอร์เนล จำกัด ที่ไม่มี IPC) นี่เป็นคุณสมบัติที่สำคัญที่สุดสำหรับ Luma3DS
• การปรับปรุง Process9 สำหรับ TWL_FIRM และ AGB_FIRM เพื่ออนุญาตให้มีคุณสมบัติเพิ่มเติมในโหมดความเข้ากันได้ของ DS และ GBA (ที่ต้องการการเข้าถึงไฟล์)
• ในที่สุด Kernel11 การปรับแต่งใหม่

ปัญหาที่รู้จัก

• เครื่องยนต์โกงล่มด้วยแอพพลิเคชั่นบางอย่างโดยเฉพาะเกมโปเกมอน : มีเงื่อนไขการแข่งขันใน Kernel11 ของ Nintendo ที่เกี่ยวข้องกับการแนบ KDebugThread ใหม่กับ KThread ในการสร้างเธรดและ thread->debugThread อื่น ๆ สิ่งนี้ทำให้เอ็นจิ้นโกงหยุดเกมที่สร้างและทำลายหลาย ๆ เธรดตลอดเวลา (เช่นโปเกมอน)
  • สำหรับเกมเหล่านี้การมี "ปลั๊กอินเกม" โดยเฉพาะ เป็นทางเลือกเดียวจนกว่า Kernel11 จะได้รับการปรับปรุงใหม่
• แอพพลิเคชั่นที่ตอบสนองต่อปุ่มเมนู Rosalina คำสั่งผสม : Rosalina Bind Polls ปุ่มป้อนข้อมูลในช่วงเวลาที่จะรู้ว่าเมื่อใดควรแสดงเมนู ซึ่งหมายความว่าบางครั้งคำสั่งผสมเมนู 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 commits

ในขณะที่ Luma3DS เผยแพร่มาพร้อมกับ 3ds-hbmenu , LUMA3DS รวบรวมเป็นไฟล์เดียว: boot.firm เพียงคัดลอกไปยังรูทของการ์ด SD ของคุณ (FTPD เป็นวิธีที่ง่ายที่สุดในการทำเช่นนั้น) และคุณก็ทำเสร็จแล้ว

การออกใบอนุญาต

ซอฟต์แวร์นี้ได้รับอนุญาตภายใต้เงื่อนไขของ GPLV3 คุณสามารถค้นหาสำเนาของใบอนุญาตในไฟล์ license.txt

ไฟล์ใน GDB Stub นั้นได้รับใบอนุญาตสามเท่าเป็น MIT หรือ "GPLV2 หรือเวอร์ชันใหม่ ๆ " ซึ่งในกรณีนี้ระบุไว้ในส่วนหัวไฟล์ PM, SM, การปรับปรุงใหม่ของ PXI ยังได้รับใบอนุญาตภายใต้ MIT

การให้เครดิต

Luma3ds จะไม่เป็นอย่างที่มันเป็นโดยไม่มีการมีส่วนร่วมและการตอบรับที่สร้างสรรค์ของหลาย ๆ คน เราขอขอบคุณเป็นพิเศษ:

• @devkitpro (โดยเฉพาะ @fincs , @wintermute และ @mtheall ) สำหรับการให้เครื่องมือที่มีคุณภาพและใช้งานง่ายด้วย GCC ที่มีเลือดออกและสำหรับคำแนะนำทางเทคนิคอย่างต่อเนื่องของพวกเขา
• @Nanquitas สำหรับเวอร์ชันเริ่มต้นของรหัสปลั๊กอินเกมโหลดรวมถึงการมีส่วนร่วมที่มีประโยชน์มากในการทำ gdb stub
• @PIEPIE62 สำหรับการใช้งานเครื่องยนต์ Rosalina Cheat ในปัจจุบัน Duckbill สำหรับการใช้งานดั้งเดิม
• @PanicBit สำหรับการใช้งานตัวกรองหน้าจอดั้งเดิมใน Rosalina
• @jasondellaluce สำหรับ layeredfs
• @LiquidFenrir สำหรับผู้ชมหน่วยความจำภายใน "รายการกระบวนการ" ของ Rosalina ของ Rosalina
• chan สำหรับ fatfs
• ทุกคนที่มีส่วนร่วมในที่เก็บ Luma3ds
• ทุกคนที่ได้รับความช่วยเหลือในการแก้ไขปัญหาผู้ใช้
• ทุกคนที่ให้ข้อเสนอแนะที่สร้างสรรค์แก่ LUMA3DS