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>SCFG_GetSystemRomType</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">SCFG_GetSystemRomType <IMG src="../../image/TWL.gif" width="23" height="12" border="0" align="middle"></H1>
12
13<H2>Syntax</H2>
14<DL>
15  <DD>
16<PRE><CODE>#include &lt;twl/scfg.h&gt;</CODE></PRE>
17  <PRE><CODE>static inline SCFGSystemRomType SCFG_GetSystemRomType( void );
18  </CODE></PRE>
19</DL>
20<H2>Arguments</H2>
21<P>None.</P>
22<H2>Return Values</H2>
23<P>If <CODE>SCFG_SYSTEM_ROM_FOR_TWL</CODE>, 64KB of ROM is used in TWL mode.<BR>If <CODE>SCFG_SYSTEM_ROM_FOR_NITRO</CODE>, 8KB of ROM is used in NITRO-compatible mode.</P>
24<H2>Description</H2>
25<P>Gets which of two types has been set as the system ROM for the ARM9.</P>
26<P>The system ROM is set to either the 64KB of ROM used in TWL mode or the 8KB of ROM used in NITRO-compatible mode.</P>
27<P><B><FONT color="#ff0000">Note:</B> Use this function when running on TWL hardware.</FONT></P>
28<P>Because NITRO hardware does not include an SCFG block, this function is not expected to be called on NITRO hardware. If this function is called when running on NITRO hardware, it returns <CODE>SCFG_SYSTEM_ROM_FOR_TWL</CODE>. Although execution does not stop even if called like this, note that the value returned is meaningless.</P>
29<H3>Correspondence Table for the Operating Environment/Operating Mode and Return Values</H3>
30<TABLE border="1">
31  <TBODY>
32    <TR>
33<TH>Operating Environment</TH>
34<TH>Return Values When Operating in TWL Mode</TH>
35<TH>Return Values When Operating in NITRO Mode</TH>
36    </TR>
37    <TR>
38<TD>IS-TWL-DEBUGGER<BR>TWL hardware</TD>
39<TD><CODE>SCFG_SYSTEM_ROM_FOR_TWL</CODE></TD>
40<TD><CODE>SCFG_SYSTEM_ROM_FOR_NITRO</CODE></TD>
41    </TR>
42    <TR>
43<TD>IS-NITRO-DEBUGGER<BR> ENSATA EMULATOR<BR> NITRO hardware</TD>
44<TD>(This combination does not exist.)</TD>
45<TD><CODE>SCFG_SYSTEM_ROM_FOR_TWL</CODE><BR> <FONT color="#ff0000">Because this combination is not anticipated, <BR>the return value means nothing.</FONT></TD>
46    </TR>
47  </TBODY>
48</TABLE>
49<H2>See Also</H2>
50<P><A href="../overview_scfg.html">SCFG Overview</A></P>
51<H2>Revision History</H2>
52<P>2008/10/07 Added a note.<BR> 2007/10/03 Initial version.</P>
53<hr><p>CONFIDENTIAL</p></body>
54</HTML>