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>Exceptions: Overview</TITLE><LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 8</HEAD> 9<BODY> 10<H1 align="left">Exceptions: Overview <img src="../../image/NTR.gif" align="middle"><img src="../../image/TWL.gif" align="middle"></H1> 11<P>This page explains the exception display system used by the TWL-SDK to show information about exceptions generated on the ARM processors.</P> 12<H2>Exception Types</H2> 13<P>The following exceptions exist for the ARM processors.<BR> 14</P> 15<TABLE border="1"> 16 <TBODY> 17 <TR bgcolor="red"> 18<TH>Exception Type</TH> 19<TH>Normal Vector Address</TH> 20<TH>High Vector Address</TH> 21 </TR> 22 <TR> 23<TD>Reset</TD> 24<TD>0x00000000</TD> 25<TD>0xFFFF0000</TD> 26 </TR> 27 <TR> 28<TD>Undefined instruction</TD> 29<TD>0x00000004</TD> 30<TD>0xFFFF0004</TD> 31 </TR> 32 <TR> 33<TD>Software interrupt</TD> 34<TD>0x00000008</TD> 35<TD>0xFFFF0008</TD> 36 </TR> 37 <TR> 38<TD>Pre-fetch abort</TD> 39<TD>0x0000000C</TD> 40<TD>0xFFFF000C</TD> 41 </TR> 42 <TR> 43<TD>Data abort</TD> 44<TD>0x00000010</TD> 45<TD>0xFFFF0010</TD> 46 </TR> 47 <TR> 48<TD>IRQ</TD> 49<TD>0x00000018</TD> 50<TD>0xFFFF0018</TD> 51 </TR> 52 <TR> 53<TD>FIQ</TD> 54<TD>0x0000001C</TD> 55<TD>0xFFFF001C</TD> 56 </TR> 57 </TBODY> 58</TABLE> 59<P><BR> Out of this list, the <I>reset interrupt</I> and <I>FIQ</I> exceptions are used by the system or debugger, so they cannot be used by users.</P> 60<P>The <I>IRQ</I> exception can be used as an interrupt. See the following for information about interrupts. <A href="../irq/about_irq.html">Interrupts (Overview)</A></P> 61<P>Some of the undefined instructions are used by the debugger for breakpoints and other such data.</P> 62<P>When an exception occurs, control is transferred to the pertinent vector address, as shown in the table above. This normally involves use of high vector addresses.</P> 63<H2>Positioning the Exception Vector</H2> 64<P>The ARM processor specifications allow you to set the exception vector addresses at either the range <CODE>0x00000000</CODE> to <CODE>0x0000001C</CODE> or the range <CODE>0xFFFF0000</CODE> to <CODE>0xFFFF001C</CODE>. The former are called normal vectors, and the latter are called high vectors.</P> 65<P>The <a href="OS_SetExceptionVectorLower.html"><nobr><code>OS_SetExceptionVectorLower</code></nobr></a> function sets the exception vectors to addresses <code>0x0000000</code> to <code>0x0000001C</code> (normal vectors).</P> 66<P>The <a href="OS_SetExceptionVectorUpper.html"><nobr><code>OS_SetExceptionVectorUpper</code></nobr></a> function sets the exception vectors to addresses <code>0xFFFF0000</code> to <code>0xFFFF001C</code> (high vectors).</P> 67<P>The TWL-SDK uses the high vectors by default. <FONT color="#ff0033">Unless you have a special reason, use the high vectors and do not change this setting.</FONT></P> 68<H2>Displaying Contexts During Exceptions</H2> 69<P>The TWL-SDK contains a mechanism for displaying the context (the contents of the registers and the CPU status) to the debug window (console) when an exception occurs. This exception display mechanism is initialized using the <A href="OS_InitException.html"><CODE>OS_InitException</CODE></A> function, but this function is called from the <A href="../init/OS_Init.html"><CODE>OS_Init</CODE></A> function, so no real preparation is required in applications that use the <A href="../init/OS_Init.html"><CODE>OS_Init</CODE></A> function.</P> 70<P>The example below shows what is displayed. The error output from the <A href="../debug/OS_FPrintf.html"><CODE>OS_FPrintf</CODE></A> function is used to display the information.</P> 71<BLOCKQUOTE style="background-color:#ffffc0;"><BR> <CODE> **** Exception Occurred ****<BR> R00=00000000 R01=12345678 R02=2000001F R03=02030340 <BR> R04=200000D7 R05=0000000F R06=00000001 R07=00000002 <BR> R08=02FFFFA8 R09=04000130 R10=00000001 R11=0201C25C <BR> R12=0200E240 SP =02FE3750 LR =02005130 PC =02005140<BR> CPSR=2000001F SPSR=00000000 CP15=0005707D</CODE><BR> <BR> 72</BLOCKQUOTE> 73<P><BR>Note that when an exception occurs on IS-TWL-DEBUGGER, the debugger itself will display this. (This is possible on IS-TWL-DEBUGGER v1.06 and later.) The format of the display will differ from that shown above. The example below shows what is displayed.</P> 74<BLOCKQUOTE style="background-color:#ffffc0;"><BR> <CODE>[[ Fatal error: Execution stopped because "data access exception" occurred on the ARM9CPU.]]<BR> <BR>Symbol:STATIC:0x02000C8C<BR>02000C8C:E591B000 LDR R11, [R1]<BR> <BR>CPSR:6000001F <BR>R0:0000007B R1:00000000 R2:00000100 R3:000003E8<BR>R4:000007D0 R5:00000BB8 R6:00000FA0 R7:00001388<BR>R8:02000C84 R9:000000FF R10:000000EE R11:00000000<BR>R12:00000123 SP:027E3750 LR:02000C5C PC:02000C8C</CODE><BR> <BR> 75</BLOCKQUOTE> 76<H2>Setting a User Handler</H2> 77<P>With IS-NITRO-DEBUGGER and actual Nintendo DS and TWL systems, when exceptions occur, control can be transferred to a user-specified exception handler. To do this, register the handler with the <a href="OS_SetUserExceptionHandler.html" target="_self"><nobr><code>OS_SetUserExceptionHandler</code></nobr></a> function. For details, see the function reference.</P> 78<H2>Environments in Which Displaying Contexts During Exceptions and Calling Users' Exception Handlers Is Possible</H2> 79<P>The table below indicates whether the context can be displayed in the debug window (console) when an exception occurs and whether control can be moved to the user's exception handler. The table is broken down by operating environment.</P> 80<P>As indicated in "Displaying Context During Exceptions," the SDK displays for IS-NITRO-DEBUGGER, and the debugger displays for IS-TWL-DEBUGGER, shown in the column entitled "Displaying Context During Exceptions" of the table. If the SDK displays the context, the <A href="../debug/OS_FPrintf.html"><CODE>OS_FPrintf</CODE></A> function used for display cannot be used in the FINALROM build. Context cannot be displayed in the FINALROM build when it says <FONT color="#ff0000"><B>OK</B></FONT> (as displayed by the SDK). <FONT color="#ff0000"><B>OK</B></FONT> (as displayed by the debugger) means that the debugger displays the context. Therefore, displaying the context is possible even in the FINALROM build.</P> 81<P>Also, items under "Calling User's Exception Handlers" in the table are not dependent on the type of build (whether or not it was a FINALROM build).</P> 82<P>Note that this table is divided by the operating environment. For example, the context cannot be displayed on IS-TWL-DEBUGGER when an exception occurs with a hybrid ROM that is running in NITRO mode, but it can be displayed on IS-NITRO-DEBUGGER if the same ROM is running in the same mode.<BR> 83</P> 84<TABLE border="1"> 85 <TBODY> 86 <TR> 87<TH colspan="3" style="background-color:#304040;"><FONT color="#ffffff">For NITRO Mode:</FONT> <img src="../../image/NTR.gif" align="middle"></TH> 88 </TR> 89 <TR> 90<TH>Operating Environment</TH> 91<TH>Displaying Contexts<BR>During Exceptions:</TH> 92<TH>Calling Users'<BR>Exception Handlers:</TH> 93 </TR> 94 <TR> 95<TD>Actual DS unit</TD> 96<TD><B>N/A</B> (There is no console)</TD> 97<TD><FONT color="#ff0000"><B>OK</B></FONT></TD> 98 </TR> 99 <TR> 100<TD>Actual TWL unit</TD> 101<TD><B>N/A</B> (There is no console)</TD> 102<TD><FONT color="#ff0000"><B>OK</B></FONT></TD> 103 </TR> 104 <TR> 105<TD>IS-NITRO-DEBUGGER</TD> 106<TD><FONT color="#ff0000"><B>OK</B></FONT> (displayed by SDK)</TD> 107<TD><FONT color="#ff0000"><B>OK</B></FONT></TD> 108 </TR> 109 <TR> 110<TD>ENSATA EMULATOR</TD> 111 <TD>???</TD> 112 <TD>???</TD> 113 </TR> 114 <TR> 115<TD>IS-TWL-DEBUGGER(For standard development: ARM9)</TD> 116<TD><B><FONT color="#ff0000">OK</FONT></B> (displayed by debugger)</TD> 117<TD><B>N/A</B></TD> 118 </TR> 119 <TR> 120<TD>IS-TWL-DEBUGGER (For component development: ARM9 + ARM7)</TD> 121<TD><B><FONT color="#ff0000">OK</FONT></B> (displayed by debugger)</TD> 122<TD><B>N/A</B></TD> 123 </TR> 124 <TR> 125<TH colspan="3" style="background-color:#304040;"><FONT color="#ffffff">For TWL Mode:</FONT> <img src="../../image/TWL.gif" align="middle"></TH> 126 </TR> 127 <TR> 128<TH>Operating Environment</TH> 129<TH>Displaying Context<BR>During Exceptions:</TH> 130<TH>Calling Users'<BR>Exception Handlers:</TH> 131 </TR> 132 <TR> 133<TD>Actual TWL unit</TD> 134<TD><B>N/A</B> (There is no console)</TD> 135<TD><FONT color="#ff0000"><B>OK</B></FONT></TD> 136 </TR> 137 <TR> 138<TD>IS-TWL-DEBUGGER (For general-purpose development: ARM9)</TD> 139<TD><B><FONT color="#ff0000">OK</FONT></B> (displayed by debugger)</TD> 140<TD><B>N/A</B></TD> 141 </TR> 142 <TR> 143<TD>IS-TWL-DEBUGGER (for component development: ARM9 + ARM7)</TD> 144<TD><B><FONT color="#ff0000">OK</FONT></B> (displayed by debugger)</TD> 145<TD><B>N/A</B></TD> 146 </TR> 147 </TBODY> 148</TABLE> 149<P><BR> 150</P> 151<H2>Process Flow When Exceptions Occur</H2> 152<P>The flow for the following exception is for IS-NITRO-DEBUGGER and the actual Nintendo DS and TWL systems. CPU operations stop at the point when the exception occurs on IS-TWL-DEBUGGER, and control shifts to the debugger. Operations, therefore, are as shown in the following figure.</P> 153<P>When an exception occurs, control jumps to the exception vector region on IS-NITRO-DEBUGGER and the actual Nintendo DS and TWL systems. As previously mentioned, the high vectors are usually used for exception vectors, but for a data abort exception, control will move to <CODE>0xFFFFFF10</CODE>.</P> 154<P>Control then moves to the address stored in <CODE>HW_EXCP_VECTOR_MAIN </CODE> (<CODE>0x2FFFFD9C</CODE>) in the system area. (In the ARM7, this address is located at the dedicated work RAM offset <CODE>0x7FDC</CODE>.) The address of the TWL-SDK's exception handler is set here.</P> 155<P>The TWL-SDK's exception handler will display the context when an exception occurs, and then call the user-defined handler registered with the <A href="OS_SetUserExceptionHandler.html"><CODE>OS_SetUserExceptionHandler</CODE></A> function, if such a handler exists.</P> 156<P>The program then stops.</P> 157<BLOCKQUOTE><BR> <IMG src="image_exception_flow.gif" border="0"></BLOCKQUOTE> 158<H2>See Also</H2> 159<P><CODE><A href="../list_os.html#Exception">List of OS Functions (Exception)</A><BR></CODE></P> 160<H2>Revision History</H2> 161<P>2009/07/01 Described the differences in behavior depending on the environment.<BR> 2008/04/18 Added a table of context display environments when exceptions occur.<BR> 2005/03/08 Standardized the Japanese term for "interrupt."<br> 2004/12/14 Revised terminology and word endings.<BR> 2004/11/16 Initial version.</P> 162<hr><p>CONFIDENTIAL</p></body> 163</HTML>
