From d17daf560526f74d0635bb6a6ad046447bdb03f7 Mon Sep 17 00:00:00 2001 From: Lily Date: Thu, 6 Jul 2023 03:11:29 -0700 Subject: [PATCH] finalizing: script v1.3.0 - Move script backups to /gm9/backups/. - Remove redundant silent A:/backups/essential.exefs backup. - Fix logical error relating to moving Nintendo 3DS folder off of SD card. - If Nintendo 3DS folder is not detected, script will now propmt user to skip to making a NAND backup - This will create a file in SD:/gm9/flags/ called BACKUPFLAG - If this flag is present when the Nintendo 3DS folder is present (re-added), the script will tell the user that a NAND backup likely already exists and prompt the user to either create another backup or to skip creating the backup - Move database dummyflag from A:/dbs/ to SD:/gm9/flags/ - Change errors to error levels, and adjust top screen accordingly - "Information" indicates that the user didn't do anything wrong, but that the user must do something that deviates from the normal guide (e.g. create title database, NAND backup flag tripped) - indicated on top screen with `(i)` - "Warning" indicates that the script will continue, but will not complete as intended (e.g. no Nintendo 3DS folder) - indicated on top screen with `/!\` - "Error" indicates that the script cannot continue due to user error (incorrect GM9 version, missing files, etc) - indicated on top screen with `:(` - "Fatal Error" indicates that the script has triggered an error that should not occur and requires debugging (CIA install fail, invalid SD size) - indicated on top screen with `wtf?` Guide also adjusted accordingly. --- _pages/en_US/finalizing-setup.txt | 7 +++-- _pages/en_US/troubleshooting.txt | 45 +++++++++++++++++++++++++----- assets/finalizing.zip | Bin 5347678 -> 5348251 bytes 3 files changed, 42 insertions(+), 10 deletions(-) diff --git a/_pages/en_US/finalizing-setup.txt b/_pages/en_US/finalizing-setup.txt index 4e8e227cb40b9..dc17d0b1796ba 100644 --- a/_pages/en_US/finalizing-setup.txt +++ b/_pages/en_US/finalizing-setup.txt @@ -102,16 +102,17 @@ In this section, you will use a script to automate homebrew installation, SD car 1. Press (Home) to bring up the action menu 1. Select "Scripts..." 1. Select "finalize" -1. Follow the prompts in the script, answering each question that you are asked +1. Follow the prompts in the script, answering any questions that you are asked + If you encounter an error, follow the instructions in the error message or consult the [troubleshooting](troubleshooting#finalizing-setup) page 1. Once the script says "Setup complete!", press (A) to power off the device + If you do NOT see the message "Setup complete!", the script was not successful and you will need to redo this section 1. Insert your SD card into your computer -1. Copy the `/gm9/out/` folder to a safe location on your computer +1. Copy the `/gm9/backups/` folder to a safe location on your computer + This folder contains critical file backups and should be backed up to multiple locations (i.e. cloud storage) if possible + The two SysNAND files are your NAND backup and can be used to revert your console to a working state if it is bricked by a software issue + The `essential.exefs` file contains your console's system-unique files and can be used to recover your data in the event of a hardware failure -1. Delete the contents of the `/gm9/out/` folder from your SD card +1. If you still have them, delete the two `SysNAND` files from the `/gm9/backups/` folder from your SD card + + The `essential.exefs` file is small and may be kept on your SD card for ease of access ___ diff --git a/_pages/en_US/troubleshooting.txt b/_pages/en_US/troubleshooting.txt index 157d4be98b996..d6fa436ea1b7f 100644 --- a/_pages/en_US/troubleshooting.txt +++ b/_pages/en_US/troubleshooting.txt @@ -503,7 +503,7 @@ The steps below can be attempted in any order, but are listed from easiest to ha
{{ compat | markdownify }}
{% capture compat %} -Error #01: No Nintendo 3DS folder +Warning #01: No Nintendo 3DS folder Your SD card does not have the `Nintendo 3DS` folder. Power on your device with your SD card inserted, then wait for the device to show a message box that says "Creating HOME Menu management information". Once the message box disappears, power off your device and try again. @@ -541,22 +541,35 @@ You need at least 1.3GB of free space to perform the NAND backup, which is a par 1. Copy the `Nintendo 3DS` folder from the root of your SD card to your computer 1. Delete the Nintendo 3DS folder from the SD card 1. Reinsert your SD card into your console -1. Power off your console, hold START and power on still holding START to boot on GodMode9 +1. Power off your console +1. Hold START and power on still holding START to open GodMode9 +1. Press the (Home) button 1. Select "Scripts..." 1. Select "finalize" -1. Follow the prompts in the script, answering each question that you are asked -1. Copy the files in `gm9/out` on your SD to a safe location on your computer -1. Delete the `__sysnand_##.bin` and `__sysnand_##.bin.sha` files from the SD card, keeping essential.exefs in `/gm9/out/` +1. Press (A) to create a NAND backup + + This may take around fifteen minutes +1. Press (A) again + + The console should automatically power off +1. Insert your SD card into your computer +1. Copy the files in `/gm9/backups/` on your SD to a safe location on your computer +1. Delete the `__sysnand_##.bin` and `__sysnand_##.bin.sha` files from the SD card 1. Copy the `Nintendo 3DS` folder from your computer to the root of your SD card 1. Delete the `Nintendo 3DS` folder from your computer -Once done, re-run the script. +Now that you have your NAND backup in a safe place: + +1. Insert your SD card into your console +1. Hold START and power on still holding START to open GodMode9 +1. Press the (Home) button +1. Select "Scripts..." +1. Select "finalize" +1. Continue the script as normal {% endcapture %}
{{ compat | markdownify }}
{% capture compat %} -Error #05: No title database +Information #05: No title database Press (A) to create a title database, unlock SysNAND writing by entering the buttons on-screen, follow the prompts [here](/images/screenshots/database-reset.jpg), then re-run the script. @@ -591,6 +604,24 @@ You didn't delete the dummy title database that was created by Error #05. Follow {% endcapture %}
{{ compat | markdownify }}
+{% capture compat %} +Error #09: Unsupported GodMode9 version + +You are somehow running a version of GodMode9 not packaged with the script. Make sure you copied the contents of `finalize.zip` to the root of your SD card and that you are holding START while powering on your console. + +{% endcapture %} +
{{ compat | markdownify }}
+ +{% capture compat %} +Information #11: NAND backup flag detected + +You most likely already made a NAND backup on this console. If you did not make a backup or lost access to your backup, select "1. Make Another NAND Backup". Otherwise, select "2. Skip NAND Backup". + +{% endcapture %} +
{{ compat | markdownify }}
+ + + --- ## Boot issues on consoles with custom firmware diff --git a/assets/finalizing.zip b/assets/finalizing.zip index 622efb874be2a7cd79d306f0bd3b9acd7fdfce6c..b26a48fea486e94d03a8694f204f568fe39eb1d1 100644 GIT binary patch delta 3731 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 delta 3144 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 iH~|Eg4VzIN0