Install Applications on a CAT-R or CAT-DEV

This page describes the procedure to install an application to the MLC NAND of a CAT-R or CAT-DEV using an SD Card. The CAT-DEV is also capable of installing an application to NAND through PCFS (no SD Card needed).

Prerequisites

The following components are required to install an application on a CAT-R or CAT-DEV NAND.

NOTE:
If you want the CAT-DEV to boot in NAND mode, you must set it to NAND boot mode before installing any titles to NAND. If you do not set the NAND boot mode before installing applications, your titles may be erased when you switch to NAND boot. For more information about boot modes, see the Cafe Operating Modes section in Environment Settings. To learn how to set boot modes, see Change CAT-DEV Boot Modes.

Prepare the Image for NAND Installation

To Prepare the Image for NAND Installation

  1. Create a master archive file. To learn how to create a master archive file for an application, see Master Cafe Applications.
  2. Open a Cafe Cygwin shell, and then start the makecfdownloadimage.sh command:
    makecfdownloadimage.sh [-i <wumad file>.wumad] [-o <output directory name>] [-w <work directory>]
    
    Alternatively, a download image can be created in a Windows environment using makecfmaster. To do this, open cafex_env.bat and invoke makecfmaster with the installimage command:
    makecfmaster installimage [-i <wumad file>.wumad] [-o <output directory name>] [-w <work directory>]
    

    Where:

    • <wumad file> is the Master archive file to be installed on NAND.
    • <output directory name> is the base output directory where download images are created. When the image is created under this directory, a folder created for each partition. If omitted, the folders are created in the $CAFE_ROOT/data/mlc/install directory.
    • <work directory> is the temporary directory used during processing. If omitted, a temporary directory is created in the current directory.

Example

In the following example, the program testapp.wumad is mastered in the $OUT_PATH/testapp_p01 directory.

$ makecfdownloadimage.sh -i testapp.wumad -o $OUT_PATH -w $WORK_DIR

The same example using makecfmaster:

makecfmaster installimage -i testapp.wumad -o %OUT_PATH% -w %WORK_DIR%
NOTE:
If you want to use PCFS to install an application to the CAT-DEV NAND, omit the -o $OUT_PATH option. This creates the application in the $CAFE_ROOT/data/mlc/install folder, which allows it to be visible in the /vol/storage_hfiomlc01/install folder when using the System Config Tool.

In the following example, the program testapp.rpx is mastered in the $OUT_NAME_p01 directory.

makecfmaster archive -d -r testapp.rpx -o $OUT_NAME -w $WORK_DIR

If you omit the -o $OUT_NAME option, testapp.rpx is mastered in the testapp_p01 directory.

Install an Application Using an SD Card (CAT-R and CAT-DEV)

To Install an Application Using an SD Card (CAT-R and CAT-DEV)

  1. Insert an SD Card into the SD Card reader on the host PC.
  2. Navigate to the OUT_PATH where your processed image is. By default, it is in the $CAFE_ROOT/data/mlc/install folder.
  3. Copy the folder that was created by the makecfdownloadimage.sh or makecfmaster installimage command to the root of the SD Card. In the example above, you would copy the testapp_p01 directory and all of its content to the root of the SD Card.
  4. Safely remove the SD Card from the host PC, and then insert it into the SD Card slot on the CAT-R or CAT-DEV.
  5. On the CAT-R, press the POWER Button on the CAT-R.
    On the CAT-DEV, open a Cafe Cygwin shell, and then type cafeon at the command to start the System Config Tool.
  6. On the System Config Tool home page, select Install from SD Card, and press the A Button.
  7. Select your application, for example testapp_p01, and then press the A Button.
  8. The progress of the installation is displayed at the bottom of the TV or on the console for the CAT-DEV.
  9. After the application is installed, you may start the application by selecting the Title ID in the Launcher menu. It will indicate that it is located on mlc01.

Install an Application via PCFS (CAT-DEV Only)

To Install an Application via PCFS (CAT-DEV Only)

  1. Ensure that the application is placed in the $CAFE_ROOT/data/mlc/install folder. This is the default directory if the -o option is not specified when running the makecfdownloadimage.sh script or makecfmaster installimage to prepare the image.
  2. Open a Cafe Cygwin shell, and then type cafeon to start the System Config Tool.
  3. After the System Config Tool is loaded, on the host PC, type the following command, and then press Enter:
    install /vol/storage_hfiomlc01/install/<titleID>
    
    Where:
    • <titleID> is the name of the application.
  4. The progress of the installation is displayed at the bottom of the TV and on the console.
  5. After the application is installed, you may start the application by selecting the Title ID in the Launcher menu. It will indicate that it is located on mlc01.

Uninstall an Application (CAT-R and CAT-DEV)

To Uninstall an Application (CAT-R and CAT-DEV)

  1. On the System Config Tool, select Installed Titles, and then press the A Button.
  2. Select your application, for example testapp_p01, and then press the A Button. The uninstall process starts.
  3. When the uninstall process finishes, the following message is displayed on the bottom of the TV screen:
    Uninstall /vol/storage_mlc01/title/(application's title id) Done
    

See Also

Launch an Application from a CAT-R Disc
Serial Logging on the Wii U

Revision History

2014/07/08 Replaced makecfmaster.sh and CafeX commands with makecfmaster.exe commands.
2014/01/14 Added makecfmaster.sh command with -d option
2013/06/11 Added equivalent CafeX command
2013/05/08 Automated cleanup pass.
2013/02/15 Edit pass
2012/07/25 Cleanup Pass
2012/05/17 Initial version.


CONFIDENTIAL