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_ReadEeprom</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CARD_ReadEeprom <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>BOOL	CARD_ReadEeprom(u32 src, void *dst, u32 len);</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<TABLE border="1" width="100%">
27  <TBODY>
28    <TR>
29<TD width="13%"><EM><STRONG>src</STRONG></EM></TD>
30<TD width="87%">Transfer source EEPROM address.</TD>
31    </TR>
32    <TR>
33<TD width="13%"><EM><STRONG>dst</STRONG></EM></TD>
34<TD width="87%">Transfer destination memory address.</TD>
35    </TR>
36    <TR>
37<TD width="13%"><EM><STRONG>len</STRONG></EM></TD>
38<TD width="87%">Length of data being read, in bytes.</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44<p>TRUE if the process succeeds. FALSE otherwise.</p>
45
46<H2>Description</H2>
47<P>This function reads data synchronously from an EEPROM device. The function does not return control until it has finished processing. It returns TRUE if the process was successful or FALSE if it failed. To get the value when processing fails, call the <A href="../common/CARD_GetResultCode.html"><CODE>CARD_GetResultCode</CODE></A> function. 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.<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>
48</P>
49<h2>See Also</h2>
50<p><CODE><A href="../common/CARD_GetResultCode.html">CARD_GetResultCode</A><BR> <A href="CARD_IsBackupEeprom.html">CARD_IsBackupEeprom</A><BR> <A href="CARD_ReadEepromAsync.html">CARD_ReadEepromAsync</A><BR> <A href="CARD_WriteEeprom.html">CARD_WriteEeprom</A><BR> <A href="CARD_VerifyEeprom.html">CARD_VerifyEeprom</A><BR> <A href="CARD_WriteAndVerifyEeprom.html">CARD_WriteAndVerifyEeprom</A></CODE></p>
51
52<H2>Revision History</H2>
53<P>
542004/12/09 Changed &quot;IO processor&quot; to &quot;ARM7 processor&quot;. <br>2004/08/31 Added a description for the <code>CARD_GetResultCode</code> function. <br>2004/08/18 Added an explanation regarding the PXI interrupt. <br>2004/07/28 Added links. <BR>2004/07/10 Removed a description related to busy loops. <BR>2004/07/05 Initial version<BR>
55</P>
56<hr><p>CONFIDENTIAL</p></body>
57</html>
58