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<LINK rel="stylesheet" type="text/css" href="../../css/nitro.css">
8<TITLE>MI Demos</TITLE>
9</HEAD>
10<BODY>
11<H1>Memory Interface (MI) Sample Demos</H1>
12<H2>Location</H2>
13<P><CODE>$TwlSDK/build/demos/mi<BR> $TwlSDK/build/demos.TWL/mi</CODE></P>
14<H2>Compilation</H2>
15<P>Move to the <CODE>$TwlSDK/build/demos/mi</CODE> (or <CODE>$TwlSDK/build/demos.TWL/mi</CODE>) directory, and enter</P>
16<BLOCKQUOTE><CODE>% make</CODE></BLOCKQUOTE>
17<P>&nbsp;The SRL executable file and the NEF or TEF files with binary information are created in <CODE>$TwlSDK/build/demos/mi/(sample name)/bin/(platform)/(target)/</CODE><BR> <CODE>$TwlSDK/build/demos.TWL/mi/(sample name)/bin/(platform)/(target)/</CODE>.</P>
18<BLOCKQUOTE></BLOCKQUOTE>
19<P>&nbsp;For example:</P>
20<BLOCKQUOTE><CODE>$TwlSDK/build/demos/mi/dmaCallback-1/bin/ARM9-TS/Release/main.srl</CODE></BLOCKQUOTE>
21<P>will be the executable file for the <CODE>dmaCallback-1</CODE> demo.</P>
22
23<H2>Execution</H2>
24<H3>For NITRO ROMs:</H3>
25<P>If using the Ensata emulator:</P>
26<UL>
27<LI>Execute NEF and SRL files with ensata.
28</UL>
29<P>If using IS-NITRO-DEBUGGER:</P>
30<UL>
31<LI>Load and execute an NLF file with IS-NITRO-DEBUGGER.
32<LI>Execute an SRL file with IS-NITRO-DEBUGGER
33<LI>Execute an SRL file with IS-NITRO-DEBUGGER using the <CODE>loadrun.exe</CODE> tool from a command line.
34</UL>
35<P>If using IS-TWL-DEBUGGER:</P>
36<UL>
37<LI>Load and execute an NLF file with IS-TWL-DEBUGGER.
38<LI>Execute an SRL file with IS-TWL-DEBUGGER.
39<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line.
40</UL>
41<H3>For TWL/NITRO HYBRID ROMs:</H3>
42<P>If using IS-NITRO-DEBUGGER:</P>
43<UL>
44<LI>Execute an SRL file with IS-NITRO-DEBUGGER
45<LI>Execute an SRL file with IS-NITRO-DEBUGGER using the <CODE>loadrun.exe</CODE> tool from a command line.
46</UL>
47<P>If using IS-TWL-DEBUGGER:</P>
48<UL>
49<LI>Load and execute a TLF file with IS-TWL-DEBUGGER.
50<LI>Execute an SRL file with IS-TWL-DEBUGGER.
51<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line.
52</UL>
53<H3>For TWL LIMITED ROMs:</H3>
54<P>If using IS-TWL-DEBUGGER:</P>
55<UL>
56<LI>Load and execute a TLF file with IS-TWL-DEBUGGER.
57<LI>Execute an SRL file with IS-TWL-DEBUGGER.
58<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line.
59</UL>
60
61<H2>Description</H2>
62<TABLE width="720">
63  <TBODY>
64    <TR>
65<TH>Name</TH>
66<TH>Directories</TH>
67<TH>Operation</TH>
68    </TR>
69    <TR>
70<TD width="187"><EM><STRONG><CODE>dmaCallback-1</CODE></STRONG></EM></TD>
71<TD><CODE>demos</CODE></TD>
72<TD width="525">Uses DMA callback during V-Blank.</TD>
73    </TR>
74    <TR>
75<TD width="187"><EM><STRONG><CODE>uncompressStream-1</CODE></STRONG></EM></TD>
76<TD><CODE>demos</CODE></TD>
77<TD width="525">Reads and extracts compressed image data from a stream.</TD>
78    </TR>
79    <TR>
80<TD width="187"><EM><STRONG><CODE>uncompressBLZ</CODE></STRONG></EM></TD>
81<TD><CODE>demos</CODE></TD>
82<TD width="525">This sample extracts BLZ-compressed data.</TD>
83    </TR>
84    <TR>
85<TD><CODE><EM><STRONG><B>ndma-1</B></STRONG></EM></CODE></TD>
86<TD><CODE>demos.TWL</CODE></TD>
87<TD>Uses the new DMA.</TD>
88    </TR>
89    <TR>
90<TD><CODE><EM><STRONG><B>wramManager-1</B></STRONG></EM></CODE></TD>
91<TD><CODE>demos.TWL</CODE></TD>
92<TD>Uses the WRAM manager on WRAM-A/B/C.</TD>
93    </TR>
94  </TBODY>
95</TABLE>
96<H2>Operation</H2>
97<P>Operates normally in all operating environments.</P>
98<H2>See Also</H2>
99<P><A href="../../mi/list_mi.html"><CODE>MI Function List</CODE></A></P>
100<H2>Revision History</H2>
101<P>2008/06/23 Added a description of the <CODE>uncompressBLZ</CODE> sample demo.<BR> 2008/05/22 Changed <CODE>UnComp_Stream_BmpBG</CODE> to <CODE>uncompressStream-1</CODE>.<BR> 2008/04/25 Cleaned up the table. Changed the lists for TWL.<BR>2005/05/10 Added description of <code>UnComp_Stream_BmpBG</code> demo.<br /> 2005/03/08 Standardized the Japanese word for &quot;interrupt.&quot;<br /> 2005/03/02 Revised descriptions to reflect current support environment conditions.<br />2005/03/08 Standardized the Japanese term for &quot;interrupt.&quot;<br /> 2005/03/02 Revised descriptions to reflect current support environment conditions.<br />2004/08/17 Standardized the notation of the IS-NITRO-EMULATOR.<br /> 2004/07/10 Changed from <code>.bin</code> to <code>.srl.</code><br />2004/01/18 Initial version.</P>
102<hr><p>CONFIDENTIAL</p></body>
103</HTML>