Mirror/Luma3DS
1
0
Fork 0
mirror of https://github.com/LumaTeam/Luma3DS.git synced 2026-02-22 01:44:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

overhaul part 1

Yuuki Hikari 2017-11-22 15:55:03 -05:00
parent d86b67b986
commit 49667733a5
1 changed files with 27 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
Installation-and-upgrade.md

@ -1,18 +1,34 @@
## Installing
## Installation
![ZIP Contents](http://i.imgur.com/cULW6Yi.png)
1. **As of Luma3DS v8.0, [boot9strap v1.2](https://github.com/SciresM/boot9strap/releases/latest) is required for usage and all previous entrypoints are no longer supported.**
Refer to [this](https://3ds.guide/https://3ds.guide/a9lh-to-b9s) for information on how to update from arm9loaderhax, or
start from [here](http://3ds.guide) if you do not yet have arm9loaderhax or boot9strap.
1. Download the latest version of Luma3DS from [here](https://github.com/AuroraWright/Luma3DS/releases/latest). The file you want to download is `Luma3DSvX.X(.X).7z`, **not** `Source code (zip)` or `Source code (tar.gz)`!
1. Extract `boot.firm` from the `Luma3DSvX.X(.X).7z` archive with a tool like [7-zip (Windows/Linux)](http://www.7-zip.org) or [Unarchiver (macOS)](https://itunes.apple.com/us/app/the-unarchiver/id425424353?mt=12) to the root of your 3DS' SD card. If your 3DS will not power on after this step or you get an "Unsupported loader" error, please try [updating boot9strap](https://3ds.guide/updating-b9s).
1. **Optional:** Follow "Section VI - CTRNAND Luma3DS" [here](https://3ds.guide/finalizing-setup). This will allow you to boot your 3DS without having an SD card inserted.
- Always copy `boot.firm` to the root of the SD. You **don't need** to do anything else if you're using boot9strap.
## Upgrading
To boot 3.x-4.x NANDs, you need to load FIRM from the SD card.
Download [this file](http://nus.cdn.c.shop.nintendowifi.net/ccs/download/0004013800000002/00000056) and rename it to `firmware.bin`, then [this other file](http://nus.cdn.c.shop.nintendowifi.net/ccs/download/0004013800000002/cetk) and rename it to `cetk`, then copy both of them to the `luma` folder.
1. You can manually update Luma3DS by repeating "Installation" above, but we recommend using [KunoichiZ's fork of Hamcha's LumaUpdate](https://github.com/KunoichiZ/lumaupdate/releases/latest).
1. To install LumaUpdate, you must have [FBI](https://github.com/Steveice10/FBI) installed on your 3DS.
1. After getting FBI, you can install LumaUpdate by navigating to Remote Install>Scan QR Code and scanning the QR code on the LumaUpdate releases page. **This requires an internet connection on your 3DS.** If you do not have one, download the CIA (or ZIP if you'd like to use the 3DSX version instead) manually and copy the CIA file to your 3DS' SD card, and install it with FBI manually.
1. If you want to use the 3DSX version of LumaUpdate instead of the CIA, download the ZIP archive on the LumaUpdate releases page and extract the "3ds" folder to the root of your SD card. You can then launch LumaUpdate from the [Homebrew Menu](https://github.com/fincs/new-hbmenu).
1. Once you have LumaUpdate installed, launch it from the Home Menu. To update Luma, selecting "Install stable version" and press "A". If this is your first time using LumaUpdate, it will ask you if want to enable CTRNAND Luma updating. This is up to you, but we highly recommend enabling it. **LumaUpdate requires an internet connection on your 3DS.**
**As of Luma3DS 7.1, boot9strap is required for usage and all previous entrypoints are no longer supported.**
Refer to [this](https://3ds.guide/updating-to-boot9strap) for information on how to update from arm9loaderhax, or
start from [here](http://3ds.guide) if you do not yet have arm9loaderhax or boot9strap
## Troubleshooting
>"My 3DS shows a blue light for a second or two and then turns off/shows "unsupported loader" on the screen! What do I do?!"
Versions of Luma v8.0 and above require [boot9strap v1.2](https://github.com/SciresM/boot9strap/releases/latest) or higher. Please try updating your boot9strap installation [here](https://3ds.guide/updating-b9s). Additionally, while third party bootloaders exist, we cannot guarantee compatibility with them; boot9strap is the **only** officially supported and recommended entrypoint.
>"I got a network error installing LumaUpdate or updating Luma!"
Make sure your 3DS is connected to the internet.
>"Some features that Luma3DS claims to have don't work for me!"
Are you on a firmware lower than 4.0.0? Many patches done by Luma are unsupported on firmwares below 4.0.0. With boot9strap and Luma3DS, there are no consequences when updating to the latest firmware, so we highly recommend doing so. If you are on the latest firmware, please try following the documentation detailing the feature you're having issues with more closely. This documentation can be found on the [options and usage](https://github.com/AuroraWright/Luma3DS/wiki/Options-and-usage), [other features and notes](https://github.com/AuroraWright/Luma3DS/wiki/Other-features-and-notes), and [Rosalina](https://github.com/AuroraWright/Luma3DS/wiki/Rosalina) pages.
---
## (Optional - **NOT RECOMMENDED**) Making Luma3DS work with an external boot manager
While it is not recommended to use a boot manager (such as BootCtr9) to load Luma3DS as it tends to cause strange issues due to the nonstandard environments these managers setup, Luma3DS can be used with one. As of the release of boot9strap and Luma3DS 8.0, the payload's path should be passed by the chainloader, thus custom path support was removed from Luma. If you are not able boot into NDS or GBA VC games while using an external boot manager, this is not an issue with Luma, but rather, the boot manager itself. In this scenario, contact said boot manager's developer and tell them that it does not pass the payload paths properly.
If you have an issue not listed here, it may be listed in Plailect's [troubleshooting guide](https://3ds.guide/troubleshooting).