3DS:Black screen unbrick and 3DS:Ctrcheck: Difference between pages

ctrcheck
Developer(s)	StarlitSkies, FrozenFire
Console	Nintendo 3DS
Version	3.0.1 (September 17, 2024; 15 months ago)
Links
Website	gist.github.com
	v; t; e;

VisualWikitext

Revision as of 22:09, 17 September 2024

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 to ctrcheck.gm9 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 FTP

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
- If ctrcheck does not appear here, enable file extensions and then make sure the name of the script is exactly ctrcheck.gm9
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 is Information, you may ignore this line. If the type is Warning or Critical, 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 is Error, ask for help in the Nintendo Homebrew Discord
- Critical: 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 to boot.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 apps
- Warning: 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 Discord
- Bruh Moment: movable.sed is from Seedminer: You have made a mistake. Find your original movable and restore it to the folder 1:/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, or Error 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.

@@ Line 1: / Line 1: @@
-{{shortcut|3DS:BSU}}
+{{Lowercase title}}{{Infobox homebrew
-When a 3DS boots to a black screen instead of the HOME Menu, it is usually a bad sign. This page lists common troubleshooting steps to fix this issue.
+| title = ctrcheck
+| for3ds = 1
+| developers = StarlitSkies, FrozenFire
+| version = 3.0.1
+| releasedate = 2024-09-17
+| website = https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/ gist.github.com
+}}
-The troubleshooting below should always be started at the first section. The troubleshooting will direct you to the next sections if necessary.
+'''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.
-__TOC__
+== Required Reading ==
-== CFW Check ==
+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.
-First, we will check if the console has CFW. This will help as it allows access to [[3DS:GodMode9|GodMode9]], a helpful tool for troubleshooting and fixing issues.
-# Power on your console while holding the {{B|SELECT}} button
+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.
-#* If your console boots to the [[3DS:Luma3DS/Configuration|Luma3DS configuration menu]], press {{B|START}} to save, then continue to the CFW troubleshooting section below
-#* If your console doesn't boot to the Luma3DS configuration menu, do the same without the SD card inserted
-#** If your console does boot to the Luma3DS configuration menu, your SD card wasn't inserted correctly, re-insert it and try again
-#** If your console turns off right away, you have CFW and can continue to the CFW troubleshooting section below
-#** If your console doesn't boot to the Luma3DS configuration menu but black-screens, your console is likely bricked without CFW, and you should continue to the stock troubleshooting section at the bottom of this page
-#*** To make sure of this, hold {{Key press|SELECT|START|X|POWER}} for seven seconds while the console is powered off, then power off again, hold {{B|HOME}}, and then press {{B|POWER}} - if the notification LED [[3DS:boot9strap#LED_Status_Codes|lit up a color]] or the [[3DS:fastboot3DS|fastboot3DS]] menu appears, then you have working CFW but something is interfering with Luma. Join the Nintendo Homebrew Discord for more advanced help
-== CFW troubleshooting ==
+== Instructions ==
-=== Section I - Prep Work ===
+=== What You Need ===
-# Follow [[3dsguide:restoring-updating-cfw.html|Restoring / Updating CFW]], then "Updating GodMode9" and "Creating a NAND backup" section on [[3DS:GodMode9/Usage]]
+* The latest release of [https://gist.github.com/StarlitSkies/f417c1ded9de8fceffdb532f92823377/raw/ctrcheck.gm9 ctrcheck.gm9]
-# Take out any inserted game cartridge
+** 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
-# Continue to the next section
+* A device that you can use to transfer files to your 3DS, either via an SD slot or via [[3DS:FTP|FTP]]
-=== Section II - RTCBug ===
-# Power on your console
+=== Section I - Prep Work ===
-# Wait ten seconds, then press {{Key press|L|Down|SELECT}} at the same time
-#* If the [[3DS:Luma3DS/Rosalina|Rosalina menu]] opens, you're likely experiencing [[3DS:Lumabug|RTCBug]] - return by pressing B, wait 15 minutes, remove any existing cartridge inserted, and the HOME Menu should load on its own. If this doesn't work, continue to the next section
-#* If Rosalina doesn't open, continue to the next section
-=== Section III - Luma3DS configuration reset ===
-# Insert the SD card into your computer
+# Power off your console and insert the SD card into your device
-# Navigate to the folder <code>sd:/luma</code>
+# Copy the downloaded <code>ctrcheck.gm9</code> into <code>sd:/gm9/scripts</code> on the SD card
-# Delete <code>config.ini</code>
+# 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
-# Power on your console
-#* If your console doesn't boot to the Luma3DS config, follow [[SD Clean]], then return to section 2
-# Do not enable anything, just press {{B|START}} to save the default configuration
-#* If your console boots to the HOME Menu, you should look for and delete faulty patches in <code>/luma/sysmodules</code> and <code>/luma/titles</code> on the SD card before turning <code>Enable game patching</code> or <code>Loading external FIRMs and modules</code> back on
-#* If your console doesn't boot to the HOME Menu, continue to the next section
-#* If your console boots to an error, check [[3DS:EXCEPTION|the Luma exceptions page]] for how to fix your error, or ask for help in the Nintendo Homebrew Discord if your error isn't listed there
-=== Section IV - SD HOME Menu extdata ===
-#Power on your console without the SD card inserted
-#* If it boots to the Luma3DS configuration screen, press {{B|START}} to save
-#* If it doesn't boot to the HOME menu, continue to the next section
-#* If it boots to the HOME Menu, do the following steps:
-#*# Insert your SD card into your computer
-#*# Navigate to <code>Nintendo 3DS</code> -> <code>ID0</code> -> <code>ID1</code> -> <code>extdata</code>
-#*#* <code>ID0</code> and <code>ID1</code> are 32-character long folders
-#*#* If you have multiple ID0/ID1 folders, do the following for all of them
-#*# Delete the corresponding folder for your region:
-#*#* USA: <code>0000008f</code>
-#*#* EUR: <code>00000098</code>
-#*#* JPN: <code>00000082</code>
-#*#* KOR: <code>000000A9</code>
-#*# Reinsert your SD card into your console
-#*# Power on your console
-#*#* If it still doesn't boot to the HOME Menu, but does without the SD card, you're experiencing a very weird issue and should ask in the Nintendo Homebrew discord for more advanced help
-=== Section V - Safe Mode ===
-# Power on your console while holding {{Key press|L|R|Up|A}}
-#* If your console boots to the Safe Mode menu, perform the update and see if it boots to the HOME Menu
-#* If it doesn't boot to Safe Mode, or doesn't boot to the HOME Menu after a Safe Mode update, continue to the next section
-=== Section VI - ctrcheck ===
-# Follow the instructions on [[3DS:Ctrcheck|the ctrcheck page]]
-# If the console doesn't boot to the HOME Menu after all applicable fixes have been tried, continue to the next section
-=== Section VII - New 3DS camera brick{{anchor|Section VIII - New 3DS camera brick}} ===
-{{info|If you are currently troubleshooting an old model console, ignore this and skip to the next section.
-<br>If you are unsure whether your console is new or old, look at its shoulder buttons. A new model has four ({{Key press|ZL|L|R|ZR}}), and an old model has two ({{Key press|L|R}}).}}
-# Insert your SD card into your computer
-# Navigate to the <code>/luma/</code> folder
-# Look for <code>errdisp.txt</code>
-## If this file already exists, rename it to <code>_errdisp.txt</code>
-## If this file doesn't exist, skip to the next section
-# Reinsert your SD card into the console
-# Power on the console
-# Wait 30 seconds without pressing any buttons
-# Power off the console
-# Navigate to the <code>/luma/</code> folder
-# Look for <code>errdisp.txt</code>
-#* If this file exists, open it in a text editor, and check if the process name is <code>qtm</code>
-#** If the process name is <code>qtm</code>, you need to disconnect your inner camera or replace it
-#** If the process name is something else, your console has a very unusual issue and you should ask in the Nintendo Homebrew Discord for more advanced help
-#* If this file doesn't exist, continue to the next section
-=== Section VIII - CTRTransfer{{anchor|Section VII - CTRTransfer}} ===
-# Follow the [[3dsguide:ctrtransfer.html|CTRTransfer guide on 3DS Hacks Guide]]
-#* If the console doesn't boot to the HOME Menu at the end of Section II, continue to the next section of this guide
-=== Section IX - 3ds_hw_test ===
-# Follow the instructions on [[3DS:Hardware test|the hardware test page]]
-#* If the number of errors from this is zero, continue to the next section
-===Section X - Manual CTRTransfer===
-#Follow [[3DS:CTRTransfer/Manual]]
-----
-By this point, you have exhausted all conventional fixes. If your console has not booted to the HOME Menu by now, go to the Nintendo Homebrew Discord and mention that you've tried this page already.
-==Stock troubleshooting==
-===Section I - Safe Mode ===
-# Power on your console while holding {{Key press|L|R|Up|A}}
-#* If your console boots to the Safe Mode menu, perform the update and see if it boots to the HOME Menu
-#* If it doesn't boot to Safe Mode, or doesn't boot to the HOME Menu after a Safe Mode update, continue to the next section
-===Section II - Shutdown menu ===
+=== Section II - ctrcheck ===
-# Power on the console
+# Hold {{B|START}}, and while holding {{B|START}}, power on your console. This will launch GodMode9
-# Wait 30 seconds without touching any buttons
+# Press the {{B|HOME}} button, then go into '''Scripts...''' -> '''ctrcheck'''
-# Press the POWER button
+#* 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>
-#* If the shutdown menu opens (a grey screen with text), you're experiencing <code>f000000b</code> corruption and must install boot9strap with a [[3DS:ntrboot|ntrboot]] compatible flashcart in order to fix the issue
+# Based on the type of issue you're having, select one of the top four options
-#* If the screen stays black and the console only powers off if you hold the button for 15 seconds, this may be potentially fixable with ntrboot if it is not a hardware issue
+#* 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:
+#* <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
+#** 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: 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)
+#* <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]]
+#* <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:Nintendo 3DS troubleshooting]]