

#include <nitro/os.h>BOOL OS_IsRunOnEmulator( void );
None.
If the program is running on IS-NITRO-DEBUGGER or IS-TWL-DEBUGGER, returns TRUE. Otherwise, returns FALSE.
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.
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.
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 | |
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.
OS_IsRunOnEmulator
OS_GetConsoleType
2008/04/15 Added tables.
2007/11/05 Initial version.
CONFIDENTIAL