1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>CARD_ReadFlashAsync</title>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</head>
10<body>
11<h1 align="left">CARD_ReadFlashAsync <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<dl>
14  <dd>
15<CODE>#include &lt;nitro/card.h&gt;</CODE><BR>
16  <BR>
17  <CODE>static inline void	CARD_ReadFlashAsync(
18	u32 src, void *dst, u32 len, MIDmaCallback callback, void *arg);</CODE><br>
19  <br>
20  </dd>
21</dl>
22<h2>Arguments</h2>
23<TABLE border="1" width="100%">
24  <TBODY>
25    <TR>
26      <TD width="13%"><EM><STRONG>src</STRONG></EM></TD>
27      <TD width="87%">The FLASH address of the transfer source</TD>
28    </TR>
29    <TR>
30      <TD width="13%"><EM><STRONG>dst</STRONG></EM></TD>
31      <TD width="87%">Transfer destination memory address.</TD>
32    </TR>
33    <TR>
34      <TD width="13%"><EM><STRONG>len</STRONG></EM></TD>
35      <TD width="87%">Length of data being read, in bytes.</TD>
36    </TR>
37    <TR>
38      <TD width="13%"><EM><STRONG>callback</STRONG></EM></TD>
39      <TD width="87%">Completion callback function.<BR>
40	  Specify <CODE>NULL</CODE> if this is unnecessary.<br>This callback is called from within the interrupt handler.</TD>
41    </TR>
42    <TR>
43      <TD width="13%"><EM><STRONG>arg</STRONG></EM></TD>
44      <TD width="87%">Arguments to pass to the completion callback function.<BR>
45	  This is simply ignored if <CODE>NULL</CODE> was specified for <CODE>callback</CODE>.</TD>
46    </TR>
47  </TBODY>
48</TABLE>
49<h2>Return Values</h2>
50<p>None.</p>
51<H2>Description</H2>
52<P>This function asynchronously loads data from the FLASH device. This function immediately returns control. To use this function, you must first lock the access bus with the <A href="../backup/CARD_LockBackup.html"><CODE>CARD_LockBackup</CODE></A> function.</font> 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 is complete.<BR><BR> <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>
53</P>
54<h2>Internal Operation</h2>
55<p>
56This function executes an asynchronous process using an internal thread. See the description of the <A href="../common/CARD_GetThreadPriority.html"><CODE>CARD_GetThreadPriority</CODE></A> function for more information on this thread.
57</p>
58<h2>See Also</h2>
59<p><CODE><A href="CARD_IsBackupFlash.html">CARD_IsBackupFlash</A><br> <A href="../backup/CARD_WaitBackupAsync.html">CARD_WaitBackupAsync</A><br> <A href="../common/CARD_GetResultCode.html">CARD_GetResultCode</A><br> <A href="CARD_ReadFlash.html">CARD_ReadFlash</A><br> <A href="CARD_WriteFlash.html">CARD_WriteFlash</A><br> <A href="CARD_VerifyFlash.html">CARD_VerifyFlash</A><br> <A href="CARD_WriteAndVerifyFlash.html">CARD_WriteAndVerifyFlash</A><br> <A href="../common/CARD_GetThreadPriority.html">CARD_GetThreadPriority</A></CODE></p>
60<H2>Revision History</H2>
61<P>
622005/06/01 Added a statement indicating that callback is called from interrupt handler. <br> 2004/12/09 Changed &quot;IO processor&quot; to &quot;ARM7 processor&quot;. <br> 2004/11/02  Revised links.<br> 2004/08/23  Revised links due to function changes. <BR> 2004/08/18  Initial version.
63</P>
64<hr><p>CONFIDENTIAL</p></body>
65</html>
66