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_WriteAndVerifyFlashSectorAsync</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CARD_WriteAndVerifyFlashSectorAsync <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 &lt;nitro/card.h&gt;</CODE><BR>
20  <BR>
21  <CODE>static inline void	CARD_WriteAndVerifyFlashSectorAsync(
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 write.<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.
49</TD>
50    </TR>
51    <TR>
52      <TD width="13%"><EM><STRONG>arg</STRONG></EM></TD>
53      <TD width="87%">Arguments to pass to the completion callback function.<BR>
54	  This is simply ignored if <CODE>NULL</CODE> was specified for <CODE>callback</CODE>.</TD>
55    </TR>
56  </TBODY>
57</TABLE>
58
59<h2>Return Values</h2>
60<p>None.</p>
61
62<H2>Description</H2>
63<p>
64This function asynchronously writes data to the FLASH device and performs a comparison on that written data at the sector level.<br>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.<br>
65</p>
66<p>
67This function simply calls a combination of the <A href="CARD_EraseFlashSector.html"><CODE>CARD_EraseFlashSector</CODE></A> and <A href="CARD_ProgramAndVerifyFlashAsync.html"><CODE>CARD_ProgramAndVerifyFlashAsync</CODE></A> functions internally. For more information, see the function references for these functions.
68</p>
69<p>
70To use this function, you must first lock the access bus with the <A href="../backup/CARD_LockBackup.html"><CODE>CARD_LockBackup</CODE></A> function.
71</p>
72<h2>Internal Operation</h2>
73<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>
74<h2>See Also</h2>
75<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>
76
77<H2>Revision History</H2>
78<P>
792007/08/22 Initial version.
80</P>
81<hr><p>CONFIDENTIAL</p></body>
82</html>
83