Osgetresetcode; Osgetresetswitchstate; Ossetresetcallback; Processes Prior To Reset - Nintendo GameCube Manual

Reset Guidelines
Caution: Since hot reset takes more than a few seconds through the IPL splash screen until the game
program restarts, please avoid use of this function wherever possible. The hot reset is appropriate only
in the following two situations.
There is not enough space on the Memory Card
Applications cannot erase files created by another application. To solve this problem, you can ask the
game player if they want to go to the IPL's menu screen and erase unneeded files. In this situation
you need to set forcemenu to TRUE and perform a hot reset. The IPL goes to menu mode
automatically making it easy to use. (A function is used to move the IPL to menu mode).
Operations for an application-driven restart are being used, a reset operation is performed, and
the result of the "Disc Check" is not normal. (See Section 4.5)
In this situation, do the opposite of the preceding and set forcemenu to FALSE.
3.2

OSGetResetCode

This function returns the reset code for the reset performed by OSResetSystem.
3.3

OSGetResetSwitchState

This function gets the state of the RESET Button, which determines whether the button is pressed or
not.
3.4

OSSetResetCallback

This registers the callback function for the reset process.
Caution: This function is used for debugging. Do not use the function OSSetResetCallback in your
applications to detect pressing of the RESET Button. This is because a RESET Button press interrupt
can be erroneously generated at the same time that the Controller is plugged into
TM
Nintendo GameCube

4. Processes Prior to Reset

By implementing appropriate processes before the reset is executed, you can ensure that the game
player is not inconvenienced by the reset. Below are several required and recommended processes
to perform prior to executing the reset.
4.1 Calibration of the Nintendo GameCube
If the game player carries out a reset operation, the origin values for the Controller must also be
recalibrated. Use the PADRecalibrate function to recalibrate the origin values. Additionally, the origin
values for the Controller are recalibrated when the OSResetSystem function is called.
4.2 Stop the Nintendo GameCube
If a Controller placed on a tabletop is allowed to continue to vibrate after the reset process has been
executed, it could end up falling off the table. To avoid this from happening, the Rumble motor must
be halted before the reset process is completed. The PADRecalibrate function halts the rumble motor
in addition to recalibrating the origin of the Controller. The Rumble motor is also halted when the
OSResetSystem function is called.
4.3

Wait for end of writing to Nintendo GameCube

If the reset process is inadvertently executed while data is being written to the Memory Card, the
integrity of the data will be lost. When data needs to be written to numerous files in one save process,
wait until all the writing processes have been completed before executing the reset process.
4.4

Wait for interruption/completion of graphics and audio

It is not good for the reset process to disturb the graphics and audio. It is recommended that you
implement appropriate measures to fade out graphics and sound. In the sections below, explanations
are given for some specific processes for each type of reset.
DOL-06-0028-001-A2
Released: 9/13/01
.
TM
Rumble Feature
TM
Controller
TM
Memory Card
4
© 2001 Nintendo of America Inc.