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<LINK rel="stylesheet" type="text/css" href="../../css/nitro.css"> 8<TITLE>SPI Demos</TITLE> 9</HEAD> 10<BODY> 11<H1>ARM7 Processor Peripheral Sample Demos</H1> 12 13<H2>Location</H2> 14<P><CODE>$TwlSDK/build/demos/spi<BR> $TwlSDK/build/demos.TWL/spi</CODE></P> 15 16<H2>Compilation</H2> 17<P>Move to the <CODE>$TwlSDK/build/demos/spi</CODE> (or <CODE>$TwlSDK/build/demos.TWL/spi</CODE>) directory and enter the following.</P> 18<BLOCKQUOTE><CODE>% make</CODE></BLOCKQUOTE> 19<P> The compilation begin, and the SRL executable file and the NEF or TEF files with binary information are generated in <CODE>$TwlSDK/build/demos/fs/(sample name)/bin/(platform)/(target)/</CODE>.</P> 20<BLOCKQUOTE><CODE>$TwlSDK/build/demos/spi/(sample name)/bin/(platform)/(target)/</CODE><BR> <CODE>$TwlSDK/build/demos.TWL/spi/(sample name)/bin/(platform)/(target)/</CODE></BLOCKQUOTE> 21<P> For example:</P> 22<BLOCKQUOTE><CODE>$TwlSDK/build/demos/spi/tp-1/bin/ARM9-TS/Release/main.srl</CODE></BLOCKQUOTE> 23<P>is the executable file for the <CODE>tp-1</CODE> demo.</P> 24 25<H2>Execution</H2> 26<H3>For NITRO ROMs</H3> 27<P>If using the Ensata emulator:</P> 28<UL> 29<LI>Execute NEF and SRL files with ensata 30</UL> 31<P>If using IS-NITRO-DEBUGGER:</P> 32<UL> 33<LI>Load and execute an NLF file with IS-NITRO-DEBUGGER 34<LI>Execute an SRL file with IS-NITRO-DEBUGGER 35<LI>Execute an SRL file with IS-NITRO-DEBUGGER using the <CODE>loadrun.exe</CODE> tool from a command line 36</UL> 37<P>If using IS-TWL-DEBUGGER:</P> 38<UL> 39<LI>Load and execute an NLF file with IS-TWL-DEBUGGER 40<LI>Execute an SRL file with IS-TWL-DEBUGGER 41<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line 42</UL> 43<H3>For TWL/NITRO Hybrid ROMs</H3> 44<P>If using IS-NITRO-DEBUGGER:</P> 45<UL> 46<LI>Execute an SRL file with IS-NITRO-DEBUGGER 47<LI>Execute an SRL file with IS-NITRO-DEBUGGER using the <CODE>loadrun.exe</CODE> tool from a command line 48</UL> 49<P>If using IS-TWL-DEBUGGER:</P> 50<UL> 51<LI>Load and execute a TLF file with IS-TWL-DEBUGGER 52<LI>Execute an SRL file with IS-TWL-DEBUGGER 53<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line 54</UL> 55<H3>For TWL Limited ROMs</H3> 56<P>If using IS-TWL-DEBUGGER:</P> 57<UL> 58<LI>Load and execute a TLF file with IS-TWL-DEBUGGER 59<LI>Execute an SRL file with IS-TWL-DEBUGGER 60<LI>Execute an SRL file with IS-TWL-DEBUGGER using the <CODE>loadrun.TWL.exe</CODE> tool from a command line 61</UL> 62<H2>Description</H2> 63<br> 64 65<TABLE width="720"> 66 <TBODY> 67 <TR> 68<TH>Name</TH> 69<TH>Directory</TH> 70<TH>Operation</TH> 71 </TR> 72 <TR> 73<TD width="187"><CODE>tp-1</CODE></TD> 74<TD><CODE>demos</CODE></TD> 75<TD width="525">Displays touch panel input positions on the screen.</TD> 76 </TR> 77 <TR> 78<TD width="187"><CODE>tp-2</CODE></TD> 79<TD><CODE>demos</CODE></TD> 80<TD width="525">Displays the track of touch panel input positions on the screen.</TD> 81 </TR> 82 <TR> 83<TD width="187"><CODE>mic-1</CODE></TD> 84<TD><CODE>demos</CODE></TD> 85<TD width="525">Displays the microphone voice input status on the screen as a waveform.</TD> 86 </TR> 87 <TR> 88<TD width="187"><CODE>mic-2</CODE></TD> 89<TD><CODE>demos</CODE></TD> 90<TD width="525">Displays microphone voice input status on the screen as a waveform, and outputs text data. <br> The <a href="../../tools/mic2wav.html"><code>mic2wav.exe</code></a> tool can convert the obtained data into a WAV file.</TD> 91 </TR> 92 <TR> 93<TD><CODE>mic-3</CODE></TD> 94<TD><CODE>demos.TWL</CODE></TD> 95<TD>Displays a waveform on the screen indicating the state of audio input, based on the TWL's own microphone auto-sampling methods.</TD> 96 </TR> 97 <TR> 98<TD><CODE>mic-4</CODE></TD> 99<TD><CODE>demos.TWL</CODE></TD> 100<TD>Displays a waveform on the screen indicating the audio input status, based on the TWL's own microphone auto-sampling methods, and outputs it as text data.<BR><br> The <a href="../../tools/mic2wav.html"><code>mic2wav.exe</code></a> tool can convert the obtained data into a WAV file.</TD> 101 </TR> 102 <TR> 103<TD width="187"><CODE>spiMonkey</CODE></TD> 104<TD><CODE>demos</CODE></TD> 105<TD width="525">Displays touch screen and microphone input status on the screen while playing the background music.</TD> 106 </TR> 107 <TR> 108<TD width="187"><CODE>spiMonkey2</CODE></TD> 109<TD><CODE>demos</CODE></TD> 110<TD width="525">Displays touch screen and microphone input status on the screen while playing BGM.<BR>Unlike <code>spiMonkey</code>, it uses automatic sampling to sample the microphone.</TD> 111 </TR> 112 <TR> 113<TD><CODE>spiMonkey3</CODE></TD> 114<TD><CODE>demos.TWL</CODE></TD> 115<TD>Displays touch screen and microphone input status on the screen while playing BGM.<BR>Unlike <code>spiMonkey2</code>, it uses the TWL's own auto-sampling method to sample the microphone.</TD> 116 </TR> 117 <TR> 118<TD width="187"><CODE>pm-1</CODE></TD> 119<TD><CODE>demos</CODE></TD> 120<TD width="525">Enters sleep mode or power save mode by pressing the power button or closing the cover.</TD> 121 </TR> 122 <TR> 123<TD width="187"><CODE>pm-2</CODE></TD> 124<TD><CODE>demos.TWL</CODE></TD> 125<TD width="525">When the power button is pressed, the system will wait for the user operation to actually exit the application.</TD> 126 </TR> 127 <TR> 128<TD><CODE>pmAmpGain</CODE></TD> 129<TD><CODE>demos</CODE></TD> 130<TD>Manipulates the gain of the audio input through the microphone.<BR>The results of sampling the audio input are displayed on the screen as a waveform, much like with the <CODE>mic-1</CODE> demo.</TD> 131 </TR> 132 <TR> 133<TD><CODE>pmAmpGainLevel</CODE></TD> 134<TD><CODE>demos.TWL</CODE></TD> 135<TD>Manipulates the gain of the audio input through the microphone.<BR>Unlike <CODE>pmAmpGain</CODE>, this demo can manipulate the gain with a finer resolution thanks to the TWL's unique features.</TD> 136 </TR> 137 </TBODY> 138</TABLE> 139 140<H2>Operation</H2> 141<P><CODE>mic-1</CODE>, <CODE>mic-2</CODE>, <CODE>spiMonkey</CODE>, <CODE>spiMonkey2</CODE>, and <CODE>pm-1</CODE> do not function properly with <CODE>ensata</CODE>.<BR> <CODE>mic-1</CODE> and <CODE>mic-2</CODE> function normally only when using NITRO ROM.<BR> <code>tp-1</code>, <code>tp-2</code>, <code>spiMonkey</code>, and <code>spiMonkey2</code> attempt to read touch panel calibration values from the non-volatile memory (NVRAM) in the DS. If they do not succeed they will terminate with an exception. In this case, use the DS Start menu that is built into the Nintendo DS to store calibration results in NVRAM.</P> 142 143<H2>See Also</H2> 144<P><A href="../../spi/list_spi.html">SPI Function List</A></P> 145 146<H2>Revision History</H2> 147<P>2008/11/13 Added text about <CODE>pm-2</CODE>.<BR> 2008/07/15 Added descriptions about <CODE>mic-3</CODE>, <CODE>mic-4</CODE>, <CODE>spiMonkey3</CODE>, <CODE>pmAmpGain</CODE>, and <CODE>pmAmpGainLevel</CODE>.<BR> 2008/07/11 Changed notation to correspond with TWL.<BR> 2008/04/25 Touched up the table. Changed the lists for TWL.<BR>2005/05/10 Added information about <code>spiMonkey2</code>.<br /> 2005/03/02 Revised descriptions to reflect current support environment conditions.<br /> 2004/08/17 Standardized the notation of IS-NITRO-EMULATOR.<br /> 2004/08/03 Added <CODE>pm-1</CODE>.<br /> 2004/07/10 Changed from <code>.bin</code> to <code>.srl</code>.<br>2004/06/18 Initial version. 148</P> 149 150<hr><p>CONFIDENTIAL</p></body> 151</HTML>