Skip to content

tombomb/BootCtr9

 
 

Repository files navigation

BootCTR9 - Arm9LoaderHax with bootloader for Nintendo 3DS

Explanation

This is my port of BootCTR9 to arm9loaderhax. There are two way to start it, the modded version of arm9loaderhax, or the bootloader loader arm9loaderhax.bin. The arm9loaderhaxmod is based on delibles implementation of the arm9loaderhax exploit, documented here and also presented in this conference, which provides ARM9 code execution directly at the console boot, exploiting a vulnerability present in 9.6+ version of New3DS arm9loader.

It works on both New and OLD 3DS.

The Arm9LoaderHax exploit was found by plutoo and yellows8, i do not own the idea. The original BootCTR was developed by m45t3r Screen_init was implemented by dark-samus pull request (thank you!).

Usage

Arm9loaderhax mod

While also having support to load a "arm9loaderhax.bin" as fallback, it normaly loads the "arm9bootloader.bin" from you SDs "arm9loaderhax" folder, or directly out of your root directory. It will try it in the following order: "arm9loaderhax/arm9bootloader.bin" -> "arm9bootloader.bin" -> "arm9loaderhax.bin"

The arm9bootloader.bin will be loaded to address 0x24F00000, while the arm9loaderhax.bin arm9 payload will be loaded at address 0x23F00000.

If none of the files is found, the console will shut down.

Bootloader loader

This version is for all people who installed the normal arm9loaderhax. Its an arm9loaderhax.bin which is doing the same as the arm9loaderhax mod, exept it doesn't support the arm9loaderhax.bin fallback loading(since this would result in a recursiv try to load itself) and doesn't do the screen initialization. Simply copy it to the root of your sd-card and it will be usable

BootCTR9

After you set up one of the above loaders, you can start setting up BootCTR9. For this simply copy the "arm9bootloader.bin" and a "boot_config.ini" to your sd-cards "arm9loaderhax" or root folder. While beeing backwardcompatible to BootCTRs "boot_config.ini", some additional settings got added. These are the following for the payload configurations:

  • screenEnabled
    • This configures, if the screen shoud be enabled before jumping to the payload(default is 1)
    • If its set to 0 while the screen was initalized before, the screen will be disabled before jumping to the payload

Also there is a new configuration section named "BOOTCTR9". This section includes some BootCTR9 only configurations:

  • key_delay
    • This sets the time in ms BootCTR9 waits for a key
  • boot_splash
    • This defines the splash type of the bootsplash(showen while waiting for the key)
      • 0 -> Disabled
      • 1 -> Splash Image
      • 2 -> Ascii Splash
  • boot_splash_image
    • This defines the path, with filename, of the bootsplash.
  • fileLog
    • This configure if the logging to a log file is enabled
      • 0 -> disabled
      • 1 -> enabled
  • screenLog
    • This is the same as fileLog, but the log is showen on the bottom screen, instead of written to a file
  • screenEnabled
    • This configures if the screen should be enabled directly at boot
  • screenBrightness
    • This configures the brightness that us used for screen initialisation

How do I update it?

Installation arm9loaderhax mod

After the compilation you'll have three files in the data_output directory:

  • arm9loaderhax.3dsx
  • arm9loaderhax.bin
  • arm9loaderhax.pack

The .pack file contains all the content that will be installed (in case of a full package, your console-unique data too), and has to be placed in the root of your SD card.

The .bin file is an indipendent payload that can be launched from Brahma2, CakeHax, Arm9LoaderHax itself (mainly for update the exploit), and so on. It is the installeing software, once you find your way to launch it, just follow the instruction.

The .3dsx file is a pre-buildt Brahma2 3dsx that can be launched on consoles with firmware below 9.2 through the Homebrew Launcher. It is a loader for the .bin file, wich is included in the 3dsx.

Software Update

When some essential parts of the software will be released, you'll be able to update your setup with the installer by using .pack files that i will provide in future releases.

Setup

####Required Files Some files are needed in order to make the setup compilable, be sure to put the following files in the data_input folder, you have to find them on your own:

Name Description SHA-256
new3ds10.firm New3DS NATIVE_FIRM from system version 10.2. d253c1cc0a5ffac6b383dac1827cfb3b2d3d566c6a1a8e5254e389c2950623e5
new3ds90.firm New3DS NATIVE_FIRM from system version 9.0. d7be76e1813f398dcea85572d0c058f7954761a1d5ea03b5eb5047ac63ac5d6b
secret_sector.bin The New 3DS secret 0x96 key sector. 82f2730d2c2da3f30165f987fdccac5cbab24b4e5f65c981cd7be6f438e6d9d3
otp.bin A dump of your console OTP data from region 0x10012000-0x10012100. Using other console's OTP will result in a brick.

####Required Enviroment

  • devkitARM r45
  • libctru (ver. 1.0.0)
  • Python 2.7 with PyCcrypto
  • GCC or MinGW (Only needed to compile the buildt-in tool, you can download a pre-compiled windows build here, place it in common folder)

####Compilation Modes

  • make : This will compile all the files
  • make hax : This will skip the 3DSX installer compilation
  • make stage2_update : This will generate an updater pack with only the secondary payload, mainly for updating the exploit files.

Credits

Copyright 2016, Jason Dellaluce

Licensed under GPLv2 or any later version, refer to the license.txt file included.

  • Smealum and contributors for libctru
  • Normmatt for sdmmc.c and .h, and also for .ld files and the log from XDS by ichfly that provided us some of the information needed to get screen init
  • Christophe Devine for the SHA codes
  • Archshift for i2c.c and .h
  • Megazig for crypto.c and .h
  • Patois for original BRAHMA code
  • Smealum, Derrek, Plutoo for publishing the exploit
  • Yellows8 and Plutoo as ideators of it
  • 3dbrew community
  • bilis/b1l1s for his screen init code, and work on inegrating it into stage 2
  • dark_samus for work on integrating screen init into stage 2

About

3DS ARM9 code execution at boot

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 97.1%
  • C++ 2.0%
  • Other 0.9%