THIS FAQ IS OUT OF DATE. AN UPDATE FAQ IS HERE

​

Since so many people have the same questions, I typed up an FAQ:
Please note this is simplified to be as understandable as possible. If you want something elaborated on I will add it as it's own question. This is just a general list of questions that I have seen being asked repeatedly over the past few weeks since the bootloader hack was leaked early.

Does my switch support Fusee Gelee/Atmosphere:

Spoiler

ALL SWITCHES SUPPORT THIS, ALL OF THEM. NO SERIOUSLY, STOP ASKING THE ANSWER IS YES. WE WILL LET YOU KNOW IF IT CHANGES.

What if I upgrade to the latest firmware:

Spoiler

ALL SWITCHES/FIRMWARE ARE SUPPORTED AT THIS TIME. IF YOU HAVE NEWER FIRMWARE 5.0+ IT ONLY MEANS THE EASY METHOD WILL TAKE LONGER TO BE RELEASED.

What about ... [insert question here]:

Spoiler

ALL SWITCHES/FIRMWARE ARE SUPPORTED AT THIS TIME. IF YOU HAVE NEWER FIRMWARE 5.0+ IT ONLY MEANS THE EASY METHOD WILL TAKE LONGER TO BE RELEASED.

What about Firmware [insert Firmware version here]:

Spoiler

ALL SWITCHES/FIRMWARE ARE SUPPORTED AT THIS TIME. IF YOU HAVE NEWER FIRMWARE 5.0+ IT ONLY MEANS THE EASY METHOD WILL TAKE LONGER TO BE RELEASED.

When will [insert name of thing here] be released?:

Spoiler

Soon TM. Note: Soon does not mean today, tomorrow, or even a month from now. Soon merely means whenever the hell the devs are done and it won't crash because you looked at it. Just like a road trip asking 100 times only pisses off the drivers, and they will turn this car around dammit.

Now onto the actual FAQ

List of TermsFirmware Versions FAQSwitch Modding General FAQReiNX FAQAtmosphere FAQFusee Gelee FAQLinux FAQ

1. 
   
   List of terms:​
   
   Cold Boot:
   Spoiler

   A method of booting a sytem that is not already powered on. Typically done when turning on your computer after shutting it down.
   Custom firmware (CFW):
   Spoiler

   Firmware that has been customized by the hacking community to extend functionality and allow users to run unsigned code on their device.
   Firmware (FW):
   Spoiler

   Firmware is the software that tells your device how to run. This is usually updated to provide new features/bug fixes.
   Hard Mod:
   Spoiler

   A method that uses a hardware modification to run arbitrary code. As it's name suggests it usually required modifying the Hardware and is also a Hard mod to do (usually). The nintendo swtich is lucky as it only requires bridging pin 10 to ground to allow privilege escalation.
   Hekate IPL:
   Spoiler

   Named after the God Hekate, it is a boot loader that allows you to choose what you want to boot your switch into (Horizon OS, Linux, Atmosphere, etc.). Still in development at this time
   Horizon:
   Spoiler

   The name of the firmware (OS) that runs on the switch, analogous to Windows 10 for PC or your favorite linux distro.
   NAND/eMMC:
   Spoiler

   The NAND is the storage of the Switch (think hard drive). In this case it is a 32GB eMMC module that is removable. However at this time we cannot upgrade the storage space as all components seem to be linked to the device (eMMC, screen, motherboard, etc.) This is used to store the firmware and games for the switch.
   NXLoader:
   Spoiler

   An Android app used to boot Fusee Gelee payloads from an android device. Required a USB OTG adapter and USB-A to USB-C cable. If your phone already has USB-C (congratulations) you just need a USB-C to USB-C cable.
   NSP:
   Spoiler

   A Nintendo eshop game format, similar to .cia files for the 3ds consoles.
   Payload:
   Spoiler

   Usually a ram binary that is loaded into the Switch's memory and then run. Can be used to run
   Privilege Escalation:
   Spoiler

   A method used to run code as a higher privileged user such as root or kernel. This is usually not possible since users run with limited privilege for security reasons.
   RCM:
   Spoiler

   Recovery mode of the switch analogous to DFU mode on iPhones or safe mode on your PC. Usually it is used to diagnose issues with hardware/software.
   RetroArch:
   Spoiler

   Software used to emulate older game systems so you can play their games.
   Signed code/Unsigned code:
   Spoiler

   Code from Nintendo is "signed" by a special key that only they should have access to. Unsigned code is not signed by this key and cannot run unless done so by an exploit (like custom firmware) or allowed by Nintendo.
   Soft Mod:
   Spoiler

   A method that uses software to modify your switch to allow for running unsigned code. It is usually an easier method than hard modding
   Tethered:
   Spoiler

   A term referencing the requirement of a host device to boot a compromised device, usually via a program to send a starting payload. Without this the device will either boot into the normal (not moddable) os or not boot at all until you have access to a computer.
   Vulkan:
   Spoiler

   An API Used by software to get better performance from GPU's. The driver for Linux on Switch is still being worked on at this time.
   Warm Boot:
   Spoiler

   A method of booting a system that is already powered on. Typically done during a reboot.
   XCI:
   Spoiler

   A Nintendo game card format, similar to .3ds files for the 3ds consoles
   
   
2. 
   
   Firmware Versions FAQ​
   
   
   What firmwares can I install homebrew on?:
   
   Spoiler

   Homebrew can be installed on Nintendo Switch system version 5.1.0 and below.
   What can I do with Firmware 1.0.0 to 1.0.0
   
   Spoiler

   Block Updates while waiting for CFW. You might also update without burning fuses.
   
   What can I do with Firmware 2.0.0 to 2.3.0
   
   Spoiler

   Block Updates and use ReiNX, RajNX, Atmosphere or SXOS CFW
   
   What can I do with Firmware 3.0.0 to 3.0.0
   
   Spoiler

   Block Updates and use ReiNX, RajNX, Atmosphere or SXOS CFW.
   
   What can I do with Firmware 3.0.1 to 5.1.0+
   
   Spoiler

   Block Updates and use ReiNX, RajNX, Atmosphere or SXOS CFW
   
   I’m on x.y.z but my new gamecart for botw/xenoblade/etc needs to update to a higher version what should I do?
   
   Spoiler

   You have one of two options.
   

   1. Do a fuseless upgrade.
   2. Find a gamecart with the appropriate update and try to update through that
   3. Find a gamecart of lower version out in the wild (buy another copy and see if it's cart 000 or 001, etc.)
   4. Update to the latest Firmware (Please no just wait it'll be worth it)
   5. Have patience and wait for CFW to make things better

   
   If you're not sure what FW a game requires you can reference this list --> List Games Required Firmware Version
3. 
   
   
   Switch Modding General FAQ​
   
   What is Hekate-IPL for 4.x and 5.x? Will it hurt my switch?
   
   Spoiler

   These are tethered methods of loading the Homebrew Launcher. They currently require us to boot via a host device such as a PC or Android through nxloader.
   
   THIS METHOD WILL NOT HARM YOUR SWITCH.
   
   However as with all mods if you don't know what you're doing wait for the noob friendly version. You always run a risk even if the risk is low. However, this boot method will not cause damage to your switch.
   
   If your switch is booted via this method and is allowed to go into sleep mode it will crash as Hekate-ipl does not support sleep mode at this time. If this happens just hold the power button for 15+ seconds, and it should turn on as normal. This will eventually be fixed but Hekate-ipl is a WIP
   
   When can I play/install backedup/pirated games?:
   
   Spoiler

   While GBATemp does allow for discussion of piracy, it doesn't condone it. There are two current methods of doing this. Paying for TX SX for XCI or use one of the free CFW's with Sigpatches for NSP files
   
   What is this Update Message Nag issue people have been reporting:
   
   Spoiler

   Nintendo has figured out a way to flip a switch on your switch making it nag you to update before you can even go online. The only systems not affected are those that are already on the latest firmware. For the time being put your Switch into airplane mode and keep it there until an update is made regarding this issue. At this time there is NO FIX.
   
   This issue seems to be separate from another similar issue and the devs are still working figuring out how this was done by Nintendo.
   
   What size SD Card should I get for CFW:
   
   Spoiler

   The recommended size is at MINIMUM 64GB. This is because while the SD card is SOLD as 32GB, the actual formatted amount is ~28-29GB. We will have to store an image on the SD card that is roughly 32GB in size, so no a 32GB card will not work. Personally I'd recommend you use at least 128GB as you must also have space to store games, homebrew, etc.
   
   Note: You should typically go for as large an SD card as you can afford.
   (I will add a list of known working cards that I know is floating around)
   
   Note 2: Fat32 can only store files upto 4gb per file
   
   Additionally if you want to boot linux, you should use a second SD card so you don't risk losing anything on your main one.
4. 
   
   ReiNX FAQ
   Coming Soon​
5. 
   
   Atmosphere FAQ​
   
   
   If I Update to firmware x.y.z will I lose access to Atmosphere/Fusee Gelee?:
   
   Spoiler

   Updating your switch will not prevent you from using Atmosphere/Fusee Gelee. It will just make doing so more difficult and involved.
   
   You should avoid updating as earlier versions of the Switch firmware have bugs that have been patched by Nintendo in later versions. These bugs make it easier to run Atmosphere/Fusee Gelee without the need for a hardware mod and a computer. In time all versions of the switch's firmware will be able to boot Atmosphere/Linux/Fusee Gelee Payloads without the use of a computer, this includes new versions not yet released. It will just take time for devs to update their code to work with those versions.
   
   More information will be given as the Devs working on Atmosphere and FG release more information.
   
   What is Atmosphere CFW?:
   
   Spoiler

   Atmosphere is what is called a Custom Firmware. It is a patched version of the firmware that is running on your switch. However, this version is run off of the SD card and supports all FW versions. At this time all firmware that runs on the switch supports atmosphere. This includes later firmware as the switch has a rather nasty hack that lets us crack the system wide open.
   
   What can Atmosphere Do?
   
   Spoiler

   Atmosphere can do everything your switch can currently do and more. However that more is where the fun begins.
   
   Atmosphere opens the switch to running unisgned third party code. Because of the amazing community that has been setup this means we have things like:
   
   

   • Run Retroarch an emulation program with support for a wide range of game consoles
   • Browse the web and watch youtube
   • Run third Party Games
   • Backup your game saves and restore them in case they are lost!!!
   • Run downloaded games

   
   But seriously guys the switch is shaping up to be one of the greatest portable emulation devices we have ever had. Even the PSP/Vita won't be as good once everything has matured. The switch is the device we all wanted in the backseat of the car on those long family trips. Nintendo has shown the switch's versatility in gaming and with homebrew on the switch through Atmsophere we will be seeing some amazing homebrew.
   
   When will Atmosphere CFW be released?:
   
   Spoiler

   Planned release: 15th of June.
   
   Bootable: 1-2 weeks (not for the end user).
   
   Can Atmosphere be patched?:
   
   Spoiler

   Nintendo CANNOT release an update that breaks Atmosphere. The vulnerability used is in the hardware of the switch and can only be fixed with different hardware being released. Think of how the original Xbox 360 didn't have an HDMI port, but later versions did. The older one couldn't add support through software, it required all new hardware to be released.
   
   Can Atosphere run signed code (Can atmosphere run games I already own?)
   
   Spoiler

   Atmosphere will be able to run signed code. More plainly Atmosphere will be able to run your gamecarts and eshop purchases without issue. All Atmosphere does is patch things to allow you to load the HBL (home brew launcher) without having to run a hack every time. It allows for execution of both signed and unsigned code.
   
   What is Trust Zone:
   
   Spoiler

   Arm TrustZone technology is a System on Chip (SoC) and CPU system-wide approach to security. TrustZone is hardware-based security built into SoCs by semiconductor chip designers who want to provide secure end points and a device root of trust. Jamis Vu and Deja Vu are the names of privilege escalation exploits that allows the user to run code as root or kernel. Usually unsigned code is prevented from being run, let alone as a more "priviledged user", but with TZ we are able to run such code. This is the exploit that will be used to launch Atmosphere. It currently works on all switches 1.0-4.x and has different names depending on the firmware version.
   
   At this time I know of no TZ exploit implementation for 5.0+, but I have heard that it is possible, it will just take time. This means that for now you anyone on 5.0+ rely on the JoyCon Mod to boot Atmosphere. This will probably change over time.
   
   What is Jamis Vu:
   
   Spoiler

   This is the name of the Trust Zone exploit implementation for FW 1.0.0. This will be used to launch Atmosphere when it is released.
   
   What is Deja Vu:
   
   Spoiler

   This is the name of the Trust Zone exploit implementation for FW 2.x-4.x. This will be used to launch Atmosphere when it is released.
6. 
   
   
   Fusee Gelee FAQ​
   
   
   What is FUSEE Gelee:
   
   Spoiler

   This is a hack that allows us to run just about any OS/CFW on the switch. It works by interrupting the boot process of the switch through use of a special RCM mode (think iPhone DFU/recovery mode) and then sending a different payload to be booted. Right now we require the use of a computer to then boot alternative software on the switch. This includes Linux, Atmosphere, ReiNX, RajNX and SXOS CFW. This flaw CANNOT BE PATCHED THROUGH FIRMWARE UPDATES. Only a new console release from Nintendo will solve this. Think of how the original Xbox 360 didn't have an HDMI port, but later versions did. The older one couldn't add support through software, it required all new hardware to be released.
   
   In order to Launch Fusee Gelee you need a pc (windows or linux) with USB 3.0 or 3.1+ (type-c connector) or a mac with usb 2.0+, and the FG launcher (link added when I can post links). You can also launch FG from a raspberry pi that has been set to run the launcher on a loop so you can just connect and boot. All methods will require either a USB-C to USB-C or USB-A to USB-C cable.
   
   What can I do with FUSEE Gelee:
   
   Spoiler

   - Dump your switch's internal memory/keys with one of the custom payloads
   - Boot Linux
   This list will be updated as new things come out. Atmosphere has not been released at this time and will be added once it has been.
   
   What is NXLoader:
   
   Spoiler

   NXLoader is an android application that allows you to boot Fusee Gelee payloads via an android device. You will still require a usb On-The-Go adapter and a USB-A to USB-C adapter. If your phone has USB-C already you just need a USB-C to USB-C cable and an android device.
   ((If information is missing from this section please let me know. I am an iPhone user so I haven't been paying much attention to this item.))
   
   What is the JoyCon Mod:
   
   Spoiler

   The JoyCon Mod is a reference to the bridging of pin 10 (closest to the back) on the RIGHT joycon's connector (on the switch) to ground (pins 1 or 7 without the joycon connected to the system). This pulls the pin low (low voltage) and in conjunction with pressing the volume up button at boot, is used to put the switch into RCM mode which is required for Fusee Gelee. This is like pressing the home button on an android or iPhone. It should not be confused with the home button on the right joycon which is more like the back button on android.
   
   You can also push pins 9 and 10 on the joycon itself together to short them. Note that this only works if you connect the joycon to the system as pin 9 on the connector is only ground when the joycon is docked on the switch. Otherwise you should ground pin 10 to pins 7 or 1 in order to get into RCM mode. This can be acheived through a joycon jig (insert link here) or through soldering specific points of the joycon.
   
   If you opt for the soldering option I'd recommend you put in a magnetic switch so you can activate the RCM by placing a magnet on the right joycon (link).
7. 
   
   
   Linux FAQ​
   
   
   What size SD Card should I get for Linux:
   
   Spoiler

   At this time no definitive size has been set for Linux on Switch. While any size above 4gb should work, I'd recommend any size 32gb and up.
   Keep in mind that if you are using linux to run emulators:
   1.) Performance is really spotty right now and there's a lot of stuff that doesn't work.
   2.) Games will need to be put on the SD card, which at this time is not an easy task unless you know about linux partitions and this will require space.
   
   Additionally if you want to use Atmosphere CFW I recommend you use a second SD card so you don't risk losing anything because of linux.
   
   What is this battery issue I keep seeing?:
   
   Spoiler

   Linux on the Switch is in it's extremly early days and not all things work on the switch. This includes complete power management. While we can put the GPU in high/medium/low power mode, there seems to be an issue where the Switch's original OS doesn't keep track of the battery while the Switch is running Linux. Because of this, when you're in Linux, the switch "loses track" of the battery's actual charge. This will be fixed in later releases, just give it time and avoid Linux unless you know what you're doing.
   
   What is this Linux SD Card issue I keep Seeing?:
   
   Spoiler

   Certain SD cards support transferring data that is apparently faster than the Switch can. There is a patch that forces faster cards to run slower so they can work, but at this time it is advised to just wait for a proper fix/solution.
   
   What actually works on Linux?:
   
   Spoiler

   • Wifi: Requires you to reboot linux and run the exploit again. Do not just force the console off with the power switch, have linux reboot.
   • Bluetooth: Works but JoyCons cannot be paired yet
   • Touchscreen: Works, but interface isn't friendly yet
   • GPU Acceleration: Works via mesa, with OpenGL (vulkan maybe?)
   • Volume Buttons: Works in Gnome, but doesn't do anything at this time

   Credit: Natinusala's thread on how to boot linux on your switch -> https://gbatemp.net/threads/quick-tuto-how-to-boot-linux-on-your-switch.501918/
   
   What doesn't work on Linux?:
   
   Spoiler

   • Power Management: See Battery issue, battery level working in Gnome.
   • Joycons: Not recognized
   • Audio: Not working
   • Power Button: no function, no sleep mode, no graceful shutdown (reboot works)
   • USB Support: No flash drives, mice, keyboards, controllers, ethernet as these all use USB. It is only used to boot into linux at this time.
   • Dock: Untested, doesn't do anything other than charge battery (No HDMI).

   Credit: Natinusala's thread on how to boot linux on your switch -> https://gbatemp.net/threads/quick-tuto-how-to-boot-linux-on-your-switch.501918/
   Note: This information for Linux may be out of date.
   

There are probably a lot of issues with this, and I will correct them in time. If you want a question added just let me know and I will add it. Links and pictures to relevant topics/guides/etc will be added when I have enough posts to do that XD.

@Adran_Marit is now maintaining this FAQ. Please ping my if anything is incorrect

 

[Deleted-442439]

THANK YOU! I was about to do this myself, now mods: Please pin this!

Also: Edit in a few things like that softmod through Deja Vu will be possible on 2.x-4.x and 1.0.0 with Jamais Vu instead of Fusee Gelee to get Atmosphere running.

 

[saneatsu]

THANK YOU! I was about to do this myself, now mods: Please pin this!

I was posting in that other question thread and I realized I can't get mad at people if I'm also not willing to help. I'm also in the unique position of having gone through this like four times already. PS2, Wii, PSP, PS3, 3DS, New 3DS, and now the Switch. Figured it was about time I used what I've learned to help make things clear.

 

[Deleted-442439]

@Issac can u pin this?

 

[itsjch]

sticky it fast oh the lords of gbatemp quickly~

 

[pofer]

Hahaha I loved the roadtrip example, the hacking scene is working so fast, I wouldn't be surprised if we see a beta release of atmosphere by the end of may

 

[karloz25]

Nice Job.

You should add: Jig, Nand, eMMC, ipl, NXLoader, and Raspberry Pi to your list of terms and relevance to the Switch.

 

[saneatsu]

THANK YOU! I was about to do this myself, now mods: Please pin this!

Also: Edit in a few things like that softmod through Deja Vu will be possible on 2.x-4.x and 1.0.0 with Jamais Vu instead of Fusee Gelee to get Atmosphere running.

I have edited them into the Atmosphere/Fusee Gelee/Trust Zone Section. I also added in information about the JoyCon Mod (Can't believe I forgot to add it)

I have also added a few things to vocab that i see people asking about as well as condensing it so it's in spoilers and isn't quite so long.

 

[saneatsu]

Nice Job.

You should add: Jig, Nand, eMMC, ipl, NXLoader, and Raspberry Pi to your list of terms and relevance to the Switch.

I've aded Nand/eMMC as one item since they're referencing the same thing, Hekate IPL was also added. NXLoader was added to the Fusee Gelee Section as well as the terms.

Not sure what you meant by jig (the joycon mod?).

I'm trying to keep this FAQ as focused as possible on the current status of switch hacking in relation to Atmosphere, Fusee Gelee, and Trust Zone. The RPI isn't required to hack the switch and everything you can do on the RPI can also be done on a PC which is why I've left it off the list. This isn't a guide to hacking your switch, there's plenty of those in the Tutorials section. All this is, is a quick list of common questions people should check before creating yet another thread.

 

[M7L7NK7]

Has anything been said about *-vu since the write up in Jan?

 

[saneatsu]

Has anything been said about *-vu since the write up in Jan?

Not that I’m aware. Not sure if it was released to github with the rest of the hacks as I believe it is a Horizon hack, not a bootrom hack. They may not want to burn the exploits if there’s the chance for them working on 5.0+, even partially (partial starting point is better than none).

 

[jose1209]

thanks, you but miss some things

-what is pegasus and what the difference ?
- does retroarch work with pegasus in what firmware ?
- what are the programs working on hbl and in what firmware
-does linux work with retroarch, dolphin what speed ? (many times asked)
-why do i care about fuse gelée, don't pegasus allow the cfw installation ?
-between firmwares what can we access in tursted zone from 1.0 >1.1 and <3.0 3.0 and > 3.0

etc...

 

[Imancol]

It's already boring to see more than 20 threads in a day on the same subject. Be serious Here there is already a state that each Firmware offers. https://gbatemp.net/threads/firmware-status.495078/

This thread is confusing because it does not clarify anything in the title if you are talking about Fusee Gelee.

 

[saneatsu]

thanks, you but miss some things

-what is pegasus and what the difference ?
- does retroarch work with pegasus in what firmware ?
- what are the programs working on hbl and in what firmware
-does linux work with retroarch, dolphin what speed ? (many times asked)
-why do i care about fuse gelée, don't pegasus allow the cfw installation ?
-between firmwares what can we access in tursted zone from 1.0 >1.1 and <3.0 3.0 and > 3.0

etc...

Roger and thanks for the input I will get them up soon. I left a lot of that out since my switch is 4.0.1 thus no pegaswitch. I will however read up and add them in accordingly.

 

[saneatsu]

It's already boring to see more than 20 threads in a day on the same subject. Be serious Here there is already a state that each Firmware offers. https://gbatemp.net/threads/firmware-status.495078/

This thread is confusing because it does not clarify anything in the title if you are talking about Fusee Gelee.

This thread is 1.) not just about Fusee Gelee. 2.) Did you even read my post? 3.) Is not meant to be a guide, just a place where common questions get answered in a consolidated fashion. 4.) Seriously, did you even read my actual post or did you scroll down to the end skimming along the way then posted saying it's confusing?


I can only figure that you saw all my spoilers keeping things tidy and no questions or answers so I will be putting things back to the way they were so it's expanded by default and hopefully this clears things up.

 

[flametorrent]

You should rename this thread to “Switch Guide for Free Games! CFW install guide.”

That’ll get the people asking the constant questions about current status and “is it safe to update” to actually click on this lolol

 

[zzzzBeatz]

I could feel the arrogance while trying to read the answers given in this faq. Also, they had a "I am fed up, GOT IT" vibe to them. Maybe it's time for a new hobby? Or is the intensive swearing part of the things newcommers should be aware of? No offense but, even if this was pinned, I'd rather get the info in other threads.

 

[jinx10000]

I think this is great.

I don't think the specific section about Deja Vu was updated to include higher firmwares.

Also, I think you already had this plan once you can post links. It might be good to link to other well answered conversations/tutorials, etc... in each answer . I think the purpose of this thread is to prevent people who refuse to search from opening a new thread.

Hope you can keep it updated at the speed everything is moving in this scene.

 

[Imancol]

This thread is 1.) not just about Fusee Gelee. 2.) Did you even read my post? 3.) Is not meant to be a guide, just a place where common questions get answered in a consolidated fashion. 4.) Seriously, did you even read my actual post or did you scroll down to the end skimming along the way then posted saying it's confusing?


I can only figure that you saw all my spoilers keeping things tidy and no questions or answers so I will be putting things back to the way they were so it's expanded by default and hopefully this clears things up.

Well hopefully some moderator add this thread to the sticky ones and remove the previous one. Because there are too many threads trying to give news. The truth is only interested in Fusee Gelee and I did not read the whole topic, but because they are questions and answers, it is to do them if they have a different result for each type of exploit. In my case I would make a thread in which I would talk about each version of FW and the advantages, disadvantages of being there. Like that sticky link that comments.

 

[nWo]

This is easy to understand and covers almost everything. Great job man

--------------------- MERGED ---------------------------

Pin this!!!