359 lines
16 KiB
C
359 lines
16 KiB
C
|
/**************************************************************************//**
|
||
|
|
* @file nu_pdma.h
|
||
|
|
* @version V1.00
|
||
|
|
* @brief M031 series PDMA driver header file
|
||
|
|
*
|
||
|
|
* SPDX-License-Identifier: Apache-2.0
|
||
|
|
* @copyright (C) 2018 Nuvoton Technology Corp. All rights reserved.
|
||
|
|
*****************************************************************************/
|
||
|
|
#ifndef __NU_PDMA_H__
|
||
|
|
#define __NU_PDMA_H__
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C"
|
||
|
|
{
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
/** @addtogroup Standard_Driver Standard Driver
|
||
|
|
@{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** @addtogroup PDMA_Driver PDMA Driver
|
||
|
|
@{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** @addtogroup PDMA_EXPORTED_CONSTANTS PDMA Exported Constants
|
||
|
|
@{
|
||
|
|
*/
|
||
|
|
#define PDMA_CH_MAX 9UL /*!< Specify Maximum Channels of PDMA \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Operation Mode Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_OP_STOP 0x00000000UL /*!<DMA Stop Mode \hideinitializer */
|
||
|
|
#define PDMA_OP_BASIC 0x00000001UL /*!<DMA Basic Mode \hideinitializer */
|
||
|
|
#define PDMA_OP_SCATTER 0x00000002UL /*!<DMA Scatter-gather Mode \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Data Width Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_WIDTH_8 0x00000000UL /*!<DMA Transfer Width 8-bit \hideinitializer */
|
||
|
|
#define PDMA_WIDTH_16 0x00001000UL /*!<DMA Transfer Width 16-bit \hideinitializer */
|
||
|
|
#define PDMA_WIDTH_32 0x00002000UL /*!<DMA Transfer Width 32-bit \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Address Attribute Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_SAR_INC 0x00000000UL /*!<DMA SAR increment \hideinitializer */
|
||
|
|
#define PDMA_SAR_FIX 0x00000300UL /*!<DMA SAR fix address \hideinitializer */
|
||
|
|
#define PDMA_DAR_INC 0x00000000UL /*!<DMA DAR increment \hideinitializer */
|
||
|
|
#define PDMA_DAR_FIX 0x00000C00UL /*!<DMA DAR fix address \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Burst Mode Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_REQ_SINGLE 0x00000004UL /*!<DMA Single Request \hideinitializer */
|
||
|
|
#define PDMA_REQ_BURST 0x00000000UL /*!<DMA Burst Request \hideinitializer */
|
||
|
|
|
||
|
|
#define PDMA_BURST_128 0x00000000UL /*!<DMA Burst 128 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_64 0x00000010UL /*!<DMA Burst 64 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_32 0x00000020UL /*!<DMA Burst 32 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_16 0x00000030UL /*!<DMA Burst 16 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_8 0x00000040UL /*!<DMA Burst 8 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_4 0x00000050UL /*!<DMA Burst 4 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_2 0x00000060UL /*!<DMA Burst 2 Transfers \hideinitializer */
|
||
|
|
#define PDMA_BURST_1 0x00000070UL /*!<DMA Burst 1 Transfers \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Table Interrupt Disable Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_TBINTDIS_ENABLE (0x0UL<<PDMA_DSCT_CTL_TBINTDIS_Pos) /*!<DMA Table Interrupt Enabled \hideinitializer */
|
||
|
|
#define PDMA_TBINTDIS_DISABLE (0x1UL<<PDMA_DSCT_CTL_TBINTDIS_Pos) /*!<DMA Table Interrupt Disabled \hideinitializer */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Peripheral Transfer Mode Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_MEM 0UL /*!<DMA Connect to Memory \hideinitializer */
|
||
|
|
#define PDMA_UART0_TX 4UL /*!<DMA Connect to UART0_TX \hideinitializer */
|
||
|
|
#define PDMA_UART0_RX 5UL /*!<DMA Connect to UART0_RX \hideinitializer */
|
||
|
|
#define PDMA_UART1_TX 6UL /*!<DMA Connect to UART1_TX \hideinitializer */
|
||
|
|
#define PDMA_UART1_RX 7UL /*!<DMA Connect to UART1_RX \hideinitializer */
|
||
|
|
#define PDMA_UART2_TX 8UL /*!<DMA Connect to UART2_TX \hideinitializer */
|
||
|
|
#define PDMA_UART2_RX 9UL /*!<DMA Connect to UART2_RX \hideinitializer */
|
||
|
|
#define PDMA_USCI0_TX 10UL /*!<DMA Connect to USCI0_TX \hideinitializer */
|
||
|
|
#define PDMA_USCI0_RX 11UL /*!<DMA Connect to USCI0_RX \hideinitializer */
|
||
|
|
#define PDMA_USCI1_TX 12UL /*!<DMA Connect to USCI1_TX \hideinitializer */
|
||
|
|
#define PDMA_USCI1_RX 13UL /*!<DMA Connect to USCI1_RX \hideinitializer */
|
||
|
|
#define PDMA_QSPI0_TX 16UL /*!<DMA Connect to QSPI0_TX \hideinitializer */
|
||
|
|
#define PDMA_QSPI0_RX 17UL /*!<DMA Connect to QSPI0_RX \hideinitializer */
|
||
|
|
#define PDMA_SPI0_TX 18UL /*!<DMA Connect to SPI0_TX \hideinitializer */
|
||
|
|
#define PDMA_SPI0_RX 19UL /*!<DMA Connect to SPI0_RX \hideinitializer */
|
||
|
|
#define PDMA_ADC_RX 20UL /*!<DMA Connect to ADC_RX \hideinitializer */
|
||
|
|
#define PDMA_PWM0_P1_RX 21UL /*!<DMA Connect to PWM0_P1 \hideinitializer */
|
||
|
|
#define PDMA_PWM0_P2_RX 22UL /*!<DMA Connect to PWM0_P2 \hideinitializer */
|
||
|
|
#define PDMA_PWM0_P3_RX 23UL /*!<DMA Connect to PWM0_P3 \hideinitializer */
|
||
|
|
#define PDMA_PWM1_P1_RX 24UL /*!<DMA Connect to PWM1_P1 \hideinitializer */
|
||
|
|
#define PDMA_PWM1_P2_RX 25UL /*!<DMA Connect to PWM1_P2 \hideinitializer */
|
||
|
|
#define PDMA_PWM1_P3_RX 26UL /*!<DMA Connect to PWM1_P3 \hideinitializer */
|
||
|
|
#define PDMA_I2C0_TX 28UL /*!<DMA Connect to I2C0_TX \hideinitializer */
|
||
|
|
#define PDMA_I2C0_RX 29UL /*!<DMA Connect to I2C0_RX \hideinitializer */
|
||
|
|
#define PDMA_I2C1_TX 30UL /*!<DMA Connect to I2C1_TX \hideinitializer */
|
||
|
|
#define PDMA_I2C1_RX 31UL /*!<DMA Connect to I2C1_RX \hideinitializer */
|
||
|
|
#define PDMA_TMR0 32UL /*!<DMA Connect to TMR0 \hideinitializer */
|
||
|
|
#define PDMA_TMR1 33UL /*!<DMA Connect to TMR1 \hideinitializer */
|
||
|
|
#define PDMA_TMR2 34UL /*!<DMA Connect to TMR2 \hideinitializer */
|
||
|
|
#define PDMA_TMR3 35UL /*!<DMA Connect to TMR3 \hideinitializer */
|
||
|
|
#define PDMA_UART3_TX 36UL /*!<DMA Connect to UART3_TX \hideinitializer */
|
||
|
|
#define PDMA_UART3_RX 37UL /*!<DMA Connect to UART3_RX \hideinitializer */
|
||
|
|
#define PDMA_UART4_TX 38UL /*!<DMA Connect to UART4_TX \hideinitializer */
|
||
|
|
#define PDMA_UART4_RX 39UL /*!<DMA Connect to UART4_RX \hideinitializer */
|
||
|
|
#define PDMA_UART5_TX 40UL /*!<DMA Connect to UART5_TX \hideinitializer */
|
||
|
|
#define PDMA_UART5_RX 41UL /*!<DMA Connect to UART5_RX \hideinitializer */
|
||
|
|
#define PDMA_UART6_TX 42UL /*!<DMA Connect to UART6_TX \hideinitializer */
|
||
|
|
#define PDMA_UART6_RX 43UL /*!<DMA Connect to UART6_RX \hideinitializer */
|
||
|
|
#define PDMA_UART7_TX 44UL /*!<DMA Connect to UART7_TX \hideinitializer */
|
||
|
|
#define PDMA_UART7_RX 45UL /*!<DMA Connect to UART7_RX \hideinitializer */
|
||
|
|
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Interrupt Type Constant Definitions */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
#define PDMA_INT_TRANS_DONE 0x00000000UL /*!<Transfer Done Interrupt \hideinitializer */
|
||
|
|
#define PDMA_INT_TEMPTY 0x00000001UL /*!<Table Empty Interrupt \hideinitializer */
|
||
|
|
#define PDMA_INT_TIMEOUT 0x00000002UL /*!<Timeout Interrupt \hideinitializer */
|
||
|
|
|
||
|
|
|
||
|
|
/*@}*/ /* end of group PDMA_EXPORTED_CONSTANTS */
|
||
|
|
|
||
|
|
/** @addtogroup PDMA_EXPORTED_FUNCTIONS PDMA Exported Functions
|
||
|
|
@{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get PDMA Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro gets the interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_GET_INT_STATUS(pdma) ((uint32_t)((pdma)->INTSTS))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get Transfer Done Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Get the transfer done Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_GET_TD_STS(pdma) ((uint32_t)((pdma)->TDSTS))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Clear Transfer Done Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Mask The channel mask
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Clear the transfer done Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_CLR_TD_FLAG(pdma, u32Mask) ((uint32_t)((pdma)->TDSTS = (u32Mask)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get Target Abort Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Get the target abort Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_GET_ABORT_STS(pdma) ((uint32_t)((pdma)->ABTSTS))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Clear Target Abort Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Mask The channel mask
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Clear the target abort Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_CLR_ABORT_FLAG(pdma, u32Mask) ((uint32_t)((pdma)->ABTSTS = (u32Mask)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Get Alignment Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Get Alignment Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_GET_ALIGN_STS(pdma) ((uint32_t)((pdma)->ALIGN))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Clear Alignment Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Mask The channel mask
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Clear the Alignment Interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_CLR_ALIGN_FLAG(pdma,u32Mask) ((uint32_t)((pdma)->ALIGN = (u32Mask)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Clear Timeout Interrupt Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details Clear the selected channel timeout interrupt status.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_CLR_TMOUT_FLAG(pdma, u32Ch) ((uint32_t)((pdma)->INTSTS = (1UL << ((u32Ch) + 8UL))))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Check Channel Status
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
*
|
||
|
|
* @retval 0 Idle state
|
||
|
|
* @retval 1 Busy state
|
||
|
|
*
|
||
|
|
* @details Check the selected channel is busy or not.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_IS_CH_BUSY(pdma, u32Ch) ((uint32_t)((pdma)->TRGSTS & (1UL << (u32Ch)))? 1 : 0)
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Set Source Address
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
* @param[in] u32Addr The selected address
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro set the selected channel source address.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_SET_SRC_ADDR(pdma, u32Ch, u32Addr) ((uint32_t)((pdma)->DSCT[(u32Ch)].SA = (u32Addr)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Set Destination Address
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
* @param[in] u32Addr The selected address
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro set the selected channel destination address.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_SET_DST_ADDR(pdma, u32Ch, u32Addr) ((uint32_t)((pdma)->DSCT[(u32Ch)].DA = (u32Addr)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Set Transfer Count
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
* @param[in] u32TransCount Transfer Count
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro set the selected channel transfer count.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_SET_TRANS_CNT(pdma, u32Ch, u32TransCount) ((uint32_t)((pdma)->DSCT[(u32Ch)].CTL=((pdma)->DSCT[(u32Ch)].CTL&~PDMA_DSCT_CTL_TXCNT_Msk)|(((u32TransCount)-1UL) << PDMA_DSCT_CTL_TXCNT_Pos)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Set Scatter-gather descriptor Address
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
* @param[in] u32Addr The descriptor address
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro set the selected channel scatter-gather descriptor address.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_SET_SCATTER_DESC(pdma, u32Ch, u32Addr) ((uint32_t)((pdma)->DSCT[(u32Ch)].NEXT = (u32Addr) - ((pdma)->SCATBA)))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Stop the channel
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro stop the selected channel.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_STOP(pdma, u32Ch) ((uint32_t)((pdma)->PAUSE = (1UL << (u32Ch))))
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Pause the channel
|
||
|
|
*
|
||
|
|
* @param[in] pdma The pointer of the specified PDMA module
|
||
|
|
* @param[in] u32Ch The selected channel
|
||
|
|
*
|
||
|
|
* @return None
|
||
|
|
*
|
||
|
|
* @details This macro pause the selected channel.
|
||
|
|
* \hideinitializer
|
||
|
|
*/
|
||
|
|
#define PDMA_PAUSE(pdma, u32Ch) ((uint32_t)((pdma)->PAUSE = (1UL << (u32Ch))))
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
/* Define PDMA functions prototype */
|
||
|
|
/*---------------------------------------------------------------------------------------------------------*/
|
||
|
|
void PDMA_Open(PDMA_T *pdma, uint32_t u32Mask);
|
||
|
|
void PDMA_Close(PDMA_T *pdma);
|
||
|
|
void PDMA_SetTransferCnt(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32Width, uint32_t u32TransCount);
|
||
|
|
void PDMA_SetTransferAddr(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32SrcAddr, uint32_t u32SrcCtrl, uint32_t u32DstAddr, uint32_t u32DstCtrl);
|
||
|
|
void PDMA_SetTransferMode(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32Peripheral, uint32_t u32ScatterEn, uint32_t u32DescAddr);
|
||
|
|
void PDMA_SetBurstType(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32BurstType, uint32_t u32BurstSize);
|
||
|
|
void PDMA_EnableTimeout(PDMA_T *pdma, uint32_t u32Mask);
|
||
|
|
void PDMA_DisableTimeout(PDMA_T *pdma, uint32_t u32Mask);
|
||
|
|
void PDMA_SetTimeOut(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32OnOff, uint32_t u32TimeOutCnt);
|
||
|
|
void PDMA_Trigger(PDMA_T *pdma, uint32_t u32Ch);
|
||
|
|
void PDMA_EnableInt(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32Mask);
|
||
|
|
void PDMA_DisableInt(PDMA_T *pdma, uint32_t u32Ch, uint32_t u32Mask);
|
||
|
|
|
||
|
|
|
||
|
|
/*@}*/ /* end of group PDMA_EXPORTED_FUNCTIONS */
|
||
|
|
|
||
|
|
/*@}*/ /* end of group PDMA_Driver */
|
||
|
|
|
||
|
|
/*@}*/ /* end of group Standard_Driver */
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* __NU_PDMA_H__ */
|
||
|
|
|
||
|
|
/*** (C) COPYRIGHT 2018 Nuvoton Technology Corp. ***/
|