1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<title>CARD_WriteFlashSectorAsync</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">CARD_WriteFlashSectorAsync <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1> 15<H2>Syntax</H2> 16 17<dl> 18 <dd> 19<CODE>#include <nitro/card.h></CODE><BR> 20 <BR> 21 <CODE>static inline void CARD_WriteFlashSectorAsync( 22 u32 dst, const void *src, u32 len, MIDmaCallback callback, void *arg);</CODE><br> 23 <br> 24 </dd> 25</dl> 26<h2>Arguments</h2> 27<TABLE border="1" width="100%"> 28 <TBODY> 29 <TR> 30 <TD width="13%"><EM><STRONG>dst</STRONG></EM></TD> 31 <TD width="87%">The flash memory address of the transfer destination.<br /> 32 <font color="#800000">This must be an integer multiple of the value obtained by the <A href="../common/CARD_GetBackupSectorSize.html"><CODE>CARD_GetBackupSectorSize</CODE></A> function.<br /> 33 For more about the sector size for each device, see <a href="../overview/about_Backup.html">Overview</a>.</font></TD> 34 </TR> 35 <TR> 36 <TD width="13%"><EM><STRONG>src</STRONG></EM></TD> 37 <TD width="87%">Transfer source memory address.</TD> 38 </TR> 39 <TR> 40 <TD width="13%"><EM><STRONG>len</STRONG></EM></TD> 41 <TD width="87%">Byte length of the data to be written.<br /> 42 <font color="#800000">This must be an integer multiple of the value obtained by the <A href="../common/CARD_GetBackupSectorSize.html"><CODE>CARD_GetBackupSectorSize</CODE></A> function.<br /> 43 For more about the sector size for each device, see <a href="../overview/about_Backup.html">Overview</a>.</font></TD> 44 </TR> 45 <TR> 46 <TD width="13%"><EM><STRONG>callback</STRONG></EM></TD> 47 <TD width="87%">Completion callback function.<BR> 48 Specify <CODE>NULL</CODE> if this is unnecessary.<br>This callback is called from within the interrupt handler.</TD> 49 </TR> 50 <TR> 51 <TD width="13%"><EM><STRONG>arg</STRONG></EM></TD> 52 <TD width="87%">Arguments to pass to the completion callback function.<BR> 53 This is simply ignored if <CODE>NULL</CODE> was specified for <CODE>callback</CODE>.</TD> 54 </TR> 55 </TBODY> 56</TABLE> 57 58<h2>Return Values</h2> 59<p>None.</p> 60 61<H2>Description</H2> 62<P>This function writes data to the FLASH device asynchronously at the sector level. This function immediately returns control. Use the <A href="../backup/CARD_WaitBackupAsync.html"><CODE>CARD_WaitBackupAsync</CODE></A> function to wait for processing to end. To determine the processing result, call the <A href="../common/CARD_GetResultCode.html"><CODE>CARD_GetResultCode</CODE></A> function after processing has ended. 63</p> 64<p> 65This function simply calls a combination of the <A href="CARD_EraseFlashSector.html"><CODE>CARD_EraseFlashSector</CODE></A> and <A href="CARD_ProgramFlashAsync.html"><CODE>CARD_ProgramFlashAsync</CODE></A> functions internally. For more information, see the function references for these functions. 66</p> 67<p> 68To use this function, you must first lock the access bus with the <A href="../backup/CARD_LockBackup.html"><CODE>CARD_LockBackup</CODE></A> function. 69</p> 70<h2>Internal Operation</h2> 71<p><CODE><font color="#800000">This function communicates with the ARM7 processor internally via PXI.<br> The process will not end if PXI interrupts are not enabled.<br></font> <br> The function uses an internal thread to execute an asynchronous process. See the description of the <A href="../common/CARD_GetThreadPriority.html"><CODE>CARD_GetThreadPriority</CODE></A> function for more information on this thread.</p> 72<h2>See Also</h2> 73<p><CODE><A href="../backup/CARD_WaitBackupAsync.html">CARD_WaitBackupAsync</A>, <A href="../common/CARD_GetResultCode.html">CARD_GetResultCode</A>, <A href="CARD_IsBackupFlash.html">CARD_IsBackupFlash</A>, <A href="CARD_ProgramFlash.html">CARD_ProgramFlash</A>, <A href="CARD_ProgramFlashAsync.html">CARD_ProgramFlashAsync</A>, <A href="CARD_ProgramAndVerifyFlash.html">CARD_ProgramAndVerifyFlash</A>, <A href="CARD_ProgramAndVerifyFlashAsync.html">CARD_ProgramAndVerifyFlashAsync</A>, <A href="CARD_EraseFlashSector.html">CARD_EraseFlashSector</A>, <A href="CARD_EraseFlashSectorAsync.html">CARD_EraseFlashSectorAsync</A>, <A href="CARD_WriteFlashSector.html">CARD_WriteFlashSector</A>, <A href="CARD_WriteFlashSectorAsync.html">CARD_WriteFlashSectorAsync</A>, <A href="CARD_WriteAndVerifyFlashSector.html">CARD_WriteAndVerifyFlashSector</A>, <A href="CARD_WriteAndVerifyFlashSectorAsync.html">CARD_WriteAndVerifyFlashSectorAsync</A>, <A href="CARD_ReadFlash.html">CARD_ReadFlash</A>, <A href="CARD_WriteFlash.html">CARD_WriteFlash</A>, <A href="CARD_WriteAndVerifyFlash.html">CARD_WriteAndVerifyFlash</A>, <A href="CARD_VerifyFlash.html">CARD_VerifyFlash</A>, <A href="../common/CARD_GetThreadPriority.html">CARD_GetThreadPriority</A></CODE></p> 74 75<H2>Revision History</H2> 76<P> 772007/08/22 Initial version. 78</P> 79<hr><p>CONFIDENTIAL</p></body> 80</html> 81
