Debug a wumad File

Introduction

A wumad file is the master archive file that contains the RPX and RPL executable files, data files used by the application, metadata accessed by system features, and other application information. The following steps describe how to debug a wumad file.

Steps

  1. Using the steps described in Writing an Image to the Hard Drive in Hard Disk Based Emulation, build and install the wumad file for your application.
  2. Use the following command to launch and debug your application:
    caferun -e h:<hdd-bank> -d multi -k <elf-file>
    
    where <hdd-bank> is the Hard Disk Drive (HDD) bank that you selected in step 1 and <elf-file> is the debugger file for your application (such as game.elf). cafediscrun can also be used to launch the application.
  3. Debug your application.
  4. Debug again or stop debugging your application:
    1. To debug your application again, in a separate cafe.bat window, enter the following command:
      devkitmsg "pm_restart 0x000500101000800A" // Restarts the system and boots into Sys Config Tool
      
      After the System Config Tool has restarted, proceed to step 5.
    2. To stop debugging this application:
      devkitmsg "cos_flags 0x768" // Turns off debugging
      devkitmsg "pm_restart 0x000500101000800A" // Restarts the system and boots into Sys Config Tool
      
      The cos_flags command disables the debugging mode that was enabled by -d multi in step 2, and the pm_restart command applies the mode change.

      After the System Config Tool has restarted, proceed to step 8.
  5. Run the wumad manually through the Title Launcher: in the System Config Tool, navigate to Title Launcher and launch the title ID under ODD2. MULTI should launch and open the <elf-file> specified in step 2.
  6. In the MULTI debugger command line, type restart to start debugging.
  7. Return to step 3.
  8. In the separate cafe.bat window, enter the following command to stop the system:
    cafestop
    

See Also

Debug a Crash
Debug FAQ

Revision History

2014/02/03 Initial version.


CONFIDENTIAL