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.1.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>nitrorun.TWL</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} 17.command_list{ 18 margin-bottom : 16pt; 19} 20.command_desc{ 21 } 22.command_item{ 23 margin-top : 16pt; 24 background-color : #e8e8e8; 25} 26.blockquoted_table { 27 border : 1px; 28 width : 80%; 29} 30TD,TH{ 31 border-color : #c0d8d8; 32 padding : 1pt 4pt 1pt 4pt; 33 border-width : 1px; 34 border-style : solid; 35} 36--> 37</STYLE> 38</HEAD> 39<BODY> 40<H1 align="left">nitrorun.TWL <IMG src="../image/TWL.gif" align="middle"></H1> 41 42<H2>Description</H2> 43<P><FONT color=#ff0000>This command is for TWL ROMs. See <A href="nitrorun.html"><CODE>nitrorun</CODE></A> for details on NITRO ROMs.</FONT></P> 44<P> The <CODE>nitrorun.TWL</CODE> script executes the following series of operations: starting <A href="buryargTWL.html"><CODE>buryarg.TWL</CODE></A> and <A href="loadrunTWL.html"><CODE>loadrun.TWL</CODE></A>, passing arguments from the command line, overwriting the argument region of the SRL file, downloading the data to IS-TWL-DEBUGGER and/or another device, and executing the code.</P> 45<P>Specifically:</P> 46<BLOCKQUOTE><CODE><A href="buryargTWL.html">buryarg.TWL</A> --stdout ... > temporaryFile<BR> <A href="loadrunTWL.html">loadrun.TWL</A> ... temporaryFile</CODE></BLOCKQUOTE> 47<P>This will call <A href="buryargTWL.html"><CODE>buryarg.TWL</CODE></A> and <A href="loadrunTWL.html"><CODE>loadrun.TWL</CODE></A> in sequence. With <A href="nitrorun.html"><CODE>nitrorun</CODE></A>, these commands were joined with pipes, but with TWL, a different method is used to load SRL files in the debugger, so the original method cannot be used. As a result, we have broken it into two commands.</P> 48<P>The reasons that the command name "<CODE>nitrorun.TWL</CODE>" is used even though this command is run on TWL ROMs are (1) to match the <A href="nitrorun.html"><CODE>nitrorun</CODE></A> command that has been around since the former NITRO-SDK, and (2) to follow the command-naming convention wherein ".TWL" is added to indicate that the command is for TWL.</P> 49<H2>Using the Tool</H2> 50<H3>Start Command</H3> 51<P><CODE>% nitrorun.TWL [OPTION]... [[TWLSRLFILE] [ARGUMENT]...]</CODE></P> 52<P><CODE>TWLSRLFILE</CODE> is the ROM file to execute. You can specify SRL files.</P> 53<P>The <B><CODE>-h</CODE></B> or <B><CODE>--help</CODE></B> option displays simple instructions.</P> 54<P>The <B><CODE>--bopt</CODE></B> option specifies options to be passed to the <A href="buryargTWL.html"><CODE>buryarg.TWL</CODE></A> command. However, the <CODE>--stdin</CODE> option does not need to be described because it will be attached in advance.</P> 55<P>The <B><CODE>--lopt</CODE></B> option specifies options to be passed to the <A href="loadrunTWL.html"><CODE>loadrun.TWL</CODE></A> command.</P> 56<P>If the <B><CODE>-v</CODE></B> or <B><CODE>--verbose</CODE></B> option is specified, detailed operation descriptions are displayed. </P> 57<P>Specifying the <B><CODE>-n</CODE></B> or <B><CODE>--noexec</CODE></B> option does not execute the command. When used in conjunction with the <CODE>-v</CODE> option, you can check which type of command will be executed.</P> 58<P>The <B><CODE>--version</CODE></B> option displays the command version.</P> 59<P><B><BR> <BR> <BR> Example 1</B></P> 60<BLOCKQUOTE><CODE>nitrorun.TWL <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT></CODE></BLOCKQUOTE> 61<BLOCKQUOTE>executes the following commands.</BLOCKQUOTE> 62<BLOCKQUOTE><CODE><A href="buryargTWL.html">buryarg.TWL</A> --stdout <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT> > tmpFile<BR> <A href="loadrunTWL.html">loadrun.TWL</A> tmpFile</CODE></BLOCKQUOTE> 63<BLOCKQUOTE> </BLOCKQUOTE> 64<P><B>Example 2</B></P> 65<BLOCKQUOTE><CODE>nitrorun.TWL --bopt "<FONT color="#00cc66">-f rep.dat</FONT>" --lopt "<FONT color="#ff0033">-t 300 -a \"ABORT\"</FONT> " <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT></CODE></BLOCKQUOTE> 66<BLOCKQUOTE>executes the following commands.</BLOCKQUOTE> 67<BLOCKQUOTE><CODE><A href="buryargTWL.html">buryarg.TWL</A> --stdout <FONT color="#00cc66">-f rep.dat</FONT> <FONT color="#ff6600">main.srl</FONT> <FONT color="#cc0099">100 300</FONT> > tmpFile<BR> <A href="loadrunTWL.html">loadrun.TWL</A> <FONT color="#ff0033">-t 300 -a "ABORT"</FONT> tmpFile</CODE></BLOCKQUOTE> 68<BLOCKQUOTE><CODE> </CODE></BLOCKQUOTE> 69<H2>Location</H2> 70<P><CODE>$TwlSDK/tools/bin/nitrorun.TWL</CODE></P> 71<H2>See Also</H2> 72<P><A href="buryargTWL.html"><CODE>buryarg.TWL</CODE></A><BR> <A href="loadrunTWL.html"><CODE>loadrun.TWL</CODE></A><BR> <A href="nitrorun.html"><CODE>nitrorun</CODE></A></P> 73<H2>Revision History</H2> 74<P>2008/07/10 Initial version.</P> 75<hr><p>CONFIDENTIAL</p></body> 76</HTML> 77
