CTRDG_Read

# CTRDG_EraseAgbFlashChip

## C Specification

      #include <nitro/ctrdg.h>

      u16 CTRDG_EraseAgbFlashChip(void);

      Corresponding AGB function: u16 (*EraseFlashChip)()

## Arguments

None.

## Return Values

Returns 0 if the erasure succeeds. Returns a non-zero value if it fails.

## Description

Completely erases all data on the AGB backup device chip.

The access cycle setting does not need to be set beforehand because it is created inside the function.
In addition, the `OS_InitTick` function must be called before this function because clock ticks are used by this function to measure timeouts.

Note: All interrupts are disabled inside this function and the catridge bus is locked for a set period.
In particular, do not use DMA for automatic startup during direct sound and V/H blank synchronization, display synchronization, or cartridge request.

In addition, the AGB backup device cannot be accessed normally by the IS-NITRO-DEBUGGER.
However, be sure to check operations using an actual DS handheld unit since normal access is possible with actual DS units.
(This will be fixed in a future version of IS-NITRO-DEBUGGER.)

## See Also

`CTRDG_EraseAgbFlashSector, CTRDG_EraseAgbFlashChipAsync, CTRDG_EraseAgbFlashSectorAsync
`

## Revision History

04/07/2006 Initial version.

CONFIDENTIAL