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 <revolution.h></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