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 the firmware that is appropriate for each title from two types: "standard firmware" (former name: "firmware for titles without network support") and "extended firmware" (former name: "firmware for titles with network support"). 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, as follows.</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 (for example 33.4.16), "WARNING" will be displayed, the program will enter the waiting for key input state, and the program's startup processing will be halted. 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 use a space in the path to the <CODE>.elf</CODE> file that is specified when <CODE>ndrun</CODE> is executed. This will cause it to fail during processing. For example, avoid paths that include "C:\Documents and Settings". 36<LI>If you are using the CodeWarrior IDE, configure it so 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>, then uncheck <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<LI>It is not clear how to open the script window in Radix Studio.<br> At present time (2007/10/02), it is not clear how to open the script window in Radix Studio. If program execution halts while using Radix Studio, run <CODE>ndrun</CODE> in the shell and confirm that it is not waiting for key input as described above.</UL> 38</P> 39 40<H2>Location</H2> 41<P><FONT face="Courier New"><CODE>$REVOLUTION_SDK_ROOT/X86/bin/ndrun_prechecker</CODE></FONT></P> 42<H2>Revision History</H2> 43<P>2007/12/6 The evaluation standards for the check were changed, so "NOTICE" items that were rendered unnecessary were deleted from the check results.<BR>2007/10/02 Initial version.</p> 44<hr><p>CONFIDENTIAL</p></body> 45</HTML>