m (change category to Category:Nintendo 3DS troubleshooting) |
StarlitSkies (talk | contribs) (update {{Infobox homebrew}}, revise & expand in-line troubleshooting, and try to mitigate people downloading ctrcheck as a .gm9.txt) |
||
Line 3: | Line 3: | ||
| for3ds = 1 | | for3ds = 1 | ||
| developers = StarlitSkies, FrozenFire | | developers = StarlitSkies, FrozenFire | ||
| releasedate = 2024- | | version = 3.0.0 | ||
| releasedate = 2024-09-11 | |||
| website = https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/ gist.github.com | | website = https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/ gist.github.com | ||
}} | }} | ||
Line 11: | Line 12: | ||
== Required Reading == | == Required Reading == | ||
ctrcheck does not fix the majority of issues by itself, and instead only informs the user that they exist. Some of the issues it checks for may still require large amounts of knowledge to fix - this script is not a 'miracle cure' and should not be treated as such. | |||
Additionally, ctrcheck cannot check whether the SD is damaged | Additionally, ctrcheck cannot check whether the SD is damaged, only certain specific issues with reading its data. If you have an issue that might be caused by an SD being corrupted or formatted badly, the pages [[Formatting an SD card]] and/or [[Checking SD card integrity]] will be far more useful. | ||
== Instructions == | == Instructions == | ||
Line 20: | Line 21: | ||
* The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9] | * The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9] | ||
** To download, right-click/long-press the page and select <code>Save page as...</code> or similar, then rename | ** To download, right-click/long-press the page and select <code>Save page as...</code> or similar, then rename the downloaded file to <code>ctrcheck.gm9</code> if it is not already named that | ||
* A device that you can use to transfer files to your 3DS, either via an SD slot or via [[3DS:FTP|FTP]] | * A device that you can use to transfer files to your 3DS, either via an SD slot or via [[3DS:FTP|FTP]] | ||
Line 35: | Line 36: | ||
# Hold {{B|START}}, and while holding {{B|START}}, power on your console. This will launch GodMode9 | # Hold {{B|START}}, and while holding {{B|START}}, power on your console. This will launch GodMode9 | ||
# Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck''' | # Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck''' | ||
#* If ctrcheck does not appear here, [[FILEXT|enable file extensions]] and then make sure the name of the script is exactly <code>ctrcheck.gm9</code> | |||
# Based on the type of issue you're having, select one of the top four options | # Based on the type of issue you're having, select one of the top four options | ||
#* If you | #* If you are even slightly unsure about what type of issue it is, pick '''Full''' | ||
# Accept any prompts to fix issues and unlock write | # Accept any prompts to fix issues and unlock sysNAND write permissions that appear, then read the results on the top screen once the script finishes | ||
# If | # If you are following this guide at someone else's request, send a picture of the results to that person. Otherwise, if the results include any of the following, do the matching instructions: | ||
#* <code> | #* <code>______ installed to firm0/firm1</code>: If the result type is <code>Information</code>, you may ignore this line. If the type is <code>Warning</code> or <code>Critical</code>, follow either [[3dsguide:updating-b9s|Updating B9S]] (if using boot9strap) or [[3DS:Fastboot3DS/Usage#Updating_fastboot3DS|Updating fastboot3DS]] (if using fastboot3DS) to get the latest version of a known good bootloader. If the type is <code>Error</code>, ask for help in the [[Get support|Nintendo Homebrew Discord]] | ||
#* <code>Critical: NVRAM is inaccessible</code>: If your console is an old model (no ZL/ZR shoulder buttons and no C-Stick), try reseating the Wi-Fi module on the motherboard. If this does not fix it or you have a new model, download [[Media:Luma_v13.0.2_ignore-cfgnor.firm|the]] special build of Luma linked in the fourteenth word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card | |||
#* <code>Critical: NVRAM is inaccessible</code>: If your console is an old model, try reseating the Wi-Fi module on the motherboard. If this does not fix it or you have a new model, download [[Media:Luma_v13.0.2_ignore-cfgnor.firm|the]] special build of Luma linked in the fourteenth word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card | |||
#** This build does not fix the issue, only stop it from causing system crashes. You will still be unable to play DS games, and if you were unable to use Wi-Fi it will also stay broken - fixing these entirely requires a hardware replacement | #** This build does not fix the issue, only stop it from causing system crashes. You will still be unable to play DS games, and if you were unable to use Wi-Fi it will also stay broken - fixing these entirely requires a hardware replacement | ||
#* <code>Warning: The SD title database needs to be reset</code>: Using [[3dsguide:images/screenshots/database-reset.jpg|this picture]] as a guide, reset the title database. After you reset, follow [[3dsguide:finalizing-setup|Finalizing Setup]] to reacquire the homebrew apps | #* <code>Warning: The SD title database needs to be reset</code>: Using [[3dsguide:images/screenshots/database-reset.jpg|this picture]] as a guide, reset the title database. After you reset, follow [[3dsguide:finalizing-setup|Finalizing Setup]] to reacquire the homebrew apps | ||
#* <code>Warning: There is no boot.firm/boot.3dsx in | #* <code>Warning: There is no boot.firm/boot.3dsx in the SD card root</code>: Follow [[3dsguide:restoring-updating-cfw|Restoring / Updating CFW]] to reacquire the file(s) | ||
#* If any <code>Warning</code>, <code>Critical</code>, or <code> | #* <code>Critical: NAND is unreadable at _______...?</code>: Your console's internal storage is damaged in a way that may require advanced troubleshooting to fix. Ask for help in the [[Get support|Nintendo Homebrew Discord]] | ||
{{info|text= The results of this ctrcheck can also be found on the SD card in <code>sd:/gm9/ctrcheck_latest.txt</code>, | #* <code>Bruh Moment: movable.sed is from Seedminer</code>: You have made a mistake. [[3DS:Recover_movable.sed|Find your original movable]] and restore it to the folder <code>1:/private</code>, or else uninstalling CFW will be guaranteed to brick your console. If you cannot find your original movable, ask for help in the [[Get support|Nintendo Homebrew Discord]] and provide every piece of context you know about this issue | ||
#* If any other result(s) of the type <code>Warning</code>, <code>Critical</code>, or <code>Error</code> appear, you may want to ask for help in the [[Get support|Nintendo Homebrew Discord]] and provide the full output of ctrcheck there | |||
{{info|text=The results of this ctrcheck can also be found on the SD card in <code>sd:/gm9/ctrcheck_latest.txt</code> - however, if you run ctrcheck again, this file will be overwritten with the new results. If permanent logging was enabled, it will also be appended to the file <code>sd:/gm9/ctrcheck_log.txt</code>.}} | |||
[[Category:Unbricking]] | [[Category:Unbricking]] | ||
[[Category:Nintendo 3DS troubleshooting]] | [[Category:Nintendo 3DS troubleshooting]] |
Revision as of 22:01, 13 September 2024
Developer(s) | StarlitSkies, FrozenFire |
---|---|
Console | Nintendo 3DS |
Version | 3.0.0 (September 11, 2024 | )
Links | |
Website | gist.github.com |
ctrcheck is a custom GodMode9 script that does a large number of sanity checks and checksums on a 3DS' firmware and SD card to make troubleshooting easier through fault isolation, though it can also automatically fix certain issues.
Required Reading
ctrcheck does not fix the majority of issues by itself, and instead only informs the user that they exist. Some of the issues it checks for may still require large amounts of knowledge to fix - this script is not a 'miracle cure' and should not be treated as such.
Additionally, ctrcheck cannot check whether the SD is damaged, only certain specific issues with reading its data. If you have an issue that might be caused by an SD being corrupted or formatted badly, the pages Formatting an SD card and/or Checking SD card integrity will be far more useful.
Instructions
What You Need
- The latest release of ctrcheck.gm9
- To download, right-click/long-press the page and select
Save page as...
or similar, then rename the downloaded file toctrcheck.gm9
if it is not already named that
- To download, right-click/long-press the page and select
- A device that you can use to transfer files to your 3DS, either via an SD slot or via FTP
Section I - Prep Work
- Power off your console and insert the SD card into your device
- Copy the downloaded
ctrcheck.gm9
intosd:/gm9/scripts
on the SD card - If GodMode9 either is not installed or is outdated (the latest version is v2.1.1), install the latest version now
- Reinsert the SD card into your console
Section II - ctrcheck
- Hold START, and while holding START, power on your console. This will launch GodMode9
- Press the HOME button, then go into Scripts... -> ctrcheck
- If ctrcheck does not appear here, enable file extensions and then make sure the name of the script is exactly
ctrcheck.gm9
- If ctrcheck does not appear here, enable file extensions and then make sure the name of the script is exactly
- Based on the type of issue you're having, select one of the top four options
- If you are even slightly unsure about what type of issue it is, pick Full
- Accept any prompts to fix issues and unlock sysNAND write permissions that appear, then read the results on the top screen once the script finishes
- If you are following this guide at someone else's request, send a picture of the results to that person. Otherwise, if the results include any of the following, do the matching instructions:
______ installed to firm0/firm1
: If the result type isInformation
, you may ignore this line. If the type isWarning
orCritical
, follow either Updating B9S (if using boot9strap) or Updating fastboot3DS (if using fastboot3DS) to get the latest version of a known good bootloader. If the type isError
, ask for help in the Nintendo Homebrew DiscordCritical: NVRAM is inaccessible
: If your console is an old model (no ZL/ZR shoulder buttons and no C-Stick), try reseating the Wi-Fi module on the motherboard. If this does not fix it or you have a new model, download the special build of Luma linked in the fourteenth word of this sentence, rename it toboot.firm
, and put it on the root of your SD card- This build does not fix the issue, only stop it from causing system crashes. You will still be unable to play DS games, and if you were unable to use Wi-Fi it will also stay broken - fixing these entirely requires a hardware replacement
Warning: The SD title database needs to be reset
: Using this picture as a guide, reset the title database. After you reset, follow Finalizing Setup to reacquire the homebrew appsWarning: There is no boot.firm/boot.3dsx in the SD card root
: Follow Restoring / Updating CFW to reacquire the file(s)Critical: NAND is unreadable at _______...?
: Your console's internal storage is damaged in a way that may require advanced troubleshooting to fix. Ask for help in the Nintendo Homebrew DiscordBruh Moment: movable.sed is from Seedminer
: You have made a mistake. Find your original movable and restore it to the folder1:/private
, or else uninstalling CFW will be guaranteed to brick your console. If you cannot find your original movable, ask for help in the Nintendo Homebrew Discord and provide every piece of context you know about this issue- If any other result(s) of the type
Warning
,Critical
, orError
appear, you may want to ask for help in the Nintendo Homebrew Discord and provide the full output of ctrcheck there
The results of this ctrcheck can also be found on the SD card in sd:/gm9/ctrcheck_latest.txt - however, if you run ctrcheck again, this file will be overwritten with the new results. If permanent logging was enabled, it will also be appended to the file sd:/gm9/ctrcheck_log.txt . |