1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../css/manpage.css" type="text/css" /> 7 <style type="text/css"><!-- 8 span.static_style 9 { 10 font-size : 8pt; 11 color : white; 12 font-weight : bold; 13 background : #44f; 14 border-left : solid 1px #aaf; 15 border-top : solid 1px #aaf; 16 border-right : solid 1px #00c; 17 border-bottom : solid 1px #00c; 18 padding-left : 2px; 19 padding-right : 2px; 20 } 21 22 span.virtual_style 23 { 24 font-size : 8pt; 25 color : white; 26 font-weight : bold; 27 background : #0a0; 28 border-left : solid 1px #0f0; 29 border-top : solid 1px #0f0; 30 border-right : solid 1px #060; 31 border-bottom : solid 1px #060; 32 padding-left : 2px; 33 padding-right : 2px; 34 } 35 36 span.protected_style 37 { 38 font-size : 8pt; 39 color : white; 40 font-weight : bold; 41 background : #444; 42 border-left : solid 1px #ccc; 43 border-top : solid 1px #ccc; 44 border-right : solid 1px #222; 45 border-bottom : solid 1px #222; 46 padding-left : 2px; 47 padding-right : 2px; 48 } 49 table.table, table.table td, table.table th 50 { 51 border-collapse: collapse; 52 background-color: white; 53 } 54 55 table.table 56 { 57 width: auto; 58 margin: 1em; 59 position : static; 60 font-family : Arial; 61 } 62 63 table.table td, table.table th 64 { 65 padding: 0.2em; 66 } 67 68 table.table td.number, table.table th.number 69 { 70 text-align: right; 71 } 72 73 table.table tbody tr th 74 { 75 text-align: left; 76 font-weight: normal; 77 width: auto; 78 } 79 80 table.table thead tr th, 81 table.table tbody tr th.category 82 { 83 padding: 0 0.2em; 84 } 85 86 table.table caption 87 { 88 font-weight: bold; 89 padding: 0.4em; 90 } 91 table.table th 92 { 93 font-weight : bold; 94 background : #acf; 95 } 96 --></style> 97 98 <title>TwlNandFiler</title> 99 </head> 100 101<body> 102 <h1><CODE>TwlNandFiler</CODE></h1> 103 104 <h2>Overview</h2> 105 <p> 106 The <CODE>TwlNandFiler</CODE> tool manipulates data in the <CODE>CTR</CODE> system <CODE>NAND</CODE> memory (TWL region). You can use it to delete, browse, and edit photo data, as well as, <CODE>DSiWare</CODE> save data stored in the system <CODE>NAND</CODE> memory.<BR> By using an SD Card, you can also use this tool to import and export save data. 107 </p> 108 109 <h2>Run</h2> 110 <p> 111 First import <CODE>TwlNandFiler.cia</CODE> using the Import tab of <a href="./DevMenu.html"><CODE>DevMenu</CODE></a>, and then select "<CODE>TWL NandFiler</CODE>" to run it. 112 </p> 113 114 <h2>Mode</h2> 115 <p>There are three modes in <CODE>TwlNandFiler</CODE>.</p> 116 <ul> 117 <li><CODE>Filer</CODE> mode: Lets you traverse directories and check file sizes, timestamps, and attributes.</li> 118 <li><CODE>View</CODE> mode: Lets you browse file contents.</li> 119 <li><CODE>Edit</CODE> mode: Lets you edit file contents.</li> 120 </ul> 121 122<h2><CODE>Filer</CODE> Mode</h2> 123 <img src="TwlNandFiler/Filer_0.png" alt=""> <img src="TwlNandFiler/Filer_1.png" alt=""> 124 <p> 125The <CODE>TwlNandFiler</CODE> tool starts in <CODE>Filer</CODE> mode by default.<br />In <CODE>Filer</CODE> mode, after you select either photo data, <CODE>DSiWare</CODE> save data that has been already imported in the system, or SD Card data, you can browse and operate on that directory tree.<br /><font color=#ff0000>When you are browsing the contents of an SD Card, file and directory names will not appear if they use characters that cannot be converted to Shift_JIS. </font> 126 </p> 127 128The following table shows what operations can be performed. 129 <table class="table"> 130 <tbody> 131<tr><th>Button</th><th>Operation</th></tr> 132<tr><td>SELECT</td><td>Displays a list of operations</td></tr> 133<tr><td>←→</td><td>Switches pages for the displayed items.</td></tr> 134<tr><td>↑↓</td><td>Selects files and so on.</td></tr> 135 <!--<tr><td>START<td>選択されている NAND アプリを起動--> 136<tr><td>A</td><td>Confirms an item.</td></tr> 137<tr><td>B</td><td>Cancels the archive or file selection.<br />Moves to the parent directory.</td></tr> 138<tr><td>X</td><td>Opens a submenu when a file or archive is selected.</td></tr> 139 </tbody> 140 </table> 141 142 <h3>Title Selection</h3> 143 <p> 144 This is the state immediately after startup. The left side of the screen displays links (shown in yellow) to the Game Code (shown in blue) of the installed <CODE>DSiWare</CODE>, and to photo data and the SD Card.<br /> Selecting a Game Code switches to archive selection in the center of the screen. Selecting a link to photo data or an SD Card switches to file selection on the right side of the screen.<BR> The following operations can be selected on the submenu displayed by pressing the X Button. 145 <ul> 146 <li>Export ... Export data.</li> 147 <li>Fill ... Fill the photo region.</li> 148 </ul> 149 </p> 150 151 <h4>Export</h4> 152 <p> 153Copies files from the application's save data region or the PHOTO directory to the SD Card.<br />A directory is created on the SD Card (named either [4-digit game code_FFFF] or [PHOTO]), and then the data is copied there. 154 155 </p> 156 157 <h4>Fill</h4> 158 <p> 159 Writes photo data to the PHOTO directory, leaving the photo region with zero available memory.<br /> This process may take several dozen seconds to complete.<br /> 160 </p> 161 162 163 <h3><a name="Archive">Archive Selection</a></h3> 164 <p> 165Selecting a Game Code under Title Selection moves here. For Archive Selection, you can choose <CODE>Public</CODE>, <CODE>Private</CODE>, or <CODE>SBanner</CODE>. These are links to the public save data, private save data, and sub-banner of the <CODE>DSiWare</CODE> selected under Title Selection.<br /> The following operations can be selected on the submenu that is displayed by pressing the X Button. 166 </p> 167 <ul> 168 <li><CODE>Backup</CODE>: Backs up save data.</li> 169 <li><CODE>Break</CODE>: Destroys the save data region.</li> 170 <li><CODE>Format</CODE>: Formats the save data region or sub-banner.</li> 171 </ul> 172 <p> 173 However, the <CODE>Backup</CODE> and <CODE>Break</CODE> features do not exist in the sub-banner submenu. 174 </p> 175 176 <h4>Backup</h4> 177 <p> 178 Backs up save data on the SD Card. The data backed up here can be imported using the <CODE>Restore</CODE> operation, described below.<br /> <CODE>Backup</CODE> differs from the <CODE>Export</CODE> operation described above, in that the entire file system of the save data region is copied to the SD Card, but with Export, data is copied in file units. 179 </p> 180 181 <h4>Break</h4> 182 <p> 183 Destroys the FAT system region of the save data. This can be used for debugging when you think the <CODE>DSiWare</CODE> save data region may cause an error.<br /> For details, see the <CODE>TWL-SDK</CODE> reference.<BR> This tool can restore the destroyed save data region through any of the methods described below. 184 </p> 185 186 <ul> 187 <li>Execute <CODE>Backup</CODE> before using <CODE>Break</CODE> and then use <CODE>Restore</CODE> after Break.</li> 188 <li>Run <CODE>Format</CODE> (files in the save data are deleted).</li> 189 <li>Re-import the application.</li> 190 </ul> 191 192 <h4>Format</h4> 193 <p> 194 Initializes the save data and sub-banner.<BR> Restoration is possible if save data or sub-banner data becomes invalid using a break. 195 </p> 196 197 <h3>File Selection</h3> 198 <p> 199 If <CODE>PHOTO</CODE> or <CODE>SD</CODE> have been selected under Title Selection, selecting any save data under Archive Selection moves to here.<br /> A list of directories (yellow) and files (white) are displayed under File Selection.<br /> When a directory is selected, press the A Button to browse the contents of that directory.<BR> When a file is selected , press the A Button to switch to <CODE>View</CODE> mode.<br /> 200 </p> 201 202 The following is the meaning of information that is displayed at the top of the screen in File Selection. 203 <table class="table"> 204 <tbody> 205<tr><td>Size:</td><td>File size.</td></tr> 206<tr><td>CTime:</td><td>The time the file was created.</td></tr> 207<tr><td>MTime:</td><td>The time the file was last modified.</td></tr> 208<tr><td>ATime:</td><td>The time the file was last accessed.</td></tr> 209<tr><td>Attr:</td><td>File attributes: <br />REA: Read-only files<br />HID: Hidden files<br />SYS: System files<br />VOL: Volume level<br />PRO: Protected files<br />ARC: Archives</td></tr> 210<tr><td>Very bottom of screen</td><td>Full path to the selected file.</td></tr> 211 </tbody> 212 </table> 213 214 <p> 215 The following operations can be selected on the submenu that is displayed by pressing the X Button. 216 <ul> 217 <li>Import: Imports Save Data.</li> 218 <li>Delete: Deletes files and directories.</li> 219 <li>Restore: Restores save data.</li> 220 </ul> 221 </p> 222 223 <h4>Import</h4> 224 <p> 225 This operation is valid for directories created with the <CODE>Export</CODE> operation. Note, however, that exported PHOTO directories cannot be imported.<br /> This operation copies data to the save data region of system memory. Provided the data does not exceed the size of the save data region of system memory, the data copied over by <CODE>Export</CODE> can be imported even if it has been altered. 226 </p> 227 228 <h4>Delete</h4> 229 <p> 230 Deletes a file or directory. If a directory is selected, files and directories inside the directory are deleted recursively. 231 </p> 232 233 <h4>Restore</h4> 234 <p> 235 This operation is only valid for save data backup files created using the Backup feature. The backup file on the SD Card is imported to system NAND memory.<br /> Note that importing backup files will fail in the cases given below. 236 <ul> 237 <li>When the backup file has been modified.</li> 238 <li>When the backup file name has been changed.</li> 239 <li>When the corresponding application has been deleted.</li> 240 <li>When the save data save size of the application in question has changed.</li> 241 </ul> 242 </p> 243 244 245 <h2>View Mode</h2> 246 <p> 247 <img src="TwlNandFiler/Viewer_0.png" alt=""> 248 </p> 249 <p> 250 In View mode, you can view file contents. The displayed filename and addresses are shown on the upper screen. <br /> The content of the file (binary values and corresponding characters) is shown on the lower screen.<br /> 251 </p> 252 253 <p> 254 The following specifications apply to the display of characters. 255 <ul> 256 <li><CODE>0x00</CODE> can be replaced by <CODE>0x20</CODE> (a space).</li> 257 <li><CODE>0x20</CODE> to <CODE>0x7A</CODE> conform to ASCII code.</li> 258 <li>Other regions display hiragana and katakana (font incorporated as sample).</li> 259 </ul> 260 </p> 261 262 The following table shows what operations can be performed. 263 264 <table class="table"> 265 <tbody> 266<tr><th>Button</th><th>Operation</th></tr> 267<tr><td>←→</td><td>Scrolls one page at a time.</td></tr> 268<tr><td>↑↓</td><td>Scrolls (one line at a time).</td></tr> 269<tr><td>A</td><td>Switches to Edit mode.</td></tr> 270<tr><td>B</td><td>Switches to <CODE>Filer</CODE> mode.<br />If a file has been edited in <CODE>Edit</CODE> mode, it will be saved.</td></tr> 271 </tbody> 272 </table> 273 274 275 <h2>Edit Mode</h2> 276 277 <p> 278 <img src="TwlNandFiler/Editor_0.png" alt=""> 279 </p> 280 <p> 281 <CODE>Edit</CODE> mode lets you edit files.<br /> Take note of the following restrictions. 282 </p> 283 284 <h4>Editing restrictions</h4> 285 <ul> 286 <li>There is no support for changes in file size.</li> 287 <li>When the file being edited is larger than 14MB, if regions near the start and the end of the file are edited at the same time, earlier changes will not be reflected.</li> 288 </ul> 289 290 <h3>Non-Editing State</h3> 291 <p>This state occurs when entering Edit mode.</p> 292 <table class="table"> 293 <tbody> 294<tr><th>Button</th><th>Operation</th></tr> 295<tr><td>←→↑↓</td><td>Moves the cursor</td></tr> 296<tr><td>A</td><td>Switches to the editing state</td></tr> 297<tr><td>B</td><td>Switches to View mode</td></tr> 298 </tbody> 299 </table> 300 301 <h3>Editing State</h3> 302 303 <table class="table"> 304 <tbody> 305<tr><th>Button</th><th>Operation</th></tr> 306<tr><td>←→↑↓</td><td>Moves the cursor.</td></tr> 307<tr><td>B</td><td>Switches to the non-editing state<br /></td></tr> 308<tr><td>L, R</td><td>Increase, Decrease value</td></tr> 309 </tbody> 310 </table> 311 312 <p> 313 Pressing the L or R Buttons in the editing state will change the value at the current cursor position.<br /> Locations where any edits have been made will appear in green. The cursor can be moved freely even in the editing state, but the horizontal range of movement is reduced compared to the non-editing state.<br /> To save edits, select <B>Yes</B> from the choices displayed when you press the B Button in View mode.<br /> 314 </p> 315 316 <h2>Revision History</h2> 317 <div class="section"> 318 <dl class="history"> 319 <dt>2011/12/15</dt> 320 <dd>Initial version.<br /></dd> 321 </dl> 322 </div> 323<hr><p>CONFIDENTIAL</p></body> 324</html>
