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.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>MI_InitNDmaConfig</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">MI_InitNDmaConfig <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_InitNDmaConfig( void );</CODE>
17  </DL>
18<H2>Arguments</H2>
19<P>None.</P>
20<H2>Return Values</H2>
21<P>None.</P>
22<H2>Description</H2>
23<P>Initializes the DMA config structure that controls the behavior of the new DMA.</P>
24<P>This function is called within <CODE><A href="../../os/init/OS_Init.html">OS_Init()</A></CODE> when the system is running in TWL mode. It can be called any number of times after that without issue. Initialization is done each time.</P>
25<P>The DMA config structure is where parameters are stored that can't be set with the DMA operation API. During actual DMA, the system will refer to this structure and operate accordingly. The structure is of type <CODE><A href="MINDmaConfig.html">MINDmaConfig</A></CODE>.</P>
26<P>The following values can be configured in the DMA config structure.</P>
27<TABLE border="1">
28  <TBODY>
29    <TR>
30      <TH>Member Name</TH>
31      <TH>Description</TH>
32      <TH>Related Register</TH>
33      <TH>Default Values</TH>
34    </TR>
35    <TR>
36      <TD><CODE>intervalTimer</CODE></TD>
37      <TD>Interval timer for block transfers.</TD>
38      <TD>d15-0 in DMAxBCNT</TD>
39      <TD><CODE>1</CODE></TD>
40    </TR>
41    <TR>
42      <TD><CODE>prescaler</CODE></TD>
43      <TD>Prescaler of interval timer for block transfers.</TD>
44      <TD>d17-16 in DMAxBCNT</TD>
45      <TD><CODE>MI_NDMA_INTERVAL_PS_1</CODE></TD>
46    </TR>
47    <TR>
48      <TD><CODE>blockWord</CODE></TD>
49      <TD>Number of words in the block transfer.</TD>
50      <TD>d19-16 in DMAx_CNT</TD>
51      <TD><CODE>MI_NDMA_BWORD_16</CODE></TD>
52    </TR>
53    <TR>
54      <TD><CODE>wordCount</CODE></TD>
55      <TD>Number of words in the transfer.</TD>
56      <TD>DMAxWCNT</TD>
57      <TD><CODE>MI_NDMA_AT_A_TIME</CODE></TD>
58    </TR>
59  </TBODY>
60</TABLE>
61<P><BR> <CODE><A href="MI_SetNDmaInterval.html">MI_SetNDmaInterval()</A></CODE> is the function used to set <CODE>intervalTimer</CODE> and <CODE>prescaler</CODE>.<BR><CODE><A href="MI_GetNDmaIntervalTimer.html">MI_GetNDmaIntervalTimer()</A></CODE> is the function used to get the current <CODE>intervalTimer</CODE> setting.<BR><CODE><A href="MI_GetNDmaIntervalPrescaler.html">MI_GetNDmaIntervalPrescaler()</A></CODE> is the function used to get the current <CODE>intervalPrescaler</CODE> setting.<BR><BR> <CODE><A href="MI_SetNDmaBlockWord.html">MI_SetNDmaBlockWord()</A></CODE> is the function used to set <CODE>blockWord</CODE>.<BR><CODE><A href="MI_GetNDmaBlockWord.html">MI_GetNDmaBlockWord()</A></CODE> is the function used to get the current <CODE>blockWord</CODE> setting.<BR><BR> <CODE><A href="MI_SetNDmaWordCount.html">MI_SetNDmaWordCount()</A></CODE> is the function used to set <CODE>wordCount</CODE>.<BR><CODE><A href="MI_GetNDmaWordCount.html">MI_GetNDmaWordCount()</A></CODE> is the function used to get the current <CODE>wordCount</CODE> setting.<BR></P>
62<P>Although this function is used to configure the structure that is used by default, developers can copy the values from this structure to to structures of their own creation, or vice versa. Refer to the <CODE><A href="MI_GetNDmaConfig.html">MI_GetNDmaConfig</A></CODE> and <CODE><A href="MI_SetNDmaConfig.html">MI_SetNDmaConfig</A></CODE> functions for more information about this.</P>
63<H2>Internal Operation</H2>
64<P>Only configures values within the library's internal structure, and does not access the actual registers.</P>
65<H2>See Also</H2>
66<P><CODE><A href="MI_GetNDmaConfig.html">MI_GetNDmaConfig</A>, <A href="MI_SetNDmaConfig.html">MI_SetNDmaConfig</A><BR></CODE></P>
67<H2>Revision History</H2>
68<P>2007/09/07 Initial version.</P>
69<hr><p>CONFIDENTIAL</p></body>
70</HTML>