/**
******************************************************************************
* @file tae32f53xx_ll_usb.h
* @author MCD Application Team
* @brief Header file of USB LL module.
*
******************************************************************************
* @attention
*
*
© Copyright (c) 2020 Tai-Action.
* All rights reserved.
*
* This software is licensed by Tai-Action under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
*
******************************************************************************
*/
/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef _TAE32F53XX_LL_USB_H_
#define _TAE32F53XX_LL_USB_H_
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/* Includes ------------------------------------------------------------------*/
#include "tae32f53xx_ll_def.h"
/** @addtogroup TAE32F53xx_LL_Driver
* @{
*/
/** @addtogroup USB_LL
* @{
*/
/* Exported constants --------------------------------------------------------*/
/* Exported macro ------------------------------------------------------------*/
/** @defgroup USB_LL_Exported_Macros USB LL Exported Macros
* @brief USB LL Exported Macros
* @{
*/
/**
* @brief Set Function Address
* @param __USB__ Specifies USB peripheral
* @param func_addr Function Address
* @return None
*/
#define __LL_USB_FuncAddr_Set(__USB__, func_addr) \
MODIFY_REG((__USB__)->FADDR, USB_FUNC_ADDR_Msk, ((func_addr & 0x7FUL) << USB_FUNC_ADDR_Pos))
/**
* @brief Enable the SUSPENDM output
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_SuspendDMOut_En(__USB__) SET_BIT((__USB__)->POWER, USB_SUSPEND_DM_EN_Msk)
/**
* @brief Disable the SUSPENDM output
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_SuspendDMOut_Dis(__USB__) CLEAR_BIT((__USB__)->POWER, USB_SUSPEND_DM_EN_Msk)
/**
* @brief Enable HighSpeed
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_HighSpeed_En(__USB__) SET_BIT((__USB__)->POWER, USB_HS_EN_Msk)
/**
* @brief Disable HighSpeed
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_HighSpeed_Dis(__USB__) CLEAR_BIT((__USB__)->POWER, USB_HS_EN_Msk)
/**
* @brief Enable Soft Connect
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_SoftConn_En(__USB__) SET_BIT((__USB__)->POWER, USB_SOFT_CONN_EN_Msk)
/**
* @brief Disable Soft Connect
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_SoftConn_Dis(__USB__) CLEAR_BIT((__USB__)->POWER, USB_SOFT_CONN_EN_Msk)
/**
* @brief Get Endpoint 0 and TX Endpoint Interrupt Status
* @param __USB__ Specifies USB peripheral
* @return Endpoint 0 and TX Endpoint Interrupt Status
*/
#define __LL_USB_EP0AndEPxTX_IntSta_Get(__USB__) ((__USB__)->INTRTX)
/**
* @brief Get RX Endpoint Interrupt Status
* @param __USB__ Specifies USB peripheral
* @return RX Interrupt Status
*/
#define __LL_USB_EPx_RXIntSta_Get(__USB__) ((__USB__)->INTRRX)
/**
* @brief Enable Endpoint 0 and TX Endpoint Interrupt
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @return None
*/
#define __LL_USB_EP0AndEPxTX_Int_EN(__USB__, ep_num) \
do { \
if(ep_num >= EP_NUMS){ \
break; \
} \
uint16_t ep0_and_epxtx_int_en_bitmask[] = {USB_EP0_INT_EN_Msk, USB_TX_EP1_INT_EN_Msk, USB_TX_EP2_INT_EN_Msk}; \
SET_BIT((__USB__)->INTRTXE, ep0_and_epxtx_int_en_bitmask[ep_num]); \
} while(0)
/**
* @brief Disable Endpoint 0 and TX Endpoint Interrupt
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @return None
*/
#define __LL_USB_EP0AndEPxTX_Int_Dis(__USB__, ep_num) \
do { \
if(ep_num >= EP_NUMS){ \
break; \
} \
uint16_t ep0_and_epxtx_int_en_bitmask[] = {USB_EP0_INT_EN_Msk, USB_TX_EP1_INT_EN_Msk, USB_TX_EP2_INT_EN_Msk}; \
CLEAR_BIT((__USB__)->INTRTXE, ep0_and_epxtx_int_en_bitmask[ep_num]); \
} while(0)
/**
* @brief Enable RX Endpoint Interrupt
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @return None
*/
#define __LL_USB_EPx_RXInt_En(__USB__, ep_num) \
do { \
if(ep_num >= EP_NUMS){ \
break; \
} \
uint16_t epxrx_int_en_bitmask[] = {0, USB_RX_EP1_INT_EN_Msk, USB_RX_EP2_INT_EN_Msk}; \
SET_BIT((__USB__)->INTRRXE, epxrx_int_en_bitmask[ep_num]); \
} while(0)
/**
* @brief Disable RX Endpoint Interrupt
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @return None
*/
#define __LL_USB_EPx_RXInt_Dis(__USB__, ep_num) \
do { \
if(ep_num >= EP_NUMS){ \
break; \
} \
uint16_t epxrx_int_en_bitmask[] = {0, USB_RX_EP1_INT_EN_Msk, USB_RX_EP2_INT_EN_Msk}; \
CLEAR_BIT((__USB__)->INTRRXE, epxrx_int_en_bitmask[ep_num]); \
} while(0)
/**
* @brief Get USB Controler Interrupt Status
* @param __USB__ Specifies USB peripheral
* @return USB Controler Interrupt Status
*/
#define __LL_USB_IntSta_Get(__USB__) (READ_BIT((__USB__)->INTRUSB, USB_CTRL_INT_ALL_Msk) >> USB_SUSPEND_INT_STA_Pos)
/**
* @brief Enable USB Controler Interrupt
* @param __USB__ Specifies USB peripheral
* @param int_bit_mask Interrupt BitMask to Be Enable
* @return None
*/
#define __LL_USB_Int_EN(__USB__, int_bit_mask) SET_BIT((__USB__)->INTRUSBE, int_bit_mask)
/**
* @brief Disable USB Controler Interrupt
* @param __USB__ Specifies USB peripheral
* @param int_bit_mask Interrupt BitMask to be Disable
* @return None
*/
#define __LL_USB_Int_Dis(__USB__, int_bit_mask) CLEAR_BIT((__USB__)->INTRUSBE, int_bit_mask)
/**
* @brief Get Frame Number
* @param __USB__ Specifies USB peripheral
* @return Frame Number
*/
#define __LL_USB_FrameNum_Get(__USB__) (READ_BIT((__USB__)->FRAME, USB_FRAME_NUM_Msk) >> USB_FRAME_NUM_Pos)
/**
* @brief Set Endpoint Index
* @param __USB__ Specifies USB peripheral
* @param idx Index to be Set
* @return None
*/
#define __LL_USB_EPIndex_Set(__USB__, idx) \
MODIFY_REG((__USB__)->INDEX, USB_EP_INDEX_Msk, ((idx & 0xFUL) << USB_EP_INDEX_Pos))
/**
* @brief Set TX Max Payload
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @param max_payload Max Payload to be Set
* @return None
*/
#define __LL_USB_EPx_TXMaxPayload_Set(__USB__, max_payload) \
MODIFY_REG((__USB__)->TXMAXP, USB_EPX_TX_MAX_PAYLD_Msk, ((max_payload & 0xFFFFUL) << USB_EPX_TX_MAX_PAYLD_Pos))
/**
* @brief Get TX Max Payload
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return TX Max Payload
*/
#define __LL_USB_EPx_TXMaxPayload_Get(__USB__) \
(READ_BIT((__USB__)->TXMAXP, USB_EPX_TX_MAX_PAYLD_Msk) >> USB_EPX_TX_MAX_PAYLD_Pos)
/**
* @brief Judge Endpoint 0 RX Packet Ready or not
* @param __USB__ Specifies USB peripheral
* @retval 0 RX Packet Not Ready
* @retval 1 RX Packet Ready
*/
#define __LL_USB_EP0_IsRXPktRdy(__USB__) (READ_BIT((__USB__)->TX_CSR0, USB_EP0_RX_PKT_RDY_Msk) >> USB_EP0_RX_PKT_RDY_Pos)
/**
* @brief Clear Endpoint 0 RX Packet Ready
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_RXPktRdy_Clr(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_CLR_RX_PKT_RDY_Msk)
/**
* @brief Set Endpoint 0 TX Packet Ready
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_TXPktRdy_Set(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_TX_PKT_RDY_Msk)
/**
* @brief Judge Endpoint 0 TX Packet Ready or not
* @param __USB__ Specifies USB peripheral
* @retval 0 TX Packet Not Ready
* @retval 1 TX Packet Ready
*/
#define __LL_USB_EP0_IsTXPktRdy(__USB__) (READ_BIT((__USB__)->TX_CSR0, USB_EP0_TX_PKT_RDY_Msk) >> USB_EP0_TX_PKT_RDY_Pos)
/**
* @brief Set Endpoint 0 to Send Stall
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_SendStall_Set(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_SEND_STALL_Msk)
/**
* @brief Judge Endpoint 0 has Sent Stall or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Hasn't Sent Stall
* @retval 1 Has Sent Stall
*/
#define __LL_USB_EP0_IsSentStall(__USB__) (READ_BIT((__USB__)->TX_CSR0, USB_EP0_SENT_STALL_Msk) >> USB_EP0_SENT_STALL_Pos)
/**
* @brief Clear Endpoint 0 Sent Stall Status
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_SentStall_Clr(__USB__) CLEAR_BIT((__USB__)->TX_CSR0, USB_EP0_SENT_STALL_Msk)
/**
* @brief Set Endpoint 0 Data End
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_DataEnd_Set(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_DATA_END_Msk)
/**
* @brief Judge Endpoint 0 has SetupEnd or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Hasn't Setup End
* @retval 1 Has Setup End
*/
#define __LL_USB_EP0_IsSetupEnd(__USB__) (READ_BIT((__USB__)->TX_CSR0, USB_EP0_SETUP_END_Msk) >> USB_EP0_SETUP_END_Pos)
/**
* @brief Clear Endpoint 0 SetupEnd Status
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_SetupEnd_Clr(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_CLR_SETUP_END_Msk)
/**
* @brief Flush Endpoint 0 FIFO
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EP0_FlushFIFO(__USB__) SET_BIT((__USB__)->TX_CSR0, USB_EP0_FLUSH_FIFO_Msk)
/**
* @brief Enable TX Packet Ready Auto Set Function
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXPktRdyAutoSet_En(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_AUTO_SET_Msk)
/**
* @brief Disable TX Packet Ready Auto Set Function
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXPktRdyAutoSet_Dis(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_AUTO_SET_Msk)
/**
* @brief Enable Endpoint TX ISO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXISO_En(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_ISO_EN_Msk)
/**
* @brief Disable Endpoint TX ISO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXISO_Dis(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_ISO_EN_Msk)
/**
* @brief Enable Endpoint TX
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TX_En(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_DIR_MODE_Msk)
/**
* @brief Enable Endpoint RX
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RX_En(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_DIR_MODE_Msk)
/**
* @brief Enable Endpoint TX DMA Request
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXDMAReq_En(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_DMA_REQ_EN_Msk)
/**
* @brief Disable Endpoint TX DMA Request
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXDMAReq_Dis(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_DMA_REQ_EN_Msk)
/**
* @brief Set Endpoint TX to Force Data Toggle
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXForceDataTog_Set(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_FRC_DATA_TOG_Msk)
/**
* @brief Clear Endpoint TX to Force Data Toggle
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXForceDataTog_Clr(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_FRC_DATA_TOG_Msk)
/**
* @brief Set Endpoint TX DMA Request Mode to 0
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXDMAReqMode0_Set(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_DMA_REQ_MODE_Msk)
/**
* @brief Set Endpoint TX DMA Request Mode to 1
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXDMAReqMode1_Set(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_DMA_REQ_MODE_Msk)
/**
* @brief Judge TX ISO Endpoint Is Incomplete or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Complete
* @retval 1 Incomplete
*/
#define __LL_USB_EPx_IsTXISOInComp(__USB__) \
(READ_BIT((__USB__)->TX_CSRX, USB_EPX_TX_ISO_INCOMP_Msk) >> USB_EPX_TX_ISO_INCOMP_Pos)
/**
* @brief Clear TX Endpoint Data Toggle
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXDataTog_Clr(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_CLR_DATA_TOG_Msk)
/**
* @brief Judge TX Endpoint has Sent Stall or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Hasn't Sent Stall
* @retval 1 Has Sent Stall
*/
#define __LL_USB_EPx_IsTXSentStall(__USB__) \
(READ_BIT((__USB__)->TX_CSRX, USB_EPX_TX_SENT_STALL_Msk) >> USB_EPX_TX_SENT_STALL_Pos)
/**
* @brief Clear TX Endpoint Sent Stall Status
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXSentStall_Clr(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_SENT_STALL_Msk)
/**
* @brief Enable TX Endpoint to Send Stall
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXSendStall_En(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_SEND_STALL_Msk)
/**
* @brief Disable TX Endpoint to Send Stall
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXSendStall_Dis(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_SEND_STALL_Msk)
/**
* @brief Flush TX Endpoint FIFO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXFlushFIFO(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_FLUSH_FIFO_Msk)
/**
* @brief Judge TX Endpoint FIFO Is UnderRun or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't UnderRun
* @retval 1 Is UnderRun
*/
#define __LL_USB_EPx_IsTXFIFOUnderRun(__USB__) \
(READ_BIT((__USB__)->TX_CSRX, USB_EPX_TX_UNDER_RUN_Msk) >> USB_EPX_TX_UNDER_RUN_Pos)
/**
* @brief Clear TX Endpoint UnderRun Status
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXFIFOUnderRun_Clr(__USB__) CLEAR_BIT((__USB__)->TX_CSRX, USB_EPX_TX_UNDER_RUN_Msk)
/**
* @brief Judge TX Endpoint FIFO Is NoEmpty or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't NoEmpty
* @retval 1 Is NoEmpty
*/
#define __LL_USB_EPx_IsTXFIFONoEmpty(__USB__) \
(READ_BIT((__USB__)->TX_CSRX, USB_EPX_TX_FIFO_NOT_EPY_Msk) >> USB_EPX_TX_FIFO_NOT_EPY_Pos)
/**
* @brief Set TX Endpoint Packet Ready
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_TXPktRdy_Set(__USB__) SET_BIT((__USB__)->TX_CSRX, USB_EPX_TX_PKT_RDY_Msk)
/**
* @brief Judge Endpoint TX Packet Ready or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Packet Ready
* @retval 1 Is Packet Ready
*/
#define __LL_USB_EPx_IsTXPktRdy(__USB__) \
(READ_BIT((__USB__)->TX_CSRX, USB_EPX_TX_PKT_RDY_Msk) >> USB_EPX_TX_PKT_RDY_Pos)
/**
* @brief Set RX Max Payload
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @param max_payload Max Payload to be Set
* @return None
*/
#define __LL_USB_EPx_RXMaxPayload_Set(__USB__, max_payload) \
MODIFY_REG((__USB__)->RXMAXP, USB_EPX_RX_MAX_PAYLD_Msk, ((max_payload & 0xFFFFUL) << USB_EPX_RX_MAX_PAYLD_Pos))
/**
* @brief Get RX Max Payload
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return RX Max Payload
*/
#define __LL_USB_EPx_RXMaxPayload_Get(__USB__) \
(READ_BIT((__USB__)->RXMAXP, USB_EPX_RX_MAX_PAYLD_Msk) >> USB_EPX_RX_MAX_PAYLD_Pos)
/**
* @brief Enable RX Packet Ready Auto Clear Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXPktRdyAutoClr_En(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_AUTO_CLR_Msk)
/**
* @brief Disable RX Packet Ready Auto Clear Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXPktRdyAutoClr_Dis(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_AUTO_CLR_Msk)
/**
* @brief Enable Endpoint RX ISO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXISO_En(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_ISO_EN_Msk)
/**
* @brief Disable Endpoint RX ISO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXISO_Dis(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_ISO_EN_Msk)
/**
* @brief Enable Endpoint RX DMA Request
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXDMAReq_En(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_DMQ_REQ_EN_Msk)
/**
* @brief Disable Endpoint RX DMA Request
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXDMAReq_Dis(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_DMQ_REQ_EN_Msk)
/**
* @brief Judge RX ISO Endpoint PID Error or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't PID Error
* @retval 1 Is PID Error
*/
#define __LL_USB_EPx_IsRXISOPIDErr(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_ISO_PID_ERR_Msk) >> USB_EPX_RX_ISO_PID_ERR_Pos)
/**
* @brief Set Endpoint RX DMA Request Mode to 0
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXDMAReqMode0_Set(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_DMA_REQ_MODE_Msk)
/**
* @brief Set Endpoint RX DMA Request Mode to 1
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXDMAReqMode1_Set(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_DMA_REQ_MODE_Msk)
/**
* @brief Judge RX ISO Endpoint Is Incomplete or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Complete
* @retval 1 Incomplete
*/
#define __LL_USB_EPx_IsRXISOInComp(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_ISO_INCOMP_Msk) >> USB_EPX_RX_ISO_INCOMP_Pos)
/**
* @brief Clear RX Endpoint Data Toggle
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXDataTog_Clr(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_CLR_DATA_TOG_Msk)
/**
* @brief Judge RX Endpoint has Sent Stall or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Hasn't Sent Stall
* @retval 1 Has Sent Stall
*/
#define __LL_USB_EPx_IsRXSentStall(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_SENT_STALL_Msk) >> USB_EPX_RX_SENT_STALL_Pos)
/**
* @brief Clear RX Endpoint Sent Stall Status
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXSentStall_Clr(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_SENT_STALL_Msk)
/**
* @brief Enable RX Endpoint to Send Stall
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXSendStall_En(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_SEND_STALL_Msk)
/**
* @brief Disable RX Endpoint to Send Stall
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXSendStall_Dis(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_SEND_STALL_Msk)
/**
* @brief Flush RX Endpoint FIFO
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXFlushFIFO(__USB__) SET_BIT((__USB__)->RXCSRN, USB_EPX_RX_FLUSH_FIFO_Msk)
/**
* @brief Judge RX ISO Endpoint Data Error or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Data Error
* @retval 1 Is Data Error
*/
#define __LL_USB_EPx_IsISORXDataErr(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_ISO_DATA_ERR_Msk) >> USB_EPX_RX_ISO_DATA_ERR_Pos)
/**
* @brief Judge RX ISO Endpoint FIFO Is OverRun or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't OverRun
* @retval 1 Is OverRun
*/
#define __LL_USB_EPx_IsISORXFIFOOverRun(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_OVER_RUN_Msk) >> USB_EPX_RX_OVER_RUN_Pos)
/**
* @brief Clear RX ISO Endpoint OverrRun Status
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_ISORXFIFOOverRun_Clr(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_OVER_RUN_Msk)
/**
* @brief Judge RX FIFO Full or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Full
* @retval 1 Is Full
*/
#define __LL_USB_EPx_IsRXFIFOFull(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_FIFO_FULL_Msk) >> USB_EPX_RX_FIFO_FULL_Pos)
/**
* @brief Judge Endpoint RX Packet Ready or not
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Packet Ready
* @retval 1 Is Packet Ready
*/
#define __LL_USB_EPx_IsRXPktRdy(__USB__) \
(READ_BIT((__USB__)->RXCSRN, USB_EPX_RX_PKT_RDY_Msk) >> USB_EPX_RX_PKT_RDY_Pos)
/**
* @brief Clear RX Endpoint Packet Ready Status
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_EPx_RXPktRdy_Clr(__USB__) CLEAR_BIT((__USB__)->RXCSRN, USB_EPX_RX_PKT_RDY_Msk)
/**
* @brief Get Endpoint RX Counter
* @note Must Set Endpoint Index first Before Call This Macro Function
* @param __USB__ Specifies USB peripheral
* @return RX Counter
*/
#define __LL_USB_RXCount_Get(__USB__) (READ_BIT((__USB__)->RXCOUNT, USB_RX_CNT_Msk) >> USB_RX_CNT_Pos)
/**
* @brief Write Single Byte to Endpoint TX FIFO
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @param dat Data to be Written
* @return None
*/
#define __LL_USB_EPFIFOWriteByte(__USB__, ep_num, dat) do{ (__USB__)->EP_FIFO[ep_num][0] = dat; }while(0)
/**
* @brief Read Single Byte form Endpoint RX FIFO
* @param __USB__ Specifies USB peripheral
* @param ep_num USB_EpNumETypeDef Type Endpoint Number
* @return Read Byte Data
*/
#define __LL_USB_EPFIFOReadByte(__USB__, ep_num) ((__USB__)->EP_FIFO[ep_num][0])
/**
* @brief Config DM Output Hardware
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMOutputHardware(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_DM_OE_EN_Msk)
/**
* @brief Config DM Output Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMOutputNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DM_OE_EN_Msk | USB_DM_OE_Msk)
/**
* @brief Disable DM Output
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMOutputDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DP_OE_EN_Msk)
/**
* @brief Config DP Output Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPOutputNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DP_OE_EN_Msk | USB_DP_OE_Msk)
/**
* @brief Disable DP Output
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPOutputDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DM_IE_EN_Msk)
/**
* @brief Config DM Input Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMInputNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DM_IE_EN_Msk | USB_DM_IE_Msk)
/**
* @brief Disable DM Input
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMInputDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DP_IE_EN_Msk)
/**
* @brief Config DP Input Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPInputNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DP_IE_EN_Msk | USB_DP_IE_Msk)
/**
* @brief Disable DP Input
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPInputDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DM_PD_EN_Msk)
/**
* @brief Config DM PullDown Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMPullDownNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DM_PD_EN_Msk | USB_DM_PD_Msk)
/**
* @brief Disable DM PullDown
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMPullDownDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DM_PU_EN_Msk)
/**
* @brief Config DM PullUp Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMPullUpNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DM_PU_EN_Msk | USB_DM_PU_Msk)
/**
* @brief Disable DM PullUp
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DMPullUpDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DP_PD_EN_Msk)
/**
* @brief Config DP PullDown Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPPullDownNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DP_PD_EN_Msk | USB_DP_PD_Msk)
/**
* @brief Disable DP PullDown
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPPullDownDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_DP_PU_EN_Msk)
/**
* @brief Config DP PullUp Normal
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPPullUpNormal(__USB__) SET_BIT((__USB__)->UCFG0, USB_DP_PU_EN_Msk | USB_DP_PU_Msk)
/**
* @brief Disable DP PullUp
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_DPPullUpDisable(__USB__) MODIFY_REG((__USB__)->UCFG0, 0x3UL<UCFG0, USB_VBUS_VALID_THRES_Msk)
/**
* @brief Clear Vbus Above VBusValid Threshold
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_VbusValidThreshold_Clr(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_VBUS_VALID_THRES_Msk)
/**
* @brief Set Vbus Above Vbus A-device Session Threshold
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_VbusAboveAdevSessThres_Set(__USB__) SET_BIT((__USB__)->UCFG0, USB_VBUS_A_SESS_THRES_Msk)
/**
* @brief Clear Vbus Above Vbus A-device Session Threshold
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_VbusAboveAdevSessThres_Clr(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_VBUS_A_SESS_THRES_Msk)
/**
* @brief Set Vbus Above Session End Threshold
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_VbusAboveSessEndThres_Set(__USB__) SET_BIT((__USB__)->UCFG0, USB_VBUS_SESS_END_THRES_Msk)
/**
* @brief Clear Vbus Above Session End Threshold
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_VbusAboveSessEndThres_Clr(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_VBUS_SESS_END_THRES_Msk)
/**
* @brief Set Mini-AB Connector ID Pin
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_MiniABConnectorID_Set(__USB__) SET_BIT((__USB__)->UCFG0, USB_MINI_AB_CONN_ID_Msk)
/**
* @brief Clear Mini-AB Connector ID Pin
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_MiniABConnectorID_Clr(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_MINI_AB_CONN_ID_Msk)
/**
* @brief Enable USB PHY
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_PHY_En(__USB__) SET_BIT((__USB__)->UCFG0, USB_PHY_EN_Msk)
/**
* @brief Disable USB PHY
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_PHY_Dis(__USB__) CLEAR_BIT((__USB__)->UCFG0, USB_PHY_EN_Msk)
/**
* @brief Enable Interrupt Send to CPU
* @param __USB__ Specifies USB peripheral
* @param int_bit_mask Interrupt BitMask to be Enable
* @return None
*/
#define __LL_USB_INTSendToCPU_En(__USB__, int_bit_mask) SET_BIT((__USB__)->UCFG1, int_bit_mask)
/**
* @brief Disable Interrupt Send to CPU
* @param __USB__ Specifies USB peripheral
* @param int_bit_mask Interrupt BitMask to be Disable
* @return None
*/
#define __LL_USB_INTSendToCPU_Dis(__USB__, int_bit_mask) CLEAR_BIT((__USB__)->UCFG1, int_bit_mask)
/**
* @brief Get SendState
* @param __USB__ Specifies USB peripheral
* @retval 0 Reserved
* @retval 1 Setup
* @retval 2 Out
* @retval 3 IN
*/
#define __LL_USB_SendState_Get(__USB__) (READ_BIT((__USB__)->UCFG2, USB_SEND_STATE_Msk) >> USB_SEND_STATE_Pos)
/**
* @brief Judge Is IN Packet or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't IN Packet
* @retval 1 Is IN Packet
*/
#define __LL_USB_IsInPacket(__USB__) (READ_BIT((__USB__)->UCFG2, USB_IN_STATE_Msk) >> USB_IN_STATE_Pos)
/**
* @brief Judge Is OUT Packet or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't OUT Packet
* @retval 1 Is OUT Packet
*/
#define __LL_USB_IsOutPacket(__USB__) (READ_BIT((__USB__)->UCFG2, USB_OUT_STATE_Msk) >> USB_OUT_STATE_Pos)
/**
* @brief Judge Is Setup Packet or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Setup Packet
* @retval 1 Is Setup Packet
*/
#define __LL_USB_IsSetupPacket(__USB__) (READ_BIT((__USB__)->UCFG2, USB_SETUP_STATE_Msk) >> USB_SETUP_STATE_Pos)
/**
* @brief Set Debounce Max
* @param __USB__ Specifies USB peripheral
* @param debouce debouce to be set
* @return None
*/
#define __LL_USB_DebouceMax_Set(__USB__, debouce) \
MODIFY_REG((__USB__)->UCFG2, USB_DEBOUCE_MAX_Msk, ((debouce & 0x3FFFUL) << USB_DEBOUCE_MAX_Pos))
/**
* @brief Enable Disconnect Interrupt
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Disconn_Int_En(__USB__) SET_BIT((__USB__)->UCFG2, USB_DISCONN_INT_EN_Msk)
/**
* @brief Disable Disconnect Interrupt
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Disconn_Int_Dis(__USB__) CLEAR_BIT((__USB__)->UCFG2, USB_DISCONN_INT_EN_Msk)
/**
* @brief Judge Is Disconnect Interrupt or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Disconnect Interrupt
* @retval 1 Is Disconnect Interrupt
*/
#define __LL_USB_IsDisconn(__USB__) (READ_BIT((__USB__)->UCFG2, USB_DISCONN_INT_STA_Msk) >> USB_DISCONN_INT_STA_Pos)
/**
* @brief Clear Disconnect Interrupt Pending
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Disconn_Clr(__USB__) SET_BIT((__USB__)->UCFG2, USB_DISCONN_INT_STA_Msk)
/**
* @brief Enable Connect Interrupt
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Conn_Int_En(__USB__) SET_BIT((__USB__)->UCFG2, USB_CONN_INT_EN_Msk)
/**
* @brief Disable Connect Interrupt
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Conn_Int_Dis(__USB__) CLEAR_BIT((__USB__)->UCFG2, USB_CONN_INT_EN_Msk)
/**
* @brief Judge Is Connect Interrupt or not
* @param __USB__ Specifies USB peripheral
* @retval 0 Isn't Connect Interrupt
* @retval 1 Is Connect Interrupt
*/
#define __LL_USB_IsConn(__USB__) (READ_BIT((__USB__)->UCFG2, USB_CONN_INT_STA_Msk) >> USB_CONN_INT_STA_Pos)
/**
* @brief Clear Connect Interrupt Pending
* @param __USB__ Specifies USB peripheral
* @return None
*/
#define __LL_USB_Conn_Clr(__USB__) SET_BIT((__USB__)->UCFG2, USB_CONN_INT_STA_Msk)
/**
* @}
*/
/* Exported types ------------------------------------------------------------*/
/** @defgroup USB_LL_Exported_Types USB LL Exported Types
* @brief USB LL Exported Types
* @{
*/
/**
* @brief USB Endpoint Number
*/
typedef enum {
EP_NUM_0 = 0, /*!< Endpoint Number 0 */
EP_NUM_1 = 1, /*!< Endpoint Number 1 */
EP_NUM_2 = 2, /*!< Endpoint Number 2 */
EP_NUMS = 3, /*!< Endpoint Numbers */
} USB_EpNumETypeDef;
/**
* @}
*/
/* Exported functions --------------------------------------------------------*/
/** @addtogroup USB_LL_Exported_Functions
* @{
*/
/** @addtogroup USB_LL_Exported_Functions_Group1
* @{
*/
LL_StatusETypeDef LL_USB_Init(USB_TypeDef *Instance);
LL_StatusETypeDef LL_USB_DeInit(USB_TypeDef *Instance);
void LL_USB_MspInit(USB_TypeDef *Instance);
void LL_USB_MspDeInit(USB_TypeDef *Instance);
/**
* @}
*/
/** @addtogroup USB_LL_Exported_Functions_Group2
* @{
*/
void LL_USB_CtrlIRQHandler(USB_TypeDef *Instance);
void LL_USB_CtrlSuspendCallback(USB_TypeDef *Instance);
void LL_USB_CtrlResumeCallback(USB_TypeDef *Instance);
void LL_USB_CtrlResetCallback(USB_TypeDef *Instance);
void LL_USB_CtrlSofCallback(USB_TypeDef *Instance);
void LL_USB_CtrlSessEndCallback(USB_TypeDef *Instance);
/**
* @}
*/
/** @addtogroup USB_LL_Exported_Functions_Group3
* @{
*/
void LL_USB_DetIRQHandler(USB_TypeDef *Instance);
void LL_USB_DetConnectCallback(USB_TypeDef *Instance);
void LL_USB_DetDisonnectCallback(USB_TypeDef *Instance);
/**
* @}
*/
/** @addtogroup USB_LL_Exported_Functions_Group4
* @{
*/
void LL_USB_EpIRQHandler(USB_TypeDef *Instance);
void LL_USB_Ep0SetupCallback(USB_TypeDef *Instance);
void LL_USB_Ep0InCallback(USB_TypeDef *Instance);
void LL_USB_Ep0OutCallback(USB_TypeDef *Instance);
void LL_USB_Ep1InCallback(USB_TypeDef *Instance);
void LL_USB_Ep1OutCallback(USB_TypeDef *Instance);
void LL_USB_Ep2InCallback(USB_TypeDef *Instance);
void LL_USB_Ep2OutCallback(USB_TypeDef *Instance);
/**
* @}
*/
/**
* @}
*/
/* Private types -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private constants ---------------------------------------------------------*/
/* Private macros ------------------------------------------------------------*/
/* Private functions ---------------------------------------------------------*/
/**
* @}
*/
/**
* @}
*/
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* _TAE32F53XX_LL_USB_H_ */
/************************* (C) COPYRIGHT Tai-Action *****END OF FILE***********/