Skip to content

Instantly share code, notes, and snippets.

@NicholeMattera
Last active June 19, 2019 17:18
Show Gist options
  • Save NicholeMattera/47174b4cfd583820e312039927a304be to your computer and use it in GitHub Desktop.
Save NicholeMattera/47174b4cfd583820e312039927a304be to your computer and use it in GitHub Desktop.
emuMMC Setup Tutorial

You are continuing at your own risk. I am not responsible for any harm that may happen to your device(s) or data by following this tutorial.

First off before anything you should expect to have issues. emuMMC is still in beta and is not perfect. It is recommended if you are not an advance user then you should wait for everything to be polished and released officially. This guide assumes you are using Linux. if you don't have Linux installed you can use a live CD, and if you don't know how to use Linux then it's recommended that you wait for Hekate. If you run into problems make sure to use the search box in Discord on either the Team AtlasNX or the ReSwitched servers. It's possible other people have ran into the same problem as you and it has been addressed. If your problem hasn't already been addressed then please do not ask in general or switch-hacking-meta rooms, instead use the support rooms.

  1. You will first want to create a backup of your switch's boot0, boot1, and emmc if you don't already have one. This will be used to create your emuMMC. You can create a backup in a few different ways, however the easiest way is with Hekate. (I will not go through this and assume you know how to do this.)
  2. Once you have your backup on your computer you should have three or more files. You will want to concatenate them altogether with boot0 being first, then boot1, and then rawnand. In linux you can do this with the following command cat BOOT0 BOOT1 `rawnand file(s) go here` > emummc. This will take some time and the resulting file size should be 31,276,924,928 bytes.
  3. Insert the SD Card you wish to install emuMMC to into your computer.
  4. Copy everything off of your SD Card to your computer.
  5. Start gparted and select your SD Card. (TRIPLE CHECK THAT YOU ARE ACTUALLY SELECTING YOUR SD CARD!)
  6. Delete all the partitions.
  7. Create your main Fat32 partition making sure it's at the beginning of your drive and the file system is Fat32. You can figure out the size of it by using the following formula:

Main partition size = size of your SD Card in MiB - 29828 * number of emuMMCs you want

  1. Create your emmMMC partition(s). The size should be 29828 and the file system should be unformatted.
  2. Apply the operations.
  3. At this point I recommend you copy all the stuff that was on your SD Card back to it and test it out on your Switch just to make sure everything still works.
  4. If everything worked correctly then lets create the emummc config file. Create a folder on the root of your SD Card called emummc.
  5. Create a file called emummc.ini inside the folder you just created and make sure it looks like the following:
[emummc]
emummc_enabled = 1
emummc_sector = 
emummc_id = 0x0001
  1. To get the value for emummc_sector you will want to open gparted again, select your SD card, right click on your emuMMC partition, select information, copy the number next to First sector:, and paste that into google and append it with " to hex". You will want to copy that value paste it into your ini file. (Ex. emummc_sector = 0x161800)
  2. Not sure if this is needed, but I copied the Nintendo folder from the root to the emummc folder and renamed it Nintendo_0001. You can do this for each of your emuMMCs you are creating.
  3. Now with everything configured we need to actually write our emuMMC to our SD Card. We need to identify the device name of our emuMMC partition. To do this you can run lsblk in a command prompt or if you still have gparted open it will be on the block diagram as /dev/sd*# where the star is a letter and the pound is a number.
  4. Once you have that information you can run the following command. It is imperative that you have the correct device as this will write the data directly to that device. There is no going back from this. Once you are absolutely sure then you can run the following: sudo dd if=`path to emummc file we created in step 2` of=/dev/sd*# bs=512 status=progress
  5. Once that is done you should be able to eject your SD Card, put it into your switch, inject fusee-primary and enjoy emuMMC. Remember if you run into any problems then double check everything here. If you are still having issues then search the discord servers mentioned above. If you still can't find a solution then ask in the support rooms for help and be patient.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment