Use the following combinations of hardware and debugging software to debug.
Hardware | Debugging Software | 3DS Application | SNAKE-Compatible Application |
---|---|---|---|
PARTNER-CTR Debugger | PARTNER-CTR | ○ | × |
IS-SNAKE-BOX | IS-CTR-DEBUGGER | ○ | ○ |
6.1. Debugging Methods According to the Menu Displayed at Startup
You can switch the menu that is displayed when you start PARTNER-CTR Debugger or IS-SNAKE-BOX. To switch the menu, from Config Tools, select Menu Settings > Menu. How you debug applications differs depending on the menu that is displayed.
6.1.1. Starting Your Application From the Development Menu
For normal debugging, you load a CCI file or CIA file into PARTNER-CTR or IS-CTR-DEBUGGER. This is the recommended debugging method, as it allows you to start debugging right after starting.
However, card-based applications written to a CTR flash card cannot be debugged when started from the development menu, unless they are started in the same way as when starting from the HOME Menu. This is also the case when starting downloadable applications from the DevMenu.
6.1.2. Starting Your Application From the HOME Menu
Starting from the HOME Menu does not happen via the debugging software, so you cannot debug this way without carrying out additional steps.
Use the following procedure to debug applications started from the HOME Menu. (This procedure allows you to debug both card-based applications, and downloadable applications that have been imported into an SD card.)
Using PARTNER-CTR
Reset to have the HOME Menu display applications loaded into the PARTNER-CTR emulation memory.
- Start PARTNER-CTR.
- Start the application from the HOME Menu.
- Run the
ATTACHA
command in the PARTNER-CTR command window.
> ATTACHA - Run the
LS
command to load the symbol file.
> LS MyApplicaton.axf
This results in debugging an application that has already started, so you cannot debug anything at start or immediately thereafter.
For more information about the PARTNER-CTR commands, see the PARTNER-CTR Debugger Manual.
Using IS-CTR-DEBUGGER
You can display on the HOME Menu even when loading a CCI file or CIA file in IS-CTR-DEBUGGER.
- Start IS-CTR-DEBUGGER.
- Start the application from the HOME Menu.
- On the IS-CTR-DEBUGGER menu, select Debug > Attach to Running Program.
- On the IS-CTR-DEBUGGER menu, select File > Open and load an AXF file.
This results in debugging an application that has already started, so you cannot debug anything at start or immediately thereafter.
6.2. Starting the CIA File With Debugger Software
When loading the CIA file directly with the debugging software, a C8804478
error may occur. This occurs when there is no CXI file in the same directory as the CIA file, and when the application is not using the default unique ID.
You must support either of the following if you want to run a CIA file directly from the debugging software.
- Building the application using the default unique ID
- Placing a CXI file in the same directory as the CIA file