3DS:Ctrcheck: Difference between revisions

ctrcheck
Developer(s)	StarlitSkies, FrozenFire
Console	Nintendo 3DS
Links
Website	gist.github.com
	v; t; e;

Revision as of 02:31, 2 November 2023

ctrcheck is a custom GodMode9 script that does a large number of sanity checks and checksums on a 3DS' firmware 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, 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.

Instructions

What You Need

The latest release of ctrcheck.gm9
A device that you can use to transfer files to your 3DS, either via an SD slot or via FTP
- To download, right-click/long-press the page and select Save page as... or similar, then rename it to ctrcheck.gm9 if it is not already called that

Section I - Prep Work

Power off your console and insert the SD card into your device
Copy the downloaded ctrcheck.gm9 into sd:/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 -> Everything
Accept any prompts to unlock write perms that appear, and then read the results on the bottom screen once the script finishes
If they say any of the following, do the matching instructions:
- Warning: ______ installed to firm0/firm1: Update your bootloader using this page of 3DS Hacks Guide
  - This also applies if the Warning: text instead reads Critical:, but if it reads Fatal Error then ask for help in the Nintendo Homebrew Discord
- Fatal Error: NVRAM is inaccessible: Ask for help in the Nintendo Homebrew Discord to receive a custom version of Luma that bypasses NVRAM
  - 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 If you unlocked write perms earlier, this has been fixed.: 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
- If any Warning, Critical, or Fatal Error that is not in the above set appears, ask for help in the Nintendo Homebrew Discord and provide the full output of ctrcheck.
The results of this ctrcheck can also be found on the SD card in sd:/gm9/ctrcheck_latest.txt, and if logging was enabled it will also be appended to the file sd:/gm9/ctrcheck_full_log.txt to save it permanently

@@ Line 1: / Line 1: @@
+{{Infobox homebrew
+| title = ctrcheck
+| for3ds = 1
+| developers = StarlitSkies, FrozenFire
+| website = https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/ gist.github.com
+}}
+'''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.
 ==Required Reading==
-WIP
+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.
 ==Instructions==
-===What you need===
-*The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/archive/0340ceb2d18918a1201f805c0b9408d585489333.zip Ctrcheck]
-*the latest release of [https://github.com/d0k3/GodMode9/releases/latest GodMode9] (the GodMode9 <code>.zip</code> file)
-===Section I: Prep work===
+===What You Need===
-# Insert your SD card into your computer
-# Copy <code>ctrcheck.gm9</code> from the Ctrcheck Zip file in <code>sd:/gm9/scripts</code> on the SD card.
+* The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9]
-*If you havent already, now is the time to setup godmode9.
+* A device that you can use to transfer files to your 3DS, either via an SD slot or via [[3DS:FTP|FTP]]
-. Insert your sd card into your 3ds.
+** To download, right-click/long-press the page and select <code>Save page as...</code> or similar, then rename it to <code>ctrcheck.gm9</code> if it is not already called that
+===Section I - Prep Work===
+# Power off your console and insert the SD card into your device
+# Copy the downloaded <code>ctrcheck.gm9</code> into <code>sd:/gm9/scripts</code> on the SD card
+* If GodMode9 either is not installed or is outdated (the latest version is v2.1.1), [[3DS:GodMode9#Installation|install the latest version now]]
+# Reinsert the SD card into your console
+=== Section II - ctrcheck ===
-===Section II: Ctrcheck===
+# Hold {{B|START}}, and while holding {{B|START}} power on your console. This will launch GodMode9
-# Power on your 3DS while holding {{B|START}}
 # Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck''' -> '''Everything'''
-# Once it finishes, read the outputs on the lower screen. If they say any of the following, do the matching instructions:
+# Accept any prompts to unlock write perms that appear, and then read the results on the bottom 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]]
 #** 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
@@ Line 22: / Line 40: @@
 #* 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
 #* 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.
+# 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_full_log.txt</code> to save it permanently