You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
rewrote parts of the updating guide, rewrote/retouched majority of the sdtransfer guide, updated links on tesla menu/nx-shell pages, rewrotesome info on partitioning pages in main guide
Copy file name to clipboardExpand all lines: docs/extras/transfer_sd.md
+74-31Lines changed: 74 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ The goal of this page is to transfer the contents from one microSD card to anoth
4
4
5
5
We will be using [hekate](https://github.com/CTCaer/hekate/releases/) to both backup and restore the emuMMC, so make sure that you have its latest files on your microSD card already.
6
6
7
-
##Instructions:
7
+
### Checking whether you have a Partition or File based emuMMC:
8
8
9
9
You should first check whether you have a file or partition based emuMMC:
10
10
@@ -13,25 +13,15 @@ You should first check whether you have a file or partition based emuMMC:
13
13
1. Tap on the `emuMMC` button.
14
14
1. Under `emuMMC Info & Selection`, check the text next to `Type`.
15
15
- If you have one it should be either `SD Raw Partition` or `SD File`.
16
+
- If you have no emuMMC, it'll be disabled.
17
+
18
+
#### Depending on if you're using a Partition based emuMMC or File based emuMMC/no emuMMC at all, click the corresponding tab below:
16
19
17
-
-----
18
-
19
-
### If you are using a file based emuMMC or are using no emuMMC at all:
20
-
21
-
1. Enter RCM and inject the hekate payload.
22
-
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your microSD card.
23
-
1. Navigate to `Tools` > `USB Tools` > `SD Card` and plug your Switch into your PC via USB.
24
-
1. Copy the contents of your microSD card somewhere to your PC.
25
-
1. Access your new microSD card via a microSD card reader or similar.
26
-
1. Format your new microSD card to FAT32 if it isn’t already.
27
-
- To do this, use [this guide](https://wiki.hacks.guide/wiki/Formatting_an_SD_card).
28
-
1. Copy the files from your PC or directly from your old microSD card to your new microSD card.
29
-
1. Eject the `UMS` device safely from within your computer's operating system.
30
-
1. Boot into hekate and launch your desired boot entry.
20
+
<br>
31
21
32
-
-----
22
+
::::: tabs
33
23
34
-
### If you are using a partition based emuMMC:
24
+
:::: tab default Partition based emuMMC
35
25
36
26
::: warning
37
27
@@ -41,22 +31,75 @@ You need at least 30GB (or 60GB if using an OLED Switch) of free space to be abl
41
31
42
32
:::
43
33
44
-
1. Enter RCM and inject the hekate payload.
45
-
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your SD.
46
-
1. In the main menu, tap on `Tools`, then `Backup eMMC` and set `SD emuMMC Raw Partition` at the bottom of your screen to `ON`.
34
+
#### What you need:
35
+
36
+
- The latest version of [hekate](https://github.com/CTCaer/Hekate/releases/) (`hekate_ctcaer_(version).zip`).
37
+
38
+
#### On your OLD microSD card:
39
+
40
+
1. Enter RCM and inject the hekate payload.
41
+
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your microSD card.
42
+
1. From hekate's `Home` menu, navigate to `Tools` > `Backup eMMC`, set `SD EmuMMC Raw Partition` at the bottom of your screen to `ON`.
47
43
1. Backup both `SD emuMMC BOOT0 & BOOT1` and `SD emuMMC RAW GPP` (Note: `SD emuMMC RAW GPP` may take a while).
48
44
1. Once both are done, go back to the main menu, navigate to `Tools` > `USB Tools` > `SD Card` and plug your Switch into your PC via USB.
49
45
1. If Windows asks you to format a drive, discard it and open the accessible drive containing the contents of your microSD card.
50
46
1. Copy the contents of your old microSD card somewhere to your PC.
51
-
1. Follow the `Preparing hekate` section at the bottom of [this page](../user_guide/rcm/sending_payload) (Unpatched Switch users only) to prepare your new SD card with hekate's files.
52
-
- If you have a modchipped Switch, follow [this page](../user_guide/modchip/preparing_hekate) instead.
53
-
1. Follow only steps 1-3 on [this page](../user_guide/all/partitioning_sd) to partition the new microSD card for an emuMMC setup.
54
-
1. After it’s done, boot into hekate and navigate to `Tools` > `USB Tools` > `SD Card`, then plug your Switch into your PC via USB.
55
-
1. Copy the backup you made of your old microSD card on your PC to your new microSD card.
56
-
1. Navigate to `/backup/<some characters>/emummc` on your microSD card and move `BOOT0`, `BOOT1` and the `rawnand.bin.xx` files to `/backup/<some characters>/restore/emummc`.
57
-
1. Eject the `UMS` device safely from within your computer's operating system.
58
-
1. Tap on `Tools`, `Restore eMMC`, set `SD emuMMC Raw Partition` at the bottom of your screen to `ON`.
59
-
1. Restore the backup by tapping on both `SD emuMMC BOOT0 & BOOT1` and `SD emuMMC RAW GPP` (Note: `SD emuMMC RAW GPP` may take a while).
60
-
- It is very important that for both of these the `SD emuMMC Raw Partition` option is enabled, otherwise you will be altering your sysMMC
47
+
48
+
-----
49
+
50
+
#### On your NEW microSD card:
51
+
52
+
1. Copy the *contents* of the previously downloaded hekate `.zip` to the root of your new microSD card.
53
+
1. Enter RCM and inject the hekate payload.
54
+
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your microSD card.
55
+
1. Navigate to `Tools` > `Partition SD card` once in hekate/Nyx.
56
+
1. Set the `emuMMC (RAW)` slider to `29 FULL` in the middle of the bar.
57
+
- Set the `emuMMC (RAW)` slider to `58 FULL` if you're on an OLED Switch.
58
+
- If you wish to install Android and/or Linux later, partition your microSD card here accordingly by moving the sliders you see during this step. We recommend setting the `Android (USER)` and `Linux (EXT4)` sliders to at least 16GB.
59
+
1. Navigate to `Next Step` at the bottom right, then select `Start` in the menu that appears.
60
+
- For Android; Select `Dynamic` partitioning for Android 13+ and `Legacy` partitioning for Android 10/11. Note that Android 10/11 are no longer supported, Legacy and Dynamic partitioning are also **NOT** intercompatible.
61
+
1. After it’s done, return to hekate's `Home` menu and navigate to `Tools` > `USB Tools` > `SD Card`, then plug your Switch into your PC via USB.
62
+
1. Copy the backup you made of your old microSD card on your PC to your new microSD card, replacing files if/when prompted.
63
+
1. Navigate to `/backup/<some characters>/emummc` on your new microSD card and move `BOOT0`, `BOOT1` and the `rawnand.bin.xx` files to `/backup/<some characters>/restore/emummc`.
64
+
1. Eject the `UMS` device safely from within your computer's operating system.
65
+
1. From hekate's `Home` menu, navigate to `Tools` > `Restore eMMC`, set `SD EmuMMC Raw Partition` at the bottom of your screen to `ON`.
66
+
1. Restore the backup by tapping on both `SD emuMMC BOOT0 & BOOT1` and `SD emuMMC RAW GPP` (Note: `SD emuMMC RAW GPP` may take a while).
67
+
- It's important that for both of these options the `SD emuMMC Raw Partition` option is enabled, otherwise you could be altering your sysMMC
61
68
which is not what you want.
62
-
1. Your emuMMC is now restored on the new microSD card and you should be able to launch it from `Launch` -> `Atmosphere PKG3 emuMMC` in hekate.
69
+
1. Your emuMMC is now restored on the new microSD card and you should be able to launch it from `Launch` -> `Atmosphere PKG3 emuMMC` in hekate.
70
+
71
+
::::
72
+
73
+
:::: tab File based emuMMC/no emuMMC at all
74
+
75
+
#### What you need:
76
+
77
+
- The latest version of [hekate](https://github.com/CTCaer/Hekate/releases/) (`hekate_ctcaer_(version).zip`).
78
+
79
+
#### On your OLD microSD card:
80
+
81
+
1. Enter RCM and inject the hekate payload.
82
+
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your microSD card.
83
+
1. Navigate to `Tools` > `USB Tools` > `SD Card` and plug your Switch into your PC via USB.
84
+
1. Copy the contents of your microSD card somewhere to your PC.
85
+
86
+
-----
87
+
88
+
#### On your NEW microSD card:
89
+
90
+
1. Copy the *contents* of the previously downloaded hekate `.zip` to the root of your new microSD card.
91
+
1. Enter RCM and inject the hekate payload.
92
+
- If you use a modchipped Switch, you can simply just turn your Switch on with the hekate payload renamed to `payload.bin` on the root of your microSD card.
93
+
1. Format your new microSD card to FAT32 using hekate. To do so, navigate to `Tools` > `Partition SD card` once in hekate/Nyx.
94
+
1. Leave all sliders on their default values.
95
+
- If you wish to install Android and/or Linux later, partition your microSD card here accordingly by moving the sliders you see during this step. We recommend setting the `Android (USER)` and `Linux (EXT4)` sliders to at least 16GB.
96
+
1. Navigate to `Next Step` at the bottom right, then select `Start` in the menu that appears.
97
+
- For Android; Select `Dynamic` partitioning for Android 13+ and `Legacy` partitioning for Android 10/11. Note that Android 10/11 are no longer supported, Legacy and Dynamic partitioning are also **NOT** intercompatible.
98
+
1. Navigate to `Tools` > `USB Tools` > `SD Card` and plug your Switch into your PC via USB.
99
+
1. Copy the backup you made of your old microSD card from your PC (or directly from your old microSD card) to your new microSD card.
100
+
1. Eject the `UMS` device safely from within your computer's operating system.
101
+
1. You've successfully followed this guide and your emuMMC is now accessible from `Launch` -> `Atmosphere PKG3 emuMMC` in hekate.
Copy file name to clipboardExpand all lines: docs/extras/updating.md
+60-11Lines changed: 60 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,9 +40,42 @@ When a new version of hekate releases, you can update by following these steps:
40
40
41
41
Always check _before_ updating your system firmware if the latest version of Atmosphère _as well_ as the latest version of hekate support the firmware version you are updating towards.
42
42
43
+
### Updating your sysMMC's firmware
44
+
45
+
- Before continuing with this guide, make sure your sysMMC is up to date. If your sysMMC is not up-to-date, do the following depending on whether your Switch is modchipped or not:
46
+
47
+
:::::: danger
48
+
#### **Note regarding updating towards major firmware versions**
49
+
50
+
Updating your Switch firmware should be done via OFW or Stock on modchipped consoles when updating towards a major firmware version. The term "major" in Switch firmware version means that the first number in the firmware version number has changed. An example of a major firmware version update would be updating from `20.5.0` to `21.0.0`, the first number is the major firmware version number. You may also want to do the same thing for minor firmware versions (for example, updating from `21.1.0` to `21.2.0`).
51
+
52
+
The reason why updating via OFW/Stock is recommended on modchipped consoles is because it ensures that you properly burn your e-fuses and preserve the ability to boot OFW afterwards (in the situations where Atmosphere and/or hekate haven't been updated to support the firmware version you've updated to). In rare instances, it also prevents issues that *can* occur when updating via sysCFW (incomplete firmware updates, improperly updated BOOT0/BOOT1 partitions, etc).
53
+
54
+
#### Click one of the tabs below depending on your situation:
55
+
56
+
</br>
57
+
58
+
::::: tabs
59
+
60
+
:::: tab default Modchipped-console users
61
+
-**Modchipped-console users:** Boot hekate/Nyx, navigate to `Reboot` > `OFW` from hekate's `Home` menu and then update through `System Settings` > `System` > `System Update`.
62
+
-**Note:** If you cannot boot `OFW`, please boot `Stock sysMMC` from hekate's `Launch` menu instead.
-**Unpatched/Non hardware modified-console users:** Boot hekate/Nyx, navigate to `Launch` > `Atmosphere PKG3 sysMMC` (may be called something different if you aren't using our guide's hekate configuration) and then update your firmware via `System Settings` > `System` > `System Update`.
67
+
-**Note:** If you have an unpatched Switch, have autoRCM enabled and you're updating your system while booted into Stock or OFW, **updating will disable autoRCM** and you will need to enter RCM manually to boot custom firmware again. To prevent autoRCM from being disabled, boot sysCFW and update through settings from there, as booting without AutoRCM <ins>will burn any preserved e-fuses</ins>.
68
+
::::
69
+
70
+
:::::
71
+
72
+
Once you've successfully updated your firmware, continue with the rest of the guide below.
73
+
74
+
::::::
75
+
43
76
### About emuMMC
44
77
45
-
Your sysMMC and emuMMC have separate system firmwares and need to be updated separately.
78
+
Your sysMMC and emuMMC have separate system firmware versions and need to be updated separately.
46
79
47
80
If you keep your emuMMC offline, you have 3 options:
48
81
@@ -62,11 +95,7 @@ This guide is made for updating your emuMMC's firmware. It is **not** for downgr
62
95
63
96
:::
64
97
65
-
There are two supported methods of dumping your sysMMC's firmware, these methods are detailed in the two tabs below. Either choice will provide the same end result, but can be more difficult depending on the console model you have.
66
-
67
-
-**Note:**
68
-
If you have an unpatched Switch, have autoRCM enabled and you're updating your system while in stock firmware, **updating will disable autoRCM** and you will need to enter RCM manually to boot custom firmware again.
69
-
To prevent autoRCM from being disabled, boot CFW on sysMMC and update through settings from there, as booting without AutoRCM <ins>will burn any preserved e-fuses</ins>.
98
+
There are three supported methods of dumping your sysMMC's firmware, these methods are detailed in the tabs below. All choices will provide the same end result, but can be more difficult depending on the console model you have.
70
99
71
100
::::: tabs
72
101
@@ -82,9 +111,7 @@ To prevent autoRCM from being disabled, boot CFW on sysMMC and update through se
82
111
1. Download the latest release of `Goldleaf.nro` and place it in `sd:/switch` on your microSD card.
83
112
84
113
#### Dumping your sysMMC firmware
85
-
86
-
1. Make sure your sysMMC is up to date. If your sysMMC is not up-to-date, boot into sysCFW and update it through `System Settings` > `System` > `System Update`.
87
-
- sysCFW is recommended since it preserves e-fuses and preserves AutoRCM (if applicable).
114
+
88
115
1. Boot into hekate, and navigate to `Launch` > `Atmosphere PKG3 sysMMC`.
89
116
-`Atmosphere PKG3 sysMMC` is sysCFW, this environment may be called something different if you do not use the config we provide in our guide.
90
117
1. Once booted into sysCFW, open the homebrew menu in applet mode by opening the gallery applet on your home menu.
@@ -95,6 +122,29 @@ To prevent autoRCM from being disabled, boot CFW on sysMMC and update through se
95
122
96
123
::::
97
124
125
+
:::: tab default Dumping your firmware via nxdumptool
126
+
127
+
#### What you need:
128
+
- The latest release of [nxdumptool](https://github.com/DarkMatterCore/nxdumptool/releases) (`nxdt_rw_poc.nro`)
129
+
130
+
#### Preparing your microSD card
131
+
132
+
1. Boot into hekate.
133
+
1. Go to `Tools` > `USB Tools` > `SD Card` and connect your Switch to your PC via USB.
134
+
1. Download the latest release of `nxdt_rw_poc.nro` and place it in `sd:/switch` on your microSD card.
135
+
136
+
#### Dumping your sysMMC firmware
137
+
138
+
1. Boot into hekate, and navigate to `Launch` > `Atmosphere PKG3 sysMMC`.
139
+
-`Atmosphere PKG3 sysMMC` is sysCFW, this environment may be called something different if you do not use the config we provide in our guide.
140
+
1. Once booted into sysCFW, open the homebrew menu in applet mode by opening the gallery applet on your home menu.
141
+
- Title takeover mode (holding `R` while launching any title on your HOME menu) also works, but isn't *required* for this process.
142
+
1. Find nxdumptool (`nxdt_rw_poc`) in your homebrew menu and launch the app.
143
+
1. Navigate to `dump system update` > `start dump`, then wait for nxdumptool to finish dumping your currently installed firmware version.
144
+
1. Once done, reboot back to hekate by holding power for 3-4 seconds and selecting `Power Options` > `Restart`, or by using the `Reboot to Payload` homebrew app in your homebrew menu (Erista ("V1") console users only).
145
+
146
+
::::
147
+
98
148
:::: tab Dumping your firmware via TegraExplorer
99
149
100
150
#### What you need:
@@ -115,8 +165,6 @@ On Mariko ("V2") consoles, this method of dumping the sysMMC's firmware requires
115
165
116
166
#### Dumping your sysMMC firmware
117
167
118
-
1. Make sure your sysMMC is up to date. If your sysMMC is not up-to-date, boot into sysCFW and update it through `System Settings` > `System` > `System Update`.
119
-
- sysCFW is recommended since it preserves e-fuses and preserves AutoRCM (if applicable).
120
168
1. Boot into hekate and navigate to `Payloads` > `TegraExplorer.bin`.
121
169
1. Using the joystick and the A buttons, select the `FirmwareDump.te` script, then select `Dump sysmmc`.
122
170
- If navigation doesn't work with your Joycons, navigating using the volume buttons and selecting using the power button also works.
@@ -138,6 +186,7 @@ On Mariko ("V2") consoles, this method of dumping the sysMMC's firmware requires
138
186
1. Find Daybreak in the homebrew menu and launch it.
139
187
1. Tap on `Install` and follow the instructions corresponding to the method you used to dump your firmware below.
140
188
- For users who dumped their firmware using Goldleaf: Navigate to `sd:/switch/Goldleaf/export/update/<latest firmware version number>`.
189
+
- For users who dumped their firmware using nxdumptool: Navigate to `sd:/nxdt_rw_poc/System Update/<latest firmware version number>`.
141
190
- For users who dumped their firmware using TegraExplorer: Navigate to `sd:/tegraexplorer/Firmware/<latest firmware version number>`.
142
191
1. Tap on `Continue` and then `Preserve settings`.
143
192
- If you see the message `Warning: exFAT firmware is missing or corrupt`, you likely don't have the exFAT drivers installed on your sysMMC. Just press continue if this is the case.
Copy file name to clipboardExpand all lines: docs/homebrew/simplemodmanager.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# SimpleModManager
2
2
3
-
SimpleModManager is a [homebrew app](index#terminologies) that allows easily adding and removing mods to the layeredFS directory from another directory on the SD card.
3
+
SimpleModManager is a [homebrew app](index#terminologies) that allows easily adding and removing mods to the layeredFS directory from another directory on the SD card. Its official Github page can be found [here](https://github.com/nadrino/SimpleModManager).
4
4
5
5
### Common use cases for SimpleModManager:
6
6
@@ -16,7 +16,7 @@ SimpleModManager should not be used for some specific games like Super Smash Bro
16
16
:::
17
17
18
18
## Installation requirements:
19
-
- The latest release of [SimpleModManager](https://github.com/nadrino/SimpleModManager/releases/latest) (the `SimpleModManager.nro` file)
19
+
- The latest release of [SimpleModManager](https://github.com/DefenderOfHyrule/SimpleModManager/releases/tag/v2.1.4) (the `SimpleModManager.nro` file)
20
20
21
21
## Installation instructions:
22
22
1. Boot into hekate and go to `Tools` > `USB Tools` > `SD Card`, then plug your Switch into your PC via USB.
Copy file name to clipboardExpand all lines: docs/homebrew/tesla-menu.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,15 +20,15 @@ Tesla-Menu is dependent on a [sysmodule](index#terminologies) called `nx-ovlload
20
20
21
21
## Installation requirements:
22
22
- An archive manager like [7-Zip](https://www.7-zip.org/)
23
-
- The latest release of [Tesla-Menu](https://github.com/WerWolv/Tesla-Menu/releases/tag/v1.2.3) (the `ovlmenu.zip` file)
24
-
- The latest release of [nx-ovlloader](https://github.com/WerWolv/nx-ovlloader/releases/tag/v1.0.7) (the `nx-ovlloader.zip` file)
23
+
- The latest release of [Tesla-Menu](https://github.com/DefenderOfHyrule/Tesla-Menu/releases/tag/v1.2.0) (the `ovlmenu.ovl` file)
24
+
- The latest release of [nx-ovlloader](https://github.com/DefenderOfHyrule/nx-ovlloader/releases/tag/v1.2.0) (the `nx-ovlloader.zip` file)
25
25
26
26
## Installation instructions:
27
27
1. Boot into hekate and go to `Tools` > `USB Tools` > `SD Card`, then plug your Switch into your PC via USB.
28
28
1. Your microSD card should now be accessible on your PC, open it.
29
-
1. Extract both `.zip`files to a location on your computer.
30
-
- If your archive manager allows for it, you can also simply open the `.zip`files directly.
31
-
1. Copy the *contents* of each (extracted) `.zip` file to the root of your microSD card.
29
+
1. Extract the nx-ovlloader `.zip`file to a location on your computer.
30
+
- If your archive manager allows for it, you can also simply open the `.zip`file directly.
31
+
1. Copy the *contents* of the (extracted) `.zip` file to the root of your microSD card, then copy `ovlmenu.ovl` to `sd:/switch/.overlays`.
32
32
-**Optional:** You can verify if you've installed Tesla-Menu and nx-ovlloader correctly, you should have a folder called `420000000007E51A` (nx-ovlloader) in `sd:/atmosphere/contents` and the `ovlmenu.ovl` (Tesla-Menu) file in `sd:/switch/.overlays`.
0 commit comments