ndrun_prechecker

Description

The ndrun_prechecker script checks the operating environment when a program is run. It is called within the ndrun script that is included in version 071002 and later of the NDEV software package.

From the SDK 3.1 patch onward, you must select either standard or extended firmware for each title (for details, refer to the readme for the SDK). This script has been provided to assist application developers in preventing the use of incorrect firmware.

ndrun_prechecker offers the following features:

• Display of the environment at startup time to the shell. The environment includes the firmware's major version, the MEM2 size set by setsmem2size, and region information set by setcountrycode.
• A check for whether or not a program is using the appropriate firmware.

There are two types of check results:

• WARNING:
  Displayed when incorrect firmware has been selected. For example, if a title that uses RevoEX is started using the standard firmware, a warning will be displayed, the program will begin to wait for key input, and startup processing will be halted.
  To cancel execution here, forcibly terminate (CTRL+C) the command in the shell.
• No display:
  No check results will be displayed when the appropriate firmware has been selected. Program startup processing will also not be suspended.

Notes

Be aware of the following issues:

• Do not include spaces in the path to the .elf file specified when ndrun is executed.
  If you do, the process will fail. For example, avoid paths that include "C:\Documents and Settings".
• If you are using the CodeWarrior IDE, configure it such that the script window is displayed.
  To enable this configuration, start the CodeWarrior IDE and click Edit > Environment Settings > Debugger > GCN Debugger Global Settings and then clear Minimize script window.
  The results from this check script are displayed in the shell window. If the check result is "WARNNING", execution will wait for key input at the shell prompt. If the script window is not displayed at this time, you will not know that execution is waiting on key input.

Location

$REVOLUTION_SDK_ROOT/X86/bin/ndrun_prechecker

Revision History

2008/07/30 Removed notes regarding the use of Radix Studio after its development was canceled.
2007/12/06 Since the criterion for performing checks was changed, "NOTICE" items that had been rendered unnecessary were deleted from the check results.
2007/10/02 Initial version.

CONFIDENTIAL