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.1.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>MI_SetNDmaArbitrament</TITLE> 8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">MI_SetNDmaArbitrament <IMG src="../../image/TWL.gif" width="24" height="12" border="0" align=middle></H1> 12<H2>Syntax</H2> 13<DL> 14 <DD><CODE>#include <twl/mi.h></CODE><BR> 15 <BR> 16 <CODE>void MI_SetNDmaArbitrament( u32 mode, u32 cycle );</CODE> 17 </DL> 18<H2>Arguments</H2> 19<TABLE border="1" width="100%"> 20 <TBODY> 21 <TR> 22 <TD><EM><STRONG>mode</STRONG></EM></TD> 23 <TD>The arbitration method of new DMA.</TD> 24 </TR> 25 <TR> 26 <TD><EM><STRONG>cycle</STRONG></EM></TD> 27 <TD>The number of cycles (only valid when the arbitration method of the new DMA is round-robin).</TD> 28 </TR> 29 </TBODY> 30</TABLE> 31<H2>Return Values</H2> 32<P>None.</P> 33<H2>Description</H2> 34<P>Specifies the DMA arbitration method for the TWL's new DMA.</P> 35<P>In <B><I>mode</I></B>, specify the arbitration method.</P> 36<TABLE border="1"> 37 <TBODY> 38 <TR> 39 <TD><CODE>MI_NDMA_ARBITRAMENT_FIX</CODE></TD> 40 <TD>Fixed method</TD> 41 </TR> 42 <TR> 43 <TD><CODE>MI_NDMA_ARBITRAMENT_ROUND</CODE></TD> 44 <TD>Round-robin method </TD> 45 </TR> 46 </TBODY> 47</TABLE> 48<P><BR> 49</P> 50<P><B><I>cycle</I></B> is meaningful when the round-robin method is specified as the <B><I>mode</I></B>. When using the fixed method, it has no meaning regardless of the value.<BR> 51</P> 52<TABLE border="1"> 53 <TBODY> 54 <TR> 55 <TD><CODE>MI_NDMA_RCYCLE_0</CODE></TD> 56 <TD>0 cycles </TD> 57 </TR> 58 <TR> 59 <TD><CODE>MI_NDMA_RCYCLE_1</CODE></TD> 60 <TD>1 cycle</TD> 61 </TR> 62 <TR> 63 <TD><CODE>MI_NDMA_RCYCLE_2</CODE></TD> 64 <TD>2 cycles</TD> 65 </TR> 66 <TR> 67 <TD><CODE>MI_NDMA_RCYCLE_4</CODE></TD> 68 <TD>4 cycles</TD> 69 </TR> 70 <TR> 71 <TD><CODE>MI_NDMA_RCYCLE_8</CODE></TD> 72 <TD>8 cycles</TD> 73 </TR> 74 <TR> 75 <TD><CODE>MI_NDMA_RCYCLE_16</CODE></TD> 76 <TD>16 cycles</TD> 77 </TR> 78 <TR> 79 <TD><CODE>MI_NDMA_RCYCLE_32</CODE></TD> 80 <TD>32 cycles</TD> 81 </TR> 82 <TR> 83 <TD><CODE>MI_NDMA_RCYCLE_64</CODE></TD> 84 <TD>64 cycles</TD> 85 </TR> 86 <TR> 87 <TD><CODE>MI_NDMA_RCYCLE_128</CODE></TD> 88 <TD>128 cycles</TD> 89 </TR> 90 <TR> 91 <TD><CODE>MI_NDMA_RCYCLE_256</CODE></TD> 92 <TD>256 cycles</TD> 93 </TR> 94 <TR> 95 <TD><CODE>MI_NDMA_RCYCLE_512</CODE></TD> 96 <TD>512 cycles</TD> 97 </TR> 98 <TR> 99 <TD><CODE>MI_NDMA_RCYCLE_1024</CODE></TD> 100 <TD>1024 cycles</TD> 101 </TR> 102 <TR> 103 <TD><CODE>MI_NDMA_RCYCLE_2048</CODE></TD> 104 <TD>2048 cycles</TD> 105 </TR> 106 <TR> 107 <TD><CODE>MI_NDMA_RCYCLE_4096</CODE></TD> 108 <TD>4096 cycles</TD> 109 </TR> 110 <TR> 111 <TD><CODE>MI_NDMA_RCYCLE_8192</CODE></TD> 112 <TD>8192 cycles</TD> 113 </TR> 114 <TR> 115 <TD><CODE>MI_NDMA_RCYCLE_16384</CODE></TD> 116 <TD>16384 cycles</TD> 117 </TR> 118 </TBODY> 119</TABLE> 120<P><BR> <B><I>cycle</I></B> will be reflected in the actual setting at the point in time when there are no DMA startup requests for any of the DMA channels.</P> 121<BLOCKQUOTE style="background-color:#ffffcc;"> 122<P>Example:<BR> <BR> <CODE>//---- Fixed method<BR> MI_SetNDmaArbitrament(MI_NDMA_ARBITRAMENT_FIX, 0/*dummy*/);<BR> <BR> //---- Round-robin method<BR> MI_SetNDmaArbitrament(MI_NDMA_ARBITRAMENT_ROUND, MI_NDMA_RCYCLE_32);</CODE></P> 123</BLOCKQUOTE> 124<H2>Internal Operation</H2> 125<P>Accesses the DMA_GCNT register.</P> 126<H2>See Also</H2> 127<P><CODE><A href="MI_GetNDmaArbitrament.html">MI_GetNDmaArbitrament</A>, <A href="MI_GetNDmaArbitramentRoundRobinCycle.html">MI_GetNDmaArbitramentRoundRobinCycle</A><BR></CODE></P> 128<H2>Revision History</H2> 129<P>2007/09/07 Initial version.</P> 130<hr><p>CONFIDENTIAL</p></body> 131</HTML>