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>OS_JumpToSystemMenu</TITLE> 8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">OS_JumpToSystemMenu <img src="../../image/TWL.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<DL> 14<DD><CODE>#include <nitro/os.h></CODE><BR> <BR> <code>BOOL OS_JumpToSystemMenu( void );</CODE> 15</DL> 16<H2>Arguments</H2> 17<P>None.</P> 18<H2>Return Values</H2> 19<P>Returns FALSE if running in NITRO mode.<BR><font color="#ff0000"><B>If running in TWL mode, this function normally succeeds but control is not returned.</B></font></P> 20<H2>Description</H2> 21<P>Performs a hardware reset and returns to the System Menu.</P> 22<P><font color="#ff0000"><B>This function cannot be called when interrupts are disabled. <BR>Because this function cannot be called during the exit process either, take care that it is not executed from within an exit callback registered using functions such as the <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Append*ExitCallback</CODE></A> functions.</B></font></P> 23 24<P>The <A href="../../spi/pm/PM_ForceToResetHardware.html"><CODE>PM_ForceToResetHardware</CODE></A>function is used internally by this function. Making a direct call to the <CODE><A href="../../spi/pm/PM_ForceToResetHardware.html">PM_ForceToResetHardware</A></CODE> function also returns the process to the System Menu. TWL has a mechanism to write parameters at the beginning of main RAM, thus enabling you to change the initial process after a hardware reset. If an unintended value is written to this parameter, the call to <CODE><A>PM_ForceToResetHardware</A></CODE> may not return the process to the System Menu. <FONT color="#ff0000">Because of this possibility, use the <CODE>OS_JumpToSystemMenu</CODE> function to return to the System Menu.</FONT></P> 25<H2>See Also</H2> 26<P><A href="../../spi/pm/PM_ForceToResetHardware.html"><CODE>PM_ForceToResetHardware</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Append*ExitCallback</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Prepend*ExitCallback</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Insert*ExitCallback</CODE></A></P> 27<H2>Revision History</H2> 28<P>2008/10/22 Added the fact that execution during exit processing is prohibited.<BR> 2008/09/08 Revised the icon.<BR> 2008/08/05 Initial version.</P> 29<hr><p>CONFIDENTIAL</p></body> 30</HTML>
