PM_ForceToResetHardware

Syntax

#include <twl/spi.h>
void PM_ForceToResetHardware( void );

Arguments

None.

Return Values

None.

Description

Forcibly resets the hardware.

In general, this function should not be called directly by applications. If your intention is to execute a hardware reset yourself, call the OS_RebootSystem function. In addition, to return to the system menu, call the OS_JumpToSystemMenu function.These functions are designed to write a parameter to determine operations in the start area of main memory and call this function. Unexpected operations may result if this parameter is somehow rewritten. As such, this function uses a separate system function that utilizes hardware reset. (Naturally, this function may also be called to execute an intended operation if the user firmly grasps the parameter written to memory.)

This function uses PXI to send the command that performs the corresponding operation in the ARM7 processor. The ARM7 side that receives that command is executed by operating the PMIC.

Before you use this function, initialize the PM library with the PM_Init function. (The PM_Init function has to be called only once. Also, when you call the OS_Init function, there is no need to call the PM_Init function separately because it is called from inside OS_Init.)

Exit callbacks configured by the PM_AppendPreExitCallback function or similar functions are not invoked. Do not reset the hardware until you have run all necessary processing. Post-callbacks are invoked.

Another related function is OS_ResetSystem. Rather than performing a hardware rest, the OS_ResetSystem function is a software reset function that reloads necessary programs and re-executes from the entry address.

Even if the SPI is occupied by another device and therefore BUSY, this function continues retrying until it succeeds.

See Also

PM_Init
PM_ForceToPowerOff
OS_ResetSystem

Revision History

2008/08/23 Added explanation of the BUSY state.
2008/02/07 Initial version.


CONFIDENTIAL