3DS:Ctrcheck: Difference between revisions

Line 6:

}}

'''ctrcheck''' is a custom GodMode9 script that does a large number of [[wikipedia:Sanity check|sanity checks]] and [[wikipedia:Checksum|checksums]] on a 3DS' firmware to make troubleshooting easier through [[wikipedia:Fault isolation|fault isolation]], though it can also automatically fix certain issues.

'''ctrcheck''' is a custom GodMode9 script that does a large number of [[wikipedia:Sanity check|sanity checks]] and [[wikipedia:Checksum|checksums]] on a 3DS' firmware and SD card to make troubleshooting easier through [[wikipedia:Fault isolation|fault isolation]], though it can also automatically fix certain issues.

== 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, ~~at current~~ ctrcheck ~~only does checks within~~ the ~~NAND~~. If you have an issue that might be caused by ~~the~~ SD ~~card instead~~, the pages [[Formatting an SD card]] and/or [[Checking SD card integrity]] ~~may~~ be more useful.

Additionally, ctrcheck cannot check whether the SD is damaged in any way. 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 ==

===What You Need===

=== What You Need ===

* The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9]

Line 22:

Line 23:

===Section I - Prep Work===

=== Section I - Prep Work ===

# Power off your console and insert the SD card into your device

Line 32:

Line 33:

# 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''' -> '''~~Everything~~'''

# Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck'''

# Accept any prompts to unlock write perms that appear, ~~and~~ then read the results on the top screen once the script finishes

# Based on the type of issue you're having, select one of the top four options

#* If you're at all unsure about what type it is, just pick '''Full'''

# Accept any prompts to fix issues and unlock write perms that appear, then read the results on the top screen once the script finishes

# If they say any of the following, do the matching instructions:

#* <code>Warning: ______ installed to firm0/firm1</code>: ~~Update your bootloader using~~ [[3dsguide:updating-b9s|~~this page of~~ 3DS ~~Hacks Guide~~]]

#* <code>Warning: ______ installed to firm0/firm1</code>: Follow either [[3dsguide:updating-b9s|Updating B9S]] or [[3DS:fastboot3DS#Installation|Installing fastboot3DS]] to get the latest version of a known good bootloader

#** This also applies if the <code>Warning:</code> text instead reads <code>Critical:</code>, but if it reads <code>Fatal Error</code> then ask for help in the Nintendo Homebrew Discord (if the text reads <code>Information:</code>, your bootloader is ~~up to date~~ and ~~no update is required~~)

#** This also applies if the <code>Warning:</code> text instead reads <code>Critical:</code>, but if it reads <code>Fatal Error</code> then ask for help in the Nintendo Homebrew Discord (if the text reads <code>Information:</code>, your bootloader is already updated and you can ignore this line)

#* <code>Fatal Error: NVRAM is inaccessible</code>: Download [[Media:~~Luma12~~.0.~~1_ignore~~-cfgnor.firm|the]] special build of Luma linked in the second word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card

#* <code>Fatal Error: NVRAM is inaccessible</code>: Download [[Media:Luma_v13.0.2_ignore-cfgnor.firm|the]] special build of Luma linked in the second word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card

#** Even with this custom version, you cannot use Wi-Fi or play DS games on the console with this error - fixing it entirely requires a hardware replacement

#* ~~Any text that ends with~~ <code>If you ~~unlocked write perms earlier~~, ~~this has been fixed.~~</code>: ~~The error that was fixed may now allow your console to~~ boot. ~~Reboot after checking~~ the ~~rest~~ of the ~~output and see if~~ the ~~HOME Menu appears~~

#* <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 the root of the SD card</code>: Follow [[3dsguide:restoring-updating-cfw|Restoring / Updating CFW]] to reacquire the file(s)

#* If any <code>Warning</code>, <code>Critical</code>, or <code>Fatal Error</code> that is not in the above set appears, ask for help in the Nintendo Homebrew Discord and provide the full output of ctrcheck.

{{info|text= The results of this ctrcheck can also be found on the SD card in <code>sd:/gm9/ctrcheck_latest.txt</code>, and if logging was enabled it will also be appended to the file <code>sd:/gm9/ctrcheck_log.txt</code> to save it permanently.}}

[[Category:Unbricking]]

[[Category:Nintendo 3DS guides]]

@@ Line 6: / Line 6: @@
 }}
-'''ctrcheck''' is a custom GodMode9 script that does a large number of [[wikipedia:Sanity check|sanity checks]] and [[wikipedia:Checksum|checksums]] on a 3DS' firmware to make troubleshooting easier through [[wikipedia:Fault isolation|fault isolation]], though it can also automatically fix certain issues.
+'''ctrcheck''' is a custom GodMode9 script that does a large number of [[wikipedia:Sanity check|sanity checks]] and [[wikipedia:Checksum|checksums]] on a 3DS' firmware and SD card to make troubleshooting easier through [[wikipedia:Fault isolation|fault isolation]], though it can also automatically fix certain issues.
+== 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, at current ctrcheck only does checks within the NAND. If you have an issue that might be caused by the SD card instead, the pages [[Formatting an SD card]] and/or [[Checking SD card integrity]] may be more useful.
+Additionally, ctrcheck cannot check whether the SD is damaged in any way. 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 ==
-===What You Need===
+=== What You Need ===
 * The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9]
@@ Line 22: / Line 23: @@
-===Section I - Prep Work===
+=== Section I - Prep Work ===
 # Power off your console and insert the SD card into your device
@@ Line 32: / Line 33: @@
 # 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''' -> '''Everything'''
+# Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck'''
-# Accept any prompts to unlock write perms that appear, and then read the results on the top screen once the script finishes
+# Based on the type of issue you're having, select one of the top four options
+#* If you're at all unsure about what type it is, just pick '''Full'''
+# Accept any prompts to fix issues and unlock write perms that appear, then read the results on the top screen once the script finishes
 # If they say any of the following, do the matching instructions:
-#* <code>Warning: ______ installed to firm0/firm1</code>: Update your bootloader using [[3dsguide:updating-b9s|this page of 3DS Hacks Guide]]
+#* <code>Warning: ______ installed to firm0/firm1</code>: Follow either [[3dsguide:updating-b9s|Updating B9S]] or [[3DS:fastboot3DS#Installation|Installing fastboot3DS]] to get the latest version of a known good bootloader
-#** This also applies if the <code>Warning:</code> text instead reads <code>Critical:</code>, but if it reads <code>Fatal Error</code> then ask for help in the Nintendo Homebrew Discord (if the text reads <code>Information:</code>, your bootloader is up to date and no update is required)
+#** This also applies if the <code>Warning:</code> text instead reads <code>Critical:</code>, but if it reads <code>Fatal Error</code> then ask for help in the Nintendo Homebrew Discord (if the text reads <code>Information:</code>, your bootloader is already updated and you can ignore this line)
-#* <code>Fatal Error: NVRAM is inaccessible</code>: Download [[Media:Luma12.0.1_ignore-cfgnor.firm|the]] special build of Luma linked in the second word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card
+#* <code>Fatal Error: NVRAM is inaccessible</code>: Download [[Media:Luma_v13.0.2_ignore-cfgnor.firm|the]] special build of Luma linked in the second word of this sentence, rename it to <code>boot.firm</code>, and put it on the root of your SD card
 #** Even with this custom version, you cannot use Wi-Fi or play DS games on the console with this error - fixing it entirely requires a hardware replacement
-#* Any text that ends with <code>If you unlocked write perms earlier, this has been fixed.</code>: The error that was fixed may now allow your console to boot. Reboot after checking the rest of the output and see if the HOME Menu appears
+#* <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 the root of the SD card</code>: Follow [[3dsguide:restoring-updating-cfw|Restoring / Updating CFW]] to reacquire the file(s)
 #* If any <code>Warning</code>, <code>Critical</code>, or <code>Fatal Error</code> that is not in the above set appears, ask for help in the Nintendo Homebrew Discord and provide the full output of ctrcheck.
 {{info|text= The results of this ctrcheck can also be found on the SD card in <code>sd:/gm9/ctrcheck_latest.txt</code>, and if logging was enabled it will also be appended to the file <code>sd:/gm9/ctrcheck_log.txt</code> to save it permanently.}}
 [[Category:Unbricking]]
 [[Category:Nintendo 3DS guides]]