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<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/ai.h> 19 20void AIInitDMA(u32 start_addr, u32 length); 21</pre></dd></dl> 22 23<h2>Arguments</h2> 24<TABLE class="arguments" border="1" > 25 <tr> 26<th>start_addr</th> 27<td>Start address of DMA transaction. Must be 32-byte aligned.</td> 28 </tr> 29 <tr> 30<th>length</th> 31<td>Length of DMA transaction. Must be 32-byte aligned.</td> 32 </tr> 33</table> 34 35<h2>Return Values</h2> 36<p>None.</p> 37 38<h2>Description</h2> 39<p>The <code>AIInitDMA</code> function programs the DMA start address and size for the AI DMA controller.</p> 40 41<p>AI-DMA transactions will not start immediately even if the <code>AIInitDMA</code> function is called. In addition, there is no effect on the AI-DMA transactions being processed. The <code>AIInitDMA</code> function programs the next AI-DMA parameters for the AI DMA controller.</p> 42 43<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, AI DMA transaction can be started based on the new parameter as soon as the the AI DMA transaction being processed has ended by calling the <code>AIInitDMA</code> function. It is not necessary to call the <a href="AIStartDMA.html"><code>AIStartDMA</code></a> function again at this time. Also, the AI DMA transaction will be started again based on the old parameter if the AI DMA transaction being processed has completed sooner than a call to the <code>AIInitDMA</code> function.</p> 44 45<p>The <a href="AIStopDMA.html"><code>AIStopDMA</code></a> function must be called explicitly in order to stop the AI DMA.</p> 46 47<h2>See Also</h2> 48<P class="reference"> 49<a href="AIStartDMA.html">AIStartDMA</a>, <a href="AIStopDMA.html">AIStopDMA</a> 50</P> 51 52<H2>Revision History</H2> 53<P> 542006/03/01 Initial version.<BR> 55</P> 56 57<hr><p>CONFIDENTIAL</p></body> 58</html> 59