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.
This commit is contained in:
Lily 2023-07-06 03:11:29 -07:00
parent c01234b753
commit d17daf5605
3 changed files with 42 additions and 10 deletions

View file

@ -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. Press (Home) to bring up the action menu
1. Select "Scripts..." 1. Select "Scripts..."
1. Select "finalize" 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 + 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 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 + 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. 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 + 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 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 + 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
___ ___

View file

@ -503,7 +503,7 @@ The steps below can be attempted in any order, but are listed from easiest to ha
<details>{{ compat | markdownify }}</details> <details>{{ compat | markdownify }}</details>
{% capture compat %} {% capture compat %}
<summary><u>Error #01: No Nintendo 3DS folder</u></summary> <summary><u>Warning #01: No Nintendo 3DS folder</u></summary>
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. 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. 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. Delete the Nintendo 3DS folder from the SD card
1. Reinsert your SD card into your console 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 "Scripts..."
1. Select "finalize" 1. Select "finalize"
1. Follow the prompts in the script, answering each question that you are asked 1. Press (A) to create a NAND backup
1. Copy the files in `gm9/out` on your SD to a safe location on your computer + This may take around fifteen minutes
1. Delete the `<date>_<serialnumber>_sysnand_##.bin` and `<date>_<serialnumber>_sysnand_##.bin.sha` files from the SD card, keeping essential.exefs in `/gm9/out/` 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 `<date>_<serialnumber>_sysnand_##.bin` and `<date>_<serialnumber>_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. Copy the `Nintendo 3DS` folder from your computer to the root of your SD card
1. Delete the `Nintendo 3DS` folder from your computer 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 %} {% endcapture %}
<details>{{ compat | markdownify }}</details> <details>{{ compat | markdownify }}</details>
{% capture compat %} {% capture compat %}
<summary><u>Error #05: No title database</u></summary> <summary><u>Information #05: No title database</u></summary>
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. 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 %} {% endcapture %}
<details>{{ compat | markdownify }}</details> <details>{{ compat | markdownify }}</details>
{% capture compat %}
<summary><u>Error #09: Unsupported GodMode9 version</u></summary>
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 %}
<details>{{ compat | markdownify }}</details>
{% capture compat %}
<summary><u>Information #11: NAND backup flag detected</u></summary>
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 %}
<details>{{ compat | markdownify }}</details>
--- ---
## Boot issues on consoles with custom firmware ## Boot issues on consoles with custom firmware

Binary file not shown.