1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> 4<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 5<base target="main"> 6<title>Nmenu</title> 7</head> 8 9<body> 10 11<h1>Nmenu</h1> 12 13<h2>Location</h2> 14<p><code>$REVOLUTION_SDK_ROOT/RVL/bin/tools/Nmenu.elf</code></p> 15 16<h2>Overview</h2> 17<p> 18In Nmenu you can import WAD files, execute imported applications, and delete imported applications. Additionally auto import, auto run, and auto import/run can be performed by specifying options at startup time. Various modes and startup options are described below.<br> <br> <font color="red">Some of the operations have changed since version 2.0 of the NADK, corresponding to the addition of support for the Wii Remote.</font> 19</p> 20 21<h2>Mode Description</h2> 22<H3>1. IMPORT MODE</H3> 23<p> 24A list of the WAD files in <CODE><DvdRoot>/viewer</CODE> can be viewed. 25</p> 26<p> 27Select a WAD file using the Nintendo GameCube Controller or the Wii Remote +Control Pad up/down buttons, and press the A button to import. In Import Mode, the following information can be viewed (each file's information may be loaded by pressing the +Control Pad left/right buttons). 28</p> 29<ul> 30<li>Application game code</li> 31<li>Application game version</li> 32<li>The game version is shown when the application has been imported. If not imported, "Not installed" is displayed.</li> 33</ul> 34<p> 35Move to the next mode, Title List Mode, with the B button.</p> 36 37<H3>2. TITLE LIST MODE</H3> 38<p> 39A list of the imported applications can be viewed. 40</p> 41<p> 42If content files are lacking, such as when they have been deleted from the Wii Menu, applications will be displayed as <B>Incomplete</B>. Select an application using the Controller up/down buttons, and press the A button to execute. An application shown as <B>Incomplete</B> cannot execute, so you will need to import that application again. In addition, when an application is incomplete, you may not be able to obtain the information displayed below, and instead only <B>?</B> will be displayed. 43</p> 44<p> 45An application can be deleted by pressing the X button on the Nintendo GameCube Controller or the 1 button on the Wii Remote. All the imported applications can be deleted by pressing the Y button on the Nintendo GameCube Controller or the 2 button on the Wii Remote. In Title List Mode, the following information can be viewed (information may be toggled using the Controller or +Control Pad left/right buttons, as with Import Mode). 46</p> 47<ul> 48<li>Application game code</li> 49<li>Application game version</li> 50<li>Application company code</li> 51<li>Number of contents used by the application (number of dedicated and shared contents)</li> 52</ul> 53<p> 54The B button switches to SD Browser mode. 55</p> 56 57<H3>3. SD Browser Mode</H3> 58<p> 59A list of files on an SD Card can be seen when an SD Card is inserted. Any WAD files on the SD Card can also be imported.<b>Only WAD files can be imported.</b> 60</p> 61<p> 62Files or directories can be selected using up/down on the Controller or +Control Pad. A selected directory can be opened with the A button, and the contents of that directory will be shown. If the selected item is a WAD file, it can be imported. A file or directory can be deleted by pressing the X button on the Nintendo GameCube Controller or the 1 button on the Wii Remote. It can be moved to the root directory by pressing the Y button on the Nintendo GameCube Controller or the 2 button on the Wii Remote. Return to Import Mode with the B button.<br> <br>In any mode, <CODE>OSReturnToMenu</CODE> is called by pressing START on the Nintendo GameCube Controller or HOME on the Wii Remote. 63</p> 64 65<h2>Auto Import/Run</h2> 66<p> 67When starting <CODE>Nmenu</CODE> with <CODE>ndrun</CODE>, auto import and auto run can be performed by specifying the following options after <CODE>-a</CODE>. However, to use auto run by itself, the application must be imported in advance.<br> <br>Starting with NADK version 2.0, options <CODE>e</CODE> and <CODE>d</CODE> have been added. Option <CODE>e</CODE> is used for simulating a MEM2 size of 128MB; <CODE>d</CODE> is used for debugging. These options can be enabled by specifying them together with the automatic execution option <CODE>l</CODE> (lower case L). Be aware that if the debugger option is specified but you are not performing debugger startup using CodeWarrior, the application will not start. The <CODE>e</CODE> and <CODE>d</CODE> options may be specified together. 68</p> 69<TABLE border="1" > 70 <tr> 71<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>-i</EM></STRONG></CODE></TD> 72<TD width="720">Continues to import specified <CODE>.wad</CODE> files automatically. <b><font color="red">The <CODE>.wad</CODE> files must be located in <CODE>${DvdRoot}/viewer</CODE>.</font></b></TD> 73 </tr> 74 <tr> 75<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>-l</EM></STRONG></CODE></TD> 76<TD width="720">Lowercase L ("<CODE>l</CODE>"). Continues to execute specified applications automatically. Note that what is specified is the initial code (for example: 0001) and not the name of a .<CODE>wad</CODE> file (for example: <CODE>cntdemo.wad</CODE>).<font color="red">The method was changed to the specification of the initial code beginning with NADK version 2.0. </font><br>As mentioned above, if <CODE>e</CODE> is specified at the same time, a MEM2 size of 128MB will be simulated. If <CODE>d</CODE> is simultaneously specified, it will run in debugger startup mode.</TD> 77 </tr> 78 <tr> 79<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>-il</EM></STRONG></CODE></TD> 80<TD width="720">Continues to import and execute the specified <CODE>.wad</CODE> files automatically.<br>Similarly, if <CODE>e</CODE> is simultaneously specified, simulation will be performed with a MEM2 size of 128MB. If <CODE>d</CODE> is simultaneously specified, it will run in debugger startup mode.</TD> 81 </tr> 82</TABLE> 83<p> 84The following is the command for automatically importing and executing <CODE>cntdemo.wad</CODE>:<br>(This assumes <CODE>cntdemo.wad</CODE> is located in <CODE>dvddata/viewer</CODE>.) 85</p> 86<TABLE border="1" width="100%"> 87 <TBODY> 88 <TR> 89 <TD width="100%"> 90 <PRE><CODE> 91% ndrun Nmenu.elf -a -il cntdemo.wad</CODE></PRE> 92 </TD> 93 </TR> 94 </TBODY> 95</TABLE> 96<p> 97The following is the command for automatically executing <CODE>cntdemo.wad</CODE> (Game Code 0001) with a MEM2 size of 128MB:<br>(This assumes <CODE>cntdemo.wad</CODE> has already been imported.) 98</p> 99<TABLE border="1" width="100%"> 100 <TBODY> 101 <TR> 102 <TD width="100%"> 103 <PRE><CODE> 104% ndrun Nmenu.elf -a -le 0001</CODE></PRE> 105 </TD> 106 </TR> 107 </TBODY> 108</TABLE> 109 110<h2>Nmenu.wad</h2> 111<p> 112Starting with Revolution SDK 3.2, a WAD file has been added to the package for Nmenu. Once the Nmenu WAD file has been imported as a Channel, procedures for starting discs and ELF files can be subsequently omitted. 113</p> 114<p> 115The <CODE>Nmenu.wad</CODE> file has basically the same controls and specifications as the normal <CODE>Nmenu.elf</CODE>. However, there is no feature for importing from a disc and therefore no Import Mode. It will be set to Title List Mode at startup time. Import NAND applications from an SD Card in SD Browser Mode. 116</p> 117 118<h2>Notes</h2> 119<ul> 120<li> 121<b>The game version is also affected when a WAD file is imported in Nmenu, overwriting an earlier WAD file. </b> The error message "Cannot import older version." will be output if you attempt to use Nmenu to import and overwrite a WAD file configured with a game version that cannot be downgraded. You can then import normally by first deleting the application. Refer to the <a href="intro.html">Introduction</a> for information on game version rules. <br><br> 122</li> 123<li> 124By default, applications are generated with a game code of "<CODE>0001</CODE>" (<CODE>0x30303031</CODE>), so the application is overwritten when another is imported. To prevent overwriting, use the <CODE>WAD_OPTION</CODE> option in <CODE>make</CODE> (or the <CODE>makeWad</CODE> option) to specify a game code. <br><br> 125</li> 126<li> 127Note that if you start Nmenu with the Wii Menu installed and run <B>Delete All</B>, the Wii Menu uninstaller will be deleted as well. If it has been deleted, you can use the firmware update program (<CODE>fwupdate</CODE>), included in the Revolution SDK, to uninstall the Wii Menu. However, Channels will not be deleted by this method. Reinstall the Wii Menu and then uninstall the Channels using normal procedures. <br><br> 128</li> 129</ul> 130 131<h2>Revision History</h2> 132<p> 1332008/07/09 Added the Nmenu WAD file to the package. Added notes and workarounds related to <B>Delete All</B> on the Wii Menu.<br>2008/06/05 Added mention of the game version's effect on overwrite-imports in Nmenu.<br>2008/01/28 Added the process for handling cases where content files and system files have been deleted.<br>2008/01/11 Changed the description of the import error caused by differing game versions.<br>2007/11/20 Standardized use of "Nmenu."<BR>2007/09/10 Added information on game versions. Deleted an explanation related to deleting shared content.<br>2007/05/10 Added the automatic execution option. Revised the Wii Remote operation methods.<br>2006/10/25 Added an SD Mode to Nmenu.<BR>2006/09/15 Added a precaution regarding automatic execution.<BR>2006/08/15 Initial version. 134</p> 135 136<hr><p>CONFIDENTIAL</p></body> 137</html> 138