1856 lines
82 KiB
C
1856 lines
82 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32h7xx_hal_eth.h
|
|
* @author MCD Application Team
|
|
* @brief Header file of ETH HAL module.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2017 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef STM32H7xx_HAL_ETH_H
|
|
#define STM32H7xx_HAL_ETH_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32h7xx_hal_def.h"
|
|
|
|
#if defined(ETH)
|
|
|
|
/** @addtogroup STM32H7xx_HAL_Driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup ETH
|
|
* @{
|
|
*/
|
|
|
|
/* Exported types ------------------------------------------------------------*/
|
|
#ifndef ETH_TX_DESC_CNT
|
|
#define ETH_TX_DESC_CNT 4U
|
|
#endif /* ETH_TX_DESC_CNT */
|
|
|
|
#ifndef ETH_RX_DESC_CNT
|
|
#define ETH_RX_DESC_CNT 4U
|
|
#endif /* ETH_RX_DESC_CNT */
|
|
|
|
#ifndef ETH_SWRESET_TIMEOUT
|
|
#define ETH_SWRESET_TIMEOUT 500U
|
|
#endif /* ETH_SWRESET_TIMEOUT */
|
|
|
|
#ifndef ETH_MDIO_BUS_TIMEOUT
|
|
#define ETH_MDIO_BUS_TIMEOUT 1000U
|
|
#endif /* ETH_MDIO_BUS_TIMEOUT */
|
|
|
|
#ifndef ETH_MAC_US_TICK
|
|
#define ETH_MAC_US_TICK 1000000U
|
|
#endif /* ETH_MAC_US_TICK */
|
|
|
|
/*********************** Descriptors struct def section ************************/
|
|
/** @defgroup ETH_Exported_Types ETH Exported Types
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH DMA Descriptor structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
__IO uint32_t DESC0;
|
|
__IO uint32_t DESC1;
|
|
__IO uint32_t DESC2;
|
|
__IO uint32_t DESC3;
|
|
uint32_t BackupAddr0; /* used to store rx buffer 1 address */
|
|
uint32_t BackupAddr1; /* used to store rx buffer 2 address */
|
|
} ETH_DMADescTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH Buffers List structure definition
|
|
*/
|
|
typedef struct __ETH_BufferTypeDef
|
|
{
|
|
uint8_t *buffer; /*<! buffer address */
|
|
|
|
uint32_t len; /*<! buffer length */
|
|
|
|
struct __ETH_BufferTypeDef *next; /*<! Pointer to the next buffer in the list */
|
|
} ETH_BufferTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief DMA Transmit Descriptors Wrapper structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t TxDesc[ETH_TX_DESC_CNT]; /*<! Tx DMA descriptors addresses */
|
|
|
|
uint32_t CurTxDesc; /*<! Current Tx descriptor index for packet transmission */
|
|
|
|
uint32_t *PacketAddress[ETH_TX_DESC_CNT]; /*<! Ethernet packet addresses array */
|
|
|
|
uint32_t *CurrentPacketAddress; /*<! Current transmit NX_PACKET addresses */
|
|
|
|
uint32_t BuffersInUse; /*<! Buffers in Use */
|
|
|
|
uint32_t releaseIndex; /*<! Release index */
|
|
} ETH_TxDescListTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief Transmit Packet Configuration structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t Attributes; /*!< Tx packet HW features capabilities.
|
|
This parameter can be a combination of @ref ETH_Tx_Packet_Attributes*/
|
|
|
|
uint32_t Length; /*!< Total packet length */
|
|
|
|
ETH_BufferTypeDef *TxBuffer; /*!< Tx buffers pointers */
|
|
|
|
uint32_t SrcAddrCtrl; /*!< Specifies the source address insertion control.
|
|
This parameter can be a value of @ref ETH_Tx_Packet_Source_Addr_Control */
|
|
|
|
uint32_t CRCPadCtrl; /*!< Specifies the CRC and Pad insertion and replacement control.
|
|
This parameter can be a value of @ref ETH_Tx_Packet_CRC_Pad_Control */
|
|
|
|
uint32_t ChecksumCtrl; /*!< Specifies the checksum insertion control.
|
|
This parameter can be a value of @ref ETH_Tx_Packet_Checksum_Control */
|
|
|
|
uint32_t MaxSegmentSize; /*!< Sets TCP maximum segment size only when TCP segmentation is enabled.
|
|
This parameter can be a value from 0x0 to 0x3FFF */
|
|
|
|
uint32_t PayloadLen; /*!< Sets Total payload length only when TCP segmentation is enabled.
|
|
This parameter can be a value from 0x0 to 0x3FFFF */
|
|
|
|
uint32_t TCPHeaderLen; /*!< Sets TCP header length only when TCP segmentation is enabled.
|
|
This parameter can be a value from 0x5 to 0xF */
|
|
|
|
uint32_t VlanTag; /*!< Sets VLAN Tag only when VLAN is enabled.
|
|
This parameter can be a value from 0x0 to 0xFFFF*/
|
|
|
|
uint32_t VlanCtrl; /*!< Specifies VLAN Tag insertion control only when VLAN is enabled.
|
|
This parameter can be a value of @ref ETH_Tx_Packet_VLAN_Control */
|
|
|
|
uint32_t InnerVlanTag; /*!< Sets Inner VLAN Tag only when Inner VLAN is enabled.
|
|
This parameter can be a value from 0x0 to 0x3FFFF */
|
|
|
|
uint32_t InnerVlanCtrl; /*!< Specifies Inner VLAN Tag insertion control only when Inner VLAN is enabled.
|
|
This parameter can be a value of @ref ETH_Tx_Packet_Inner_VLAN_Control */
|
|
|
|
void *pData; /*!< Specifies Application packet pointer to save */
|
|
|
|
} ETH_TxPacketConfig;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH Timestamp structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t TimeStampLow;
|
|
uint32_t TimeStampHigh;
|
|
|
|
} ETH_TimeStampTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
#ifdef HAL_ETH_USE_PTP
|
|
/**
|
|
* @brief ETH Timeupdate structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t Seconds;
|
|
uint32_t NanoSeconds;
|
|
} ETH_TimeTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
#endif /* HAL_ETH_USE_PTP */
|
|
|
|
/**
|
|
* @brief DMA Receive Descriptors Wrapper structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t RxDesc[ETH_RX_DESC_CNT]; /*<! Rx DMA descriptors addresses. */
|
|
|
|
uint32_t ItMode; /*<! If 1, DMA will generate the Rx complete interrupt.
|
|
If 0, DMA will not generate the Rx complete interrupt. */
|
|
|
|
uint32_t RxDescIdx; /*<! Current Rx descriptor. */
|
|
|
|
uint32_t RxDescCnt; /*<! Number of descriptors . */
|
|
|
|
uint32_t RxDataLength; /*<! Received Data Length. */
|
|
|
|
uint32_t RxBuildDescIdx; /*<! Current Rx Descriptor for building descriptors. */
|
|
|
|
uint32_t RxBuildDescCnt; /*<! Number of Rx Descriptors awaiting building. */
|
|
|
|
uint32_t pRxLastRxDesc; /*<! Last received descriptor. */
|
|
|
|
ETH_TimeStampTypeDef TimeStamp; /*<! Time Stamp Low value for receive. */
|
|
|
|
void *pRxStart; /*<! Pointer to the first buff. */
|
|
|
|
void *pRxEnd; /*<! Pointer to the last buff. */
|
|
|
|
} ETH_RxDescListTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH MAC Configuration Structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t
|
|
SourceAddrControl; /*!< Selects the Source Address Insertion or Replacement Control.
|
|
This parameter can be a value of @ref ETH_Source_Addr_Control */
|
|
|
|
FunctionalState
|
|
ChecksumOffload; /*!< Enables or Disable the checksum checking for received packet payloads TCP, UDP or ICMP headers */
|
|
|
|
uint32_t InterPacketGapVal; /*!< Sets the minimum IPG between Packet during transmission.
|
|
This parameter can be a value of @ref ETH_Inter_Packet_Gap */
|
|
|
|
FunctionalState GiantPacketSizeLimitControl; /*!< Enables or disables the Giant Packet Size Limit Control. */
|
|
|
|
FunctionalState Support2KPacket; /*!< Enables or disables the IEEE 802.3as Support for 2K length Packets */
|
|
|
|
FunctionalState CRCStripTypePacket; /*!< Enables or disables the CRC stripping for Type packets.*/
|
|
|
|
FunctionalState AutomaticPadCRCStrip; /*!< Enables or disables the Automatic MAC Pad/CRC Stripping.*/
|
|
|
|
FunctionalState Watchdog; /*!< Enables or disables the Watchdog timer on Rx path.*/
|
|
|
|
FunctionalState Jabber; /*!< Enables or disables Jabber timer on Tx path.*/
|
|
|
|
FunctionalState JumboPacket; /*!< Enables or disables receiving Jumbo Packet
|
|
When enabled, the MAC allows jumbo packets of 9,018 bytes
|
|
without reporting a giant packet error */
|
|
|
|
uint32_t Speed; /*!< Sets the Ethernet speed: 10/100 Mbps.
|
|
This parameter can be a value of @ref ETH_Speed */
|
|
|
|
uint32_t DuplexMode; /*!< Selects the MAC duplex mode: Half-Duplex or Full-Duplex mode
|
|
This parameter can be a value of @ref ETH_Duplex_Mode */
|
|
|
|
FunctionalState LoopbackMode; /*!< Enables or disables the loopback mode */
|
|
|
|
FunctionalState
|
|
CarrierSenseBeforeTransmit; /*!< Enables or disables the Carrier Sense Before Transmission in Full Duplex Mode. */
|
|
|
|
FunctionalState ReceiveOwn; /*!< Enables or disables the Receive Own in Half Duplex mode. */
|
|
|
|
FunctionalState
|
|
CarrierSenseDuringTransmit; /*!< Enables or disables the Carrier Sense During Transmission in the Half Duplex mode */
|
|
|
|
FunctionalState
|
|
RetryTransmission; /*!< Enables or disables the MAC retry transmission, when a collision occurs in Half Duplex mode.*/
|
|
|
|
uint32_t BackOffLimit; /*!< Selects the BackOff limit value.
|
|
This parameter can be a value of @ref ETH_Back_Off_Limit */
|
|
|
|
FunctionalState
|
|
DeferralCheck; /*!< Enables or disables the deferral check function in Half Duplex mode. */
|
|
|
|
uint32_t
|
|
PreambleLength; /*!< Selects or not the Preamble Length for Transmit packets (Full Duplex mode).
|
|
This parameter can be a value of @ref ETH_Preamble_Length */
|
|
|
|
FunctionalState
|
|
UnicastSlowProtocolPacketDetect; /*!< Enable or disables the Detection of Slow Protocol Packets with unicast address. */
|
|
|
|
FunctionalState SlowProtocolDetect; /*!< Enable or disables the Slow Protocol Detection. */
|
|
|
|
FunctionalState CRCCheckingRxPackets; /*!< Enable or disables the CRC Checking for Received Packets. */
|
|
|
|
uint32_t
|
|
GiantPacketSizeLimit; /*!< Specifies the packet size that the MAC will declare it as Giant, If it's size is
|
|
greater than the value programmed in this field in units of bytes
|
|
This parameter must be a number between
|
|
Min_Data = 0x618 (1518 byte) and Max_Data = 0x3FFF (32 Kbyte). */
|
|
|
|
FunctionalState ExtendedInterPacketGap; /*!< Enable or disables the extended inter packet gap. */
|
|
|
|
uint32_t ExtendedInterPacketGapVal; /*!< Sets the Extended IPG between Packet during transmission.
|
|
This parameter can be a value from 0x0 to 0xFF */
|
|
|
|
FunctionalState ProgrammableWatchdog; /*!< Enable or disables the Programmable Watchdog.*/
|
|
|
|
uint32_t WatchdogTimeout; /*!< This field is used as watchdog timeout for a received packet
|
|
This parameter can be a value of @ref ETH_Watchdog_Timeout */
|
|
|
|
uint32_t
|
|
PauseTime; /*!< This field holds the value to be used in the Pause Time field in the transmit control packet.
|
|
This parameter must be a number between
|
|
Min_Data = 0x0 and Max_Data = 0xFFFF.*/
|
|
|
|
FunctionalState
|
|
ZeroQuantaPause; /*!< Enable or disables the automatic generation of Zero Quanta Pause Control packets.*/
|
|
|
|
uint32_t
|
|
PauseLowThreshold; /*!< This field configures the threshold of the PAUSE to be checked for automatic retransmission of PAUSE Packet.
|
|
This parameter can be a value of @ref ETH_Pause_Low_Threshold */
|
|
|
|
FunctionalState
|
|
TransmitFlowControl; /*!< Enables or disables the MAC to transmit Pause packets in Full Duplex mode
|
|
or the MAC back pressure operation in Half Duplex mode */
|
|
|
|
FunctionalState
|
|
UnicastPausePacketDetect; /*!< Enables or disables the MAC to detect Pause packets with unicast address of the station */
|
|
|
|
FunctionalState ReceiveFlowControl; /*!< Enables or disables the MAC to decodes the received Pause packet
|
|
and disables its transmitter for a specified (Pause) time */
|
|
|
|
uint32_t TransmitQueueMode; /*!< Specifies the Transmit Queue operating mode.
|
|
This parameter can be a value of @ref ETH_Transmit_Mode */
|
|
|
|
uint32_t ReceiveQueueMode; /*!< Specifies the Receive Queue operating mode.
|
|
This parameter can be a value of @ref ETH_Receive_Mode */
|
|
|
|
FunctionalState DropTCPIPChecksumErrorPacket; /*!< Enables or disables Dropping of TCPIP Checksum Error Packets. */
|
|
|
|
FunctionalState ForwardRxErrorPacket; /*!< Enables or disables forwarding Error Packets. */
|
|
|
|
FunctionalState ForwardRxUndersizedGoodPacket; /*!< Enables or disables forwarding Undersized Good Packets.*/
|
|
} ETH_MACConfigTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH DMA Configuration Structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t DMAArbitration; /*!< Sets the arbitration scheme between DMA Tx and Rx
|
|
This parameter can be a value of @ref ETH_DMA_Arbitration */
|
|
|
|
FunctionalState AddressAlignedBeats; /*!< Enables or disables the AHB Master interface address aligned
|
|
burst transfers on Read and Write channels */
|
|
|
|
uint32_t BurstMode; /*!< Sets the AHB Master interface burst transfers.
|
|
This parameter can be a value of @ref ETH_Burst_Mode */
|
|
|
|
FunctionalState RebuildINCRxBurst; /*!< Enables or disables the AHB Master to rebuild the pending beats
|
|
of any initiated burst transfer with INCRx and SINGLE transfers. */
|
|
|
|
FunctionalState PBLx8Mode; /*!< Enables or disables the PBL multiplication by eight. */
|
|
|
|
uint32_t
|
|
TxDMABurstLength; /*!< Indicates the maximum number of beats to be transferred in one Tx DMA transaction.
|
|
This parameter can be a value of @ref ETH_Tx_DMA_Burst_Length */
|
|
|
|
FunctionalState
|
|
SecondPacketOperate; /*!< Enables or disables the Operate on second Packet mode, which allows the DMA to process a second
|
|
Packet of Transmit data even before
|
|
obtaining the status for the first one. */
|
|
|
|
uint32_t
|
|
RxDMABurstLength; /*!< Indicates the maximum number of beats to be transferred in one Rx DMA transaction.
|
|
This parameter can be a value of @ref ETH_Rx_DMA_Burst_Length */
|
|
|
|
FunctionalState FlushRxPacket; /*!< Enables or disables the Rx Packet Flush */
|
|
|
|
FunctionalState TCPSegmentation; /*!< Enables or disables the TCP Segmentation */
|
|
|
|
uint32_t
|
|
MaximumSegmentSize; /*!< Sets the maximum segment size that should be used while segmenting the packet
|
|
This parameter can be a value from 0x40 to 0x3FFF */
|
|
} ETH_DMAConfigTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief HAL ETH Media Interfaces enum definition
|
|
*/
|
|
typedef enum
|
|
{
|
|
HAL_ETH_MII_MODE = 0x00U, /*!< Media Independent Interface */
|
|
HAL_ETH_RMII_MODE = 0x01U /*!< Reduced Media Independent Interface */
|
|
} ETH_MediaInterfaceTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
#ifdef HAL_ETH_USE_PTP
|
|
/**
|
|
* @brief HAL ETH PTP Update type enum definition
|
|
*/
|
|
typedef enum
|
|
{
|
|
HAL_ETH_PTP_POSITIVE_UPDATE = 0x00000000U, /*!< PTP positive time update */
|
|
HAL_ETH_PTP_NEGATIVE_UPDATE = 0x00000001U /*!< PTP negative time update */
|
|
} ETH_PtpUpdateTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
#endif /* HAL_ETH_USE_PTP */
|
|
|
|
/**
|
|
* @brief ETH Init Structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
|
|
uint8_t
|
|
*MACAddr; /*!< MAC Address of used Hardware: must be pointer on an array of 6 bytes */
|
|
|
|
ETH_MediaInterfaceTypeDef MediaInterface; /*!< Selects the MII interface or the RMII interface. */
|
|
|
|
ETH_DMADescTypeDef
|
|
*TxDesc; /*!< Provides the address of the first DMA Tx descriptor in the list */
|
|
|
|
ETH_DMADescTypeDef
|
|
*RxDesc; /*!< Provides the address of the first DMA Rx descriptor in the list */
|
|
|
|
uint32_t RxBuffLen; /*!< Provides the length of Rx buffers size */
|
|
|
|
} ETH_InitTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
#ifdef HAL_ETH_USE_PTP
|
|
/**
|
|
* @brief ETH PTP Init Structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t Timestamp; /*!< Enable Timestamp */
|
|
uint32_t TimestampUpdateMode; /*!< Fine or Coarse Timestamp Update */
|
|
uint32_t TimestampInitialize; /*!< Initialize Timestamp */
|
|
uint32_t TimestampUpdate; /*!< Timestamp Update */
|
|
uint32_t TimestampAddendUpdate; /*!< Timestamp Addend Update */
|
|
uint32_t TimestampAll; /*!< Enable Timestamp for All Packets */
|
|
uint32_t TimestampRolloverMode; /*!< Timestamp Digital or Binary Rollover Control */
|
|
uint32_t TimestampV2; /*!< Enable PTP Packet Processing for Version 2 Format */
|
|
uint32_t TimestampEthernet; /*!< Enable Processing of PTP over Ethernet Packets */
|
|
uint32_t TimestampIPv6; /*!< Enable Processing of PTP Packets Sent over IPv6-UDP */
|
|
uint32_t TimestampIPv4; /*!< Enable Processing of PTP Packets Sent over IPv4-UDP */
|
|
uint32_t TimestampEvent; /*!< Enable Timestamp Snapshot for Event Messages */
|
|
uint32_t TimestampMaster; /*!< Enable Timestamp Snapshot for Event Messages */
|
|
uint32_t TimestampSnapshots; /*!< Select PTP packets for Taking Snapshots */
|
|
uint32_t TimestampFilter; /*!< Enable MAC Address for PTP Packet Filtering */
|
|
uint32_t
|
|
TimestampChecksumCorrection; /*!< Enable checksum correction during OST for PTP over UDP/IPv4 packets */
|
|
uint32_t TimestampStatusMode; /*!< Transmit Timestamp Status Mode */
|
|
uint32_t TimestampAddend; /*!< Timestamp addend value */
|
|
uint32_t TimestampSubsecondInc; /*!< Subsecond Increment */
|
|
|
|
} ETH_PTP_ConfigTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
#endif /* HAL_ETH_USE_PTP */
|
|
|
|
/**
|
|
* @brief HAL State structures definition
|
|
*/
|
|
typedef uint32_t HAL_ETH_StateTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief HAL ETH Rx Get Buffer Function definition
|
|
*/
|
|
typedef void (*pETH_rxAllocateCallbackTypeDef)(uint8_t **buffer); /*!< pointer to an ETH Rx Get Buffer Function */
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief HAL ETH Rx Set App Data Function definition
|
|
*/
|
|
typedef void (*pETH_rxLinkCallbackTypeDef)(void **pStart, void **pEnd, uint8_t *buff,
|
|
uint16_t Length); /*!< pointer to an ETH Rx Set App Data Function */
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief HAL ETH Tx Free Function definition
|
|
*/
|
|
typedef void (*pETH_txFreeCallbackTypeDef)(uint32_t *buffer); /*!< pointer to an ETH Tx Free function */
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief HAL ETH Tx Free Function definition
|
|
*/
|
|
typedef void (*pETH_txPtpCallbackTypeDef)(uint32_t *buffer,
|
|
ETH_TimeStampTypeDef *timestamp); /*!< pointer to an ETH Tx Free function */
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH Handle Structure definition
|
|
*/
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
typedef struct __ETH_HandleTypeDef
|
|
#else
|
|
typedef struct
|
|
#endif /* USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
{
|
|
ETH_TypeDef *Instance; /*!< Register base address */
|
|
|
|
ETH_InitTypeDef Init; /*!< Ethernet Init Configuration */
|
|
|
|
ETH_TxDescListTypeDef TxDescList; /*!< Tx descriptor wrapper: holds all Tx descriptors list
|
|
addresses and current descriptor index */
|
|
|
|
ETH_RxDescListTypeDef RxDescList; /*!< Rx descriptor wrapper: holds all Rx descriptors list
|
|
addresses and current descriptor index */
|
|
|
|
#ifdef HAL_ETH_USE_PTP
|
|
ETH_TimeStampTypeDef TxTimestamp; /*!< Tx Timestamp */
|
|
#endif /* HAL_ETH_USE_PTP */
|
|
|
|
__IO HAL_ETH_StateTypeDef gState; /*!< ETH state information related to global Handle management
|
|
and also related to Tx operations. This parameter can
|
|
be a value of @ref HAL_ETH_StateTypeDef */
|
|
|
|
__IO uint32_t ErrorCode; /*!< Holds the global Error code of the ETH HAL status machine
|
|
This parameter can be a value of @ref ETH_Error_Code.*/
|
|
|
|
__IO uint32_t
|
|
DMAErrorCode; /*!< Holds the DMA Rx Tx Error code when a DMA AIS interrupt occurs
|
|
This parameter can be a combination of
|
|
@ref ETH_DMA_Status_Flags */
|
|
|
|
__IO uint32_t
|
|
MACErrorCode; /*!< Holds the MAC Rx Tx Error code when a MAC Rx or Tx status interrupt occurs
|
|
This parameter can be a combination of
|
|
@ref ETH_MAC_Rx_Tx_Status */
|
|
|
|
__IO uint32_t MACWakeUpEvent; /*!< Holds the Wake Up event when the MAC exit the power down mode
|
|
This parameter can be a value of
|
|
@ref ETH_MAC_Wake_Up_Event */
|
|
|
|
__IO uint32_t MACLPIEvent; /*!< Holds the LPI event when the an LPI status interrupt occurs.
|
|
This parameter can be a value of @ref ETHEx_LPI_Event */
|
|
|
|
__IO uint32_t IsPtpConfigured; /*!< Holds the PTP configuration status.
|
|
This parameter can be a value of
|
|
@ref ETH_PTP_Config_Status */
|
|
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
|
|
void (* TxCpltCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Tx Complete Callback */
|
|
void (* RxCpltCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Rx Complete Callback */
|
|
void (* ErrorCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Error Callback */
|
|
void (* PMTCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Power Management Callback */
|
|
void (* EEECallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH EEE Callback */
|
|
void (* WakeUpCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Wake UP Callback */
|
|
|
|
void (* MspInitCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Msp Init callback */
|
|
void (* MspDeInitCallback)(struct __ETH_HandleTypeDef *heth); /*!< ETH Msp DeInit callback */
|
|
|
|
#endif /* USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
|
|
pETH_rxAllocateCallbackTypeDef rxAllocateCallback; /*!< ETH Rx Get Buffer Function */
|
|
pETH_rxLinkCallbackTypeDef rxLinkCallback; /*!< ETH Rx Set App Data Function */
|
|
pETH_txFreeCallbackTypeDef txFreeCallback; /*!< ETH Tx Free Function */
|
|
pETH_txPtpCallbackTypeDef txPtpCallback; /*!< ETH Tx Handle Ptp Function */
|
|
|
|
} ETH_HandleTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
/**
|
|
* @brief HAL ETH Callback ID enumeration definition
|
|
*/
|
|
typedef enum
|
|
{
|
|
HAL_ETH_MSPINIT_CB_ID = 0x00U, /*!< ETH MspInit callback ID */
|
|
HAL_ETH_MSPDEINIT_CB_ID = 0x01U, /*!< ETH MspDeInit callback ID */
|
|
|
|
HAL_ETH_TX_COMPLETE_CB_ID = 0x02U, /*!< ETH Tx Complete Callback ID */
|
|
HAL_ETH_RX_COMPLETE_CB_ID = 0x03U, /*!< ETH Rx Complete Callback ID */
|
|
HAL_ETH_ERROR_CB_ID = 0x04U, /*!< ETH Error Callback ID */
|
|
HAL_ETH_PMT_CB_ID = 0x06U, /*!< ETH Power Management Callback ID */
|
|
HAL_ETH_EEE_CB_ID = 0x07U, /*!< ETH EEE Callback ID */
|
|
HAL_ETH_WAKEUP_CB_ID = 0x08U /*!< ETH Wake UP Callback ID */
|
|
|
|
|
|
} HAL_ETH_CallbackIDTypeDef;
|
|
|
|
/**
|
|
* @brief HAL ETH Callback pointer definition
|
|
*/
|
|
typedef void (*pETH_CallbackTypeDef)(ETH_HandleTypeDef *heth); /*!< pointer to an ETH callback function */
|
|
|
|
#endif /* USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
|
|
/**
|
|
* @brief ETH MAC filter structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
FunctionalState PromiscuousMode; /*!< Enable or Disable Promiscuous Mode */
|
|
|
|
FunctionalState ReceiveAllMode; /*!< Enable or Disable Receive All Mode */
|
|
|
|
FunctionalState HachOrPerfectFilter; /*!< Enable or Disable Perfect filtering in addition to Hash filtering */
|
|
|
|
FunctionalState HashUnicast; /*!< Enable or Disable Hash filtering on unicast packets */
|
|
|
|
FunctionalState HashMulticast; /*!< Enable or Disable Hash filtering on multicast packets */
|
|
|
|
FunctionalState PassAllMulticast; /*!< Enable or Disable passing all multicast packets */
|
|
|
|
FunctionalState SrcAddrFiltering; /*!< Enable or Disable source address filtering module */
|
|
|
|
FunctionalState SrcAddrInverseFiltering; /*!< Enable or Disable source address inverse filtering */
|
|
|
|
FunctionalState DestAddrInverseFiltering; /*!< Enable or Disable destination address inverse filtering */
|
|
|
|
FunctionalState BroadcastFilter; /*!< Enable or Disable broadcast filter */
|
|
|
|
uint32_t ControlPacketsFilter; /*!< Set the control packets filter
|
|
This parameter can be a value of @ref ETH_Control_Packets_Filter */
|
|
} ETH_MACFilterConfigTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @brief ETH Power Down structure definition
|
|
*/
|
|
typedef struct
|
|
{
|
|
FunctionalState WakeUpPacket; /*!< Enable or Disable Wake up packet detection in power down mode */
|
|
|
|
FunctionalState MagicPacket; /*!< Enable or Disable Magic packet detection in power down mode */
|
|
|
|
FunctionalState GlobalUnicast; /*!< Enable or Disable Global unicast packet detection in power down mode */
|
|
|
|
FunctionalState WakeUpForward; /*!< Enable or Disable Forwarding Wake up packets */
|
|
|
|
} ETH_PowerDownConfigTypeDef;
|
|
/**
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Exported constants --------------------------------------------------------*/
|
|
/** @defgroup ETH_Exported_Constants ETH Exported Constants
|
|
* @{
|
|
*/
|
|
|
|
/** @defgroup ETH_DMA_Tx_Descriptor_Bit_Definition ETH DMA Tx Descriptor Bit Definition
|
|
* @{
|
|
*/
|
|
|
|
/*
|
|
DMA Tx Normal Descriptor Read Format
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES0 | Buffer1 or Header Address [31:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES1 | Buffer2 Address [31:0] / Next Descriptor Address [31:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES2 | IOC(31) | TTSE(30) | Buff2 Length[29:16] | VTIR[15:14] | Header or Buff1 Length[13:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES3 | OWN(31) | CTRL[30:26] | Reserved[25:24] | CTRL[23:20] | Reserved[19:17] | Status[16:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of TDES0 RF register
|
|
*/
|
|
#define ETH_DMATXNDESCRF_B1AP 0xFFFFFFFFU /*!< Transmit Packet Timestamp Low */
|
|
|
|
/**
|
|
* @brief Bit definition of TDES1 RF register
|
|
*/
|
|
#define ETH_DMATXNDESCRF_B2AP 0xFFFFFFFFU /*!< Transmit Packet Timestamp High */
|
|
|
|
/**
|
|
* @brief Bit definition of TDES2 RF register
|
|
*/
|
|
#define ETH_DMATXNDESCRF_IOC 0x80000000U /*!< Interrupt on Completion */
|
|
#define ETH_DMATXNDESCRF_TTSE 0x40000000U /*!< Transmit Timestamp Enable */
|
|
#define ETH_DMATXNDESCRF_B2L 0x3FFF0000U /*!< Buffer 2 Length */
|
|
#define ETH_DMATXNDESCRF_VTIR 0x0000C000U /*!< VLAN Tag Insertion or Replacement mask */
|
|
#define ETH_DMATXNDESCRF_VTIR_DISABLE 0x00000000U /*!< Do not add a VLAN tag. */
|
|
#define ETH_DMATXNDESCRF_VTIR_REMOVE 0x00004000U /*!< Remove the VLAN tag from the packets before transmission. */
|
|
#define ETH_DMATXNDESCRF_VTIR_INSERT 0x00008000U /*!< Insert a VLAN tag. */
|
|
#define ETH_DMATXNDESCRF_VTIR_REPLACE 0x0000C000U /*!< Replace the VLAN tag. */
|
|
#define ETH_DMATXNDESCRF_B1L 0x00003FFFU /*!< Buffer 1 Length */
|
|
#define ETH_DMATXNDESCRF_HL 0x000003FFU /*!< Header Length */
|
|
|
|
/**
|
|
* @brief Bit definition of TDES3 RF register
|
|
*/
|
|
#define ETH_DMATXNDESCRF_OWN 0x80000000U /*!< OWN bit: descriptor is owned by DMA engine */
|
|
#define ETH_DMATXNDESCRF_CTXT 0x40000000U /*!< Context Type */
|
|
#define ETH_DMATXNDESCRF_FD 0x20000000U /*!< First Descriptor */
|
|
#define ETH_DMATXNDESCRF_LD 0x10000000U /*!< Last Descriptor */
|
|
#define ETH_DMATXNDESCRF_CPC 0x0C000000U /*!< CRC Pad Control mask */
|
|
#define ETH_DMATXNDESCRF_CPC_CRCPAD_INSERT 0x00000000U /*!< CRC Pad Control: CRC and Pad Insertion */
|
|
#define ETH_DMATXNDESCRF_CPC_CRC_INSERT 0x04000000U /*!< CRC Pad Control: CRC Insertion (Disable Pad Insertion) */
|
|
#define ETH_DMATXNDESCRF_CPC_DISABLE 0x08000000U /*!< CRC Pad Control: Disable CRC Insertion */
|
|
#define ETH_DMATXNDESCRF_CPC_CRC_REPLACE 0x0C000000U /*!< CRC Pad Control: CRC Replacement */
|
|
#define ETH_DMATXNDESCRF_SAIC 0x03800000U /*!< SA Insertion Control mask*/
|
|
#define ETH_DMATXNDESCRF_SAIC_DISABLE 0x00000000U /*!< SA Insertion Control: Do not include the source address */
|
|
#define ETH_DMATXNDESCRF_SAIC_INSERT 0x00800000U /*!< SA Insertion Control: Include or insert the source address */
|
|
#define ETH_DMATXNDESCRF_SAIC_REPLACE 0x01000000U /*!< SA Insertion Control: Replace the source address */
|
|
#define ETH_DMATXNDESCRF_THL 0x00780000U /*!< TCP Header Length */
|
|
#define ETH_DMATXNDESCRF_TSE 0x00040000U /*!< TCP segmentation enable */
|
|
#define ETH_DMATXNDESCRF_CIC 0x00030000U /*!< Checksum Insertion Control: 4 cases */
|
|
#define ETH_DMATXNDESCRF_CIC_DISABLE 0x00000000U /*!< Do Nothing: Checksum Engine is disabled */
|
|
#define ETH_DMATXNDESCRF_CIC_IPHDR_INSERT 0x00010000U /*!< Only IP header checksum calculation and insertion are enabled. */
|
|
#define ETH_DMATXNDESCRF_CIC_IPHDR_PAYLOAD_INSERT 0x00020000U /*!< IP header checksum and payload checksum calculation and insertion are
|
|
enabled, but pseudo header
|
|
checksum is not
|
|
calculated in hardware */
|
|
#define ETH_DMATXNDESCRF_CIC_IPHDR_PAYLOAD_INSERT_PHDR_CALC 0x00030000U /*!< IP Header checksum and payload checksum calculation and insertion are
|
|
enabled, and pseudo header
|
|
checksum is
|
|
calculated in hardware. */
|
|
#define ETH_DMATXNDESCRF_TPL 0x0003FFFFU /*!< TCP Payload Length */
|
|
#define ETH_DMATXNDESCRF_FL 0x00007FFFU /*!< Transmit End of Ring */
|
|
|
|
/*
|
|
DMA Tx Normal Descriptor Write Back Format
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES0 | Timestamp Low |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES1 | Timestamp High |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES2 | Reserved[31:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES3 | OWN(31) | Status[30:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of TDES0 WBF register
|
|
*/
|
|
#define ETH_DMATXNDESCWBF_TTSL 0xFFFFFFFFU /*!< Buffer1 Address Pointer or TSO Header Address Pointer */
|
|
|
|
/**
|
|
* @brief Bit definition of TDES1 WBF register
|
|
*/
|
|
#define ETH_DMATXNDESCWBF_TTSH 0xFFFFFFFFU /*!< Buffer2 Address Pointer */
|
|
|
|
/**
|
|
* @brief Bit definition of TDES3 WBF register
|
|
*/
|
|
#define ETH_DMATXNDESCWBF_OWN 0x80000000U /*!< OWN bit: descriptor is owned by DMA engine */
|
|
#define ETH_DMATXNDESCWBF_CTXT 0x40000000U /*!< Context Type */
|
|
#define ETH_DMATXNDESCWBF_FD 0x20000000U /*!< First Descriptor */
|
|
#define ETH_DMATXNDESCWBF_LD 0x10000000U /*!< Last Descriptor */
|
|
#define ETH_DMATXNDESCWBF_TTSS 0x00020000U /*!< Tx Timestamp Status */
|
|
#define ETH_DMATXNDESCWBF_DP 0x04000000U /*!< Disable Padding */
|
|
#define ETH_DMATXNDESCWBF_TTSE 0x02000000U /*!< Transmit Timestamp Enable */
|
|
#define ETH_DMATXNDESCWBF_ES 0x00008000U /*!< Error summary: OR of the following bits: IHE || UF || ED || EC || LCO || PCE || NC || LCA || FF || JT */
|
|
#define ETH_DMATXNDESCWBF_JT 0x00004000U /*!< Jabber Timeout */
|
|
#define ETH_DMATXNDESCWBF_FF 0x00002000U /*!< Packet Flushed: DMA/MTL flushed the packet due to SW flush */
|
|
#define ETH_DMATXNDESCWBF_PCE 0x00001000U /*!< Payload Checksum Error */
|
|
#define ETH_DMATXNDESCWBF_LCA 0x00000800U /*!< Loss of Carrier: carrier lost during transmission */
|
|
#define ETH_DMATXNDESCWBF_NC 0x00000400U /*!< No Carrier: no carrier signal from the transceiver */
|
|
#define ETH_DMATXNDESCWBF_LCO 0x00000200U /*!< Late Collision: transmission aborted due to collision */
|
|
#define ETH_DMATXNDESCWBF_EC 0x00000100U /*!< Excessive Collision: transmission aborted after 16 collisions */
|
|
#define ETH_DMATXNDESCWBF_CC 0x000000F0U /*!< Collision Count */
|
|
#define ETH_DMATXNDESCWBF_ED 0x00000008U /*!< Excessive Deferral */
|
|
#define ETH_DMATXNDESCWBF_UF 0x00000004U /*!< Underflow Error: late data arrival from the memory */
|
|
#define ETH_DMATXNDESCWBF_DB 0x00000002U /*!< Deferred Bit */
|
|
#define ETH_DMATXNDESCWBF_IHE 0x00000004U /*!< IP Header Error */
|
|
|
|
|
|
/*
|
|
DMA Tx Context Descriptor
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES0 | Timestamp Low |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES1 | Timestamp High |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES2 | Inner VLAN Tag[31:16] | Reserved(15) | Maximum Segment Size [14:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
TDES3 | OWN(31) | Status[30:0] |
|
|
-----------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of Tx context descriptor register 0
|
|
*/
|
|
#define ETH_DMATXCDESC_TTSL 0xFFFFFFFFU /*!< Transmit Packet Timestamp Low */
|
|
|
|
/**
|
|
* @brief Bit definition of Tx context descriptor register 1
|
|
*/
|
|
#define ETH_DMATXCDESC_TTSH 0xFFFFFFFFU /*!< Transmit Packet Timestamp High */
|
|
|
|
/**
|
|
* @brief Bit definition of Tx context descriptor register 2
|
|
*/
|
|
#define ETH_DMATXCDESC_IVT 0xFFFF0000U /*!< Inner VLAN Tag */
|
|
#define ETH_DMATXCDESC_MSS 0x00003FFFU /*!< Maximum Segment Size */
|
|
|
|
/**
|
|
* @brief Bit definition of Tx context descriptor register 3
|
|
*/
|
|
#define ETH_DMATXCDESC_OWN 0x80000000U /*!< OWN bit: descriptor is owned by DMA engine */
|
|
#define ETH_DMATXCDESC_CTXT 0x40000000U /*!< Context Type */
|
|
#define ETH_DMATXCDESC_OSTC 0x08000000U /*!< One-Step Timestamp Correction Enable */
|
|
#define ETH_DMATXCDESC_TCMSSV 0x04000000U /*!< One-Step Timestamp Correction Input or MSS Valid */
|
|
#define ETH_DMATXCDESC_CDE 0x00800000U /*!< Context Descriptor Error */
|
|
#define ETH_DMATXCDESC_IVTIR 0x000C0000U /*!< Inner VLAN Tag Insert or Replace Mask */
|
|
#define ETH_DMATXCDESC_IVTIR_DISABLE 0x00000000U /*!< Do not add the inner VLAN tag. */
|
|
#define ETH_DMATXCDESC_IVTIR_REMOVE 0x00040000U /*!< Remove the inner VLAN tag from the packets before transmission. */
|
|
#define ETH_DMATXCDESC_IVTIR_INSERT 0x00080000U /*!< Insert the inner VLAN tag. */
|
|
#define ETH_DMATXCDESC_IVTIR_REPLACE 0x000C0000U /*!< Replace the inner VLAN tag. */
|
|
#define ETH_DMATXCDESC_IVLTV 0x00020000U /*!< Inner VLAN Tag Valid */
|
|
#define ETH_DMATXCDESC_VLTV 0x00010000U /*!< VLAN Tag Valid */
|
|
#define ETH_DMATXCDESC_VT 0x0000FFFFU /*!< VLAN Tag */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/** @defgroup ETH_DMA_Rx_Descriptor_Bit_Definition ETH DMA Rx Descriptor Bit Definition
|
|
* @{
|
|
*/
|
|
|
|
/*
|
|
DMA Rx Normal Descriptor read format
|
|
-----------------------------------------------------------------------------------------------------------
|
|
RDES0 | Buffer1 or Header Address [31:0] |
|
|
-----------------------------------------------------------------------------------------------------------
|
|
RDES1 | Reserved |
|
|
-----------------------------------------------------------------------------------------------------------
|
|
RDES2 | Payload or Buffer2 Address[31:0] |
|
|
-----------------------------------------------------------------------------------------------------------
|
|
RDES3 | OWN(31) | IOC(30) | Reserved [29:26] | BUF2V(25) | BUF1V(24) | Reserved [23:0] |
|
|
-----------------------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 0 read format
|
|
*/
|
|
#define ETH_DMARXNDESCRF_BUF1AP 0xFFFFFFFFU /*!< Header or Buffer 1 Address Pointer */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 2 read format
|
|
*/
|
|
#define ETH_DMARXNDESCRF_BUF2AP 0xFFFFFFFFU /*!< Buffer 2 Address Pointer */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 3 read format
|
|
*/
|
|
#define ETH_DMARXNDESCRF_OWN 0x80000000U /*!< OWN bit: descriptor is owned by DMA engine */
|
|
#define ETH_DMARXNDESCRF_IOC 0x40000000U /*!< Interrupt Enabled on Completion */
|
|
#define ETH_DMARXNDESCRF_BUF2V 0x02000000U /*!< Buffer 2 Address Valid */
|
|
#define ETH_DMARXNDESCRF_BUF1V 0x01000000U /*!< Buffer 1 Address Valid */
|
|
|
|
/*
|
|
DMA Rx Normal Descriptor write back format
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES0 | Inner VLAN Tag[31:16] | Outer VLAN Tag[15:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES1 | OAM code, or MAC Control Opcode [31:16] | Extended Status |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES2 | MAC Filter Status[31:16] | VF(15) | Reserved [14:12] | ARP Status [11:10] | Header Length [9:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES3 | OWN(31) | CTXT(30) | FD(29) | LD(28) | Status[27:16] | ES(15) | Packet Length[14:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 0 write back format
|
|
*/
|
|
#define ETH_DMARXNDESCWBF_IVT 0xFFFF0000U /*!< Inner VLAN Tag */
|
|
#define ETH_DMARXNDESCWBF_OVT 0x0000FFFFU /*!< Outer VLAN Tag */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 1 write back format
|
|
*/
|
|
#define ETH_DMARXNDESCWBF_OPC 0xFFFF0000U /*!< OAM Sub-Type Code, or MAC Control Packet opcode */
|
|
#define ETH_DMARXNDESCWBF_TD 0x00008000U /*!< Timestamp Dropped */
|
|
#define ETH_DMARXNDESCWBF_TSA 0x00004000U /*!< Timestamp Available */
|
|
#define ETH_DMARXNDESCWBF_PV 0x00002000U /*!< PTP Version */
|
|
#define ETH_DMARXNDESCWBF_PFT 0x00001000U /*!< PTP Packet Type */
|
|
#define ETH_DMARXNDESCWBF_PMT_NO 0x00000000U /*!< PTP Message Type: No PTP message received */
|
|
#define ETH_DMARXNDESCWBF_PMT_SYNC 0x00000100U /*!< PTP Message Type: SYNC (all clock types) */
|
|
#define ETH_DMARXNDESCWBF_PMT_FUP 0x00000200U /*!< PTP Message Type: Follow_Up (all clock types) */
|
|
#define ETH_DMARXNDESCWBF_PMT_DREQ 0x00000300U /*!< PTP Message Type: Delay_Req (all clock types) */
|
|
#define ETH_DMARXNDESCWBF_PMT_DRESP 0x00000400U /*!< PTP Message Type: Delay_Resp (all clock types) */
|
|
#define ETH_DMARXNDESCWBF_PMT_PDREQ 0x00000500U /*!< PTP Message Type: Pdelay_Req (in peer-to-peer transparent clock) */
|
|
#define ETH_DMARXNDESCWBF_PMT_PDRESP 0x00000600U /*!< PTP Message Type: Pdelay_Resp (in peer-to-peer transparent clock) */
|
|
#define ETH_DMARXNDESCWBF_PMT_PDRESPFUP 0x00000700U /*!< PTP Message Type: Pdelay_Resp_Follow_Up (in peer-to-peer transparent clock) */
|
|
#define ETH_DMARXNDESCWBF_PMT_ANNOUNCE 0x00000800U /*!< PTP Message Type: Announce */
|
|
#define ETH_DMARXNDESCWBF_PMT_MANAG 0x00000900U /*!< PTP Message Type: Management */
|
|
#define ETH_DMARXNDESCWBF_PMT_SIGN 0x00000A00U /*!< PTP Message Type: Signaling */
|
|
#define ETH_DMARXNDESCWBF_PMT_RESERVED 0x00000F00U /*!< PTP Message Type: PTP packet with Reserved message type */
|
|
#define ETH_DMARXNDESCWBF_IPCE 0x00000080U /*!< IP Payload Error */
|
|
#define ETH_DMARXNDESCWBF_IPCB 0x00000040U /*!< IP Checksum Bypassed */
|
|
#define ETH_DMARXNDESCWBF_IPV6 0x00000020U /*!< IPv6 header Present */
|
|
#define ETH_DMARXNDESCWBF_IPV4 0x00000010U /*!< IPv4 header Present */
|
|
#define ETH_DMARXNDESCWBF_IPHE 0x00000008U /*!< IP Header Error */
|
|
#define ETH_DMARXNDESCWBF_PT 0x00000003U /*!< Payload Type mask */
|
|
#define ETH_DMARXNDESCWBF_PT_UNKNOWN 0x00000000U /*!< Payload Type: Unknown type or IP/AV payload not processed */
|
|
#define ETH_DMARXNDESCWBF_PT_UDP 0x00000001U /*!< Payload Type: UDP */
|
|
#define ETH_DMARXNDESCWBF_PT_TCP 0x00000002U /*!< Payload Type: TCP */
|
|
#define ETH_DMARXNDESCWBF_PT_ICMP 0x00000003U /*!< Payload Type: ICMP */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 2 write back format
|
|
*/
|
|
#define ETH_DMARXNDESCWBF_L3L4FM 0x20000000U /*!< L3 and L4 Filter Number Matched: if reset filter 0 is matched , if set filter 1 is matched */
|
|
#define ETH_DMARXNDESCWBF_L4FM 0x10000000U /*!< Layer 4 Filter Match */
|
|
#define ETH_DMARXNDESCWBF_L3FM 0x08000000U /*!< Layer 3 Filter Match */
|
|
#define ETH_DMARXNDESCWBF_MADRM 0x07F80000U /*!< MAC Address Match or Hash Value */
|
|
#define ETH_DMARXNDESCWBF_HF 0x00040000U /*!< Hash Filter Status */
|
|
#define ETH_DMARXNDESCWBF_DAF 0x00020000U /*!< Destination Address Filter Fail */
|
|
#define ETH_DMARXNDESCWBF_SAF 0x00010000U /*!< SA Address Filter Fail */
|
|
#define ETH_DMARXNDESCWBF_VF 0x00008000U /*!< VLAN Filter Status */
|
|
#define ETH_DMARXNDESCWBF_ARPNR 0x00000400U /*!< ARP Reply Not Generated */
|
|
|
|
|
|
/**
|
|
* @brief Bit definition of Rx normal descriptor register 3 write back format
|
|
*/
|
|
#define ETH_DMARXNDESCWBF_OWN 0x80000000U /*!< Own Bit */
|
|
#define ETH_DMARXNDESCWBF_CTXT 0x40000000U /*!< Receive Context Descriptor */
|
|
#define ETH_DMARXNDESCWBF_FD 0x20000000U /*!< First Descriptor */
|
|
#define ETH_DMARXNDESCWBF_LD 0x10000000U /*!< Last Descriptor */
|
|
#define ETH_DMARXNDESCWBF_RS2V 0x08000000U /*!< Receive Status RDES2 Valid */
|
|
#define ETH_DMARXNDESCWBF_RS1V 0x04000000U /*!< Receive Status RDES1 Valid */
|
|
#define ETH_DMARXNDESCWBF_RS0V 0x02000000U /*!< Receive Status RDES0 Valid */
|
|
#define ETH_DMARXNDESCWBF_CE 0x01000000U /*!< CRC Error */
|
|
#define ETH_DMARXNDESCWBF_GP 0x00800000U /*!< Giant Packet */
|
|
#define ETH_DMARXNDESCWBF_RWT 0x00400000U /*!< Receive Watchdog Timeout */
|
|
#define ETH_DMARXNDESCWBF_OE 0x00200000U /*!< Overflow Error */
|
|
#define ETH_DMARXNDESCWBF_RE 0x00100000U /*!< Receive Error */
|
|
#define ETH_DMARXNDESCWBF_DE 0x00080000U /*!< Dribble Bit Error */
|
|
#define ETH_DMARXNDESCWBF_LT 0x00070000U /*!< Length/Type Field */
|
|
#define ETH_DMARXNDESCWBF_LT_LP 0x00000000U /*!< The packet is a length packet */
|
|
#define ETH_DMARXNDESCWBF_LT_TP 0x00010000U /*!< The packet is a type packet */
|
|
#define ETH_DMARXNDESCWBF_LT_ARP 0x00030000U /*!< The packet is a ARP Request packet type */
|
|
#define ETH_DMARXNDESCWBF_LT_VLAN 0x00040000U /*!< The packet is a type packet with VLAN Tag */
|
|
#define ETH_DMARXNDESCWBF_LT_DVLAN 0x00050000U /*!< The packet is a type packet with Double VLAN Tag */
|
|
#define ETH_DMARXNDESCWBF_LT_MAC 0x00060000U /*!< The packet is a MAC Control packet type */
|
|
#define ETH_DMARXNDESCWBF_LT_OAM 0x00070000U /*!< The packet is a OAM packet type */
|
|
#define ETH_DMARXNDESCWBF_ES 0x00008000U /*!< Error Summary */
|
|
#define ETH_DMARXNDESCWBF_PL 0x00007FFFU /*!< Packet Length */
|
|
|
|
/*
|
|
DMA Rx context Descriptor
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES0 | Timestamp Low[31:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES1 | Timestamp High[31:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES2 | Reserved |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
RDES3 | OWN(31) | CTXT(30) | Reserved[29:0] |
|
|
---------------------------------------------------------------------------------------------------------------------
|
|
*/
|
|
|
|
/**
|
|
* @brief Bit definition of Rx context descriptor register 0
|
|
*/
|
|
#define ETH_DMARXCDESC_RTSL 0xFFFFFFFFU /*!< Receive Packet Timestamp Low */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx context descriptor register 1
|
|
*/
|
|
#define ETH_DMARXCDESC_RTSH 0xFFFFFFFFU /*!< Receive Packet Timestamp High */
|
|
|
|
/**
|
|
* @brief Bit definition of Rx context descriptor register 3
|
|
*/
|
|
#define ETH_DMARXCDESC_OWN 0x80000000U /*!< Own Bit */
|
|
#define ETH_DMARXCDESC_CTXT 0x40000000U /*!< Receive Context Descriptor */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Frame_settings ETH frame settings
|
|
* @{
|
|
*/
|
|
#define ETH_MAX_PACKET_SIZE 1528U /*!< ETH_HEADER + 2*VLAN_TAG + MAX_ETH_PAYLOAD + ETH_CRC */
|
|
#define ETH_HEADER 14U /*!< 6 byte Dest addr, 6 byte Src addr, 2 byte length/type */
|
|
#define ETH_CRC 4U /*!< Ethernet CRC */
|
|
#define ETH_VLAN_TAG 4U /*!< optional 802.1q VLAN Tag */
|
|
#define ETH_MIN_PAYLOAD 46U /*!< Minimum Ethernet payload size */
|
|
#define ETH_MAX_PAYLOAD 1500U /*!< Maximum Ethernet payload size */
|
|
#define ETH_JUMBO_FRAME_PAYLOAD 9000U /*!< Jumbo frame payload size */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Error_Code ETH Error Code
|
|
* @{
|
|
*/
|
|
#define HAL_ETH_ERROR_NONE 0x00000000U /*!< No error */
|
|
#define HAL_ETH_ERROR_PARAM 0x00000001U /*!< Busy error */
|
|
#define HAL_ETH_ERROR_BUSY 0x00000002U /*!< Parameter error */
|
|
#define HAL_ETH_ERROR_TIMEOUT 0x00000004U /*!< Timeout error */
|
|
#define HAL_ETH_ERROR_DMA 0x00000008U /*!< DMA transfer error */
|
|
#define HAL_ETH_ERROR_MAC 0x00000010U /*!< MAC transfer error */
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
#define HAL_ETH_ERROR_INVALID_CALLBACK 0x00000020U /*!< Invalid Callback error */
|
|
#endif /* USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_Attributes ETH Tx Packet Attributes
|
|
* @{
|
|
*/
|
|
#define ETH_TX_PACKETS_FEATURES_CSUM 0x00000001U
|
|
#define ETH_TX_PACKETS_FEATURES_SAIC 0x00000002U
|
|
#define ETH_TX_PACKETS_FEATURES_VLANTAG 0x00000004U
|
|
#define ETH_TX_PACKETS_FEATURES_INNERVLANTAG 0x00000008U
|
|
#define ETH_TX_PACKETS_FEATURES_TSO 0x00000010U
|
|
#define ETH_TX_PACKETS_FEATURES_CRCPAD 0x00000020U
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_Source_Addr_Control ETH Tx Packet Source Addr Control
|
|
* @{
|
|
*/
|
|
#define ETH_SRC_ADDR_CONTROL_DISABLE ETH_DMATXNDESCRF_SAIC_DISABLE
|
|
#define ETH_SRC_ADDR_INSERT ETH_DMATXNDESCRF_SAIC_INSERT
|
|
#define ETH_SRC_ADDR_REPLACE ETH_DMATXNDESCRF_SAIC_REPLACE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_CRC_Pad_Control ETH Tx Packet CRC Pad Control
|
|
* @{
|
|
*/
|
|
#define ETH_CRC_PAD_DISABLE ETH_DMATXNDESCRF_CPC_DISABLE
|
|
#define ETH_CRC_PAD_INSERT ETH_DMATXNDESCRF_CPC_CRCPAD_INSERT
|
|
#define ETH_CRC_INSERT ETH_DMATXNDESCRF_CPC_CRC_INSERT
|
|
#define ETH_CRC_REPLACE ETH_DMATXNDESCRF_CPC_CRC_REPLACE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_Checksum_Control ETH Tx Packet Checksum Control
|
|
* @{
|
|
*/
|
|
#define ETH_CHECKSUM_DISABLE ETH_DMATXNDESCRF_CIC_DISABLE
|
|
#define ETH_CHECKSUM_IPHDR_INSERT ETH_DMATXNDESCRF_CIC_IPHDR_INSERT
|
|
#define ETH_CHECKSUM_IPHDR_PAYLOAD_INSERT ETH_DMATXNDESCRF_CIC_IPHDR_PAYLOAD_INSERT
|
|
#define ETH_CHECKSUM_IPHDR_PAYLOAD_INSERT_PHDR_CALC ETH_DMATXNDESCRF_CIC_IPHDR_PAYLOAD_INSERT_PHDR_CALC
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_VLAN_Control ETH Tx Packet VLAN Control
|
|
* @{
|
|
*/
|
|
#define ETH_VLAN_DISABLE ETH_DMATXNDESCRF_VTIR_DISABLE
|
|
#define ETH_VLAN_REMOVE ETH_DMATXNDESCRF_VTIR_REMOVE
|
|
#define ETH_VLAN_INSERT ETH_DMATXNDESCRF_VTIR_INSERT
|
|
#define ETH_VLAN_REPLACE ETH_DMATXNDESCRF_VTIR_REPLACE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_Packet_Inner_VLAN_Control ETH Tx Packet Inner VLAN Control
|
|
* @{
|
|
*/
|
|
#define ETH_INNER_VLAN_DISABLE ETH_DMATXCDESC_IVTIR_DISABLE
|
|
#define ETH_INNER_VLAN_REMOVE ETH_DMATXCDESC_IVTIR_REMOVE
|
|
#define ETH_INNER_VLAN_INSERT ETH_DMATXCDESC_IVTIR_INSERT
|
|
#define ETH_INNER_VLAN_REPLACE ETH_DMATXCDESC_IVTIR_REPLACE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_Checksum_Status ETH Rx Checksum Status
|
|
* @{
|
|
*/
|
|
#define ETH_CHECKSUM_BYPASSED ETH_DMARXNDESCWBF_IPCB
|
|
#define ETH_CHECKSUM_IP_HEADER_ERROR ETH_DMARXNDESCWBF_IPHE
|
|
#define ETH_CHECKSUM_IP_PAYLOAD_ERROR ETH_DMARXNDESCWBF_IPCE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_IP_Header_Type ETH Rx IP Header Type
|
|
* @{
|
|
*/
|
|
#define ETH_IP_HEADER_IPV4 ETH_DMARXNDESCWBF_IPV4
|
|
#define ETH_IP_HEADER_IPV6 ETH_DMARXNDESCWBF_IPV6
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_Payload_Type ETH Rx Payload Type
|
|
* @{
|
|
*/
|
|
#define ETH_IP_PAYLOAD_UNKNOWN ETH_DMARXNDESCWBF_PT_UNKNOWN
|
|
#define ETH_IP_PAYLOAD_UDP ETH_DMARXNDESCWBF_PT_UDP
|
|
#define ETH_IP_PAYLOAD_TCP ETH_DMARXNDESCWBF_PT_TCP
|
|
#define ETH_IP_PAYLOAD_ICMPN ETH_DMARXNDESCWBF_PT_ICMP
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_MAC_Filter_Status ETH Rx MAC Filter Status
|
|
* @{
|
|
*/
|
|
#define ETH_HASH_FILTER_PASS ETH_DMARXNDESCWBF_HF
|
|
#define ETH_VLAN_FILTER_PASS ETH_DMARXNDESCWBF_VF
|
|
#define ETH_DEST_ADDRESS_FAIL ETH_DMARXNDESCWBF_DAF
|
|
#define ETH_SOURCE_ADDRESS_FAIL ETH_DMARXNDESCWBF_SAF
|
|
/**
|
|
* @}
|
|
*/
|
|
/** @defgroup ETH_Rx_L3_Filter_Status ETH Rx L3 Filter Status
|
|
* @{
|
|
*/
|
|
#define ETH_L3_FILTER0_MATCH ETH_DMARXNDESCWBF_L3FM
|
|
#define ETH_L3_FILTER1_MATCH (ETH_DMARXNDESCWBF_L3FM | ETH_DMARXNDESCWBF_L3L4FM)
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_L4_Filter_Status ETH Rx L4 Filter Status
|
|
* @{
|
|
*/
|
|
#define ETH_L4_FILTER0_MATCH ETH_DMARXNDESCWBF_L4FM
|
|
#define ETH_L4_FILTER1_MATCH (ETH_DMARXNDESCWBF_L4FM | ETH_DMARXNDESCWBF_L3L4FM)
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_Error_Code ETH Rx Error Code
|
|
* @{
|
|
*/
|
|
#define ETH_DRIBBLE_BIT_ERROR ETH_DMARXNDESCWBF_DE
|
|
#define ETH_RECEIVE_ERROR ETH_DMARXNDESCWBF_RE
|
|
#define ETH_RECEIVE_OVERFLOW ETH_DMARXNDESCWBF_OE
|
|
#define ETH_WATCHDOG_TIMEOUT ETH_DMARXNDESCWBF_RWT
|
|
#define ETH_GIANT_PACKET ETH_DMARXNDESCWBF_GP
|
|
#define ETH_CRC_ERROR ETH_DMARXNDESCWBF_CE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_DMA_Arbitration ETH DMA Arbitration
|
|
* @{
|
|
*/
|
|
#define ETH_DMAARBITRATION_RX ETH_DMAMR_DA
|
|
#define ETH_DMAARBITRATION_RX1_TX1 0x00000000U
|
|
#define ETH_DMAARBITRATION_RX2_TX1 ETH_DMAMR_PR_2_1
|
|
#define ETH_DMAARBITRATION_RX3_TX1 ETH_DMAMR_PR_3_1
|
|
#define ETH_DMAARBITRATION_RX4_TX1 ETH_DMAMR_PR_4_1
|
|
#define ETH_DMAARBITRATION_RX5_TX1 ETH_DMAMR_PR_5_1
|
|
#define ETH_DMAARBITRATION_RX6_TX1 ETH_DMAMR_PR_6_1
|
|
#define ETH_DMAARBITRATION_RX7_TX1 ETH_DMAMR_PR_7_1
|
|
#define ETH_DMAARBITRATION_RX8_TX1 ETH_DMAMR_PR_8_1
|
|
#define ETH_DMAARBITRATION_TX (ETH_DMAMR_TXPR | ETH_DMAMR_DA)
|
|
#define ETH_DMAARBITRATION_TX1_RX1 0x00000000U
|
|
#define ETH_DMAARBITRATION_TX2_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_2_1)
|
|
#define ETH_DMAARBITRATION_TX3_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_3_1)
|
|
#define ETH_DMAARBITRATION_TX4_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_4_1)
|
|
#define ETH_DMAARBITRATION_TX5_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_5_1)
|
|
#define ETH_DMAARBITRATION_TX6_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_6_1)
|
|
#define ETH_DMAARBITRATION_TX7_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_7_1)
|
|
#define ETH_DMAARBITRATION_TX8_RX1 (ETH_DMAMR_TXPR | ETH_DMAMR_PR_8_1)
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Burst_Mode ETH Burst Mode
|
|
* @{
|
|
*/
|
|
#define ETH_BURSTLENGTH_FIXED ETH_DMASBMR_FB
|
|
#define ETH_BURSTLENGTH_MIXED ETH_DMASBMR_MB
|
|
#define ETH_BURSTLENGTH_UNSPECIFIED 0x00000000U
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Tx_DMA_Burst_Length ETH Tx DMA Burst Length
|
|
* @{
|
|
*/
|
|
#define ETH_TXDMABURSTLENGTH_1BEAT ETH_DMACTCR_TPBL_1PBL
|
|
#define ETH_TXDMABURSTLENGTH_2BEAT ETH_DMACTCR_TPBL_2PBL
|
|
#define ETH_TXDMABURSTLENGTH_4BEAT ETH_DMACTCR_TPBL_4PBL
|
|
#define ETH_TXDMABURSTLENGTH_8BEAT ETH_DMACTCR_TPBL_8PBL
|
|
#define ETH_TXDMABURSTLENGTH_16BEAT ETH_DMACTCR_TPBL_16PBL
|
|
#define ETH_TXDMABURSTLENGTH_32BEAT ETH_DMACTCR_TPBL_32PBL
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Rx_DMA_Burst_Length ETH Rx DMA Burst Length
|
|
* @{
|
|
*/
|
|
#define ETH_RXDMABURSTLENGTH_1BEAT ETH_DMACRCR_RPBL_1PBL
|
|
#define ETH_RXDMABURSTLENGTH_2BEAT ETH_DMACRCR_RPBL_2PBL
|
|
#define ETH_RXDMABURSTLENGTH_4BEAT ETH_DMACRCR_RPBL_4PBL
|
|
#define ETH_RXDMABURSTLENGTH_8BEAT ETH_DMACRCR_RPBL_8PBL
|
|
#define ETH_RXDMABURSTLENGTH_16BEAT ETH_DMACRCR_RPBL_16PBL
|
|
#define ETH_RXDMABURSTLENGTH_32BEAT ETH_DMACRCR_RPBL_32PBL
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_DMA_Interrupts ETH DMA Interrupts
|
|
* @{
|
|
*/
|
|
#define ETH_DMA_NORMAL_IT ETH_DMACIER_NIE
|
|
#define ETH_DMA_ABNORMAL_IT ETH_DMACIER_AIE
|
|
#define ETH_DMA_CONTEXT_DESC_ERROR_IT ETH_DMACIER_CDEE
|
|
#define ETH_DMA_FATAL_BUS_ERROR_IT ETH_DMACIER_FBEE
|
|
#define ETH_DMA_EARLY_RX_IT ETH_DMACIER_ERIE
|
|
#define ETH_DMA_EARLY_TX_IT ETH_DMACIER_ETIE
|
|
#define ETH_DMA_RX_WATCHDOG_TIMEOUT_IT ETH_DMACIER_RWTE
|
|
#define ETH_DMA_RX_PROCESS_STOPPED_IT ETH_DMACIER_RSE
|
|
#define ETH_DMA_RX_BUFFER_UNAVAILABLE_IT ETH_DMACIER_RBUE
|
|
#define ETH_DMA_RX_IT ETH_DMACIER_RIE
|
|
#define ETH_DMA_TX_BUFFER_UNAVAILABLE_IT ETH_DMACIER_TBUE
|
|
#define ETH_DMA_TX_PROCESS_STOPPED_IT ETH_DMACIER_TXSE
|
|
#define ETH_DMA_TX_IT ETH_DMACIER_TIE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_DMA_Status_Flags ETH DMA Status Flags
|
|
* @{
|
|
*/
|
|
#define ETH_DMA_RX_NO_ERROR_FLAG 0x00000000U
|
|
#define ETH_DMA_RX_DESC_READ_ERROR_FLAG (ETH_DMACSR_REB_BIT_2 | ETH_DMACSR_REB_BIT_1 | ETH_DMACSR_REB_BIT_0)
|
|
#define ETH_DMA_RX_DESC_WRITE_ERROR_FLAG (ETH_DMACSR_REB_BIT_2 | ETH_DMACSR_REB_BIT_1)
|
|
#define ETH_DMA_RX_BUFFER_READ_ERROR_FLAG (ETH_DMACSR_REB_BIT_2 | ETH_DMACSR_REB_BIT_0)
|
|
#define ETH_DMA_RX_BUFFER_WRITE_ERROR_FLAG ETH_DMACSR_REB_BIT_2
|
|
#define ETH_DMA_TX_NO_ERROR_FLAG 0x00000000U
|
|
#define ETH_DMA_TX_DESC_READ_ERROR_FLAG (ETH_DMACSR_TEB_BIT_2 | ETH_DMACSR_TEB_BIT_1 | ETH_DMACSR_TEB_BIT_0)
|
|
#define ETH_DMA_TX_DESC_WRITE_ERROR_FLAG (ETH_DMACSR_TEB_BIT_2 | ETH_DMACSR_TEB_BIT_1)
|
|
#define ETH_DMA_TX_BUFFER_READ_ERROR_FLAG (ETH_DMACSR_TEB_BIT_2 | ETH_DMACSR_TEB_BIT_0)
|
|
#define ETH_DMA_TX_BUFFER_WRITE_ERROR_FLAG ETH_DMACSR_TEB_BIT_2
|
|
#define ETH_DMA_CONTEXT_DESC_ERROR_FLAG ETH_DMACSR_CDE
|
|
#define ETH_DMA_FATAL_BUS_ERROR_FLAG ETH_DMACSR_FBE
|
|
#define ETH_DMA_EARLY_TX_IT_FLAG ETH_DMACSR_ERI
|
|
#define ETH_DMA_RX_WATCHDOG_TIMEOUT_FLAG ETH_DMACSR_RWT
|
|
#define ETH_DMA_RX_PROCESS_STOPPED_FLAG ETH_DMACSR_RPS
|
|
#define ETH_DMA_RX_BUFFER_UNAVAILABLE_FLAG ETH_DMACSR_RBU
|
|
#define ETH_DMA_TX_PROCESS_STOPPED_FLAG ETH_DMACSR_TPS
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Transmit_Mode ETH Transmit Mode
|
|
* @{
|
|
*/
|
|
#define ETH_TRANSMITSTOREFORWARD ETH_MTLTQOMR_TSF
|
|
#define ETH_TRANSMITTHRESHOLD_32 ETH_MTLTQOMR_TTC_32BITS
|
|
#define ETH_TRANSMITTHRESHOLD_64 ETH_MTLTQOMR_TTC_64BITS
|
|
#define ETH_TRANSMITTHRESHOLD_96 ETH_MTLTQOMR_TTC_96BITS
|
|
#define ETH_TRANSMITTHRESHOLD_128 ETH_MTLTQOMR_TTC_128BITS
|
|
#define ETH_TRANSMITTHRESHOLD_192 ETH_MTLTQOMR_TTC_192BITS
|
|
#define ETH_TRANSMITTHRESHOLD_256 ETH_MTLTQOMR_TTC_256BITS
|
|
#define ETH_TRANSMITTHRESHOLD_384 ETH_MTLTQOMR_TTC_384BITS
|
|
#define ETH_TRANSMITTHRESHOLD_512 ETH_MTLTQOMR_TTC_512BITS
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Receive_Mode ETH Receive Mode
|
|
* @{
|
|
*/
|
|
#define ETH_RECEIVESTOREFORWARD ETH_MTLRQOMR_RSF
|
|
#define ETH_RECEIVETHRESHOLD8_64 ETH_MTLRQOMR_RTC_64BITS
|
|
#define ETH_RECEIVETHRESHOLD8_32 ETH_MTLRQOMR_RTC_32BITS
|
|
#define ETH_RECEIVETHRESHOLD8_96 ETH_MTLRQOMR_RTC_96BITS
|
|
#define ETH_RECEIVETHRESHOLD8_128 ETH_MTLRQOMR_RTC_128BITS
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Pause_Low_Threshold ETH Pause Low Threshold
|
|
* @{
|
|
*/
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_4 ETH_MACTFCR_PLT_MINUS4
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_28 ETH_MACTFCR_PLT_MINUS28
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_36 ETH_MACTFCR_PLT_MINUS36
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_144 ETH_MACTFCR_PLT_MINUS144
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_256 ETH_MACTFCR_PLT_MINUS256
|
|
#define ETH_PAUSELOWTHRESHOLD_MINUS_512 ETH_MACTFCR_PLT_MINUS512
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Watchdog_Timeout ETH Watchdog Timeout
|
|
* @{
|
|
*/
|
|
#define ETH_WATCHDOGTIMEOUT_2KB ETH_MACWTR_WTO_2KB
|
|
#define ETH_WATCHDOGTIMEOUT_3KB ETH_MACWTR_WTO_3KB
|
|
#define ETH_WATCHDOGTIMEOUT_4KB ETH_MACWTR_WTO_4KB
|
|
#define ETH_WATCHDOGTIMEOUT_5KB ETH_MACWTR_WTO_5KB
|
|
#define ETH_WATCHDOGTIMEOUT_6KB ETH_MACWTR_WTO_6KB
|
|
#define ETH_WATCHDOGTIMEOUT_7KB ETH_MACWTR_WTO_7KB
|
|
#define ETH_WATCHDOGTIMEOUT_8KB ETH_MACWTR_WTO_8KB
|
|
#define ETH_WATCHDOGTIMEOUT_9KB ETH_MACWTR_WTO_9KB
|
|
#define ETH_WATCHDOGTIMEOUT_10KB ETH_MACWTR_WTO_10KB
|
|
#define ETH_WATCHDOGTIMEOUT_11KB ETH_MACWTR_WTO_12KB
|
|
#define ETH_WATCHDOGTIMEOUT_12KB ETH_MACWTR_WTO_12KB
|
|
#define ETH_WATCHDOGTIMEOUT_13KB ETH_MACWTR_WTO_13KB
|
|
#define ETH_WATCHDOGTIMEOUT_14KB ETH_MACWTR_WTO_14KB
|
|
#define ETH_WATCHDOGTIMEOUT_15KB ETH_MACWTR_WTO_15KB
|
|
#define ETH_WATCHDOGTIMEOUT_16KB ETH_MACWTR_WTO_16KB
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Inter_Packet_Gap ETH Inter Packet Gap
|
|
* @{
|
|
*/
|
|
#define ETH_INTERPACKETGAP_96BIT ETH_MACCR_IPG_96BIT
|
|
#define ETH_INTERPACKETGAP_88BIT ETH_MACCR_IPG_88BIT
|
|
#define ETH_INTERPACKETGAP_80BIT ETH_MACCR_IPG_80BIT
|
|
#define ETH_INTERPACKETGAP_72BIT ETH_MACCR_IPG_72BIT
|
|
#define ETH_INTERPACKETGAP_64BIT ETH_MACCR_IPG_64BIT
|
|
#define ETH_INTERPACKETGAP_56BIT ETH_MACCR_IPG_56BIT
|
|
#define ETH_INTERPACKETGAP_48BIT ETH_MACCR_IPG_48BIT
|
|
#define ETH_INTERPACKETGAP_40BIT ETH_MACCR_IPG_40BIT
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Speed ETH Speed
|
|
* @{
|
|
*/
|
|
#define ETH_SPEED_10M 0x00000000U
|
|
#define ETH_SPEED_100M ETH_MACCR_FES
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Duplex_Mode ETH Duplex Mode
|
|
* @{
|
|
*/
|
|
#define ETH_FULLDUPLEX_MODE ETH_MACCR_DM
|
|
#define ETH_HALFDUPLEX_MODE 0x00000000U
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Back_Off_Limit ETH Back Off Limit
|
|
* @{
|
|
*/
|
|
#define ETH_BACKOFFLIMIT_10 ETH_MACCR_BL_10
|
|
#define ETH_BACKOFFLIMIT_8 ETH_MACCR_BL_8
|
|
#define ETH_BACKOFFLIMIT_4 ETH_MACCR_BL_4
|
|
#define ETH_BACKOFFLIMIT_1 ETH_MACCR_BL_1
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Preamble_Length ETH Preamble Length
|
|
* @{
|
|
*/
|
|
#define ETH_PREAMBLELENGTH_7 ETH_MACCR_PRELEN_7
|
|
#define ETH_PREAMBLELENGTH_5 ETH_MACCR_PRELEN_5
|
|
#define ETH_PREAMBLELENGTH_3 ETH_MACCR_PRELEN_3
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Source_Addr_Control ETH Source Addr Control
|
|
* @{
|
|
*/
|
|
#define ETH_SOURCEADDRESS_DISABLE 0x00000000U
|
|
#define ETH_SOURCEADDRESS_INSERT_ADDR0 ETH_MACCR_SARC_INSADDR0
|
|
#define ETH_SOURCEADDRESS_INSERT_ADDR1 ETH_MACCR_SARC_INSADDR1
|
|
#define ETH_SOURCEADDRESS_REPLACE_ADDR0 ETH_MACCR_SARC_REPADDR0
|
|
#define ETH_SOURCEADDRESS_REPLACE_ADDR1 ETH_MACCR_SARC_REPADDR1
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_Control_Packets_Filter ETH Control Packets Filter
|
|
* @{
|
|
*/
|
|
#define ETH_CTRLPACKETS_BLOCK_ALL ETH_MACPFR_PCF_BLOCKALL
|
|
#define ETH_CTRLPACKETS_FORWARD_ALL_EXCEPT_PA ETH_MACPFR_PCF_FORWARDALLEXCEPTPA
|
|
#define ETH_CTRLPACKETS_FORWARD_ALL ETH_MACPFR_PCF_FORWARDALL
|
|
#define ETH_CTRLPACKETS_FORWARD_PASSED_ADDR_FILTER ETH_MACPFR_PCF_FORWARDPASSEDADDRFILTER
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_VLAN_Tag_Comparison ETH VLAN Tag Comparison
|
|
* @{
|
|
*/
|
|
#define ETH_VLANTAGCOMPARISON_16BIT 0x00000000U
|
|
#define ETH_VLANTAGCOMPARISON_12BIT ETH_MACVTR_ETV
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_MAC_addresses ETH MAC addresses
|
|
* @{
|
|
*/
|
|
#define ETH_MAC_ADDRESS0 0x00000000U
|
|
#define ETH_MAC_ADDRESS1 0x00000008U
|
|
#define ETH_MAC_ADDRESS2 0x00000010U
|
|
#define ETH_MAC_ADDRESS3 0x00000018U
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_MAC_Interrupts ETH MAC Interrupts
|
|
* @{
|
|
*/
|
|
#define ETH_MAC_RX_STATUS_IT ETH_MACIER_RXSTSIE
|
|
#define ETH_MAC_TX_STATUS_IT ETH_MACIER_TXSTSIE
|
|
#define ETH_MAC_TIMESTAMP_IT ETH_MACIER_TSIE
|
|
#define ETH_MAC_LPI_IT ETH_MACIER_LPIIE
|
|
#define ETH_MAC_PMT_IT ETH_MACIER_PMTIE
|
|
#define ETH_MAC_PHY_IT ETH_MACIER_PHYIE
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_MAC_Wake_Up_Event ETH MAC Wake Up Event
|
|
* @{
|
|
*/
|
|
#define ETH_WAKEUP_PACKET_RECIEVED ETH_MACPCSR_RWKPRCVD
|
|
#define ETH_MAGIC_PACKET_RECIEVED ETH_MACPCSR_MGKPRCVD
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_MAC_Rx_Tx_Status ETH MAC Rx Tx Status
|
|
* @{
|
|
*/
|
|
#define ETH_RECEIVE_WATCHDOG_TIMEOUT ETH_MACRXTXSR_RWT
|
|
#define ETH_EXECESSIVE_COLLISIONS ETH_MACRXTXSR_EXCOL
|
|
#define ETH_LATE_COLLISIONS ETH_MACRXTXSR_LCOL
|
|
#define ETH_EXECESSIVE_DEFERRAL ETH_MACRXTXSR_EXDEF
|
|
#define ETH_LOSS_OF_CARRIER ETH_MACRXTXSR_LCARR
|
|
#define ETH_NO_CARRIER ETH_MACRXTXSR_NCARR
|
|
#define ETH_TRANSMIT_JABBR_TIMEOUT ETH_MACRXTXSR_TJT
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup HAL_ETH_StateTypeDef ETH States
|
|
* @{
|
|
*/
|
|
#define HAL_ETH_STATE_RESET 0x00000000U /*!< Peripheral not yet Initialized or disabled */
|
|
#define HAL_ETH_STATE_READY 0x00000010U /*!< Peripheral Communication started */
|
|
#define HAL_ETH_STATE_BUSY 0x00000023U /*!< an internal process is ongoing */
|
|
#define HAL_ETH_STATE_STARTED 0x00000023U /*!< an internal process is started */
|
|
#define HAL_ETH_STATE_ERROR 0x000000E0U /*!< Error State */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup ETH_PTP_Config_Status ETH PTP Config Status
|
|
* @{
|
|
*/
|
|
#define HAL_ETH_PTP_NOT_CONFIGURATED 0x00000000U /*!< ETH PTP Configuration not done */
|
|
#define HAL_ETH_PTP_CONFIGURATED 0x00000001U /*!< ETH PTP Configuration done */
|
|
/**
|
|
* @}
|
|
*/
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Exported macro ------------------------------------------------------------*/
|
|
/** @defgroup ETH_Exported_Macros ETH Exported Macros
|
|
* @{
|
|
*/
|
|
|
|
/** @brief Reset ETH handle state
|
|
* @param __HANDLE__: specifies the ETH handle.
|
|
* @retval None
|
|
*/
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
#define __HAL_ETH_RESET_HANDLE_STATE(__HANDLE__) do{ \
|
|
(__HANDLE__)->gState = HAL_ETH_STATE_RESET; \
|
|
(__HANDLE__)->MspInitCallback = NULL; \
|
|
(__HANDLE__)->MspDeInitCallback = NULL; \
|
|
} while(0)
|
|
#else
|
|
#define __HAL_ETH_RESET_HANDLE_STATE(__HANDLE__) do{ \
|
|
(__HANDLE__)->gState = HAL_ETH_STATE_RESET; \
|
|
} while(0)
|
|
#endif /*USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
|
|
/**
|
|
* @brief Enables the specified ETHERNET DMA interrupts.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the ETHERNET DMA interrupt sources to be
|
|
* enabled @ref ETH_DMA_Interrupts
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_DMA_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DMACIER |= (__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Disables the specified ETHERNET DMA interrupts.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the ETHERNET DMA interrupt sources to be
|
|
* disabled. @ref ETH_DMA_Interrupts
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DMACIER &= ~(__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Gets the ETHERNET DMA IT source enabled or disabled.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the interrupt source to get . @ref ETH_DMA_Interrupts
|
|
* @retval The ETH DMA IT Source enabled or disabled
|
|
*/
|
|
#define __HAL_ETH_DMA_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) \
|
|
(((__HANDLE__)->Instance->DMACIER & (__INTERRUPT__)) == (__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Gets the ETHERNET DMA IT pending bit.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the interrupt source to get . @ref ETH_DMA_Interrupts
|
|
* @retval The state of ETH DMA IT (SET or RESET)
|
|
*/
|
|
#define __HAL_ETH_DMA_GET_IT(__HANDLE__, __INTERRUPT__) \
|
|
(((__HANDLE__)->Instance->DMACSR & (__INTERRUPT__)) == (__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Clears the ETHERNET DMA IT pending bit.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the interrupt pending bit to clear. @ref ETH_DMA_Interrupts
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_DMA_CLEAR_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DMACSR = (__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Checks whether the specified ETHERNET DMA flag is set or not.
|
|
* @param __HANDLE__: ETH Handle
|
|
* @param __FLAG__: specifies the flag to check. @ref ETH_DMA_Status_Flags
|
|
* @retval The state of ETH DMA FLAG (SET or RESET).
|
|
*/
|
|
#define __HAL_ETH_DMA_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->DMACSR &( __FLAG__)) == ( __FLAG__))
|
|
|
|
/**
|
|
* @brief Clears the specified ETHERNET DMA flag.
|
|
* @param __HANDLE__: ETH Handle
|
|
* @param __FLAG__: specifies the flag to check. @ref ETH_DMA_Status_Flags
|
|
* @retval The state of ETH DMA FLAG (SET or RESET).
|
|
*/
|
|
#define __HAL_ETH_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->DMACSR = ( __FLAG__))
|
|
|
|
/**
|
|
* @brief Enables the specified ETHERNET MAC interrupts.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the ETHERNET MAC interrupt sources to be
|
|
* enabled @ref ETH_MAC_Interrupts
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_MAC_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->MACIER |= (__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Disables the specified ETHERNET MAC interrupts.
|
|
* @param __HANDLE__ : ETH Handle
|
|
* @param __INTERRUPT__: specifies the ETHERNET MAC interrupt sources to be
|
|
* enabled @ref ETH_MAC_Interrupts
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_MAC_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->MACIER &= ~(__INTERRUPT__))
|
|
|
|
/**
|
|
* @brief Checks whether the specified ETHERNET MAC flag is set or not.
|
|
* @param __HANDLE__: ETH Handle
|
|
* @param __INTERRUPT__: specifies the flag to check. @ref ETH_MAC_Interrupts
|
|
* @retval The state of ETH MAC IT (SET or RESET).
|
|
*/
|
|
#define __HAL_ETH_MAC_GET_IT(__HANDLE__, __INTERRUPT__) \
|
|
(((__HANDLE__)->Instance->MACISR &( __INTERRUPT__)) == ( __INTERRUPT__))
|
|
|
|
/*!< External interrupt line 86 Connected to the ETH wakeup EXTI Line */
|
|
#define ETH_WAKEUP_EXTI_LINE 0x00400000U /* !< 86 - 64 = 22 */
|
|
|
|
/**
|
|
* @brief Enable the ETH WAKEUP Exti Line.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be enabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_ENABLE_IT(__EXTI_LINE__) (EXTI_D1->IMR3 |= (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief checks whether the specified ETH WAKEUP Exti interrupt flag is set or not.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be cleared.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval EXTI ETH WAKEUP Line Status.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_GET_FLAG(__EXTI_LINE__) (EXTI_D1->PR3 & (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Clear the ETH WAKEUP Exti flag.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be cleared.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_CLEAR_FLAG(__EXTI_LINE__) (EXTI_D1->PR3 = (__EXTI_LINE__))
|
|
|
|
#if defined(DUAL_CORE)
|
|
/**
|
|
* @brief Enable the ETH WAKEUP Exti Line by Core2.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be enabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTID2_ENABLE_IT(__EXTI_LINE__) (EXTI_D2->IMR3 |= (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief checks whether the specified ETH WAKEUP Exti interrupt flag is set or not.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be cleared.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval EXTI ETH WAKEUP Line Status.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTID2_GET_FLAG(__EXTI_LINE__) (EXTI_D2->PR3 & (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Clear the ETH WAKEUP Exti flag.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP Exti sources to be cleared.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None.
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTID2_CLEAR_FLAG(__EXTI_LINE__) (EXTI_D2->PR3 = (__EXTI_LINE__))
|
|
#endif /* DUAL_CORE */
|
|
|
|
/**
|
|
* @brief enable rising edge interrupt on selected EXTI line.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP EXTI sources to be disabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_ENABLE_RISING_EDGE(__EXTI_LINE__) (EXTI->FTSR3 &= ~(__EXTI_LINE__)); \
|
|
(EXTI->RTSR3 |= (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief enable falling edge interrupt on selected EXTI line.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP EXTI sources to be disabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_ENABLE_FALLING_EDGE(__EXTI_LINE__) (EXTI->RTSR3 &= ~(__EXTI_LINE__));\
|
|
(EXTI->FTSR3 |= (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief enable falling edge interrupt on selected EXTI line.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP EXTI sources to be disabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_ENABLE_RISING_FALLING_EDGE(__EXTI_LINE__) (EXTI->RTSR3 |= (__EXTI_LINE__));\
|
|
(EXTI->FTSR3 |= (__EXTI_LINE__))
|
|
|
|
/**
|
|
* @brief Generates a Software interrupt on selected EXTI line.
|
|
* @param __EXTI_LINE__: specifies the ETH WAKEUP EXTI sources to be disabled.
|
|
* @arg ETH_WAKEUP_EXTI_LINE
|
|
* @retval None
|
|
*/
|
|
#define __HAL_ETH_WAKEUP_EXTI_GENERATE_SWIT(__EXTI_LINE__) (EXTI->SWIER3 |= (__EXTI_LINE__))
|
|
|
|
#define __HAL_ETH_GET_PTP_CONTROL(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->MACTSCR) & \
|
|
(__FLAG__)) == (__FLAG__)) ? SET : RESET)
|
|
|
|
#define __HAL_ETH_SET_PTP_CONTROL(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->MACTSCR |= (__FLAG__))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Include ETH HAL Extension module */
|
|
#include "stm32h7xx_hal_eth_ex.h"
|
|
|
|
/* Exported functions --------------------------------------------------------*/
|
|
|
|
/** @addtogroup ETH_Exported_Functions
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup ETH_Exported_Functions_Group1
|
|
* @{
|
|
*/
|
|
/* Initialization and de initialization functions **********************************/
|
|
HAL_StatusTypeDef HAL_ETH_Init(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_DeInit(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_MspInit(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_MspDeInit(ETH_HandleTypeDef *heth);
|
|
|
|
/* Callbacks Register/UnRegister functions ***********************************/
|
|
#if (USE_HAL_ETH_REGISTER_CALLBACKS == 1)
|
|
HAL_StatusTypeDef HAL_ETH_RegisterCallback(ETH_HandleTypeDef *heth, HAL_ETH_CallbackIDTypeDef CallbackID,
|
|
pETH_CallbackTypeDef pCallback);
|
|
HAL_StatusTypeDef HAL_ETH_UnRegisterCallback(ETH_HandleTypeDef *heth, HAL_ETH_CallbackIDTypeDef CallbackID);
|
|
#endif /* USE_HAL_ETH_REGISTER_CALLBACKS */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @addtogroup ETH_Exported_Functions_Group2
|
|
* @{
|
|
*/
|
|
/* IO operation functions *******************************************************/
|
|
HAL_StatusTypeDef HAL_ETH_Start(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_Start_IT(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_Stop(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_Stop_IT(ETH_HandleTypeDef *heth);
|
|
|
|
HAL_StatusTypeDef HAL_ETH_ReadData(ETH_HandleTypeDef *heth, void **pAppBuff);
|
|
HAL_StatusTypeDef HAL_ETH_RegisterRxAllocateCallback(ETH_HandleTypeDef *heth,
|
|
pETH_rxAllocateCallbackTypeDef rxAllocateCallback);
|
|
HAL_StatusTypeDef HAL_ETH_UnRegisterRxAllocateCallback(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_RegisterRxLinkCallback(ETH_HandleTypeDef *heth, pETH_rxLinkCallbackTypeDef rxLinkCallback);
|
|
HAL_StatusTypeDef HAL_ETH_UnRegisterRxLinkCallback(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_GetRxDataErrorCode(ETH_HandleTypeDef *heth, uint32_t *pErrorCode);
|
|
HAL_StatusTypeDef HAL_ETH_RegisterTxFreeCallback(ETH_HandleTypeDef *heth, pETH_txFreeCallbackTypeDef txFreeCallback);
|
|
HAL_StatusTypeDef HAL_ETH_UnRegisterTxFreeCallback(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_ReleaseTxPacket(ETH_HandleTypeDef *heth);
|
|
|
|
#ifdef HAL_ETH_USE_PTP
|
|
HAL_StatusTypeDef HAL_ETH_PTP_SetConfig(ETH_HandleTypeDef *heth, ETH_PTP_ConfigTypeDef *ptpconfig);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_GetConfig(ETH_HandleTypeDef *heth, ETH_PTP_ConfigTypeDef *ptpconfig);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_SetTime(ETH_HandleTypeDef *heth, ETH_TimeTypeDef *time);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_GetTime(ETH_HandleTypeDef *heth, ETH_TimeTypeDef *time);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_AddTimeOffset(ETH_HandleTypeDef *heth, ETH_PtpUpdateTypeDef ptpoffsettype,
|
|
ETH_TimeTypeDef *timeoffset);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_InsertTxTimestamp(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_GetTxTimestamp(ETH_HandleTypeDef *heth, ETH_TimeStampTypeDef *timestamp);
|
|
HAL_StatusTypeDef HAL_ETH_PTP_GetRxTimestamp(ETH_HandleTypeDef *heth, ETH_TimeStampTypeDef *timestamp);
|
|
HAL_StatusTypeDef HAL_ETH_RegisterTxPtpCallback(ETH_HandleTypeDef *heth, pETH_txPtpCallbackTypeDef txPtpCallback);
|
|
HAL_StatusTypeDef HAL_ETH_UnRegisterTxPtpCallback(ETH_HandleTypeDef *heth);
|
|
#endif /* HAL_ETH_USE_PTP */
|
|
|
|
HAL_StatusTypeDef HAL_ETH_Transmit(ETH_HandleTypeDef *heth, ETH_TxPacketConfig *pTxConfig, uint32_t Timeout);
|
|
HAL_StatusTypeDef HAL_ETH_Transmit_IT(ETH_HandleTypeDef *heth, ETH_TxPacketConfig *pTxConfig);
|
|
|
|
HAL_StatusTypeDef HAL_ETH_WritePHYRegister(ETH_HandleTypeDef *heth, uint32_t PHYAddr, uint32_t PHYReg,
|
|
uint32_t RegValue);
|
|
HAL_StatusTypeDef HAL_ETH_ReadPHYRegister(ETH_HandleTypeDef *heth, uint32_t PHYAddr, uint32_t PHYReg,
|
|
uint32_t *pRegValue);
|
|
|
|
void HAL_ETH_IRQHandler(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_TxCpltCallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_RxCpltCallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_ErrorCallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_PMTCallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_EEECallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_WakeUpCallback(ETH_HandleTypeDef *heth);
|
|
void HAL_ETH_RxAllocateCallback(uint8_t **buff);
|
|
void HAL_ETH_RxLinkCallback(void **pStart, void **pEnd, uint8_t *buff, uint16_t Length);
|
|
void HAL_ETH_TxFreeCallback(uint32_t *buff);
|
|
void HAL_ETH_TxPtpCallback(uint32_t *buff, ETH_TimeStampTypeDef *timestamp);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @addtogroup ETH_Exported_Functions_Group3
|
|
* @{
|
|
*/
|
|
/* Peripheral Control functions **********************************************/
|
|
/* MAC & DMA Configuration APIs **********************************************/
|
|
HAL_StatusTypeDef HAL_ETH_GetMACConfig(ETH_HandleTypeDef *heth, ETH_MACConfigTypeDef *macconf);
|
|
HAL_StatusTypeDef HAL_ETH_GetDMAConfig(ETH_HandleTypeDef *heth, ETH_DMAConfigTypeDef *dmaconf);
|
|
HAL_StatusTypeDef HAL_ETH_SetMACConfig(ETH_HandleTypeDef *heth, ETH_MACConfigTypeDef *macconf);
|
|
HAL_StatusTypeDef HAL_ETH_SetDMAConfig(ETH_HandleTypeDef *heth, ETH_DMAConfigTypeDef *dmaconf);
|
|
void HAL_ETH_SetMDIOClockRange(ETH_HandleTypeDef *heth);
|
|
|
|
/* MAC VLAN Processing APIs ************************************************/
|
|
void HAL_ETH_SetRxVLANIdentifier(ETH_HandleTypeDef *heth, uint32_t ComparisonBits,
|
|
uint32_t VLANIdentifier);
|
|
|
|
/* MAC L2 Packet Filtering APIs **********************************************/
|
|
HAL_StatusTypeDef HAL_ETH_GetMACFilterConfig(ETH_HandleTypeDef *heth, ETH_MACFilterConfigTypeDef *pFilterConfig);
|
|
HAL_StatusTypeDef HAL_ETH_SetMACFilterConfig(ETH_HandleTypeDef *heth, ETH_MACFilterConfigTypeDef *pFilterConfig);
|
|
HAL_StatusTypeDef HAL_ETH_SetHashTable(ETH_HandleTypeDef *heth, uint32_t *pHashTable);
|
|
HAL_StatusTypeDef HAL_ETH_SetSourceMACAddrMatch(ETH_HandleTypeDef *heth, uint32_t AddrNbr, uint8_t *pMACAddr);
|
|
|
|
/* MAC Power Down APIs *****************************************************/
|
|
void HAL_ETH_EnterPowerDownMode(ETH_HandleTypeDef *heth, ETH_PowerDownConfigTypeDef *pPowerDownConfig);
|
|
void HAL_ETH_ExitPowerDownMode(ETH_HandleTypeDef *heth);
|
|
HAL_StatusTypeDef HAL_ETH_SetWakeUpFilter(ETH_HandleTypeDef *heth, uint32_t *pFilter, uint32_t Count);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @addtogroup ETH_Exported_Functions_Group4
|
|
* @{
|
|
*/
|
|
/* Peripheral State functions **************************************************/
|
|
HAL_ETH_StateTypeDef HAL_ETH_GetState(ETH_HandleTypeDef *heth);
|
|
uint32_t HAL_ETH_GetError(ETH_HandleTypeDef *heth);
|
|
uint32_t HAL_ETH_GetDMAError(ETH_HandleTypeDef *heth);
|
|
uint32_t HAL_ETH_GetMACError(ETH_HandleTypeDef *heth);
|
|
uint32_t HAL_ETH_GetMACWakeUpSource(ETH_HandleTypeDef *heth);
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* ETH */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* STM32H7xx_HAL_ETH_H */
|
|
|
|
|