PADRecalibrate

C Specification

#include <revolution/pad.h>

#define PAD_CHAN0_BIT           0x80000000
#define PAD_CHAN1_BIT           0x40000000
#define PAD_CHAN2_BIT           0x20000000
#define PAD_CHAN3_BIT           0x10000000
BOOL PADRecalibrate(u32 mask);

Arguments

mask the bit OR mask of controllers (PAD_CHANn_BIT) to reset

Return Values

Always returns TRUE.

Be aware that if PADRead is called immediately after PADRecalibrate is run, the returned PADStatus for the specified ports may contain an error code, either PAD_ERR_NOT_READY or PAD_ERR_TRANSFER. If this happens, PADReset (not PADRecalibrate) should be called repeatedly until PADRead returns the PAD_ERR_NONE error code.

Description

This function recalibrates the specified controller. Furthermore, PADRecalibrate behaves like PADReset. Note that the controller is automatically adjusted when the power is turned on. The PADRecalibrate function must be called when the Revolution RESET Button has been pressed.

No recalibration is performed for the WaveBird Controller even when the PADRecalibrate function is called. However, game programmers don't have to worry about this fact. Call PADRecalibrate whenever the RESET Button has been pressed.

See Also

Controller Functions, PADButtonDown, PADButtonUp, PADInit, PADRead, PADReset, PADStatus

Revision History

2006/03/01 Initial version.


CONFIDENTIAL