339 lines
15 KiB
C
339 lines
15 KiB
C
//*****************************************************************************
|
|
//
|
|
// udma.h - Prototypes and macros for the uDMA controller.
|
|
//
|
|
// Copyright (c) 2007-2009 Luminary Micro, Inc. All rights reserved.
|
|
// Software License Agreement
|
|
//
|
|
// Luminary Micro, Inc. (LMI) is supplying this software for use solely and
|
|
// exclusively on LMI's microcontroller products.
|
|
//
|
|
// The software is owned by LMI and/or its suppliers, and is protected under
|
|
// applicable copyright laws. All rights are reserved. You may not combine
|
|
// this software with "viral" open-source software in order to form a larger
|
|
// program. Any use in violation of the foregoing restrictions may subject
|
|
// the user to criminal sanctions under applicable laws, as well as to civil
|
|
// liability for the breach of the terms and conditions of this license.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED
|
|
// OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
|
|
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE.
|
|
// LMI SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR
|
|
// CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.
|
|
//
|
|
// This is part of revision 4694 of the Stellaris Peripheral Driver Library.
|
|
//
|
|
//*****************************************************************************
|
|
|
|
#ifndef __UDMA_H__
|
|
#define __UDMA_H__
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// If building with a C++ compiler, make all of the definitions in this header
|
|
// have a C binding.
|
|
//
|
|
//*****************************************************************************
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// A structure that defines an entry in the channel control table. These
|
|
// fields are used by the uDMA controller and normally it is not necessary for
|
|
// software to directly read or write fields in the table.
|
|
//
|
|
//*****************************************************************************
|
|
typedef struct
|
|
{
|
|
//
|
|
// The ending source address of the data transfer.
|
|
//
|
|
volatile void *pvSrcEndAddr;
|
|
|
|
//
|
|
// The ending destination address of the data transfer.
|
|
//
|
|
volatile void *pvDstEndAddr;
|
|
|
|
//
|
|
// The channel control mode.
|
|
//
|
|
volatile unsigned long ulControl;
|
|
|
|
//
|
|
// An unused location.
|
|
//
|
|
volatile unsigned long ulSpare;
|
|
}
|
|
tDMAControlTable;
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Flags that can be passed to uDMAChannelAttributeEnable(),
|
|
// uDMAChannelAttributeDisable(), and returned from uDMAChannelAttributeGet().
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_ATTR_USEBURST 0x00000001
|
|
#define UDMA_ATTR_ALTSELECT 0x00000002
|
|
#define UDMA_ATTR_HIGH_PRIORITY 0x00000004
|
|
#define UDMA_ATTR_REQMASK 0x00000008
|
|
#define UDMA_ATTR_ALL 0x0000000F
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// DMA control modes that can be passed to uDMAModeSet() and returned
|
|
// uDMAModeGet().
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_MODE_STOP 0x00000000
|
|
#define UDMA_MODE_BASIC 0x00000001
|
|
#define UDMA_MODE_AUTO 0x00000002
|
|
#define UDMA_MODE_PINGPONG 0x00000003
|
|
#define UDMA_MODE_MEM_SCATTER_GATHER \
|
|
0x00000004
|
|
#define UDMA_MODE_PER_SCATTER_GATHER \
|
|
0x00000006
|
|
#define UDMA_MODE_ALT_SELECT 0x00000001
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Channel configuration values that can be passed to uDMAControlSet().
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_DST_INC_8 0x00000000
|
|
#define UDMA_DST_INC_16 0x40000000
|
|
#define UDMA_DST_INC_32 0x80000000
|
|
#define UDMA_DST_INC_NONE 0xc0000000
|
|
#define UDMA_SRC_INC_8 0x00000000
|
|
#define UDMA_SRC_INC_16 0x04000000
|
|
#define UDMA_SRC_INC_32 0x08000000
|
|
#define UDMA_SRC_INC_NONE 0x0c000000
|
|
#define UDMA_SIZE_8 0x00000000
|
|
#define UDMA_SIZE_16 0x11000000
|
|
#define UDMA_SIZE_32 0x22000000
|
|
#define UDMA_ARB_1 0x00000000
|
|
#define UDMA_ARB_2 0x00004000
|
|
#define UDMA_ARB_4 0x00008000
|
|
#define UDMA_ARB_8 0x0000c000
|
|
#define UDMA_ARB_16 0x00010000
|
|
#define UDMA_ARB_32 0x00014000
|
|
#define UDMA_ARB_64 0x00018000
|
|
#define UDMA_ARB_128 0x0001c000
|
|
#define UDMA_ARB_256 0x00020000
|
|
#define UDMA_ARB_512 0x00024000
|
|
#define UDMA_ARB_1024 0x00028000
|
|
#define UDMA_NEXT_USEBURST 0x00000008
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Channel numbers to be passed to API functions that require a channel number
|
|
// ID.
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_CHANNEL_USBEP1RX 0
|
|
#define UDMA_CHANNEL_USBEP1TX 1
|
|
#define UDMA_CHANNEL_USBEP2RX 2
|
|
#define UDMA_CHANNEL_USBEP2TX 3
|
|
#define UDMA_CHANNEL_USBEP3RX 4
|
|
#define UDMA_CHANNEL_USBEP3TX 5
|
|
#define UDMA_CHANNEL_ETH0RX 6
|
|
#define UDMA_CHANNEL_ETH0TX 7
|
|
#define UDMA_CHANNEL_UART0RX 8
|
|
#define UDMA_CHANNEL_UART0TX 9
|
|
#define UDMA_CHANNEL_SSI0RX 10
|
|
#define UDMA_CHANNEL_SSI0TX 11
|
|
#define UDMA_CHANNEL_ADC0 14
|
|
#define UDMA_CHANNEL_ADC1 15
|
|
#define UDMA_CHANNEL_ADC2 16
|
|
#define UDMA_CHANNEL_ADC3 17
|
|
#define UDMA_CHANNEL_TMR0A 18
|
|
#define UDMA_CHANNEL_TMR0B 19
|
|
#define UDMA_CHANNEL_TMR1A 20
|
|
#define UDMA_CHANNEL_TMR1B 21
|
|
#define UDMA_CHANNEL_UART1RX 22
|
|
#define UDMA_CHANNEL_UART1TX 23
|
|
#define UDMA_CHANNEL_SSI1RX 24
|
|
#define UDMA_CHANNEL_SSI1TX 25
|
|
#define UDMA_CHANNEL_I2S0RX 28
|
|
#define UDMA_CHANNEL_I2S0TX 29
|
|
#define UDMA_CHANNEL_SW 30
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Flags to be OR'd with the channel ID to indicate if the primary or alternate
|
|
// control structure should be used.
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_PRI_SELECT 0x00000000
|
|
#define UDMA_ALT_SELECT 0x00000020
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// uDMA interrupt sources, to be passed to uDMAIntRegister() and
|
|
// uDMAIntUnregister().
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_INT_SW 62
|
|
#define UDMA_INT_ERR 63
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Channel numbers to be passed to API functions that require a channel number
|
|
// ID. These are for secondary peripheral assignments.
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_SEC_CHANNEL_UART2RX_0 \
|
|
0
|
|
#define UDMA_SEC_CHANNEL_UART2TX_1 \
|
|
1
|
|
#define UDMA_SEC_CHANNEL_TMR3A 2
|
|
#define UDMA_SEC_CHANNEL_TMR3B 3
|
|
#define UDMA_SEC_CHANNEL_TMR2A_4 \
|
|
4
|
|
#define UDMA_SEC_CHANNEL_TMR2B_5 \
|
|
5
|
|
#define UDMA_SEC_CHANNEL_TMR2A_6 \
|
|
6
|
|
#define UDMA_SEC_CHANNEL_TMR2B_7 \
|
|
7
|
|
#define UDMA_SEC_CHANNEL_UART1RX \
|
|
8
|
|
#define UDMA_SEC_CHANNEL_UART1TX \
|
|
9
|
|
#define UDMA_SEC_CHANNEL_SSI1RX 10
|
|
#define UDMA_SEC_CHANNEL_SSI1TX 11
|
|
#define UDMA_SEC_CHANNEL_UART2RX_12 \
|
|
12
|
|
#define UDMA_SEC_CHANNEL_UART2TX_13 \
|
|
13
|
|
#define UDMA_SEC_CHANNEL_TMR2A_14 \
|
|
14
|
|
#define UDMA_SEC_CHANNEL_TMR2B_15 \
|
|
15
|
|
#define UDMA_SEC_CHANNEL_TMR1A 18
|
|
#define UDMA_SEC_CHANNEL_TMR1B 19
|
|
#define UDMA_SEC_CHANNEL_EPI0RX 20
|
|
#define UDMA_SEC_CHANNEL_EPI0TX 21
|
|
#define UDMA_SEC_CHANNEL_ADC10 24
|
|
#define UDMA_SEC_CHANNEL_ADC11 25
|
|
#define UDMA_SEC_CHANNEL_ADC12 26
|
|
#define UDMA_SEC_CHANNEL_ADC13 27
|
|
#define UDMA_SEC_CHANNEL_SW 30
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// uDMA default/secondary peripheral selections, to be passed to
|
|
// uDMAChannelSelectSecondary() and uDMAChannelSelectDefault().
|
|
//
|
|
//*****************************************************************************
|
|
#define UDMA_DEF_USBEP1RX_SEC_UART2RX \
|
|
0x00000001
|
|
#define UDMA_DEF_USBEP1TX_SEC_UART2TX \
|
|
0x00000002
|
|
#define UDMA_DEF_USBEP2RX_SEC_TMR3A \
|
|
0x00000004
|
|
#define UDMA_DEF_USBEP2TX_SEC_TMR3B \
|
|
0x00000008
|
|
#define UDMA_DEF_USBEP3RX_SEC_TMR2A \
|
|
0x00000010
|
|
#define UDMA_DEF_USBEP3TX_SEC_TMR2B \
|
|
0x00000020
|
|
#define UDMA_DEF_ETH0RX_SEC_TMR2A \
|
|
0x00000040
|
|
#define UDMA_DEF_ETH0TX_SEC_TMR2B \
|
|
0x00000080
|
|
#define UDMA_DEF_UART0RX_SEC_UART1RX \
|
|
0x00000100
|
|
#define UDMA_DEF_UART0TX_SEC_UART1TX \
|
|
0x00000200
|
|
#define UDMA_DEF_SSI0RX_SEC_SSI1RX \
|
|
0x00000400
|
|
#define UDMA_DEF_SSI0TX_SEC_SSI1TX \
|
|
0x00000800
|
|
#define UDMA_DEF_RESERVED_SEC_UART2RX \
|
|
0x00001000
|
|
#define UDMA_DEF_RESERVED_SEC_UART2TX \
|
|
0x00002000
|
|
#define UDMA_DEF_ADC00_SEC_TMR2A \
|
|
0x00004000
|
|
#define UDMA_DEF_ADC01_SEC_TMR2B \
|
|
0x00008000
|
|
#define UDMA_DEF_ADC02_SEC_RESERVED \
|
|
0x00010000
|
|
#define UDMA_DEF_ADC03_SEC_RESERVED \
|
|
0x00020000
|
|
#define UDMA_DEF_TMR0A_SEC_TMR1A \
|
|
0x00040000
|
|
#define UDMA_DEF_TMR0B_SEC_TMR1B \
|
|
0x00080000
|
|
#define UDMA_DEF_TMR1A_SEC_EPI0RX \
|
|
0x00100000
|
|
#define UDMA_DEF_TMR1B_SEC_EPI0TX \
|
|
0x00200000
|
|
#define UDMA_DEF_UART1RX_SEC_RESERVED \
|
|
0x00400000
|
|
#define UDMA_DEF_UART1TX_SEC_RESERVED \
|
|
0x00800000
|
|
#define UDMA_DEF_SSI1RX_SEC_ADC10 \
|
|
0x01000000
|
|
#define UDMA_DEF_SSI1TX_SEC_ADC11 \
|
|
0x02000000
|
|
#define UDMA_DEF_RESERVED_SEC_ADC12 \
|
|
0x04000000
|
|
#define UDMA_DEF_RESERVED_SEC_ADC13 \
|
|
0x08000000
|
|
#define UDMA_DEF_I2S0RX_SEC_RESERVED \
|
|
0x10000000
|
|
#define UDMA_DEF_I2S0TX_SEC_RESERVED \
|
|
0x20000000
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// API Function prototypes
|
|
//
|
|
//*****************************************************************************
|
|
extern void uDMAEnable(void);
|
|
extern void uDMADisable(void);
|
|
extern unsigned long uDMAErrorStatusGet(void);
|
|
extern void uDMAErrorStatusClear(void);
|
|
extern void uDMAChannelEnable(unsigned long ulChannel);
|
|
extern void uDMAChannelDisable(unsigned long ulChannel);
|
|
extern tBoolean uDMAChannelIsEnabled(unsigned long ulChannel);
|
|
extern void uDMAControlBaseSet(void *pControlTable);
|
|
extern void *uDMAControlBaseGet(void);
|
|
extern void uDMAChannelRequest(unsigned long ulChannel);
|
|
extern void uDMAChannelAttributeEnable(unsigned long ulChannel,
|
|
unsigned long ulAttr);
|
|
extern void uDMAChannelAttributeDisable(unsigned long ulChannel,
|
|
unsigned long ulAttr);
|
|
extern unsigned long uDMAChannelAttributeGet(unsigned long ulChannel);
|
|
extern void uDMAChannelControlSet(unsigned long ulChannel,
|
|
unsigned long ulControl);
|
|
extern void uDMAChannelTransferSet(unsigned long ulChannel,
|
|
unsigned long ulMode, void *pvSrcAddr,
|
|
void *pvDstAddr,
|
|
unsigned long ulTransferSize);
|
|
extern unsigned long uDMAChannelSizeGet(unsigned long ulChannel);
|
|
extern unsigned long uDMAChannelModeGet(unsigned long ulChannel);
|
|
extern void uDMAIntRegister(unsigned long ulIntChannel,
|
|
void (*pfnHandler)(void));
|
|
extern void uDMAIntUnregister(unsigned long ulIntChannel);
|
|
extern void uDMAChannelSelectDefault(unsigned long ulDefPeriphs);
|
|
extern void uDMAChannelSelectSecondary(unsigned long ulSecPeriphs);
|
|
extern unsigned long uDMAIntStatus(void);
|
|
extern void uDMAIntClear(unsigned long ulChanMask);
|
|
|
|
//*****************************************************************************
|
|
//
|
|
// Mark the end of the C bindings section for C++ compilers.
|
|
//
|
|
//*****************************************************************************
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // __UDMA_H__
|