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 7.0.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>TWL Nmenu</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9<STYLE type="text/css"> 10<!-- 11.sample_source{ 12 background-color : #e8e8e8; 13} 14H3{ 15 color : teal; 16} 17pre 18{ 19 display: compact; 20 font-family : "Courier New", monospace; 21 font-weight : normal; 22 font-size : normal; 23 24/* margin : 0pt 0pt 6pt 50pt;*/ 25 padding : 2pt 8pt 2pt 8pt; 26 background-color : #eee; 27 28 border-style : solid; 29 border-width : 1px; 30} 31.command_list{ 32 margin-bottom : 16pt; 33} 34.command_desc{ 35 } 36.command_item{ 37 margin-top : 16pt; 38 background-color : #e8e8e8; 39} 40.blockquoted_table { 41 border : 1px; 42 width : 80%; 43} 44TD,TH{ 45 border-color : #c0d8d8; 46 padding : 1pt 4pt 1pt 4pt; 47 border-width : 1px; 48 border-style : solid; 49} 50div.screen 51{ 52 float: left; 53 padding: 2px; 54 background-color: black; 55 margin: 0 0.5em 1em 1em; 56} 57ol, ul 58{ 59 padding-left: 4em; 60 margin-left: 0pt; 61} 62 63div.screen img.main 64{ 65 margin-bottom: 10px; 66} 67.warning 68{ 69 color: red; 70} 71table 72{ 73 left: 0; 74} 75table.plain td 76{ 77 border: none; 78 background-color: transparent; 79} 80--> 81</STYLE> 82</HEAD> 83<BODY> 84 85<H1 align="left">TWL Nmenu</H1> 86 87 88<H2>Overview</H2> 89<P> 90 <CODE>TwlNmenu</CODE> is a TWL application that manages NAND applications in the TWL system. It can install NAND applications from TAD files on SD Cards or DS cards in the TWL system. It can start or delete NAND applications stored in the TWL system. 91</P> 92 93 94<H2>Execution</H2> 95<H3></H3> 96<P> 97It can be run in the following ways: 98</P> 99<ul> 100<li>Use the IS-TWL-DEBUGGER software to run <CODE>TwlNmenu.srl</CODE>. 101<li>Use the IS-TWL-DEBUGGER software to import and then run <CODE>TwlNmenu.tad</CODE>. 102<li>Write <CODE>TwlNmenu.srl</CODE> to a DS Game Card and then run it. 103<li>Use TWL Nmenu to import and then run <CODE>TwlNmenu.tad</CODE>. 104</ul> 105<P> 106If running the TWL Nmenu using the IS-TWL-DEBUGGER software, a "Please wait a moment" dialog box will be displayed, and you'll no longer be able to perform operations within the IS-TWL-DEBUGGER software. To exit, click <B>Force Quit</B> in the dialog box. 107</P> 108 109<H2>Storing TAD Files on a DS Card</h2> 110<p> 111NAND applications can be imported from a TAD file stored on a DS card when in <B>Card</B> mode. This is a description of how to prepare the DS card to be used at this time. 112</p> 113<p> 114There are two methods. 115</p> 116 117<h5>Using the <CODE>-n</CODE> Option with <CODE>maketad</CODE></h5> 118<p> 119Although the <a href="../tools/maketad.html"><CODE>maketad</CODE></a> tool creates TAD files, using the <CODE>-n</CODE> option creates an SRL file that contains a TAD file instead of creating just a TAD file. Access the TAD file contained in the SRL file in <B>Card</B> mode by writing the SRL created with this option to a DS card. 120</p> 121 122<h5>Creating an Original SRL File</h5> 123<p> 124Access a TAD file included in the ROM-FS of an SRL file in <B>Card</B> mode by creating an SRL file that meets the following conditions and then writing it to a DS card. 125</p> 126<ul> 127<li>It must be NITRO ROM. 128<li>The company code must be "YZ". 129</ul> 130 131 132<H2>Using the Tool</H2> 133<p> 134Once you are in TWL Nmenu, the upper screen will display some basic instructions and information about the currently selected file. The lower screen is used for displaying and selecting items in the list. Although display is usually in English, if the system language is Japanese (that is, if the market is Japan), some messages may appear in Japanese.<br>The TWL Nmenu is divided into three modes: <B>NAND</B>, <B>SD</B>, and <B>Card</B>. However, the <B>Card</B> mode is not available when Twl Nmenu is started as a card application. You can switch to the inactive mode either by touching the gray area at the top of the lower screen, or by pressing ← or → on the +Control Pad. 135</p> 136 137<h4>NAND Mode</h4> 138<div class="screen"><img class="main" src="TwlNmenu/NAND_main_0.png"><br><img src="TwlNmenu/NAND_sub_0.png"></div> 139<div class="screen"><img class="main" src="TwlNmenu/NAND_main_1.png"><br><img src="TwlNmenu/NAND_sub_1.png"></div> 140<p> 141In NAND mode, a list of NAND applications that are installed on the TWL system is displayed. In this mode, you can start or delete the selected NAND application. 142</p> 143<p> 144Each item in the list displayed on the lower screen shows information about a NAND application in the following format: 145</p> 146<table class="plain" style="width:0"><tr><td> 147<pre> 14803. 01 4BNA (3031 34424e41) Ver.1.0 149 -- ---- ---- -------- --- 150 1 2 3 4 5 151</pre> 152</td></tr></table> 153<table class="plain" style="width:25em"><tr><td> 154<ol> 155<li>Company Code (ASCII) 156<li>Game Code (ASCII) 157<li>Company Code (Hexadecimal) 158<li>Game Code (Hexadecimal) 159<li>NAND application version number 160</ol> 161</td></tr></table> 162<p> 163Light blue items in the list, for which "deleted" appears to the right, indicate NAND applications that have been deleted. Red items in the list, for which "error" appears to the right, indicate NAND applications that are invalid. You should delete and then reimport these items. 164</p> 165 166<br clear="left"> 167 168<p> 169The controls for this mode are shown in the table below. 170</p> 171 172<table class="table"> 173<tbody> 174<tr><th>Button<th>Operations 175<tr><td>Left/Right arrows <td>Mode Switching 176<tr><td>Up/Down arrows <td>Selects NAND applications. 177<tr><td>START<td>Starts the selected NAND application. 178<tr><td>Y<td>Clears the private save data of the selected NAND application. 179<tr><td>X<td>Deletes the selected NAND application. 180<tr><td>R + X<td>Deletes all NAND applications of the same type as the selected one. 181<tr><td>L<td>Moves to the next page on the upper screen. 182<tr><td>SELECT<td>Toggles between showing and hiding the description of the controls. 183</tbody> 184</table> 185 186<p> 187The following information is shown on the upper screen: 188</p> 189 190<p> 191Page 1 192</p> 193<table class="table"> 194<tbody> 195<tr><th colspan="2">Item<th>Description 196<tr><th colspan="2">Hardware<td>Displays information related to the TWL system. 197<tr><th> 198<td>BoxCount<td>�Enbsp;<CODE>used</CODE> indicates the number of installed NAND applications.<br>�Enbsp;<CODE>free</CODE> indicates the remaining number of NAND applications that can be installed. 199<tr><th colspan="2">Media<td>Displays information related to the system memory. 200<tr><th rowspan="2"> 201<td>Free<td>Displays the available space in blocks and KB. 202<tr><td>Total<td>Displays the total space in blocks and KB. 203</tbody> 204</table> 205 206<p> 207Page 2 208</p> 209<table class="table"> 210<tbody> 211<tr><th colspan="2">Item<th>Description 212<tr><th colspan="2">Title<td>Displays information related to the selected NAND application. 213<tr><th rowspan="7"> 214<td>CompanyCode<td>Displays the Company Code in ASCII and hexadecimal. 215<tr><td>InitialCode<td>Displays the Game Code in ASCII and hexadecimal. 216<tr><td>GameVersion<td>Displays the game version. 217<tr><td>TitleSize<td>Displays the space occupied by the NAND application in units of blocks and kilobytes. 218<tr><td>AppSize<td>Displays the size of the SRL in blocks and KB. 219<tr><td>PublicSave<td>Displays the size of the public save data in blocks and KB. 220<tr><td>PrivateSave<td>Displays the size of the private save data in blocks and KB. 221</tbody> 222</table> 223 224 225<h5>Starting NAND Applications</h5> 226<p> 227Press START to run the selected NAND application. Once the NAND application is started, TWL Nmenu will give up all control. To return to TWL Nmenu, you must run TWL Nmenu again. 228</p> 229 230<h5>Deleting NAND Applications</h5> 231<p> 232Press the X Button to uninstall the selected NAND application from NAND. Even if a NAND application is deleted, information about the fact that it used to be installed remains within the TWL system. For applications in this state, only the Game Code will be displayed in light blue within the list on the lower screen. Furthermore, performing a <I>delete</I> operation on applications in this state will remove all traces of them. 233</p> 234 235<h5>Clearing the Private Save Data of NAND Applications</h5> 236<p> 237All private save data of the selected NAND application is deleted. The TWL system provides a feature that allows the user to back up NAND applications to SD Cards. However, the private save data region will not be backed up by this feature. Because the private save data is not backed up, it will be cleared when the system memory is restored from a backup. For this reason, NAND applications must consider the case in which only the private save data is cleared. This situation can be recreated by using TWL Nmenu to clear the private save data. 238</p> 239 240<h5>Deleting NAND Applications of the Same Type</h5> 241<p> 242When deleting NAND applications of the same type, delete all NAND applications that are the same as the selected NAND application from the perspective of whether the NAND applications have been deleted. For example, if an undeleted NAND application has been selected, all undeleted NAND applications will be deleted. 243</p> 244 245 246<br clear="all"> 247 248<h4>SD Mode<br>Card Mode</h4> 249<div class="screen"><img class="main" src="TwlNmenu/SD_main_0.png"><br><img src="TwlNmenu/SD_sub_0.png"></div> 250<div class="screen"><img class="main" src="TwlNmenu/SD_main_1.png"><br><img src="TwlNmenu/SD_sub_1.png"></div> 251<p> 252In <B>SD</B> mode and <B>Card</B> mode, the files on the SD Card or DS Card will be displayed on the lower screen.<br>In this mode, you can import .tad files. 253</p> 254<p> 255<B>Card</B> mode can be used only when Twl Nmenu has been started as a NAND application. Furthermore, a DS card must be inserted into the card slot before Twl Nmenu is started. A DS card inserted after starting Twl Nmenu will not be recognized. 256</p> 257<p> 258Each item in the list displayed on the lower screen shows information about a NAND application in the following format: 259</p> 260<table class="plain" style="width:0"><tr><td> 261<pre> 26205. 866,240 backupSample.tad 263 ------- ---------------- 264 1 2 265</pre> 266</tr></td></table> 267<table class="plain" style="width:30em"><tr><td> 268<ol> 269<li>File size or TAD file size in the directory 270<li>File name or directory name 271</ol> 272</tr></td></table> 273 274<br clear="left"> 275 276<p> 277The controls for this mode are shown in the table below. 278</p> 279 280<table class="table"> 281<tbody> 282<tr><th>Button<th>Operation 283<tr><td>Left/Right arrows <td>Switches modes. 284<tr><td>Up/Down arrows <td>Selects a file or directory. 285<tr><td>A<td>Imports a TAD file when a TAD file is selected.<br>Moves to the given directory when a directory is selected. 286<tr><td>B<td>Moves up one directory. 287<tr><td>X<td>Moves to the root directory. 288<tr><td>R + A<td>Imports all .tad files within the directory. 289<tr><td>L<td>Moves to the next page on the upper screen. 290<tr><td>SELECT<td>Toggles between showing and hiding the description of the controls. 291</tbody> 292</table> 293 294<p> 295The following information is shown on the upper screen: 296</p> 297 298<p> 299Page 1 300</p> 301<table class="table"> 302<tbody> 303<tr><th colspan="2">Item<th>Description 304<tr><th colspan="2">Hardware<td>Displays information related to the TWL system. 305<tr><th> 306<td>BoxCount<td>�Enbsp;<CODE>used</CODE> indicates the number of installed NAND applications.<br>�Enbsp;<CODE>free</CODE> indicates the remaining number of NAND applications that can be installed. 307<tr><th colspan="2">Media<td>Displays media-related information. This is always 0 in <B>Card</B> mode. 308<tr><th rowspan="2"> 309<td>Free<td>Displays the available space in blocks and KB. 310<tr><td>Total<td>Displays the total space in blocks and KB. 311</tbody> 312</table> 313 314<p> 315Page 2 316</p> 317<table class="table"> 318<tbody> 319<tr><th colspan="2">File<td>Displays information related to the selected file. 320<tr><th rowspan="6"> 321<td>CompanyCode<td>Displays the Company Code in ASCII and hexadecimal. 322<tr><td>InitialCode<td>Displays the Game Code in ASCII and hexadecimal. 323<tr><td>GameVersion<td>Displays the game version and the version that has been imported in the system memory. 324<tr><td>FileName<td>Displays the file name. 325<tr><td>LastUpdate<td>Displays the date last modified on the SD Card. This is always 0 in <B>Card</B> mode. 326</tbody> 327</table> 328 329<h5>Importing TAD Files</h5> 330<p> 331Install a TAD file created with <a href="../tools/maketad.html"><CODE>maketad</CODE></a> in the TWL system. If a NAND application with the same Game Code is already installed, the new application will overwrite the existing one. 332</p> 333 334 335<H2>Location</H2> 336<P> 337<CODE>$TwlSDK/bin/ARM9-TS/Rom/TwlNmenu.srl</CODE><br> <CODE>$TwlSDK/bin/ARM9-TS/Rom/TwlNmenu.tad</CODE><br> 338</P> 339 340 341<H2>See Also</H2> 342 343 344<H2>Revision History</H2> 345<P> 3462008/10/16 Added information related to <B>Card</B> mode and added information about Japanese language display.<br> 2008/07/11 Support for Twl Nmenu update.<br> 2008/04/25 Deleted <B>ROM</B> mode, backup, and restore.<br>2008/03/19 Made descriptions compliant with the terminology. Adjusted phrasing. 2007/12/20 Initial version. 347</P> 348 349 350<hr><p>CONFIDENTIAL</p></body> 351</HTML> 352
