1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AIInitDMA</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="Microsoft FrontPage 5.0">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AIInitDMA</h1>
15
16
17<h2>C Specification</h2>
18
19<dl>
20<dd><pre><CODE>#include &lt;revolution.h&gt;</CODE></pre>
21  </dd>
22<dd><pre><CODE>void AIInitDMA(u32 start_addr, u32 length);</CODE></pre>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26
27<table border="1" cellpadding="3" cellspacing="0.1">
28  <tr>
29<td width="120" bgcolor="#ffffe8"><em><strong><font face="Courier New"><STRONG><EM><CODE>start_addr</CODE></EM></STRONG></font></strong></em></td>
30<td width="520">Start address of DMA transaction. Must be 32-byte aligned.</td>
31  </tr>
32  <tr>
33<td width="120" bgcolor="#ffffe8"><em><strong><font face="Courier New"><STRONG><EM><CODE>length</CODE></EM></STRONG></font></strong></em></td>
34<td width="520">Length of DMA transaction. Must be 32-byte aligned.</td>
35  </tr>
36</table>
37
38<h2>Return Values</h2>
39
40<p>None.</p>
41
42<h2>Description</h2>
43
44<p>The <code>AIInitDMA</code> function programs the DMA start address and length for the AI DMA controller. </p>
45
46<p>AI DMA transactions do not start immediately even if the <code>AIInitDMA</code> function is called. Furthermore, the AI DMA transactions that are currently processing are not affected. The <code>AIInitDMA</code> function programs the next AI DMA parameters for the AI DMA controller. </p>
47
48<p>If AI DMA is stopped, call the <code>AIInitDMA</code> function and then call the <a href="AIStartDMA.html"><code>AIStartDMA</code></a> function to start the AI DMA transaction. If the AI DMA is operating, the new parameters can be used to start an AI DMA transaction by calling the <code>AIInitDMA</code> function as soon as the processing AI DMA transaction completes. At this time, you must call the <a href="AIStartDMA.html"><code>AIStartDMA</code></a> function again. Also, if the processing AI DMA transaction completes before a call to the <code>AIInitDMA</code> function completes, the AI DMA transaction starts again using the old parameters.</p>
49
50<p>The <a href="AIStopDMA.html"><code>AIStopDMA</code></a> function must be called explicitly to stop the AI DMA.</p>
51
52<h2>See Also</h2>
53
54<P>
55<a href="AIStartDMA.html"><code>AIStartDMA</code></a>, <a href="AIStopDMA.html"><code>AIStopDMA</code></a>
56</P>
57
58<H2>Revision History</H2>
59<P>2006/03/01 Initial version.</P>
60
61<hr>
62<P>CONFIDENTIAL</p>
63</BODY>
64</HTML>
65