6. Debugging

Use the following combinations of hardware and debugging software to debug.

Table 6-1. Combinations of Hardware and Debugging Software to Use for Debugging
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

After starting the PARTNER-CTR Debugger, you can switch the menus displayed in IS-SNAKE-BOX by using the Config tool's Other Settings > Menu command. How you debug your application depends on which menus are 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.

Follow the procedure below 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
Note:

Reset to have the HOME Menu display applications loaded into the PARTNER-CTR emulation memory.

  1. Start PARTNER-CTR.
  2. Start the application from the HOME Menu.
  3. Run the ATTACHA command in the PARTNER-CTR command window.
    > ATTACHA
  4. 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
Note:

You can display on the HOME Menu even when loading a CCI file or CIA file in IS-CTR-DEBUGGER.

  1. Start IS-CTR-DEBUGGER.
  2. Start the application from the HOME Menu.
  3. On the IS-CTR-DEBUGGER menu, select Debug > Attach to Running Program.
  4. 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

 


CONFIDENTIAL