rt-thread-official/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_emac.h

358 lines
15 KiB
C

/**************************************************************************//**
* @file nu_emac.h
* @version V1.00
* @brief M480 EMAC driver header file
*
* SPDX-License-Identifier: Apache-2.0
* @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved.
*****************************************************************************/
#ifndef __NU_EMAC_H__
#define __NU_EMAC_H__
#ifdef __cplusplus
extern "C"
{
#endif
#include <stdint.h>
/** @addtogroup Standard_Driver Standard Driver
@{
*/
/** @addtogroup EMAC_Driver EMAC Driver
@{
*/
/** @addtogroup EMAC_EXPORTED_CONSTANTS EMAC Exported Constants
@{
*/
#define EMAC_PHY_ADDR 1UL /*!< PHY address, this address is board dependent \hideinitializer */
#define EMAC_RX_DESC_SIZE 4UL /*!< Number of Rx Descriptors, should be 2 at least \hideinitializer */
#define EMAC_TX_DESC_SIZE 4UL /*!< Number of Tx Descriptors, should be 2 at least \hideinitializer */
#define EMAC_CAMENTRY_NB 16UL /*!< Number of CAM \hideinitializer */
#define EMAC_MAX_PKT_SIZE 1524UL /*!< Number of HDR + EXTRA + VLAN_TAG + PAYLOAD + CRC \hideinitializer */
#define EMAC_LINK_DOWN 0UL /*!< Ethernet link is down \hideinitializer */
#define EMAC_LINK_100F 1UL /*!< Ethernet link is 100Mbps full duplex \hideinitializer */
#define EMAC_LINK_100H 2UL /*!< Ethernet link is 100Mbps half duplex \hideinitializer */
#define EMAC_LINK_10F 3UL /*!< Ethernet link is 10Mbps full duplex \hideinitializer */
#define EMAC_LINK_10H 4UL /*!< Ethernet link is 10Mbps half duplex \hideinitializer */
/*@}*/ /* end of group EMAC_EXPORTED_CONSTANTS */
/** @addtogroup EMAC_EXPORTED_FUNCTIONS EMAC Exported Functions
@{
*/
/**
* @brief Enable EMAC Tx function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_ENABLE_TX() (EMAC->CTL |= EMAC_CTL_TXON_Msk)
/**
* @brief Enable EMAC Rx function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_ENABLE_RX() do{EMAC->CTL |= EMAC_CTL_RXON_Msk; EMAC->RXST = 0;}while(0)
/**
* @brief Disable EMAC Tx function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_DISABLE_TX() (EMAC->CTL &= ~EMAC_CTL_TXON_Msk)
/**
* @brief Disable EMAC Rx function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_DISABLE_RX() (EMAC->CTL &= ~EMAC_CTL_RXON_Msk)
/**
* @brief Enable EMAC Magic Packet Wakeup function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_ENABLE_MAGIC_PKT_WAKEUP() (EMAC->CTL |= EMAC_CTL_WOLEN_Msk)
/**
* @brief Disable EMAC Magic Packet Wakeup function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_DISABLE_MAGIC_PKT_WAKEUP() (EMAC->CTL &= ~EMAC_CTL_WOLEN_Msk)
/**
* @brief Enable EMAC to receive broadcast packets
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_ENABLE_RECV_BCASTPKT() (EMAC->CAMCTL |= EMAC_CAMCTL_ABP_Msk)
/**
* @brief Disable EMAC to receive broadcast packets
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_DISABLE_RECV_BCASTPKT() (EMAC->CAMCTL &= ~EMAC_CAMCTL_ABP_Msk)
/**
* @brief Enable EMAC to receive multicast packets
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_ENABLE_RECV_MCASTPKT() (EMAC->CAMCTL |= EMAC_CAMCTL_AMP_Msk)
/**
* @brief Disable EMAC Magic Packet Wakeup function
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_DISABLE_RECV_MCASTPKT() (EMAC->CAMCTL &= ~EMAC_CAMCTL_AMP_Msk)
/**
* @brief Check if EMAC time stamp alarm interrupt occurred or not
* @param None
* @return If time stamp alarm interrupt occurred or not
* @retval 0 Alarm interrupt does not occur
* @retval 1 Alarm interrupt occurred
* \hideinitializer
*/
#define EMAC_GET_ALARM_FLAG() (EMAC->INTSTS & EMAC_INTSTS_TSALMIF_Msk ? 1 : 0)
/**
* @brief Clear EMAC time stamp alarm interrupt flag
* @param None
* @return None
* \hideinitializer
*/
#define EMAC_CLR_ALARM_FLAG() (EMAC->INTSTS = EMAC_INTSTS_TSALMIF_Msk)
/**
* @brief Trigger EMAC Rx function
* @param None
* @return None
*/
#define EMAC_TRIGGER_RX() do{EMAC->RXST = 0UL;}while(0)
/**
* @brief Trigger EMAC Tx function
* @param None
* @return None
*/
#define EMAC_TRIGGER_TX() do{EMAC->TXST = 0UL;}while(0)
/**
* @brief Enable specified EMAC interrupt
*
* @param[in] emac The pointer of the specified EMAC module
* @param[in] u32eIntSel Interrupt type select
* - \ref EMAC_INTEN_RXIEN_Msk : Receive
* - \ref EMAC_INTEN_CRCEIEN_Msk : CRC Error
* - \ref EMAC_INTEN_RXOVIEN_Msk : Receive FIFO Overflow
* - \ref EMAC_INTEN_LPIEN_Msk : Long Packet
* - \ref EMAC_INTEN_RXGDIEN_Msk : Receive Good
* - \ref EMAC_INTEN_ALIEIEN_Msk : Alignment Error
* - \ref EMAC_INTEN_RPIEN_Msk : Runt Packet
* - \ref EMAC_INTEN_MPCOVIEN_Msk : Miss Packet Counter Overrun
* - \ref EMAC_INTEN_MFLEIEN_Msk : Maximum Frame Length Exceed
* - \ref EMAC_INTEN_DENIEN_Msk : DMA Early Notification
* - \ref EMAC_INTEN_RDUIEN_Msk : Receive Descriptor Unavailable
* - \ref EMAC_INTEN_RXBEIEN_Msk : Receive Bus Error
* - \ref EMAC_INTEN_CFRIEN_Msk : Control Frame Receive
* - \ref EMAC_INTEN_WOLIEN_Msk : Wake on LAN Interrupt
* - \ref EMAC_INTEN_TXIEN_Msk : Transmit
* - \ref EMAC_INTEN_TXUDIEN_Msk : Transmit FIFO Underflow
* - \ref EMAC_INTEN_TXCPIEN_Msk : Transmit Completion
* - \ref EMAC_INTEN_EXDEFIEN_Msk : Defer Exceed
* - \ref EMAC_INTEN_NCSIEN_Msk : No Carrier Sense
* - \ref EMAC_INTEN_TXABTIEN_Msk : Transmit Abort
* - \ref EMAC_INTEN_LCIEN_Msk : Late Collision
* - \ref EMAC_INTEN_TDUIEN_Msk : Transmit Descriptor Unavailable
* - \ref EMAC_INTEN_TXBEIEN_Msk : Transmit Bus Error
* - \ref EMAC_INTEN_TSALMIEN_Msk : Time Stamp Alarm
*
* @return None
*
* @details This macro enable specified EMAC interrupt.
* \hideinitializer
*/
#define EMAC_ENABLE_INT(emac, u32eIntSel) ((emac)->INTEN |= (u32eIntSel))
/**
* @brief Disable specified EMAC interrupt
*
* @param[in] emac The pointer of the specified EMAC module
* @param[in] u32eIntSel Interrupt type select
* - \ref EMAC_INTEN_RXIEN_Msk : Receive
* - \ref EMAC_INTEN_CRCEIEN_Msk : CRC Error
* - \ref EMAC_INTEN_RXOVIEN_Msk : Receive FIFO Overflow
* - \ref EMAC_INTEN_LPIEN_Msk : Long Packet
* - \ref EMAC_INTEN_RXGDIEN_Msk : Receive Good
* - \ref EMAC_INTEN_ALIEIEN_Msk : Alignment Error
* - \ref EMAC_INTEN_RPIEN_Msk : Runt Packet
* - \ref EMAC_INTEN_MPCOVIEN_Msk : Miss Packet Counter Overrun
* - \ref EMAC_INTEN_MFLEIEN_Msk : Maximum Frame Length Exceed
* - \ref EMAC_INTEN_DENIEN_Msk : DMA Early Notification
* - \ref EMAC_INTEN_RDUIEN_Msk : Receive Descriptor Unavailable
* - \ref EMAC_INTEN_RXBEIEN_Msk : Receive Bus Error
* - \ref EMAC_INTEN_CFRIEN_Msk : Control Frame Receive
* - \ref EMAC_INTEN_WOLIEN_Msk : Wake on LAN Interrupt
* - \ref EMAC_INTEN_TXIEN_Msk : Transmit
* - \ref EMAC_INTEN_TXUDIEN_Msk : Transmit FIFO Underflow
* - \ref EMAC_INTEN_TXCPIEN_Msk : Transmit Completion
* - \ref EMAC_INTEN_EXDEFIEN_Msk : Defer Exceed
* - \ref EMAC_INTEN_NCSIEN_Msk : No Carrier Sense
* - \ref EMAC_INTEN_TXABTIEN_Msk : Transmit Abort
* - \ref EMAC_INTEN_LCIEN_Msk : Late Collision
* - \ref EMAC_INTEN_TDUIEN_Msk : Transmit Descriptor Unavailable
* - \ref EMAC_INTEN_TXBEIEN_Msk : Transmit Bus Error
* - \ref EMAC_INTEN_TSALMIEN_Msk : Time Stamp Alarm
*
* @return None
*
* @details This macro disable specified EMAC interrupt.
* \hideinitializer
*/
#define EMAC_DISABLE_INT(emac, u32eIntSel) ((emac)->INTEN &= ~ (u32eIntSel))
/**
* @brief Get specified interrupt flag/status
*
* @param[in] emac The pointer of the specified EMAC module
* @param[in] u32eIntTypeFlag Interrupt Type Flag, should be
* - \ref EMAC_INTSTS_RXIF_Msk : Receive
* - \ref EMAC_INTSTS_CRCEIF_Msk : CRC Error
* - \ref EMAC_INTSTS_RXOVIF_Msk : Receive FIFO Overflow
* - \ref EMAC_INTSTS_LPIF_Msk : Long Packet
* - \ref EMAC_INTSTS_RXGDIF_Msk : Receive Good
* - \ref EMAC_INTSTS_ALIEIF_Msk : Alignment Error
* - \ref EMAC_INTSTS_RPIF_Msk : Runt Packet
* - \ref EMAC_INTSTS_MPCOVIF_Msk : Missed Packet Counter
* - \ref EMAC_INTSTS_MFLEIF_Msk : Maximum Frame Length Exceed
* - \ref EMAC_INTSTS_DENIF_Msk : DMA Early Notification
* - \ref EMAC_INTSTS_RDUIF_Msk : Receive Descriptor Unavailable
* - \ref EMAC_INTSTS_RXBEIF_Msk : Receive Bus Error
* - \ref EMAC_INTSTS_CFRIF_Msk : Control Frame Receive
* - \ref EMAC_INTSTS_WOLIF_Msk : Wake on LAN
* - \ref EMAC_INTSTS_TXIF_Msk : Transmit
* - \ref EMAC_INTSTS_TXUDIF_Msk : Transmit FIFO Underflow
* - \ref EMAC_INTSTS_TXCPIF_Msk : Transmit Completion
* - \ref EMAC_INTSTS_EXDEFIF_Msk : Defer Exceed
* - \ref EMAC_INTSTS_NCSIF_Msk : No Carrier Sense
* - \ref EMAC_INTSTS_TXABTIF_Msk : Transmit Abort
* - \ref EMAC_INTSTS_LCIF_Msk : Late Collision
* - \ref EMAC_INTSTS_TDUIF_Msk : Transmit Descriptor Unavailable
* - \ref EMAC_INTSTS_TXBEIF_Msk : Transmit Bus Error
* - \ref EMAC_INTSTS_TSALMIF_Msk : Time Stamp Alarm
*
* @return None
*
* @details This macro get specified interrupt flag or interrupt indicator status.
* \hideinitializer
*/
#define EMAC_GET_INT_FLAG(emac, u32eIntTypeFlag) (((emac)->INTSTS & (u32eIntTypeFlag))?1:0)
/**
* @brief Clear specified interrupt flag/status
*
* @param[in] emac The pointer of the specified EMAC module
* @param[in] u32eIntTypeFlag Interrupt Type Flag, should be
* - \ref EMAC_INTSTS_RXIF_Msk : Receive
* - \ref EMAC_INTSTS_CRCEIF_Msk : CRC Error
* - \ref EMAC_INTSTS_RXOVIF_Msk : Receive FIFO Overflow
* - \ref EMAC_INTSTS_LPIF_Msk : Long Packet
* - \ref EMAC_INTSTS_RXGDIF_Msk : Receive Good
* - \ref EMAC_INTSTS_ALIEIF_Msk : Alignment Error
* - \ref EMAC_INTSTS_RPIF_Msk : Runt Packet
* - \ref EMAC_INTSTS_MPCOVIF_Msk : Missed Packet Counter
* - \ref EMAC_INTSTS_MFLEIF_Msk : Maximum Frame Length Exceed
* - \ref EMAC_INTSTS_DENIF_Msk : DMA Early Notification
* - \ref EMAC_INTSTS_RDUIF_Msk : Receive Descriptor Unavailable
* - \ref EMAC_INTSTS_RXBEIF_Msk : Receive Bus Error
* - \ref EMAC_INTSTS_CFRIF_Msk : Control Frame Receive
* - \ref EMAC_INTSTS_WOLIF_Msk : Wake on LAN
* - \ref EMAC_INTSTS_TXIF_Msk : Transmit
* - \ref EMAC_INTSTS_TXUDIF_Msk : Transmit FIFO Underflow
* - \ref EMAC_INTSTS_TXCPIF_Msk : Transmit Completion
* - \ref EMAC_INTSTS_EXDEFIF_Msk : Defer Exceed
* - \ref EMAC_INTSTS_NCSIF_Msk : No Carrier Sense
* - \ref EMAC_INTSTS_TXABTIF_Msk : Transmit Abort
* - \ref EMAC_INTSTS_LCIF_Msk : Late Collision
* - \ref EMAC_INTSTS_TDUIF_Msk : Transmit Descriptor Unavailable
* - \ref EMAC_INTSTS_TXBEIF_Msk : Transmit Bus Error
* - \ref EMAC_INTSTS_TSALMIF_Msk : Time Stamp Alarm
*
* @retval 0 The specified interrupt is not happened.
* 1 The specified interrupt is happened.
*
* @details This macro clear specified interrupt flag or interrupt indicator status.
* \hideinitializer
*/
#define EMAC_CLEAR_INT_FLAG(emac, u32eIntTypeFlag) ((emac)->INTSTS |= (u32eIntTypeFlag))
void EMAC_Open(uint8_t *pu8MacAddr);
void EMAC_Close(void);
void EMAC_SetMacAddr(uint8_t *pu8MacAddr);
void EMAC_EnableCamEntry(uint32_t u32Entry, uint8_t pu8MacAddr[]);
void EMAC_DisableCamEntry(uint32_t u32Entry);
uint32_t EMAC_RecvPkt(uint8_t *pu8Data, uint32_t *pu32Size);
uint32_t EMAC_RecvPktTS(uint8_t *pu8Data, uint32_t *pu32Size, uint32_t *pu32Sec, uint32_t *pu32Nsec);
void EMAC_RecvPktDone(void);
uint32_t EMAC_SendPkt(uint8_t *pu8Data, uint32_t u32Size);
uint32_t EMAC_SendPktDone(void);
uint32_t EMAC_SendPktDoneTS(uint32_t *pu32Sec, uint32_t *pu32Nsec);
void EMAC_EnableTS(uint32_t u32Sec, uint32_t u32Nsec);
void EMAC_DisableTS(void);
void EMAC_GetTime(uint32_t *pu32Sec, uint32_t *pu32Nsec);
void EMAC_SetTime(uint32_t u32Sec, uint32_t u32Nsec);
void EMAC_UpdateTime(uint32_t u32Neg, uint32_t u32Sec, uint32_t u32Nsec);
void EMAC_EnableAlarm(uint32_t u32Sec, uint32_t u32Nsec);
void EMAC_DisableAlarm(void);
uint32_t EMAC_CheckLinkStatus(void);
void EMAC_PhyInit(void);
int32_t EMAC_FillCamEntry(uint8_t pu8MacAddr[]);
uint8_t *EMAC_ClaimFreeTXBuf(void);
uint32_t EMAC_GetAvailRXBufSize(uint8_t** ppuDataBuf);
uint32_t EMAC_SendPktWoCopy(uint32_t u32Size);
void EMAC_RecvPktDoneWoRxTrigger(void);
/*@}*/ /* end of group EMAC_EXPORTED_FUNCTIONS */
/*@}*/ /* end of group EMAC_Driver */
/*@}*/ /* end of group Standard_Driver */
#ifdef __cplusplus
}
#endif
#endif /* __NU_EMAC_H__ */
/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/