
#include <nitro/ctrdg.h>
void CTRDG_WriteAndVerifyAgbSramAsync(u32 dst, const void* src, u32 size, CTRDG_TASK_FUNC callback);
| dst | Destination SRAM address (address on the AGB memory map). |
| src | Source work area address. |
| size | Size of data written and verified in bytes |
| callback | Callback function called when WriteAndVerify processing ends |
None.
Internally, after data is asynchronously written by CTRDG_WriteAgbSram, verification is asynchronously performed by CTRDG_VerifyAgbSram. If there is an error, the function retries up to the number of times specified by CTRDG_AGB_SRAM_RETRY_MAX (defined in AgbSram.h). To find out whether the WriteAndVerify process succeeded, access the result member of the CTRDGTaskInfo structure used as an argument to the callback function that returns after this function is called. It returns zero if the WriteAndVerify process succeeded, a nonzero value if the process failed, and the error address on the device side if there was a verification error.
The access cycle setting is created in the function and does not need to be set in advance.
Note: The cartridge bus is locked for a set period by this function.
Note that the AGB backup device cannot be accessed normally with IS-NITRO-DEBUGGER version 1.66 or earlier.
CTRDG_WriteAgbSram
CTRDG_VerifyAgbSram
CTRDG_WriteAndVerifyAgbSram
2006/05/25 Added a description that the AGB backup device cannot be accessed normally with IS-NITRO-DEBUGGER version 1.66 or earlier.
2006/04/07 Initial version.
CONFIDENTIAL