OS_IsRunOnDebugger

Syntax

#include <nitro/os.h>

BOOL OS_IsRunOnEmulator( void );

Arguments

None.

Return Values

If the program is running on IS-NITRO-DEBUGGER or IS-TWL-DEBUGGER, returns TRUE. Otherwise, returns FALSE.

Description

Checks whether the program is running on either IS-NITRO-DEBUGGER or IS-TWL-DEBUGGER.

Because this is a debugging function, it always returns FALSE in the FINALROM version of the library.

Similar Functions

The OS_IsRunOnEmulator function is also used for finding out the operating environment. It can find out whether the application is running on the Ensata NITRO Software Emulator.

Actual Values Due to the Environment or Build

The table below shows the differences in the values returned by the OS_IsRunOnDebugger and OS_IsRunOnEmulator functions due to the operating environment.

For NITRO Mode
Operating Environment Build Value of OS_IsRunOnDebugger Value of OS_IsRunOnEmulator
Actual DS unit DEBUG
RELEASE
FINALROM
FALSE FALSE
Actual TWL unit DEBUG
RELEASE
FINALROM
FALSE FALSE
IS-NITRO-DEBUGGER DEBUG
RELEASE
TRUE FALSE
FINALROM FALSE FALSE
ENSATA EMULATOR DEBUG
RELEASE
FALSE TRUE
FINALROM FALSE FALSE
IS-TWL-DEBUGGER
(For standard development: ARM9)
DEBUG
RELEASE
TRUE FALSE
FINALROM FALSE FALSE
IS-TWL-DEBUGGER
(For component development
ARM9 + ARM7)
DEBUG
RELEASE
TRUE FALSE
FINALROM FALSE FALSE
For TWL Mode
Operating Environment Build Value of OS_IsRunOnDebugger Value of OS_IsRunOnEmulator
Actual TWL unit DEBUG
RELEASE
FINALROM
FALSE FALSE
IS-TWL-DEBUGGER
(For standard development: ARM9)
DEBUG
RELEASE
TRUE FALSE
FINALROM FALSE FALSE
IS-TWL-DEBUGGER
(For component development
ARM9 + ARM7)
DEBUG
RELEASE
TRUE FALSE
FINALROM FALSE FALSE

Internal Operation

Makes a decision based on the logical sum of the the return value of the OS_GetConsoleType function and the OS_CONSOLE_ISDEBUGGER and OS_CONSOLE_TWLDEBUGGER bits.

See Also

OS_IsRunOnEmulator
OS_GetConsoleType

Revision History

2008/04/15 Added tables.
2007/11/05 Initial version.


CONFIDENTIAL