1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>ndrun_prechecker</TITLE> 8<LINK rel="stylesheet" href="../CSS/revolution.css"> 9</HEAD> 10<BODY> 11<H1 align="left">ndrun_prechecker</H1> 12<H2>Description</H2> 13<P>The <CODE>ndrun_prechecker</CODE> script checks the operating environment when a program is run. It is called within the <CODE>ndrun</CODE> script that is included in version 071002 and later of the NDEV software package.</p><p> 14 15From 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. 16</p><p> 17<CODE>ndrun_prechecker</CODE> offers the following features:</p> 18<UL> 19<LI>Display of the environment at startup time to the shell. The environment includes the firmware's major version, the MEM2 size set by <CODE>setsmem2size</CODE>, and region information set by <CODE>setcountrycode</CODE>. 20<LI>A check for whether or not a program is using the appropriate firmware. 21</UL> 22<p> 23There are two types of check results:</p> 24 25<UL> 26<LI>WARNING: <br>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.<br>To cancel execution here, forcibly terminate (CTRL+C) the command in the shell. 27<LI>No display:<br>No check results will be displayed when the appropriate firmware has been selected. Program startup processing will also not be suspended. 28</UL> 29 30</P> 31<H2>Notes</H2> 32<P> 33Be aware of the following issues: 34<UL> 35<LI>Do not include spaces in the path to the <CODE>.elf</CODE> file specified when <CODE>ndrun</CODE> is executed.<br> If you do, the process will fail. For example, avoid paths that include "C:\Documents and Settings". 36<LI>If you are using the CodeWarrior IDE, configure it such that the script window is displayed.<br>To enable this configuration, start the CodeWarrior IDE and click <B>Edit</B> > <B>Environment Settings</B> > <B>Debugger</B> > <B>GCN Debugger Global Settings</B> and then clear <B>Minimize script window</B>.<br> The results from this check script are displayed in the shell window. If the check result is "<CODE>WARNNING</CODE>", 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. 37</UL> 38</P> 39 40<H2>Location</H2> 41<P><FONT face="Courier New">$REVOLUTION_SDK_ROOT/X86/bin/ndrun_prechecker</FONT></P> 42<H2>Revision History</H2> 43<P>2008/07/30 Removed notes regarding the use of Radix Studio after its development was canceled. <BR>2007/12/06 Since the criterion for performing checks was changed, "NOTICE" items that had been rendered unnecessary were deleted from the check results.<BR>2007/10/02 Initial version.</p> 44<hr><p>CONFIDENTIAL</p></body> 45</HTML>