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 &lt;twl/mi.h&gt;</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>