Homebrew Tutorial
Updated
Ultimate guide to upgrade your firmware/Atmosphère
ONLY UPDATE YOUR CONSOLE TO 21.x.x IF ALL THE HOMEBREW YOU USE IS UPGRADED
Sometimes you need to upgrade your console, upgrade the firmware or upgrade Atmosphère, using the @l7777 's guide (https://gbatemp.net/threads/updating-hekate-atmosphere-and-hos.631739/) as base I hope to create a list of necessary steps to successful upgrade your console.
This guide uses Hekate, if you don't want to use Hekate skip the steps about it. You may loose some features.
Make a backup.
Always make a full backup of your console, so if something goes wrong you have a know working restore point.
- If you are going to update your SysNAND you can create a backup using Hekate's NYX, It's the easy way.
- For your EmuNAND there are two paths:
- If your EmuNAND is RAW based, you can use a tool like EmuTool (EmuTool GitHub) to backup the RAW partition to a set of files on your PC. That backup can be used later to restore the RAW partition or you can convert your setup to File based EmuNAND using that files.
- If your EmuNAND is file based, making a backup is so easy as copying the
SDMC:/emuMMCfolder to your PC.
Also is advisable to backup all files on your SD Card, You can Use Hekate's UMS for that task, so you don't remove the SD from Console and avoid the problem associated to manipulating the SD card.
Preparation.
Before you start the process you need some steps:- Download latest Atmosphère files, download again from the GitHub repo no matters if you think you have it, sometimes the repo is silent updated.
- Download latest Hekate files, download again from the GitHub repo no matters if you think you have it, sometimes the repo is silent updated.
- Download latest Sigpatches from the GBATemp Thread no matters if you think you have the newest, they might be upgraded.
- Download latest Sys-Patch Sysmodule some people tells is redundant but is better be safe than sorry
- If you are going to upgrade your firmware, remove any theme you have installed! NX-Themeinstaller now have a option to remove all installed themes.
- You can get a legally acquired firmware files:
- By example dumping them from another console using homebrew like: Switch Firmware Dumper, The most recent version can be downloaded from:
- Or DBI
- Also a search engine can help you to find a correct backup, by example Firmware 18.1.0 rebootless have an ID of e7e2b68
Starting the process.
Restart your console to Hekate's NYX and load UMS tool, or remove the card and put on your PC, is up to you, Hakate may be a little bit slower but you do not risk physically your console.- Delete
SDMC:/atmosphere/contentsorSDMC:/atmosphere/titles, you should have backed up this folder before. - Delete the next folders, that's because the first time you load new Atmosphère that folders will emptied and that can take a lot of time so you could think your console got frozen, so in order to avoid that false alarm it's better to delete them before start console.
SDMC:/atmosphere/crash_reportsSDMC:/atmosphere/erpt_reportsSDMC:/atmosphere/fatal_reports
- If you had used INCOGNITO_RCM, is advisable to remove incognito from yours *NAND, having PRODINFO blanked via Incognito RCM can create problems on the new firmware/atmosphère versions.
- Extract Atmosphère zip file and copy to the root of your SD, overwrite all files.
ProdInfo Blanked
If you like to kept your prodinfo blanked, restore and edit your
SDMC:/exosphere.ini file and add/change the next values to «1» in order to enable Atmosphère incognito on telemetry:
Code:
blank_prodinfo_sysmmc=1
blank_prodinfo_emummc=1DNS MiTM
Now to enable DNSMiTM, you need to restore your
SDMC:/atmosphere/config/system_settings.ini file from backup, or copy the one from SDMC:/atmosphere/config_template/system_settings.ini and be sure the parameter enable_dns_mitm , enable_dns_mitm_debug_log and add_defaults_to_dns_hosts have the value u8!0x1 Also be sure you remove the «;» at start of the line. By example, your file should be something like:
Code:
[atmosphere]
.
.
.
enable_dns_mitm = u8!0x1
; Controls whether dns.mitm uses the default redirections in addition to
; whatever is specified in the user's hosts file.
; 0 = Disabled (use hosts file contents), 1 = Enabled (use defaults and hosts file contents)
add_defaults_to_dns_hosts = u8!0x1
; Controls whether dns.mitm logs to the sd card for debugging
; 0 = Disabled, 1 = Enabled
enable_dns_mitm_debug_log = u8!0x1
; Controls whether htc is enabled
; 0 = Disabled, 1 = Enabled
.
.
.Where the dots represent other text.
Other Atmosphère Configs
Restore your
SDMC:/atmosphere/config/override_config.ini (Key combos for atmosphère) & SDMC:/atmosphere/config/stratosphere.ini (Disable game cartdrige) files.Hekate
- Extract the downloaded Hekate zip file, and copy to the root of your SD, overwrite all files.
- Upgrade your payload.bin file, if you use a injector on the injector, if you use a modchip replacing the file
SDMC:/payload.binfile, if you use Hekate rename the filehekate_ctcaer_X.Y.Z.binto payload.bin and copy to root of your SDCard. - Restore YOUR OWN CUSTOMIZED
SDMC:/bootloader/hekate_ipl.inifile from the backup you did before. if is necessary remove anykip1patch=nosigchkline on it because you are not usingpatches.iniso far.
Or if you like to use it on your console, download latest Sigpatches archive from the post indicated on the thread, but copy only the fileSDMC:/bootloader/patches.iniand do not remove the lines on yourhekate_ipl.ini. this is not necessary.
Sigpatches
- Download latest Sys-Patch Sysmodule from the Downloads section EVEN IF YOU THINK YOU HAVE IT, sometimes is silently updated
- Download latest NX-OVLLoader sysmodule from the official Github, EVEN IF YOU THINK YOU HAVE IT, sometimes is silently updated
- Download latest UltraHand Overlay from the official Github, EVEN IF YOU THINK YOU HAVE IT, sometimes is silently updated
- Extract the sigpatches file and copy to the root of your SD Card, overwrite all files.
- Etract the Sys-Patch zip file and copy to the root of your SD Card, overwrite all files.
- Create a folder on your SD Card and copy on it the extracted files for the firmware.
Testing the console
Put the card or turn off the console, then start your console as usual and let the HOS to load.
If everything load fine you can now upgrade your firmware or go to next step.
In order to upgrade your firmware, load Homebrew Loader (HBmenu) and run Daybreak. it's better to select «install (FAT32 + exFAT)» option, on this way if anytime you insert a SD card formatted on exFAT you will avoid an error. This option only install additional drivers but DO NOT modify your card. Be sure of select «Preserve settings» if you like to preserve your games and configuration.
Your console will restart once the process end.
Test your installed titles and verify some games to run OK.
Finishing the setup.
After you know your console boots correctly and everything is fine now you can reinstall SYSMODULES, cheats, and modifications. you can choose restore them from your
SDMC:/atmosphere/contents backup or I do recommend to look if there is any newer version.
Other common SYSmodules are, Emuiibo, Mission Control, FTPD, etc.
Remember to restart your console once you upgraded any SYSMODULE
Take a time and look for updated version of your Homebrew.
If you use themes look if there are new versions of NXThemesInstaller and the patches needed to install them, after update all components, reinstall your themes.
Important note for Mac Users:
Macintosh OSes and IOS have a disgusting tendency to no adhere to standards so if you handle your card on a Mac, be sure to boot in to NYX and on tools tab select «Unset archive bit» AND «Fix archive bit - Nintendo»
More information about the upgrade process:
Last edited by impeeza,
