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 &lt;nitro/card.h&gt;</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