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!).
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.
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
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
- This defines the splash type of the bootsplash(showen while waiting for the key)
- 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
- This configure if the logging to a log file is 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
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.
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.
####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.
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