From e4e7b661172477aaa682a9cccfbac89adb1d01f6 Mon Sep 17 00:00:00 2001 From: Pixel Date: Sun, 23 Jan 2011 12:15:41 -0800 Subject: Adding basic CMSIS source code; v1.3.0 from the NXP website currently. --- arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h | 417 +++++++++++++++++++++++ 1 file changed, 417 insertions(+) create mode 100644 arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h (limited to 'arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h') diff --git a/arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h b/arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h new file mode 100644 index 0000000..f2053fc --- /dev/null +++ b/arch/arm/lpc17xx/Drivers/include/lpc17xx_gpdma.h @@ -0,0 +1,417 @@ +/***********************************************************************//** + * @file lpc17xx_gpdma.h + * @brief Contains all macro definitions and function prototypes + * support for GPDMA firmware library on LPC17xx + * @version 2.0 + * @date 21. May. 2010 + * @author NXP MCU SW Application Team + ************************************************************************** + * Software that is described herein is for illustrative purposes only + * which provides customers with programming information regarding the + * products. This software is supplied "AS IS" without any warranties. + * NXP Semiconductors assumes no responsibility or liability for the + * use of the software, conveys no license or title under any patent, + * copyright, or mask work right to the product. NXP Semiconductors + * reserves the right to make changes in the software without + * notification. NXP Semiconductors also make no representation or + * warranty that such application will be suitable for the specified + * use without further testing or modification. + **************************************************************************/ + +/* Peripheral group ----------------------------------------------------------- */ +/** @defgroup GPDMA GPDMA + * @ingroup LPC1700CMSIS_FwLib_Drivers + * @{ + */ + +#ifndef LPC17XX_GPDMA_H_ +#define LPC17XX_GPDMA_H_ + +/* Includes ------------------------------------------------------------------- */ +#include "LPC17xx.h" +#include "lpc_types.h" + + +#ifdef __cplusplus +extern "C" +{ +#endif + +/* Public Macros -------------------------------------------------------------- */ +/** @defgroup GPDMA_Public_Macros GPDMA Public Macros + * @{ + */ + +/** DMA Connection number definitions */ +#define GPDMA_CONN_SSP0_Tx ((0UL)) /**< SSP0 Tx */ +#define GPDMA_CONN_SSP0_Rx ((1UL)) /**< SSP0 Rx */ +#define GPDMA_CONN_SSP1_Tx ((2UL)) /**< SSP1 Tx */ +#define GPDMA_CONN_SSP1_Rx ((3UL)) /**< SSP1 Rx */ +#define GPDMA_CONN_ADC ((4UL)) /**< ADC */ +#define GPDMA_CONN_I2S_Channel_0 ((5UL)) /**< I2S channel 0 */ +#define GPDMA_CONN_I2S_Channel_1 ((6UL)) /**< I2S channel 1 */ +#define GPDMA_CONN_DAC ((7UL)) /**< DAC */ +#define GPDMA_CONN_UART0_Tx ((8UL)) /**< UART0 Tx */ +#define GPDMA_CONN_UART0_Rx ((9UL)) /**< UART0 Rx */ +#define GPDMA_CONN_UART1_Tx ((10UL)) /**< UART1 Tx */ +#define GPDMA_CONN_UART1_Rx ((11UL)) /**< UART1 Rx */ +#define GPDMA_CONN_UART2_Tx ((12UL)) /**< UART2 Tx */ +#define GPDMA_CONN_UART2_Rx ((13UL)) /**< UART2 Rx */ +#define GPDMA_CONN_UART3_Tx ((14UL)) /**< UART3 Tx */ +#define GPDMA_CONN_UART3_Rx ((15UL)) /**< UART3 Rx */ +#define GPDMA_CONN_MAT0_0 ((16UL)) /**< MAT0.0 */ +#define GPDMA_CONN_MAT0_1 ((17UL)) /**< MAT0.1 */ +#define GPDMA_CONN_MAT1_0 ((18UL)) /**< MAT1.0 */ +#define GPDMA_CONN_MAT1_1 ((19UL)) /**< MAT1.1 */ +#define GPDMA_CONN_MAT2_0 ((20UL)) /**< MAT2.0 */ +#define GPDMA_CONN_MAT2_1 ((21UL)) /**< MAT2.1 */ +#define GPDMA_CONN_MAT3_0 ((22UL)) /**< MAT3.0 */ +#define GPDMA_CONN_MAT3_1 ((23UL)) /**< MAT3.1 */ + +/** GPDMA Transfer type definitions */ +#define GPDMA_TRANSFERTYPE_M2M ((0UL)) /**< Memory to memory - DMA control */ +#define GPDMA_TRANSFERTYPE_M2P ((1UL)) /**< Memory to peripheral - DMA control */ +#define GPDMA_TRANSFERTYPE_P2M ((2UL)) /**< Peripheral to memory - DMA control */ +#define GPDMA_TRANSFERTYPE_P2P ((3UL)) /**< Source peripheral to destination peripheral - DMA control */ + +/** Burst size in Source and Destination definitions */ +#define GPDMA_BSIZE_1 ((0UL)) /**< Burst size = 1 */ +#define GPDMA_BSIZE_4 ((1UL)) /**< Burst size = 4 */ +#define GPDMA_BSIZE_8 ((2UL)) /**< Burst size = 8 */ +#define GPDMA_BSIZE_16 ((3UL)) /**< Burst size = 16 */ +#define GPDMA_BSIZE_32 ((4UL)) /**< Burst size = 32 */ +#define GPDMA_BSIZE_64 ((5UL)) /**< Burst size = 64 */ +#define GPDMA_BSIZE_128 ((6UL)) /**< Burst size = 128 */ +#define GPDMA_BSIZE_256 ((7UL)) /**< Burst size = 256 */ + +/** Width in Source transfer width and Destination transfer width definitions */ +#define GPDMA_WIDTH_BYTE ((0UL)) /**< Width = 1 byte */ +#define GPDMA_WIDTH_HALFWORD ((1UL)) /**< Width = 2 bytes */ +#define GPDMA_WIDTH_WORD ((2UL)) /**< Width = 4 bytes */ + +/** DMA Request Select Mode definitions */ +#define GPDMA_REQSEL_UART ((0UL)) /**< UART TX/RX is selected */ +#define GPDMA_REQSEL_TIMER ((1UL)) /**< Timer match is selected */ + +/** + * @} + */ + + +/* Private Macros ------------------------------------------------------------- */ +/** @defgroup GPDMA_Private_Macros GPDMA Private Macros + * @{ + */ + +/* --------------------- BIT DEFINITIONS -------------------------------------- */ +/*********************************************************************//** + * Macro defines for DMA Interrupt Status register + **********************************************************************/ +#define GPDMA_DMACIntStat_Ch(n) (((1UL<=0) && (n<=7)) + +/* Macros check GPDMA connection type */ +#define PARAM_GPDMA_CONN(n) ((n==GPDMA_CONN_SSP0_Tx) || (n==GPDMA_CONN_SSP0_Rx) \ +|| (n==GPDMA_CONN_SSP1_Tx) || (n==GPDMA_CONN_SSP1_Rx) \ +|| (n==GPDMA_CONN_ADC) || (n==GPDMA_CONN_I2S_Channel_0) \ +|| (n==GPDMA_CONN_I2S_Channel_1) || (n==GPDMA_CONN_DAC) \ +|| (n==GPDMA_CONN_UART0_Tx) || (n==GPDMA_CONN_UART0_Rx) \ +|| (n==GPDMA_CONN_UART1_Tx) || (n==GPDMA_CONN_UART1_Rx) \ +|| (n==GPDMA_CONN_UART2_Tx) || (n==GPDMA_CONN_UART2_Rx) \ +|| (n==GPDMA_CONN_UART3_Tx) || (n==GPDMA_CONN_UART3_Rx) \ +|| (n==GPDMA_CONN_MAT0_0) || (n==GPDMA_CONN_MAT0_1) \ +|| (n==GPDMA_CONN_MAT1_0) || (n==GPDMA_CONN_MAT1_1) \ +|| (n==GPDMA_CONN_MAT2_0) || (n==GPDMA_CONN_MAT2_1) \ +|| (n==GPDMA_CONN_MAT3_0) || (n==GPDMA_CONN_MAT3_1)) + +/* Macros check GPDMA burst size type */ +#define PARAM_GPDMA_BSIZE(n) ((n==GPDMA_BSIZE_1) || (n==GPDMA_BSIZE_4) \ +|| (n==GPDMA_BSIZE_8) || (n==GPDMA_BSIZE_16) \ +|| (n==GPDMA_BSIZE_32) || (n==GPDMA_BSIZE_64) \ +|| (n==GPDMA_BSIZE_128) || (n==GPDMA_BSIZE_256)) + +/* Macros check GPDMA width type */ +#define PARAM_GPDMA_WIDTH(n) ((n==GPDMA_WIDTH_BYTE) || (n==GPDMA_WIDTH_HALFWORD) \ +|| (n==GPDMA_WIDTH_WORD)) + +/* Macros check GPDMA status type */ +#define PARAM_GPDMA_STAT(n) ((n==GPDMA_STAT_INT) || (n==GPDMA_STAT_INTTC) \ +|| (n==GPDMA_STAT_INTERR) || (n==GPDMA_STAT_RAWINTTC) \ +|| (n==GPDMA_STAT_RAWINTERR) || (n==GPDMA_STAT_ENABLED_CH)) + +/* Macros check GPDMA transfer type */ +#define PARAM_GPDMA_TRANSFERTYPE(n) ((n==GPDMA_TRANSFERTYPE_M2M)||(n==GPDMA_TRANSFERTYPE_M2P) \ +||(n==GPDMA_TRANSFERTYPE_P2M)||(n==GPDMA_TRANSFERTYPE_P2P)) + +/* Macros check GPDMA state clear type */ +#define PARAM_GPDMA_STATCLR(n) ((n==GPDMA_STATCLR_INTTC) || (n==GPDMA_STATCLR_INTERR)) + +/* Macros check GPDMA request select type */ +#define PARAM_GPDMA_REQSEL(n) ((n==GPDMA_REQSEL_UART) || (n==GPDMA_REQSEL_TIMER)) +/** + * @} + */ + + +/* Public Types --------------------------------------------------------------- */ +/** @defgroup GPDMA_Public_Types GPDMA Public Types + * @{ + */ + +/** + * @brief GPDMA Status enumeration + */ +typedef enum { + GPDMA_STAT_INT, /**< GPDMA Interrupt Status */ + GPDMA_STAT_INTTC, /**< GPDMA Interrupt Terminal Count Request Status */ + GPDMA_STAT_INTERR, /**< GPDMA Interrupt Error Status */ + GPDMA_STAT_RAWINTTC, /**< GPDMA Raw Interrupt Terminal Count Status */ + GPDMA_STAT_RAWINTERR, /**< GPDMA Raw Error Interrupt Status */ + GPDMA_STAT_ENABLED_CH /**< GPDMA Enabled Channel Status */ +} GPDMA_Status_Type; + +/** + * @brief GPDMA Interrupt clear status enumeration + */ +typedef enum{ + GPDMA_STATCLR_INTTC, /**< GPDMA Interrupt Terminal Count Request Clear */ + GPDMA_STATCLR_INTERR /**< GPDMA Interrupt Error Clear */ +}GPDMA_StateClear_Type; + +/** + * @brief GPDMA Channel configuration structure type definition + */ +typedef struct { + uint32_t ChannelNum; /**< DMA channel number, should be in + range from 0 to 7. + Note: DMA channel 0 has the highest priority + and DMA channel 7 the lowest priority. + */ + uint32_t TransferSize; /**< Length/Size of transfer */ + uint32_t TransferWidth; /**< Transfer width - used for TransferType is GPDMA_TRANSFERTYPE_M2M only */ + uint32_t SrcMemAddr; /**< Physical Source Address, used in case TransferType is chosen as + GPDMA_TRANSFERTYPE_M2M or GPDMA_TRANSFERTYPE_M2P */ + uint32_t DstMemAddr; /**< Physical Destination Address, used in case TransferType is chosen as + GPDMA_TRANSFERTYPE_M2M or GPDMA_TRANSFERTYPE_P2M */ + uint32_t TransferType; /**< Transfer Type, should be one of the following: + - GPDMA_TRANSFERTYPE_M2M: Memory to memory - DMA control + - GPDMA_TRANSFERTYPE_M2P: Memory to peripheral - DMA control + - GPDMA_TRANSFERTYPE_P2M: Peripheral to memory - DMA control + - GPDMA_TRANSFERTYPE_P2P: Source peripheral to destination peripheral - DMA control + */ + uint32_t SrcConn; /**< Peripheral Source Connection type, used in case TransferType is chosen as + GPDMA_TRANSFERTYPE_P2M or GPDMA_TRANSFERTYPE_P2P, should be one of + following: + - GPDMA_CONN_SSP0_Tx: SSP0, Tx + - GPDMA_CONN_SSP0_Rx: SSP0, Rx + - GPDMA_CONN_SSP1_Tx: SSP1, Tx + - GPDMA_CONN_SSP1_Rx: SSP1, Rx + - GPDMA_CONN_ADC: ADC + - GPDMA_CONN_I2S_Channel_0: I2S Channel 0 + - GPDMA_CONN_I2S_Channel_1: I2S Channel 1 + - GPDMA_CONN_DAC: DAC + - GPDMA_CONN_UART0_Tx_MAT0_0: UART0 Tx / MAT0.0 + - GPDMA_CONN_UART0_Rx_MAT0_1: UART0 Rx / MAT0.1 + - GPDMA_CONN_UART1_Tx_MAT1_0: UART1 Tx / MAT1.0 + - GPDMA_CONN_UART1_Rx_MAT1_1: UART1 Rx / MAT1.1 + - GPDMA_CONN_UART2_Tx_MAT2_0: UART2 Tx / MAT2.0 + - GPDMA_CONN_UART2_Rx_MAT2_1: UART2 Rx / MAT2.1 + - GPDMA_CONN_UART3_Tx_MAT3_0: UART3 Tx / MAT3.0 + - GPDMA_CONN_UART3_Rx_MAT3_1: UART3 Rx / MAT3.1 + */ + uint32_t DstConn; /**< Peripheral Destination Connection type, used in case TransferType is chosen as + GPDMA_TRANSFERTYPE_M2P or GPDMA_TRANSFERTYPE_P2P, should be one of + following: + - GPDMA_CONN_SSP0_Tx: SSP0, Tx + - GPDMA_CONN_SSP0_Rx: SSP0, Rx + - GPDMA_CONN_SSP1_Tx: SSP1, Tx + - GPDMA_CONN_SSP1_Rx: SSP1, Rx + - GPDMA_CONN_ADC: ADC + - GPDMA_CONN_I2S_Channel_0: I2S Channel 0 + - GPDMA_CONN_I2S_Channel_1: I2S Channel 1 + - GPDMA_CONN_DAC: DAC + - GPDMA_CONN_UART0_Tx_MAT0_0: UART0 Tx / MAT0.0 + - GPDMA_CONN_UART0_Rx_MAT0_1: UART0 Rx / MAT0.1 + - GPDMA_CONN_UART1_Tx_MAT1_0: UART1 Tx / MAT1.0 + - GPDMA_CONN_UART1_Rx_MAT1_1: UART1 Rx / MAT1.1 + - GPDMA_CONN_UART2_Tx_MAT2_0: UART2 Tx / MAT2.0 + - GPDMA_CONN_UART2_Rx_MAT2_1: UART2 Rx / MAT2.1 + - GPDMA_CONN_UART3_Tx_MAT3_0: UART3 Tx / MAT3.0 + - GPDMA_CONN_UART3_Rx_MAT3_1: UART3 Rx / MAT3.1 + */ + uint32_t DMALLI; /**< Linker List Item structure data address + if there's no Linker List, set as '0' + */ +} GPDMA_Channel_CFG_Type; + +/** + * @brief GPDMA Linker List Item structure type definition + */ +typedef struct { + uint32_t SrcAddr; /**< Source Address */ + uint32_t DstAddr; /**< Destination address */ + uint32_t NextLLI; /**< Next LLI address, otherwise set to '0' */ + uint32_t Control; /**< GPDMA Control of this LLI */ +} GPDMA_LLI_Type; + + +/** + * @} + */ + +/* Public Functions ----------------------------------------------------------- */ +/** @defgroup GPDMA_Public_Functions GPDMA Public Functions + * @{ + */ + +void GPDMA_Init(void); +//Status GPDMA_Setup(GPDMA_Channel_CFG_Type *GPDMAChannelConfig, fnGPDMACbs_Type *pfnGPDMACbs); +Status GPDMA_Setup(GPDMA_Channel_CFG_Type *GPDMAChannelConfig); +IntStatus GPDMA_IntGetStatus(GPDMA_Status_Type type, uint8_t channel); +void GPDMA_ClearIntPending(GPDMA_StateClear_Type type, uint8_t channel); +void GPDMA_ChannelCmd(uint8_t channelNum, FunctionalState NewState); +//void GPDMA_IntHandler(void); + +/** + * @} + */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LPC17XX_GPDMA_H_ */ + +/** + * @} + */ + +/* --------------------------------- End Of File ------------------------------ */ -- cgit v1.2.3