1636 lines
75 KiB
C
1636 lines
75 KiB
C
/*
|
|
* The Clear BSD License
|
|
* Copyright (c) 2015 - 2016, Freescale Semiconductor, Inc.
|
|
* Copyright 2016-2017 NXP
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted (subject to the limitations in the disclaimer below) provided
|
|
* that the following conditions are met:
|
|
*
|
|
* o Redistributions of source code must retain the above copyright notice, this list
|
|
* of conditions and the following disclaimer.
|
|
*
|
|
* o Redistributions in binary form must reproduce the above copyright notice, this
|
|
* list of conditions and the following disclaimer in the documentation and/or
|
|
* other materials provided with the distribution.
|
|
*
|
|
* o Neither the name of the copyright holder nor the names of its
|
|
* contributors may be used to endorse or promote products derived from this
|
|
* software without specific prior written permission.
|
|
*
|
|
* NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE.
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
|
|
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
|
|
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
#ifndef _FSL_ENET_H_
|
|
#define _FSL_ENET_H_
|
|
|
|
#include "fsl_common.h"
|
|
#if defined(FSL_FEATURE_MEMORY_HAS_ADDRESS_OFFSET) && FSL_FEATURE_MEMORY_HAS_ADDRESS_OFFSET
|
|
#include "fsl_memory.h"
|
|
#endif
|
|
/*!
|
|
* @addtogroup enet
|
|
* @{
|
|
*/
|
|
|
|
/*******************************************************************************
|
|
* Definitions
|
|
******************************************************************************/
|
|
|
|
/*! @name Driver version */
|
|
/*@{*/
|
|
/*! @brief Defines the driver version. */
|
|
#define FSL_ENET_DRIVER_VERSION (MAKE_VERSION(2, 2, 3)) /*!< Version 2.2.3. */
|
|
/*@}*/
|
|
|
|
/*! @name ENET DESCRIPTOR QUEUE */
|
|
/*@{*/
|
|
/*! @brief Defines the queue number. */
|
|
#ifndef FSL_FEATURE_ENET_QUEUE
|
|
#define FSL_FEATURE_ENET_QUEUE 1 /* Singal queue for previous IP. */
|
|
#endif
|
|
/*@}*/
|
|
|
|
/*! @name Control and status region bit masks of the receive buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_RX_EMPTY_MASK 0x8000U /*!< Empty bit mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_SOFTOWNER1_MASK 0x4000U /*!< Software owner one mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_WRAP_MASK 0x2000U /*!< Next buffer descriptor is the start address. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_SOFTOWNER2_Mask 0x1000U /*!< Software owner two mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_LAST_MASK 0x0800U /*!< Last BD of the frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_MISS_MASK 0x0100U /*!< Received because of the promiscuous mode. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_BROADCAST_MASK 0x0080U /*!< Broadcast packet mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_MULTICAST_MASK 0x0040U /*!< Multicast packet mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_LENVLIOLATE_MASK 0x0020U /*!< Length violation mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_NOOCTET_MASK 0x0010U /*!< Non-octet aligned frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_CRC_MASK 0x0004U /*!< CRC error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_OVERRUN_MASK 0x0002U /*!< FIFO overrun mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_TRUNC_MASK 0x0001U /*!< Frame is truncated mask. */
|
|
/*@}*/
|
|
|
|
/*! @name Control and status bit masks of the transmit buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_TX_READY_MASK 0x8000U /*!< Ready bit mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_SOFTOWENER1_MASK 0x4000U /*!< Software owner one mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_WRAP_MASK 0x2000U /*!< Wrap buffer descriptor mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_SOFTOWENER2_MASK 0x1000U /*!< Software owner two mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_LAST_MASK 0x0800U /*!< Last BD of the frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_TRANMITCRC_MASK 0x0400U /*!< Transmit CRC mask. */
|
|
/*@}*/
|
|
|
|
/* Extended control regions for enhanced buffer descriptors. */
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*! @name First extended control region bit masks of the receive buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_RX_IPV4_MASK 0x0001U /*!< Ipv4 frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_IPV6_MASK 0x0002U /*!< Ipv6 frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_VLAN_MASK 0x0004U /*!< VLAN frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_PROTOCOLCHECKSUM_MASK 0x0010U /*!< Protocol checksum error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_IPHEADCHECKSUM_MASK 0x0020U /*!< IP header checksum error mask. */
|
|
/*@}*/
|
|
|
|
/*! @name Second extended control region bit masks of the receive buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_RX_INTERRUPT_MASK 0x0080U /*!< BD interrupt mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_UNICAST_MASK 0x0100U /*!< Unicast frame mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_COLLISION_MASK 0x0200U /*!< BD collision mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_PHYERR_MASK 0x0400U /*!< PHY error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_MACERR_MASK 0x8000U /*!< Mac error mask. */
|
|
/*@}*/
|
|
|
|
/*! @name First extended control region bit masks of the transmit buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_TX_ERR_MASK 0x8000U /*!< Transmit error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_UNDERFLOWERR_MASK 0x2000U /*!< Underflow error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_EXCCOLLISIONERR_MASK 0x1000U /*!< Excess collision error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_FRAMEERR_MASK 0x0800U /*!< Frame error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_LATECOLLISIONERR_MASK 0x0400U /*!< Late collision error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_OVERFLOWERR_MASK 0x0200U /*!< Overflow error mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_TIMESTAMPERR_MASK 0x0100U /*!< Timestamp error mask. */
|
|
/*@}*/
|
|
|
|
/*! @name Second extended control region bit masks of the transmit buffer descriptor. */
|
|
/*@{*/
|
|
#define ENET_BUFFDESCRIPTOR_TX_INTERRUPT_MASK 0x4000U /*!< Interrupt mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_TIMESTAMP_MASK 0x2000U /*!< Timestamp flag mask. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
#define ENET_BUFFDESCRIPTOR_TX_USETXLAUNCHTIME_MASK 0x0100U /*!< Use the transmit launch time. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_FRAMETYPE_MASK 0x00F0U /*!< Frame type mask. */
|
|
#define ENET_BUFFDESCRIPTOR_TX_FRAMETYPE_SHIFT 4U /*!< Frame type shift. */
|
|
#define ENET_BD_FTYPE(n) ((n << ENET_BUFFDESCRIPTOR_TX_FRAMETYPE_SHIFT) & ENET_BUFFDESCRIPTOR_TX_FRAMETYPE_MASK)
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
/*@}*/
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
/*! @brief Defines the receive error status flag mask. */
|
|
#define ENET_BUFFDESCRIPTOR_RX_ERR_MASK \
|
|
(ENET_BUFFDESCRIPTOR_RX_TRUNC_MASK | ENET_BUFFDESCRIPTOR_RX_OVERRUN_MASK | \
|
|
ENET_BUFFDESCRIPTOR_RX_LENVLIOLATE_MASK | ENET_BUFFDESCRIPTOR_RX_NOOCTET_MASK | ENET_BUFFDESCRIPTOR_RX_CRC_MASK)
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
#define ENET_BUFFDESCRIPTOR_RX_EXT_ERR_MASK \
|
|
(ENET_BUFFDESCRIPTOR_RX_MACERR_MASK | ENET_BUFFDESCRIPTOR_RX_PHYERR_MASK | ENET_BUFFDESCRIPTOR_RX_COLLISION_MASK)
|
|
#endif
|
|
|
|
/*! @name Defines some Ethernet parameters. */
|
|
/*@{*/
|
|
#define ENET_FRAME_MAX_FRAMELEN 1518U /*!< Default maximum Ethernet frame size. */
|
|
|
|
#define ENET_FIFO_MIN_RX_FULL 5U /*!< ENET minimum receive FIFO full. */
|
|
#define ENET_RX_MIN_BUFFERSIZE 256U /*!< ENET minimum buffer size. */
|
|
#define ENET_PHY_MAXADDRESS (ENET_MMFR_PA_MASK >> ENET_MMFR_PA_SHIFT)
|
|
#if FSL_FEATURE_ENET_QUEUE > 1
|
|
#define ENET_TX_INTERRUPT \
|
|
(kENET_TxFrameInterrupt | kENET_TxBufferInterrupt | kENET_TxFrame1Interrupt | kENET_TxBuffer1Interrupt | \
|
|
kENET_TxFrame2Interrupt | kENET_TxBuffer2Interrupt)
|
|
#define ENET_RX_INTERRUPT \
|
|
(kENET_RxFrameInterrupt | kENET_RxBufferInterrupt | kENET_RxFrame1Interrupt | kENET_RxBuffer1Interrupt | \
|
|
kENET_RxFrame2Interrupt | kENET_RxBuffer2Interrupt)
|
|
#else
|
|
#define ENET_TX_INTERRUPT (kENET_TxFrameInterrupt | kENET_TxBufferInterrupt)
|
|
#define ENET_RX_INTERRUPT (kENET_RxFrameInterrupt | kENET_RxBufferInterrupt)
|
|
#endif /* FSL_FEATURE_ENET_QUEUE > 1 */
|
|
#define ENET_TS_INTERRUPT (kENET_TsTimerInterrupt | kENET_TsAvailInterrupt)
|
|
#define ENET_ERR_INTERRUPT \
|
|
(kENET_BabrInterrupt | kENET_BabtInterrupt | kENET_EBusERInterrupt | kENET_LateCollisionInterrupt | \
|
|
kENET_RetryLimitInterrupt | kENET_UnderrunInterrupt | kENET_PayloadRxInterrupt)
|
|
#define ENET_ERR_INTERRUPT \
|
|
(kENET_BabrInterrupt | kENET_BabtInterrupt | kENET_EBusERInterrupt | kENET_LateCollisionInterrupt | \
|
|
kENET_RetryLimitInterrupt | kENET_UnderrunInterrupt | kENET_PayloadRxInterrupt)
|
|
/*@}*/
|
|
|
|
/*! @brief Defines the status return codes for transaction. */
|
|
enum _enet_status
|
|
{
|
|
kStatus_ENET_RxFrameError = MAKE_STATUS(kStatusGroup_ENET, 0U), /*!< A frame received but data error happen. */
|
|
kStatus_ENET_RxFrameFail = MAKE_STATUS(kStatusGroup_ENET, 1U), /*!< Failed to receive a frame. */
|
|
kStatus_ENET_RxFrameEmpty = MAKE_STATUS(kStatusGroup_ENET, 2U), /*!< No frame arrive. */
|
|
kStatus_ENET_TxFrameOverLen = MAKE_STATUS(kStatusGroup_ENET, 3U), /*!< Tx frame over length. */
|
|
kStatus_ENET_TxFrameBusy = MAKE_STATUS(kStatusGroup_ENET, 4U), /*!< Tx buffer descriptors are under process. */
|
|
kStatus_ENET_TxFrameFail = MAKE_STATUS(kStatusGroup_ENET, 5U) /*!< Transmit frame fail. */
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
,
|
|
kStatus_ENET_PtpTsRingFull = MAKE_STATUS(kStatusGroup_ENET, 6U), /*!< Timestamp ring full. */
|
|
kStatus_ENET_PtpTsRingEmpty = MAKE_STATUS(kStatusGroup_ENET, 7U) /*!< Timestamp ring empty. */
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
};
|
|
|
|
/*! @brief Defines the MII/RMII/RGMII mode for data interface between the MAC and the PHY. */
|
|
typedef enum _enet_mii_mode
|
|
{
|
|
kENET_MiiMode = 0U, /*!< MII mode for data interface. */
|
|
kENET_RmiiMode = 1U, /*!< RMII mode for data interface. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
kENET_RgmiiMode = 2U /*!< RGMII mode for data interface. */
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
} enet_mii_mode_t;
|
|
|
|
/*! @brief Defines the 10/100/1000 Mbps speed for the MII data interface.
|
|
*
|
|
* Notice: "kENET_MiiSpeed1000M" only supported when mii mode is "kENET_RgmiiMode".
|
|
*/
|
|
typedef enum _enet_mii_speed
|
|
{
|
|
kENET_MiiSpeed10M = 0U, /*!< Speed 10 Mbps. */
|
|
kENET_MiiSpeed100M = 1U, /*!< Speed 100 Mbps. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
kENET_MiiSpeed1000M = 2U /*!< Speed 1000M bps. */
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
} enet_mii_speed_t;
|
|
|
|
/*! @brief Defines the half or full duplex for the MII data interface. */
|
|
typedef enum _enet_mii_duplex
|
|
{
|
|
kENET_MiiHalfDuplex = 0U, /*!< Half duplex mode. */
|
|
kENET_MiiFullDuplex /*!< Full duplex mode. */
|
|
} enet_mii_duplex_t;
|
|
|
|
/*! @brief Define the MII opcode for normal MDIO_CLAUSES_22 Frame. */
|
|
typedef enum _enet_mii_write
|
|
{
|
|
kENET_MiiWriteNoCompliant = 0U, /*!< Write frame operation, but not MII-compliant. */
|
|
kENET_MiiWriteValidFrame /*!< Write frame operation for a valid MII management frame. */
|
|
} enet_mii_write_t;
|
|
|
|
/*! @brief Defines the read operation for the MII management frame. */
|
|
typedef enum _enet_mii_read
|
|
{
|
|
kENET_MiiReadValidFrame = 2U, /*!< Read frame operation for a valid MII management frame. */
|
|
kENET_MiiReadNoCompliant = 3U /*!< Read frame operation, but not MII-compliant. */
|
|
} enet_mii_read_t;
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_EXTEND_MDIO) && FSL_FEATURE_ENET_HAS_EXTEND_MDIO
|
|
/*! @brief Define the MII opcode for extended MDIO_CLAUSES_45 Frame. */
|
|
typedef enum _enet_mii_extend_opcode
|
|
{
|
|
kENET_MiiAddrWrite_C45 = 0U, /*!< Address Write operation. */
|
|
kENET_MiiWriteFrame_C45 = 1U, /*!< Write frame operation for a valid MII management frame. */
|
|
kENET_MiiReadFrame_C45 = 3U /*!< Read frame operation for a valid MII management frame. */
|
|
} enet_mii_extend_opcode;
|
|
#endif /* FSL_FEATURE_ENET_HAS_EXTEND_MDIO */
|
|
|
|
/*! @brief Defines a special configuration for ENET MAC controller.
|
|
*
|
|
* These control flags are provided for special user requirements.
|
|
* Normally, these control flags are unused for ENET initialization.
|
|
* For special requirements, set the flags to
|
|
* macSpecialConfig in the enet_config_t.
|
|
* The kENET_ControlStoreAndFwdDisable is used to disable the FIFO store
|
|
* and forward. FIFO store and forward means that the FIFO read/send is started
|
|
* when a complete frame is stored in TX/RX FIFO. If this flag is set,
|
|
* configure rxFifoFullThreshold and txFifoWatermark
|
|
* in the enet_config_t.
|
|
*/
|
|
typedef enum _enet_special_control_flag
|
|
{
|
|
kENET_ControlFlowControlEnable = 0x0001U, /*!< Enable ENET flow control: pause frame. */
|
|
kENET_ControlRxPayloadCheckEnable = 0x0002U, /*!< Enable ENET receive payload length check. */
|
|
kENET_ControlRxPadRemoveEnable = 0x0004U, /*!< Padding is removed from received frames. */
|
|
kENET_ControlRxBroadCastRejectEnable = 0x0008U, /*!< Enable broadcast frame reject. */
|
|
kENET_ControlMacAddrInsert = 0x0010U, /*!< Enable MAC address insert. */
|
|
kENET_ControlStoreAndFwdDisable = 0x0020U, /*!< Enable FIFO store and forward. */
|
|
kENET_ControlSMIPreambleDisable = 0x0040U, /*!< Enable SMI preamble. */
|
|
kENET_ControlPromiscuousEnable = 0x0080U, /*!< Enable promiscuous mode. */
|
|
kENET_ControlMIILoopEnable = 0x0100U, /*!< Enable ENET MII loop back. */
|
|
kENET_ControlVLANTagEnable = 0x0200U, /*!< Enable normal VLAN (single vlan tag). */
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
kENET_ControlSVLANEnable = 0x0400U, /*!< Enable S-VLAN. */
|
|
kENET_ControlVLANUseSecondTag = 0x0800U /*!< Enable extracting the second vlan tag for further processing. */
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
} enet_special_control_flag_t;
|
|
|
|
/*! @brief List of interrupts supported by the peripheral. This
|
|
* enumeration uses one-bot encoding to allow a logical OR of multiple
|
|
* members. Members usually map to interrupt enable bits in one or more
|
|
* peripheral registers.
|
|
*/
|
|
typedef enum _enet_interrupt_enable
|
|
{
|
|
kENET_BabrInterrupt = ENET_EIR_BABR_MASK, /*!< Babbling receive error interrupt source */
|
|
kENET_BabtInterrupt = ENET_EIR_BABT_MASK, /*!< Babbling transmit error interrupt source */
|
|
kENET_GraceStopInterrupt = ENET_EIR_GRA_MASK, /*!< Graceful stop complete interrupt source */
|
|
kENET_TxFrameInterrupt = ENET_EIR_TXF_MASK, /*!< TX FRAME interrupt source */
|
|
kENET_TxBufferInterrupt = ENET_EIR_TXB_MASK, /*!< TX BUFFER interrupt source */
|
|
kENET_RxFrameInterrupt = ENET_EIR_RXF_MASK, /*!< RX FRAME interrupt source */
|
|
kENET_RxBufferInterrupt = ENET_EIR_RXB_MASK, /*!< RX BUFFER interrupt source */
|
|
kENET_MiiInterrupt = ENET_EIR_MII_MASK, /*!< MII interrupt source */
|
|
kENET_EBusERInterrupt = ENET_EIR_EBERR_MASK, /*!< Ethernet bus error interrupt source */
|
|
kENET_LateCollisionInterrupt = ENET_EIR_LC_MASK, /*!< Late collision interrupt source */
|
|
kENET_RetryLimitInterrupt = ENET_EIR_RL_MASK, /*!< Collision Retry Limit interrupt source */
|
|
kENET_UnderrunInterrupt = ENET_EIR_UN_MASK, /*!< Transmit FIFO underrun interrupt source */
|
|
kENET_PayloadRxInterrupt = ENET_EIR_PLR_MASK, /*!< Payload Receive error interrupt source */
|
|
kENET_WakeupInterrupt = ENET_EIR_WAKEUP_MASK, /*!< WAKEUP interrupt source */
|
|
#if FSL_FEATURE_ENET_QUEUE > 1
|
|
kENET_RxFlush2Interrupt = ENET_EIR_RXFLUSH_2_MASK, /*!< Rx DMA ring2 flush indication. */
|
|
kENET_RxFlush1Interrupt = ENET_EIR_RXFLUSH_1_MASK, /*!< Rx DMA ring1 flush indication. */
|
|
kENET_RxFlush0Interrupt = ENET_EIR_RXFLUSH_0_MASK, /*!< RX DMA ring0 flush indication. */
|
|
kENET_TxFrame2Interrupt = ENET_EIR_TXF2_MASK, /*!< Tx frame interrupt for Tx ring/class 2. */
|
|
kENET_TxBuffer2Interrupt = ENET_EIR_TXB2_MASK, /*!< Tx buffer interrupt for Tx ring/class 2. */
|
|
kENET_RxFrame2Interrupt = ENET_EIR_RXF2_MASK, /*!< Rx frame interrupt for Rx ring/class 2. */
|
|
kENET_RxBuffer2Interrupt = ENET_EIR_RXB2_MASK, /*!< Rx buffer interrupt for Rx ring/class 2. */
|
|
kENET_TxFrame1Interrupt = ENET_EIR_TXF1_MASK, /*!< Tx frame interrupt for Tx ring/class 1. */
|
|
kENET_TxBuffer1Interrupt = ENET_EIR_TXB1_MASK, /*!< Tx buffer interrupt for Tx ring/class 1. */
|
|
kENET_RxFrame1Interrupt = ENET_EIR_RXF1_MASK, /*!< Rx frame interrupt for Rx ring/class 1. */
|
|
kENET_RxBuffer1Interrupt = ENET_EIR_RXB1_MASK, /*!< Rx buffer interrupt for Rx ring/class 1. */
|
|
#endif /* FSL_FEATURE_ENET_QUEUE > 1 */
|
|
kENET_TsAvailInterrupt = ENET_EIR_TS_AVAIL_MASK, /*!< TS AVAIL interrupt source for PTP */
|
|
kENET_TsTimerInterrupt = ENET_EIR_TS_TIMER_MASK /*!< TS WRAP interrupt source for PTP */
|
|
} enet_interrupt_enable_t;
|
|
|
|
/*! @brief Defines the common interrupt event for callback use. */
|
|
typedef enum _enet_event
|
|
{
|
|
kENET_RxEvent, /*!< Receive event. */
|
|
kENET_TxEvent, /*!< Transmit event. */
|
|
kENET_ErrEvent, /*!< Error event: BABR/BABT/EBERR/LC/RL/UN/PLR . */
|
|
kENET_WakeUpEvent, /*!< Wake up from sleep mode event. */
|
|
kENET_TimeStampEvent, /*!< Time stamp event. */
|
|
kENET_TimeStampAvailEvent /*!< Time stamp available event.*/
|
|
} enet_event_t;
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
/*! @brief Defines certain idle slope for bandwidth fraction. */
|
|
typedef enum _enet_idle_slope
|
|
{
|
|
kENET_IdleSlope1 = 1U, /*!< The bandwidth fraction is about 0.002. */
|
|
kENET_IdleSlope2 = 2U, /*!< The bandwidth fraction is about 0.003. */
|
|
kENET_IdleSlope4 = 4U, /*!< The bandwidth fraction is about 0.008. */
|
|
kENET_IdleSlope8 = 8U, /*!< The bandwidth fraction is about 0.02. */
|
|
kENET_IdleSlope16 = 16U, /*!< The bandwidth fraction is about 0.03. */
|
|
kENET_IdleSlope32 = 32U, /*!< The bandwidth fraction is about 0.06. */
|
|
kENET_IdleSlope64 = 64U, /*!< The bandwidth fraction is about 0.11. */
|
|
kENET_IdleSlope128 = 128U, /*!< The bandwidth fraction is about 0.20. */
|
|
kENET_IdleSlope256 = 256U, /*!< The bandwidth fraction is about 0.33. */
|
|
kENET_IdleSlope384 = 384U, /*!< The bandwidth fraction is about 0.43. */
|
|
kENET_IdleSlope512 = 512U, /*!< The bandwidth fraction is about 0.50. */
|
|
kENET_IdleSlope640 = 640U, /*!< The bandwidth fraction is about 0.56. */
|
|
kENET_IdleSlope768 = 768U, /*!< The bandwidth fraction is about 0.60. */
|
|
kENET_IdleSlope896 = 896U, /*!< The bandwidth fraction is about 0.64. */
|
|
kENET_IdleSlope1024 = 1024U, /*!< The bandwidth fraction is about 0.67. */
|
|
kENET_IdleSlope1152 = 1152U, /*!< The bandwidth fraction is about 0.69. */
|
|
kENET_IdleSlope1280 = 1280U, /*!< The bandwidth fraction is about 0.71. */
|
|
kENET_IdleSlope1408 = 1408U, /*!< The bandwidth fraction is about 0.73. */
|
|
kENET_IdleSlope1536 = 1536U /*!< The bandwidth fraction is about 0.75. */
|
|
} enet_idle_slope_t;
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
|
|
/*! @brief Defines the transmit accelerator configuration. */
|
|
typedef enum _enet_tx_accelerator
|
|
{
|
|
kENET_TxAccelIsShift16Enabled = ENET_TACC_SHIFT16_MASK, /*!< Transmit FIFO shift-16. */
|
|
kENET_TxAccelIpCheckEnabled = ENET_TACC_IPCHK_MASK, /*!< Insert IP header checksum. */
|
|
kENET_TxAccelProtoCheckEnabled = ENET_TACC_PROCHK_MASK /*!< Insert protocol checksum. */
|
|
} enet_tx_accelerator_t;
|
|
|
|
/*! @brief Defines the receive accelerator configuration. */
|
|
typedef enum _enet_rx_accelerator
|
|
{
|
|
kENET_RxAccelPadRemoveEnabled = ENET_RACC_PADREM_MASK, /*!< Padding removal for short IP frames. */
|
|
kENET_RxAccelIpCheckEnabled = ENET_RACC_IPDIS_MASK, /*!< Discard with wrong IP header checksum. */
|
|
kENET_RxAccelProtoCheckEnabled = ENET_RACC_PRODIS_MASK, /*!< Discard with wrong protocol checksum. */
|
|
kENET_RxAccelMacCheckEnabled = ENET_RACC_LINEDIS_MASK, /*!< Discard with Mac layer errors. */
|
|
kENET_RxAccelisShift16Enabled = ENET_RACC_SHIFT16_MASK /*!< Receive FIFO shift-16. */
|
|
} enet_rx_accelerator_t;
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*! @brief Defines the ENET PTP message related constant. */
|
|
typedef enum _enet_ptp_event_type
|
|
{
|
|
kENET_PtpEventMsgType = 3U, /*!< PTP event message type. */
|
|
kENET_PtpSrcPortIdLen = 10U, /*!< PTP message sequence id length. */
|
|
kENET_PtpEventPort = 319U, /*!< PTP event port number. */
|
|
kENET_PtpGnrlPort = 320U /*!< PTP general port number. */
|
|
} enet_ptp_event_type_t;
|
|
|
|
/*! @brief Defines the IEEE 1588 PTP timer channel numbers. */
|
|
typedef enum _enet_ptp_timer_channel
|
|
{
|
|
kENET_PtpTimerChannel1 = 0U, /*!< IEEE 1588 PTP timer Channel 1. */
|
|
kENET_PtpTimerChannel2, /*!< IEEE 1588 PTP timer Channel 2. */
|
|
kENET_PtpTimerChannel3, /*!< IEEE 1588 PTP timer Channel 3. */
|
|
kENET_PtpTimerChannel4 /*!< IEEE 1588 PTP timer Channel 4. */
|
|
} enet_ptp_timer_channel_t;
|
|
|
|
/*! @brief Defines the capture or compare mode for IEEE 1588 PTP timer channels. */
|
|
typedef enum _enet_ptp_timer_channel_mode
|
|
{
|
|
kENET_PtpChannelDisable = 0U, /*!< Disable timer channel. */
|
|
kENET_PtpChannelRisingCapture = 1U, /*!< Input capture on rising edge. */
|
|
kENET_PtpChannelFallingCapture = 2U, /*!< Input capture on falling edge. */
|
|
kENET_PtpChannelBothCapture = 3U, /*!< Input capture on both edges. */
|
|
kENET_PtpChannelSoftCompare = 4U, /*!< Output compare software only. */
|
|
kENET_PtpChannelToggleCompare = 5U, /*!< Toggle output on compare. */
|
|
kENET_PtpChannelClearCompare = 6U, /*!< Clear output on compare. */
|
|
kENET_PtpChannelSetCompare = 7U, /*!< Set output on compare. */
|
|
kENET_PtpChannelClearCompareSetOverflow = 10U, /*!< Clear output on compare, set output on overflow. */
|
|
kENET_PtpChannelSetCompareClearOverflow = 11U, /*!< Set output on compare, clear output on overflow. */
|
|
kENET_PtpChannelPulseLowonCompare = 14U, /*!< Pulse output low on compare for one IEEE 1588 clock cycle. */
|
|
kENET_PtpChannelPulseHighonCompare = 15U /*!< Pulse output high on compare for one IEEE 1588 clock cycle. */
|
|
} enet_ptp_timer_channel_mode_t;
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
/*! @brief Defines the receive buffer descriptor structure for the little endian system.*/
|
|
typedef struct _enet_rx_bd_struct
|
|
{
|
|
uint16_t length; /*!< Buffer descriptor data length. */
|
|
uint16_t control; /*!< Buffer descriptor control and status. */
|
|
uint8_t *buffer; /*!< Data buffer pointer. */
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
uint16_t controlExtend0; /*!< Extend buffer descriptor control0. */
|
|
uint16_t controlExtend1; /*!< Extend buffer descriptor control1. */
|
|
uint16_t payloadCheckSum; /*!< Internal payload checksum. */
|
|
uint8_t headerLength; /*!< Header length. */
|
|
uint8_t protocolTyte; /*!< Protocol type. */
|
|
uint16_t reserved0;
|
|
uint16_t controlExtend2; /*!< Extend buffer descriptor control2. */
|
|
uint32_t timestamp; /*!< Timestamp. */
|
|
uint16_t reserved1;
|
|
uint16_t reserved2;
|
|
uint16_t reserved3;
|
|
uint16_t reserved4;
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
} enet_rx_bd_struct_t;
|
|
|
|
/*! @brief Defines the enhanced transmit buffer descriptor structure for the little endian system. */
|
|
typedef struct _enet_tx_bd_struct
|
|
{
|
|
uint16_t length; /*!< Buffer descriptor data length. */
|
|
uint16_t control; /*!< Buffer descriptor control and status. */
|
|
uint8_t *buffer; /*!< Data buffer pointer. */
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
uint16_t controlExtend0; /*!< Extend buffer descriptor control0. */
|
|
uint16_t controlExtend1; /*!< Extend buffer descriptor control1. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
int8_t *txLaunchTime; /*!< Transmit launch time. */
|
|
#else
|
|
uint16_t reserved0;
|
|
uint16_t reserved1;
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
uint16_t reserved2;
|
|
uint16_t controlExtend2; /*!< Extend buffer descriptor control2. */
|
|
uint32_t timestamp; /*!< Timestamp. */
|
|
uint16_t reserved3;
|
|
uint16_t reserved4;
|
|
uint16_t reserved5;
|
|
uint16_t reserved6;
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
} enet_tx_bd_struct_t;
|
|
|
|
/*! @brief Defines the ENET data error statistics structure. */
|
|
typedef struct _enet_data_error_stats
|
|
{
|
|
uint32_t statsRxLenGreaterErr; /*!< Receive length greater than RCR[MAX_FL]. */
|
|
uint32_t statsRxAlignErr; /*!< Receive non-octet alignment/ */
|
|
uint32_t statsRxFcsErr; /*!< Receive CRC error. */
|
|
uint32_t statsRxOverRunErr; /*!< Receive over run. */
|
|
uint32_t statsRxTruncateErr; /*!< Receive truncate. */
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
uint32_t statsRxProtocolChecksumErr; /*!< Receive protocol checksum error. */
|
|
uint32_t statsRxIpHeadChecksumErr; /*!< Receive IP header checksum error. */
|
|
uint32_t statsRxMacErr; /*!< Receive Mac error. */
|
|
uint32_t statsRxPhyErr; /*!< Receive PHY error. */
|
|
uint32_t statsRxCollisionErr; /*!< Receive collision. */
|
|
uint32_t statsTxErr; /*!< The error happen when transmit the frame. */
|
|
uint32_t statsTxFrameErr; /*!< The transmit frame is error. */
|
|
uint32_t statsTxOverFlowErr; /*!< Transmit overflow. */
|
|
uint32_t statsTxLateCollisionErr; /*!< Transmit late collision. */
|
|
uint32_t statsTxExcessCollisionErr; /*!< Transmit excess collision.*/
|
|
uint32_t statsTxUnderFlowErr; /*!< Transmit under flow error. */
|
|
uint32_t statsTxTsErr; /*!< Transmit time stamp error. */
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
} enet_data_error_stats_t;
|
|
|
|
/*! @brief Defines the receive buffer descriptor configuration structure.
|
|
*
|
|
* Note that for the internal DMA requirements, the buffers have a corresponding alignment requirements.
|
|
* 1. The aligned receive and transmit buffer size must be evenly divisible by ENET_BUFF_ALIGNMENT.
|
|
* when the data buffers are in cacheable region when cache is enabled, all those size should be
|
|
* aligned to the maximum value of "ENET_BUFF_ALIGNMENT" and the cache line size.
|
|
* 2. The aligned transmit and receive buffer descriptor start address must be at
|
|
* least 64 bit aligned. However, it's recommended to be evenly divisible by ENET_BUFF_ALIGNMENT.
|
|
* buffer descriptors should be put in non-cacheable region when cache is enabled.
|
|
* 3. The aligned transmit and receive data buffer start address must be evenly divisible by ENET_BUFF_ALIGNMENT.
|
|
* Receive buffers should be continuous with the total size equal to "rxBdNumber * rxBuffSizeAlign".
|
|
* Transmit buffers should be continuous with the total size equal to "txBdNumber * txBuffSizeAlign".
|
|
* when the data buffers are in cacheable region when cache is enabled, all those size should be
|
|
* aligned to the maximum value of "ENET_BUFF_ALIGNMENT" and the cache line size.
|
|
*/
|
|
typedef struct _enet_buffer_config
|
|
{
|
|
uint16_t rxBdNumber; /*!< Receive buffer descriptor number. */
|
|
uint16_t txBdNumber; /*!< Transmit buffer descriptor number. */
|
|
uint32_t rxBuffSizeAlign; /*!< Aligned receive data buffer size. */
|
|
uint32_t txBuffSizeAlign; /*!< Aligned transmit data buffer size. */
|
|
volatile enet_rx_bd_struct_t
|
|
*rxBdStartAddrAlign; /*!< Aligned receive buffer descriptor start address: should be non-cacheable. */
|
|
volatile enet_tx_bd_struct_t
|
|
*txBdStartAddrAlign; /*!< Aligned transmit buffer descriptor start address: should be non-cacheable. */
|
|
uint8_t *rxBufferAlign; /*!< Receive data buffer start address. */
|
|
uint8_t *txBufferAlign; /*!< Transmit data buffer start address. */
|
|
} enet_buffer_config_t;
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*! @brief Defines the ENET PTP time stamp structure. */
|
|
typedef struct _enet_ptp_time
|
|
{
|
|
uint64_t second; /*!< Second. */
|
|
uint32_t nanosecond; /*!< Nanosecond. */
|
|
} enet_ptp_time_t;
|
|
|
|
/*! @brief Defines the structure for the ENET PTP message data and timestamp data.*/
|
|
typedef struct _enet_ptp_time_data
|
|
{
|
|
uint8_t version; /*!< PTP version. */
|
|
uint8_t sourcePortId[kENET_PtpSrcPortIdLen]; /*!< PTP source port ID. */
|
|
uint16_t sequenceId; /*!< PTP sequence ID. */
|
|
uint8_t messageType; /*!< PTP message type. */
|
|
enet_ptp_time_t timeStamp; /*!< PTP timestamp. */
|
|
} enet_ptp_time_data_t;
|
|
|
|
/*! @brief Defines the ENET PTP ring buffer structure for the PTP message timestamp store.*/
|
|
typedef struct _enet_ptp_time_data_ring
|
|
{
|
|
uint32_t front; /*!< The first index of the ring. */
|
|
uint32_t end; /*!< The end index of the ring. */
|
|
uint32_t size; /*!< The size of the ring. */
|
|
enet_ptp_time_data_t *ptpTsData; /*!< PTP message data structure. */
|
|
} enet_ptp_time_data_ring_t;
|
|
|
|
/*! @brief Defines the ENET PTP configuration structure. */
|
|
typedef struct _enet_ptp_config
|
|
{
|
|
uint8_t ptpTsRxBuffNum; /*!< Receive 1588 timestamp buffer number*/
|
|
uint8_t ptpTsTxBuffNum; /*!< Transmit 1588 timestamp buffer number*/
|
|
enet_ptp_time_data_t *rxPtpTsData; /*!< The start address of 1588 receive timestamp buffers */
|
|
enet_ptp_time_data_t *txPtpTsData; /*!< The start address of 1588 transmit timestamp buffers */
|
|
enet_ptp_timer_channel_t channel; /*!< Used for ERRATA_2579: the PTP 1588 timer channel for time interrupt. */
|
|
uint32_t ptp1588ClockSrc_Hz; /*!< The clock source of the PTP 1588 timer. */
|
|
} enet_ptp_config_t;
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE) && FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE
|
|
/*! @brief Defines the interrupt coalescing configure structure. */
|
|
typedef struct _enet_intcoalesce_config
|
|
{
|
|
uint8_t txCoalesceFrameCount[FSL_FEATURE_ENET_QUEUE]; /*!< Transmit interrupt coalescing frame count threshold. */
|
|
uint16_t txCoalesceTimeCount[FSL_FEATURE_ENET_QUEUE]; /*!< Transmit interrupt coalescing timer count threshold. */
|
|
uint8_t rxCoalesceFrameCount[FSL_FEATURE_ENET_QUEUE]; /*!< Receive interrupt coalescing frame count threshold. */
|
|
uint16_t rxCoalesceTimeCount[FSL_FEATURE_ENET_QUEUE]; /*!< Receive interrupt coalescing timer count threshold. */
|
|
} enet_intcoalesce_config_t;
|
|
#endif /* FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE */
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
/*! @brief Defines the ENET AVB Configure structure.
|
|
*
|
|
* This is used for to configure the extended ring 1 and ring 2.
|
|
* 1. The classification match format is (CMP3 << 12) | (CMP2 << 8) | (CMP1 << 4) | CMP0.
|
|
* composed of four 3-bit compared VLAN priority field cmp0~cmp3, cm0 ~ cmp3 are used in parallel.
|
|
*
|
|
* If CMP1,2,3 are not unused, please set them to the same value as CMP0.
|
|
* 2. The idleSlope is used to calculate the Band Width fraction, BW fraction = 1 / (1 + 512/idleSlope).
|
|
* For avb configuration, the BW fraction of Class 1 and Class 2 combined must not exceed 0.75.
|
|
*/
|
|
typedef struct _enet_avb_config
|
|
{
|
|
uint16_t rxClassifyMatch[FSL_FEATURE_ENET_QUEUE - 1]; /*!< The classification match value for the ring. */
|
|
enet_idle_slope_t idleSlope[FSL_FEATURE_ENET_QUEUE - 1]; /*!< The idle slope for certian bandwidth fraction. */
|
|
} enet_avb_config_t;
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
|
|
/*! @brief Defines the basic configuration structure for the ENET device.
|
|
*
|
|
* Note:
|
|
* 1. macSpecialConfig is used for a special control configuration, A logical OR of
|
|
* "enet_special_control_flag_t". For a special configuration for MAC,
|
|
* set this parameter to 0.
|
|
* 2. txWatermark is used for a cut-through operation. It is in steps of 64 bytes:
|
|
* 0/1 - 64 bytes written to TX FIFO before transmission of a frame begins.
|
|
* 2 - 128 bytes written to TX FIFO ....
|
|
* 3 - 192 bytes written to TX FIFO ....
|
|
* The maximum of txWatermark is 0x2F - 4032 bytes written to TX FIFO ....
|
|
* txWatermark allows minimizing the transmit latency to set the txWatermark to 0 or 1
|
|
* or for larger bus access latency 3 or larger due to contention for the system bus.
|
|
* 3. rxFifoFullThreshold is similar to the txWatermark for cut-through operation in RX.
|
|
* It is in 64-bit words. The minimum is ENET_FIFO_MIN_RX_FULL and the maximum is 0xFF.
|
|
* If the end of the frame is stored in FIFO and the frame size if smaller than the
|
|
* txWatermark, the frame is still transmitted. The rule is the
|
|
* same for rxFifoFullThreshold in the receive direction.
|
|
* 4. When "kENET_ControlFlowControlEnable" is set in the macSpecialConfig, ensure
|
|
* that the pauseDuration, rxFifoEmptyThreshold, and rxFifoStatEmptyThreshold
|
|
* are set for flow control enabled case.
|
|
* 5. When "kENET_ControlStoreAndFwdDisabled" is set in the macSpecialConfig, ensure
|
|
* that the rxFifoFullThreshold and txFifoWatermark are set for store and forward disable.
|
|
* 6. The rxAccelerConfig and txAccelerConfig default setting with 0 - accelerator
|
|
* are disabled. The "enet_tx_accelerator_t" and "enet_rx_accelerator_t" are
|
|
* recommended to be used to enable the transmit and receive accelerator.
|
|
* After the accelerators are enabled, the store and forward feature should be enabled.
|
|
* As a result, kENET_ControlStoreAndFwdDisabled should not be set.
|
|
* 7. The intCoalesceCfg can be used in the rx or tx enabled cases to decrese the CPU loading.
|
|
*/
|
|
typedef struct _enet_config
|
|
{
|
|
uint32_t macSpecialConfig; /*!< Mac special configuration. A logical OR of "enet_special_control_flag_t". */
|
|
uint32_t interrupt; /*!< Mac interrupt source. A logical OR of "enet_interrupt_enable_t". */
|
|
uint16_t rxMaxFrameLen; /*!< Receive maximum frame length. */
|
|
enet_mii_mode_t miiMode; /*!< MII mode. */
|
|
enet_mii_speed_t miiSpeed; /*!< MII Speed. */
|
|
enet_mii_duplex_t miiDuplex; /*!< MII duplex. */
|
|
uint8_t rxAccelerConfig; /*!< Receive accelerator, A logical OR of "enet_rx_accelerator_t". */
|
|
uint8_t txAccelerConfig; /*!< Transmit accelerator, A logical OR of "enet_rx_accelerator_t". */
|
|
uint16_t pauseDuration; /*!< For flow control enabled case: Pause duration. */
|
|
uint8_t rxFifoEmptyThreshold; /*!< For flow control enabled case: when RX FIFO level reaches this value,
|
|
it makes MAC generate XOFF pause frame. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_RECEIVE_STATUS_THRESHOLD) && FSL_FEATURE_ENET_HAS_RECEIVE_STATUS_THRESHOLD
|
|
uint8_t rxFifoStatEmptyThreshold; /*!< For flow control enabled case: number of frames in the receive FIFO,
|
|
independent of size, that can be accept. If the limit is reached, reception
|
|
continues and a pause frame is triggered. */
|
|
#endif /* FSL_FEATURE_ENET_HAS_RECEIVE_STATUS_THRESHOLD */
|
|
uint8_t rxFifoFullThreshold; /*!< For store and forward disable case, the data required in RX FIFO to notify
|
|
the MAC receive ready status. */
|
|
uint8_t txFifoWatermark; /*!< For store and forward disable case, the data required in TX FIFO
|
|
before a frame transmit start. */
|
|
#if defined(FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE) && FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE
|
|
enet_intcoalesce_config_t
|
|
*intCoalesceCfg; /* If the interrupt coalsecence is not required in the ring n(0,1,2), please set
|
|
to NULL. */
|
|
#endif /* FSL_FEATURE_ENET_HAS_INTERRUPT_COALESCE */
|
|
uint8_t ringNum; /*!< Number of used rings. default with 1 -- single ring. */
|
|
} enet_config_t;
|
|
|
|
/* Forward declaration of the handle typedef. */
|
|
typedef struct _enet_handle enet_handle_t;
|
|
|
|
/*! @brief ENET callback function. */
|
|
#if FSL_FEATURE_ENET_QUEUE > 1
|
|
typedef void (*enet_callback_t)(
|
|
ENET_Type *base, enet_handle_t *handle, uint32_t ringId, enet_event_t event, void *userData);
|
|
#else
|
|
typedef void (*enet_callback_t)(ENET_Type *base, enet_handle_t *handle, enet_event_t event, void *userData);
|
|
#endif /* FSL_FEATURE_ENET_QUEUE > 1 */
|
|
|
|
/*! @brief Defines the ENET handler structure. */
|
|
struct _enet_handle
|
|
{
|
|
volatile enet_rx_bd_struct_t
|
|
*rxBdBase[FSL_FEATURE_ENET_QUEUE]; /*!< Receive buffer descriptor base address pointer. */
|
|
volatile enet_rx_bd_struct_t
|
|
*rxBdCurrent[FSL_FEATURE_ENET_QUEUE]; /*!< The current available receive buffer descriptor pointer. */
|
|
volatile enet_tx_bd_struct_t
|
|
*txBdBase[FSL_FEATURE_ENET_QUEUE]; /*!< Transmit buffer descriptor base address pointer. */
|
|
volatile enet_tx_bd_struct_t
|
|
*txBdCurrent[FSL_FEATURE_ENET_QUEUE]; /*!< The current available transmit buffer descriptor pointer. */
|
|
uint32_t rxBuffSizeAlign[FSL_FEATURE_ENET_QUEUE]; /*!< Receive buffer size alignment. */
|
|
uint32_t txBuffSizeAlign[FSL_FEATURE_ENET_QUEUE]; /*!< Transmit buffer size alignment. */
|
|
uint8_t ringNum; /*!< Number of used rings. */
|
|
enet_callback_t callback; /*!< Callback function. */
|
|
void *userData; /*!< Callback function parameter.*/
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
volatile enet_tx_bd_struct_t
|
|
*txBdDirtyStatic[FSL_FEATURE_ENET_QUEUE]; /*!< The dirty transmit buffer descriptor for error static update. */
|
|
volatile enet_tx_bd_struct_t
|
|
*txBdDirtyTime[FSL_FEATURE_ENET_QUEUE]; /*!< The dirty transmit buffer descriptor for time stamp update. */
|
|
uint64_t msTimerSecond; /*!< The second for Master PTP timer .*/
|
|
enet_ptp_time_data_ring_t rxPtpTsDataRing; /*!< Receive PTP 1588 time stamp data ring buffer. */
|
|
enet_ptp_time_data_ring_t txPtpTsDataRing; /*!< Transmit PTP 1588 time stamp data ring buffer. */
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
};
|
|
|
|
/*******************************************************************************
|
|
* API
|
|
******************************************************************************/
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*!
|
|
* @name Initialization and De-initialization
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Gets the ENET default configuration structure.
|
|
*
|
|
* The purpose of this API is to get the default ENET MAC controller
|
|
* configure structure for ENET_Init(). User may use the initialized
|
|
* structure unchanged in ENET_Init(), or modify some fields of the
|
|
* structure before calling ENET_Init().
|
|
* Example:
|
|
@code
|
|
enet_config_t config;
|
|
ENET_GetDefaultConfig(&config);
|
|
@endcode
|
|
* @param config The ENET mac controller configuration structure pointer.
|
|
*/
|
|
void ENET_GetDefaultConfig(enet_config_t *config);
|
|
|
|
/*!
|
|
* @brief Initializes the ENET module.
|
|
*
|
|
* This function ungates the module clock and initializes it with the ENET configuration.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle ENET handler pointer.
|
|
* @param config ENET mac configuration structure pointer.
|
|
* The "enet_config_t" type mac configuration return from ENET_GetDefaultConfig
|
|
* can be used directly. It is also possible to verify the Mac configuration using other methods.
|
|
* @param bufferConfig ENET buffer configuration structure pointer.
|
|
* The buffer configuration should be prepared for ENET Initialization.
|
|
* It is the start address of "ringNum" enet_buffer_config structures.
|
|
* To support added multi-ring features in some soc and compatible with the previous
|
|
* enet driver version. For single ring supported, this bufferConfig is a buffer
|
|
* configure structure pointer, for multi-ring supported and used case, this bufferConfig
|
|
* pointer should be a buffer configure structure array pointer.
|
|
* @param macAddr ENET mac address of Ethernet device. This MAC address should be
|
|
* provided.
|
|
* @param srcClock_Hz The internal module clock source for MII clock.
|
|
*
|
|
* @note ENET has two buffer descriptors legacy buffer descriptors and
|
|
* enhanced IEEE 1588 buffer descriptors. The legacy descriptor is used by default. To
|
|
* use the IEEE 1588 feature, use the enhanced IEEE 1588 buffer descriptor
|
|
* by defining "ENET_ENHANCEDBUFFERDESCRIPTOR_MODE" and calling ENET_Ptp1588Configure()
|
|
* to configure the 1588 feature and related buffers after calling ENET_Init().
|
|
*/
|
|
void ENET_Init(ENET_Type *base,
|
|
enet_handle_t *handle,
|
|
const enet_config_t *config,
|
|
const enet_buffer_config_t *bufferConfig,
|
|
uint8_t *macAddr,
|
|
uint32_t srcClock_Hz);
|
|
/*!
|
|
* @brief Deinitializes the ENET module.
|
|
|
|
* This function gates the module clock, clears ENET interrupts, and disables the ENET module.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
void ENET_Deinit(ENET_Type *base);
|
|
|
|
/*!
|
|
* @brief Resets the ENET module.
|
|
*
|
|
* This function restores the ENET module to reset state.
|
|
* Note that this function sets all registers to
|
|
* reset state. As a result, the ENET module can't work after calling this function.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
static inline void ENET_Reset(ENET_Type *base)
|
|
{
|
|
base->ECR |= ENET_ECR_RESET_MASK;
|
|
}
|
|
|
|
/* @} */
|
|
|
|
/*!
|
|
* @name MII interface operation
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Sets the ENET MII speed and duplex.
|
|
*
|
|
* This API is provided to dynamically change the speed and dulpex for MAC.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param speed The speed of the RMII mode.
|
|
* @param duplex The duplex of the RMII mode.
|
|
*/
|
|
void ENET_SetMII(ENET_Type *base, enet_mii_speed_t speed, enet_mii_duplex_t duplex);
|
|
|
|
/*!
|
|
* @brief Sets the ENET SMI(serial management interface)- MII management interface.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param srcClock_Hz This is the ENET module clock frequency. Normally it's the system clock. See clock distribution.
|
|
* @param isPreambleDisabled The preamble disable flag.
|
|
* - true Enables the preamble.
|
|
* - false Disables the preamble.
|
|
*/
|
|
void ENET_SetSMI(ENET_Type *base, uint32_t srcClock_Hz, bool isPreambleDisabled);
|
|
|
|
/*!
|
|
* @brief Gets the ENET SMI- MII management interface configuration.
|
|
*
|
|
* This API is used to get the SMI configuration to check whether the MII management
|
|
* interface has been set.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @return The SMI setup status true or false.
|
|
*/
|
|
static inline bool ENET_GetSMI(ENET_Type *base)
|
|
{
|
|
return (0 != (base->MSCR & 0x7E));
|
|
}
|
|
|
|
/*!
|
|
* @brief Reads data from the PHY register through an SMI interface.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @return The data read from PHY
|
|
*/
|
|
static inline uint32_t ENET_ReadSMIData(ENET_Type *base)
|
|
{
|
|
return (uint32_t)((base->MMFR & ENET_MMFR_DATA_MASK) >> ENET_MMFR_DATA_SHIFT);
|
|
}
|
|
|
|
/*!
|
|
* @brief Starts an SMI (Serial Management Interface) read command.
|
|
*
|
|
* Used for standard IEEE802.3 MDIO Clause 22 format.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param phyAddr The PHY address.
|
|
* @param phyReg The PHY register. Range from 0 ~ 31.
|
|
* @param operation The read operation.
|
|
*/
|
|
void ENET_StartSMIRead(ENET_Type *base, uint32_t phyAddr, uint32_t phyReg, enet_mii_read_t operation);
|
|
|
|
/*!
|
|
* @brief Starts an SMI write command.
|
|
*
|
|
* Used for standard IEEE802.3 MDIO Clause 22 format.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param phyAddr The PHY address.
|
|
* @param phyReg The PHY register. Range from 0 ~ 31.
|
|
* @param operation The write operation.
|
|
* @param data The data written to PHY.
|
|
*/
|
|
void ENET_StartSMIWrite(ENET_Type *base, uint32_t phyAddr, uint32_t phyReg, enet_mii_write_t operation, uint32_t data);
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_EXTEND_MDIO) && FSL_FEATURE_ENET_HAS_EXTEND_MDIO
|
|
/*!
|
|
* @brief Starts the extended IEEE802.3 Clause 45 MDIO format SMI read command.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param phyAddr The PHY address.
|
|
* @param phyReg The PHY register. For MDIO IEEE802.3 Clause 45,
|
|
* the phyReg is a 21-bits combination of the devaddr (5 bits device address)
|
|
* and the regAddr (16 bits phy register): phyReg = (devaddr << 16) | regAddr.
|
|
*/
|
|
void ENET_StartExtC45SMIRead(ENET_Type *base, uint32_t phyAddr, uint32_t phyReg);
|
|
|
|
/*!
|
|
* @brief Starts the extended IEEE802.3 Clause 45 MDIO format SMI write command.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param phyAddr The PHY address.
|
|
* @param phyReg The PHY register. For MDIO IEEE802.3 Clause 45,
|
|
* the phyReg is a 21-bits combination of the devaddr (5 bits device address)
|
|
* and the regAddr (16 bits phy register): phyReg = (devaddr << 16) | regAddr.
|
|
* @param data The data written to PHY.
|
|
*/
|
|
void ENET_StartExtC45SMIWrite(ENET_Type *base, uint32_t phyAddr, uint32_t phyReg, uint32_t data);
|
|
#endif /* FSL_FEATURE_ENET_HAS_EXTEND_MDIO */
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
/*!
|
|
* @brief Control the usage of the delayed tx/rx RGMII clock.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param txEnabled Enable or disable to generate the delayed version of RGMII_TXC.
|
|
* @param rxEnabled Enable or disable to use the delayed version of RGMII_RXC.
|
|
*/
|
|
|
|
static inline void ENET_SetRGMIIClockDelay(ENET_Type *base, bool txEnabled, bool rxEnabled)
|
|
{
|
|
uint32_t ecrReg = base->ECR;
|
|
|
|
/* Set for transmit clock delay. */
|
|
if (txEnabled)
|
|
{
|
|
ecrReg |= ENET_ECR_TXC_DLY_MASK;
|
|
}
|
|
else
|
|
{
|
|
ecrReg &= ~ENET_ECR_TXC_DLY_MASK;
|
|
}
|
|
|
|
/* Set for receive clock delay. */
|
|
if (rxEnabled)
|
|
{
|
|
ecrReg |= ENET_ECR_RXC_DLY_MASK;
|
|
}
|
|
else
|
|
{
|
|
ecrReg &= ~ENET_ECR_RXC_DLY_MASK;
|
|
}
|
|
}
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
/* @} */
|
|
|
|
/*!
|
|
* @name MAC Address Filter
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Sets the ENET module Mac address.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param macAddr The six-byte Mac address pointer.
|
|
* The pointer is allocated by application and input into the API.
|
|
*/
|
|
void ENET_SetMacAddr(ENET_Type *base, uint8_t *macAddr);
|
|
|
|
/*!
|
|
* @brief Gets the ENET module Mac address.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param macAddr The six-byte Mac address pointer.
|
|
* The pointer is allocated by application and input into the API.
|
|
*/
|
|
void ENET_GetMacAddr(ENET_Type *base, uint8_t *macAddr);
|
|
|
|
/*!
|
|
* @brief Adds the ENET device to a multicast group.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param address The six-byte multicast group address which is provided by application.
|
|
*/
|
|
void ENET_AddMulticastGroup(ENET_Type *base, uint8_t *address);
|
|
|
|
/*!
|
|
* @brief Moves the ENET device from a multicast group.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param address The six-byte multicast group address which is provided by application.
|
|
*/
|
|
void ENET_LeaveMulticastGroup(ENET_Type *base, uint8_t *address);
|
|
|
|
/* @} */
|
|
|
|
/*!
|
|
* @name Other basic operation
|
|
* @{
|
|
*/
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
#if defined(FSL_FEATURE_ENET_HAS_AVB) && FSL_FEATURE_ENET_HAS_AVB
|
|
/*!
|
|
* @brief Sets the ENET AVB feature.
|
|
*
|
|
* ENET AVB feature configuration, set the Receive classification match and transmit
|
|
* bandwidth. This API is called when the AVB feature is required.
|
|
*
|
|
* Note: The AVB frames transmission scheme is credit-based tx scheme and it's only supported
|
|
* with the Enhanced buffer descriptors. so the AVB configuration should only done with
|
|
* Enhanced buffer descriptor. so when the AVB feature is required, please make sure the
|
|
* the "ENET_ENHANCEDBUFFERDESCRIPTOR_MODE" is defined.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle ENET handler pointer.
|
|
* @param config The ENET AVB feature configuration structure.
|
|
*/
|
|
void ENET_AVBConfigure(ENET_Type *base, enet_handle_t *handle, const enet_avb_config_t *config);
|
|
#endif /* FSL_FEATURE_ENET_HAS_AVB */
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
/*!
|
|
* @brief Activates ENET read or receive.
|
|
*
|
|
* This function is to active the enet read process. It is
|
|
* used for single descriptor ring/queue.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*
|
|
* @note This must be called after the MAC configuration and
|
|
* state are ready. It must be called after the ENET_Init() and
|
|
* ENET_Ptp1588Configure(). This should be called when the ENET receive required.
|
|
*/
|
|
static inline void ENET_ActiveRead(ENET_Type *base)
|
|
{
|
|
base->RDAR = ENET_RDAR_RDAR_MASK;
|
|
}
|
|
|
|
#if FSL_FEATURE_ENET_QUEUE > 1
|
|
/*!
|
|
* @brief Activates ENET read or receive for multiple-queue/ring.
|
|
*
|
|
* This function is to active the enet read process. It is
|
|
* used for extended multiple descriptor rings/queues.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*
|
|
* @note This must be called after the MAC configuration and
|
|
* state are ready. It must be called after the ENET_Init() and
|
|
* ENET_Ptp1588Configure(). This should be called when the ENET receive required.
|
|
*/
|
|
static inline void ENET_ActiveReadMultiRing(ENET_Type *base)
|
|
{
|
|
base->RDAR = ENET_RDAR_RDAR_MASK;
|
|
base->RDAR1 = ENET_RDAR1_RDAR_MASK;
|
|
base->RDAR2 = ENET_RDAR2_RDAR_MASK;
|
|
}
|
|
#endif /* FSL_FEATURE_ENET_QUEUE > 1 */
|
|
|
|
/*!
|
|
* @brief Enables/disables the MAC to enter sleep mode.
|
|
* This function is used to set the MAC enter sleep mode.
|
|
* When entering sleep mode, the magic frame wakeup interrupt should be enabled
|
|
* to wake up MAC from the sleep mode and reset it to normal mode.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param enable True enable sleep mode, false disable sleep mode.
|
|
*/
|
|
static inline void ENET_EnableSleepMode(ENET_Type *base, bool enable)
|
|
{
|
|
if (enable)
|
|
{
|
|
/* When this field is set, MAC enters sleep mode. */
|
|
base->ECR |= ENET_ECR_SLEEP_MASK | ENET_ECR_MAGICEN_MASK;
|
|
}
|
|
else
|
|
{ /* MAC exits sleep mode. */
|
|
base->ECR &= ~(ENET_ECR_SLEEP_MASK | ENET_ECR_MAGICEN_MASK);
|
|
}
|
|
}
|
|
|
|
/*!
|
|
* @brief Gets ENET transmit and receive accelerator functions from MAC controller.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param txAccelOption The transmit accelerator option. The "enet_tx_accelerator_t" is
|
|
* recommended to be used to as the mask to get the exact the accelerator option.
|
|
* @param rxAccelOption The receive accelerator option. The "enet_rx_accelerator_t" is
|
|
* recommended to be used to as the mask to get the exact the accelerator option.
|
|
*/
|
|
static inline void ENET_GetAccelFunction(ENET_Type *base, uint32_t *txAccelOption, uint32_t *rxAccelOption)
|
|
{
|
|
assert(txAccelOption);
|
|
assert(txAccelOption);
|
|
|
|
*txAccelOption = base->TACC;
|
|
*rxAccelOption = base->RACC;
|
|
}
|
|
|
|
/* @} */
|
|
|
|
/*!
|
|
* @name Interrupts.
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Enables the ENET interrupt.
|
|
*
|
|
* This function enables the ENET interrupt according to the provided mask. The mask
|
|
* is a logical OR of enumeration members. See @ref enet_interrupt_enable_t.
|
|
* For example, to enable the TX frame interrupt and RX frame interrupt, do the following.
|
|
* @code
|
|
* ENET_EnableInterrupts(ENET, kENET_TxFrameInterrupt | kENET_RxFrameInterrupt);
|
|
* @endcode
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param mask ENET interrupts to enable. This is a logical OR of the
|
|
* enumeration :: enet_interrupt_enable_t.
|
|
*/
|
|
static inline void ENET_EnableInterrupts(ENET_Type *base, uint32_t mask)
|
|
{
|
|
base->EIMR |= mask;
|
|
}
|
|
|
|
/*!
|
|
* @brief Disables the ENET interrupt.
|
|
*
|
|
* This function disables the ENET interrupts according to the provided mask. The mask
|
|
* is a logical OR of enumeration members. See @ref enet_interrupt_enable_t.
|
|
* For example, to disable the TX frame interrupt and RX frame interrupt, do the following.
|
|
* @code
|
|
* ENET_DisableInterrupts(ENET, kENET_TxFrameInterrupt | kENET_RxFrameInterrupt);
|
|
* @endcode
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param mask ENET interrupts to disable. This is a logical OR of the
|
|
* enumeration :: enet_interrupt_enable_t.
|
|
*/
|
|
static inline void ENET_DisableInterrupts(ENET_Type *base, uint32_t mask)
|
|
{
|
|
base->EIMR &= ~mask;
|
|
}
|
|
|
|
/*!
|
|
* @brief Gets the ENET interrupt status flag.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @return The event status of the interrupt source. This is the logical OR of members
|
|
* of the enumeration :: enet_interrupt_enable_t.
|
|
*/
|
|
static inline uint32_t ENET_GetInterruptStatus(ENET_Type *base)
|
|
{
|
|
return base->EIR;
|
|
}
|
|
|
|
/*!
|
|
* @brief Clears the ENET interrupt events status flag.
|
|
*
|
|
* This function clears enabled ENET interrupts according to the provided mask. The mask
|
|
* is a logical OR of enumeration members. See the @ref enet_interrupt_enable_t.
|
|
* For example, to clear the TX frame interrupt and RX frame interrupt, do the following.
|
|
* @code
|
|
* ENET_ClearInterruptStatus(ENET, kENET_TxFrameInterrupt | kENET_RxFrameInterrupt);
|
|
* @endcode
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param mask ENET interrupt source to be cleared.
|
|
* This is the logical OR of members of the enumeration :: enet_interrupt_enable_t.
|
|
*/
|
|
static inline void ENET_ClearInterruptStatus(ENET_Type *base, uint32_t mask)
|
|
{
|
|
base->EIR = mask;
|
|
}
|
|
/* @} */
|
|
|
|
/*!
|
|
* @name Transactional operation
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Sets the callback function.
|
|
* This API is provided for the application callback required case when ENET
|
|
* interrupt is enabled. This API should be called after calling ENET_Init.
|
|
*
|
|
* @param handle ENET handler pointer. Should be provided by application.
|
|
* @param callback The ENET callback function.
|
|
* @param userData The callback function parameter.
|
|
*/
|
|
void ENET_SetCallback(enet_handle_t *handle, enet_callback_t callback, void *userData);
|
|
|
|
/*!
|
|
* @brief Gets the error statistics of a received frame for ENET single ring.
|
|
*
|
|
* This API must be called after the ENET_GetRxFrameSize and before the ENET_ReadFrame().
|
|
* If the ENET_GetRxFrameSize returns kStatus_ENET_RxFrameError,
|
|
* the ENET_GetRxErrBeforeReadFrame can be used to get the exact error statistics.
|
|
* This is an example.
|
|
* @code
|
|
* status = ENET_GetRxFrameSize(&g_handle, &length);
|
|
* if (status == kStatus_ENET_RxFrameError)
|
|
* {
|
|
* // Get the error information of the received frame.
|
|
* ENET_GetRxErrBeforeReadFrame(&g_handle, &eErrStatic);
|
|
* // update the receive buffer.
|
|
* ENET_ReadFrame(EXAMPLE_ENET, &g_handle, NULL, 0);
|
|
* }
|
|
* @endcode
|
|
* @param handle The ENET handler structure pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param eErrorStatic The error statistics structure pointer.
|
|
*/
|
|
void ENET_GetRxErrBeforeReadFrame(enet_handle_t *handle, enet_data_error_stats_t *eErrorStatic);
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*!
|
|
* @brief Gets the ENET transmit frame statistics after the data send for single ring.
|
|
*
|
|
* This interface gets the error statistics of the transmit frame.
|
|
* Because the error information is reported by the uDMA after the data delivery, this interface
|
|
* should be called after the data transmit API. It is recommended to call this function on
|
|
* transmit interrupt handler. After calling the ENET_SendFrame, the
|
|
* transmit interrupt notifies the transmit completion.
|
|
*
|
|
* @param handle The PTP handler pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param eErrorStatic The error statistics structure pointer.
|
|
* @return The execute status.
|
|
*/
|
|
status_t ENET_GetTxErrAfterSendFrame(enet_handle_t *handle, enet_data_error_stats_t *eErrorStatic);
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
/*!
|
|
* @brief Gets the size of the read frame for single ring.
|
|
*
|
|
* This function gets a received frame size from the ENET buffer descriptors.
|
|
* @note The FCS of the frame is automatically removed by MAC and the size is the length without the FCS.
|
|
* After calling ENET_GetRxFrameSize, ENET_ReadFrame() should be called to update the
|
|
* receive buffers If the result is not "kStatus_ENET_RxFrameEmpty".
|
|
*
|
|
* @param handle The ENET handler structure. This is the same handler pointer used in the ENET_Init.
|
|
* @param length The length of the valid frame received.
|
|
* @retval kStatus_ENET_RxFrameEmpty No frame received. Should not call ENET_ReadFrame to read frame.
|
|
* @retval kStatus_ENET_RxFrameError Data error happens. ENET_ReadFrame should be called with NULL data
|
|
* and NULL length to update the receive buffers.
|
|
* @retval kStatus_Success Receive a frame Successfully then the ENET_ReadFrame
|
|
* should be called with the right data buffer and the captured data length input.
|
|
*/
|
|
status_t ENET_GetRxFrameSize(enet_handle_t *handle, uint32_t *length);
|
|
|
|
/*!
|
|
* @brief Reads a frame from the ENET device for single ring.
|
|
* This function reads a frame (both the data and the length) from the ENET buffer descriptors.
|
|
* The ENET_GetRxFrameSize should be used to get the size of the prepared data buffer.
|
|
* This is an example:
|
|
* @code
|
|
* uint32_t length;
|
|
* enet_handle_t g_handle;
|
|
* //Get the received frame size firstly.
|
|
* status = ENET_GetRxFrameSize(&g_handle, &length);
|
|
* if (length != 0)
|
|
* {
|
|
* //Allocate memory here with the size of "length"
|
|
* uint8_t *data = memory allocate interface;
|
|
* if (!data)
|
|
* {
|
|
* ENET_ReadFrame(ENET, &g_handle, NULL, 0);
|
|
* //Add the console warning log.
|
|
* }
|
|
* else
|
|
* {
|
|
* status = ENET_ReadFrame(ENET, &g_handle, data, length);
|
|
* //Call stack input API to deliver the data to stack
|
|
* }
|
|
* }
|
|
* else if (status == kStatus_ENET_RxFrameError)
|
|
* {
|
|
* //Update the received buffer when a error frame is received.
|
|
* ENET_ReadFrame(ENET, &g_handle, NULL, 0);
|
|
* }
|
|
* @endcode
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler structure. This is the same handler pointer used in the ENET_Init.
|
|
* @param data The data buffer provided by user to store the frame which memory size should be at least "length".
|
|
* @param length The size of the data buffer which is still the length of the received frame.
|
|
* @return The execute status, successful or failure.
|
|
*/
|
|
status_t ENET_ReadFrame(ENET_Type *base, enet_handle_t *handle, uint8_t *data, uint32_t length);
|
|
|
|
/*!
|
|
* @brief Transmits an ENET frame for single ring.
|
|
* @note The CRC is automatically appended to the data. Input the data
|
|
* to send without the CRC.
|
|
*
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param data The data buffer provided by user to be send.
|
|
* @param length The length of the data to be send.
|
|
* @retval kStatus_Success Send frame succeed.
|
|
* @retval kStatus_ENET_TxFrameBusy Transmit buffer descriptor is busy under transmission.
|
|
* The transmit busy happens when the data send rate is over the MAC capacity.
|
|
* The waiting mechanism is recommended to be added after each call return with
|
|
* kStatus_ENET_TxFrameBusy.
|
|
*/
|
|
status_t ENET_SendFrame(ENET_Type *base, enet_handle_t *handle, const uint8_t *data, uint32_t length);
|
|
|
|
#if FSL_FEATURE_ENET_QUEUE > 1
|
|
/*!
|
|
* @brief Gets the error statistics of received frame for extended multi-ring.
|
|
*
|
|
* This API must be called after the ENET_GetRxFrameSizeMultiRing and before the ENET_ReadFrameMultiRing().
|
|
* If the ENET_GetRxFrameSizeMultiRing returns kStatus_ENET_RxFrameError,
|
|
* the ENET_GetRxErrBeforeReadFrameMultiRing can be used to get the exact error statistics.
|
|
*
|
|
* @param handle The ENET handler structure pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param eErrorStatic The error statistics structure pointer.
|
|
* @param ringId The ring index, range from 0 ~ FSL_FEATURE_ENET_QUEUE - 1.
|
|
*/
|
|
void ENET_GetRxErrBeforeReadFrameMultiRing(enet_handle_t *handle,
|
|
enet_data_error_stats_t *eErrorStatic,
|
|
uint32_t ringId);
|
|
|
|
/*!
|
|
* @brief Transmits an ENET frame for extended multi-ring.
|
|
* @note The CRC is automatically appended to the data. Input the data
|
|
* to send without the CRC.
|
|
*
|
|
* In this API, multiple-ring are mainly used for extended avb frames are supported.
|
|
* The transmit scheme for avb frames is the credit-based scheme, the AVB class A, AVB class B
|
|
* and the non-AVB frame are transmitted in ring 1, ring 2 and ring 0 independently.
|
|
* So application should care about the transmit ring index when use multiple-ring transmission.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param data The data buffer provided by user to be send.
|
|
* @param length The length of the data to be send.
|
|
* @param ringId The ring index for transmission.
|
|
* @retval kStatus_Success Send frame succeed.
|
|
* @retval kStatus_ENET_TxFrameBusy Transmit buffer descriptor is busy under transmission.
|
|
* The transmit busy happens when the data send rate is over the MAC capacity.
|
|
* The waiting mechanism is recommended to be added after each call return with
|
|
* kStatus_ENET_TxFrameBusy.
|
|
*/
|
|
status_t ENET_SendFrameMultiRing(
|
|
ENET_Type *base, enet_handle_t *handle, uint8_t *data, uint32_t length, uint32_t ringId);
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*!
|
|
* @brief Gets the ENET transmit frame statistics after the data send for extended multi-ring.
|
|
*
|
|
* This interface gets the error statistics of the transmit frame.
|
|
* Because the error information is reported by the uDMA after the data delivery, this interface
|
|
* should be called after the data transmit API and shall be called by transmit interrupt handler.
|
|
* After calling the ENET_SendFrame, the transmit interrupt notifies the transmit completion.
|
|
*
|
|
* @param handle The PTP handler pointer. This is the same handler pointer used in the ENET_Init.
|
|
* @param eErrorStatic The error statistics structure pointer.
|
|
* @param ringId The ring index.
|
|
* @return The execute status.
|
|
*/
|
|
status_t ENET_GetTxErrAfterSendFrameMultiRing(enet_handle_t *handle,
|
|
enet_data_error_stats_t *eErrorStatic,
|
|
uint32_t ringId);
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
|
|
/*!
|
|
* @brief Gets the size of the read frame for extended mutli-ring.
|
|
*
|
|
* This function gets a received frame size from the ENET buffer descriptors.
|
|
* @note The FCS of the frame is automatically removed by MAC and the size is the length without the FCS.
|
|
* After calling ENET_GetRxFrameSizeMultiRing, ENET_ReadFrameMultiRing() should be called to update the
|
|
* receive buffers If the result is not "kStatus_ENET_RxFrameEmpty". The usage is
|
|
* the same to the single ring, refer to ENET_GetRxFrameSize.
|
|
*
|
|
* @param handle The ENET handler structure. This is the same handler pointer used in the ENET_Init.
|
|
* @param length The length of the valid frame received.
|
|
* @param ringId The ring index or ring number;
|
|
* @retval kStatus_ENET_RxFrameEmpty No frame received. Should not call ENET_ReadFrameMultiRing to read frame.
|
|
* @retval kStatus_ENET_RxFrameError Data error happens. ENET_ReadFrameMultiRing should be called with NULL data
|
|
* and NULL length to update the receive buffers.
|
|
* @retval kStatus_Success Receive a frame Successfully then the ENET_ReadFrame
|
|
* should be called with the right data buffer and the captured data length input.
|
|
*/
|
|
status_t ENET_GetRxFrameSizeMultiRing(enet_handle_t *handle, uint32_t *length, uint32_t ringId);
|
|
|
|
/*!
|
|
* @brief Reads a frame from the ENET device for multi-ring.
|
|
*
|
|
* This function reads a frame (both the data and the length) from the ENET buffer descriptors.
|
|
* The ENET_GetRxFrameSizeMultiRing should be used to get the size of the prepared data buffer.
|
|
* This usage is the same as the single ring, refer to ENET_ReadFrame.
|
|
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler structure. This is the same handler pointer used in the ENET_Init.
|
|
* @param data The data buffer provided by user to store the frame which memory size should be at least "length".
|
|
* @param length The size of the data buffer which is still the length of the received frame.
|
|
* @param ringId The ring index or ring number;
|
|
* @return The execute status, successful or failure.
|
|
*/
|
|
status_t ENET_ReadFrameMultiRing(
|
|
ENET_Type *base, enet_handle_t *handle, uint8_t *data, uint32_t length, uint32_t ringId);
|
|
|
|
/*!
|
|
* @brief The transmit IRQ handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer.
|
|
* @param ringId The ring id or ring number.
|
|
*/
|
|
void ENET_TransmitIRQHandler(ENET_Type *base, enet_handle_t *handle, uint32_t ringId);
|
|
|
|
/*!
|
|
* @brief The receive IRQ handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer.
|
|
* @param ringId The ring id or ring number.
|
|
*/
|
|
void ENET_ReceiveIRQHandler(ENET_Type *base, enet_handle_t *handle, uint32_t ringId);
|
|
|
|
/*!
|
|
* @brief the common IRQ handler for the tx/rx irq handler.
|
|
*
|
|
* This is used for the combined tx/rx interrupt for multi-ring (frame 1).
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
void ENET_CommonFrame1IRQHandler(ENET_Type *base);
|
|
|
|
/*!
|
|
* @brief the common IRQ handler for the tx/rx irq handler.
|
|
*
|
|
* This is used for the combined tx/rx interrupt for multi-ring (frame 2).
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
void ENET_CommonFrame2IRQHandler(ENET_Type *base);
|
|
#else
|
|
/*!
|
|
* @brief The transmit IRQ handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer.
|
|
*/
|
|
void ENET_TransmitIRQHandler(ENET_Type *base, enet_handle_t *handle);
|
|
|
|
/*!
|
|
* @brief The receive IRQ handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer.
|
|
*/
|
|
void ENET_ReceiveIRQHandler(ENET_Type *base, enet_handle_t *handle);
|
|
#endif /* FSL_FEATURE_ENET_QUEUE > 1 */
|
|
|
|
/*!
|
|
* @brief Some special IRQ handler including the error, mii, wakeup irq handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET handler pointer.
|
|
*/
|
|
void ENET_ErrorIRQHandler(ENET_Type *base, enet_handle_t *handle);
|
|
|
|
/*!
|
|
* @brief the common IRQ handler for the tx/rx/error etc irq handler.
|
|
*
|
|
* This is used for the combined tx/rx/error interrupt for single/mutli-ring (frame 0).
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
void ENET_CommonFrame0IRQHandler(ENET_Type *base);
|
|
/* @} */
|
|
|
|
#ifdef ENET_ENHANCEDBUFFERDESCRIPTOR_MODE
|
|
/*!
|
|
* @name ENET PTP 1588 function operation
|
|
* @{
|
|
*/
|
|
|
|
/*!
|
|
* @brief Configures the ENET PTP IEEE 1588 feature with the basic configuration.
|
|
* The function sets the clock for PTP 1588 timer and enables
|
|
* time stamp interrupts and transmit interrupts for PTP 1588 features.
|
|
* This API should be called when the 1588 feature is enabled
|
|
* or the ENET_ENHANCEDBUFFERDESCRIPTOR_MODE is defined.
|
|
* ENET_Init should be called before calling this API.
|
|
*
|
|
* @note The PTP 1588 time-stamp second increase though time-stamp interrupt handler
|
|
* and the transmit time-stamp store is done through transmit interrupt handler.
|
|
* As a result, the TS interrupt and TX interrupt are enabled when you call this API.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle ENET handler pointer.
|
|
* @param ptpConfig The ENET PTP1588 configuration.
|
|
*/
|
|
void ENET_Ptp1588Configure(ENET_Type *base, enet_handle_t *handle, enet_ptp_config_t *ptpConfig);
|
|
|
|
/*!
|
|
* @brief Starts the ENET PTP 1588 Timer.
|
|
* This function is used to initialize the PTP timer. After the PTP starts,
|
|
* the PTP timer starts running.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param ptpClkSrc The clock source of the PTP timer.
|
|
*/
|
|
void ENET_Ptp1588StartTimer(ENET_Type *base, uint32_t ptpClkSrc);
|
|
|
|
/*!
|
|
* @brief Stops the ENET PTP 1588 Timer.
|
|
* This function is used to stops the ENET PTP timer.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
*/
|
|
static inline void ENET_Ptp1588StopTimer(ENET_Type *base)
|
|
{
|
|
/* Disable PTP timer and reset the timer. */
|
|
base->ATCR &= ~ENET_ATCR_EN_MASK;
|
|
base->ATCR |= ENET_ATCR_RESTART_MASK;
|
|
}
|
|
|
|
/*!
|
|
* @brief Adjusts the ENET PTP 1588 timer.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param corrIncrease The correction increment value. This value is added every time the correction
|
|
* timer expires. A value less than the PTP timer frequency(1/ptpClkSrc) slows down the timer,
|
|
* a value greater than the 1/ptpClkSrc speeds up the timer.
|
|
* @param corrPeriod The PTP timer correction counter wrap-around value. This defines after how
|
|
* many timer clock the correction counter should be reset and trigger a correction
|
|
* increment on the timer. A value of 0 disables the correction counter and no correction occurs.
|
|
*/
|
|
void ENET_Ptp1588AdjustTimer(ENET_Type *base, uint32_t corrIncrease, uint32_t corrPeriod);
|
|
|
|
/*!
|
|
* @brief Sets the ENET PTP 1588 timer channel mode.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param channel The ENET PTP timer channel number.
|
|
* @param mode The PTP timer channel mode, see "enet_ptp_timer_channel_mode_t".
|
|
* @param intEnable Enables or disables the interrupt.
|
|
*/
|
|
static inline void ENET_Ptp1588SetChannelMode(ENET_Type *base,
|
|
enet_ptp_timer_channel_t channel,
|
|
enet_ptp_timer_channel_mode_t mode,
|
|
bool intEnable)
|
|
{
|
|
uint32_t tcrReg = 0;
|
|
|
|
tcrReg = ENET_TCSR_TMODE(mode) | (intEnable ? ENET_TCSR_TIE_MASK : 0);
|
|
|
|
/* Disable channel mode first. */
|
|
base->CHANNEL[channel].TCSR = 0;
|
|
base->CHANNEL[channel].TCSR = tcrReg;
|
|
}
|
|
|
|
#if defined(FSL_FEATURE_ENET_HAS_TIMER_PWCONTROL) && FSL_FEATURE_ENET_HAS_TIMER_PWCONTROL
|
|
/*!
|
|
* @brief Sets ENET PTP 1588 timer channel mode pulse width.
|
|
*
|
|
* For the input "mode" in ENET_Ptp1588SetChannelMode, the kENET_PtpChannelPulseLowonCompare
|
|
* kENET_PtpChannelPulseHighonCompare only support the pulse width for one 1588 clock.
|
|
* this function is extended for control the pulse width from 1 to 32 1588 clock cycles.
|
|
* so call this function if you need to set the timer channel mode for
|
|
* kENET_PtpChannelPulseLowonCompare or kENET_PtpChannelPulseHighonCompare
|
|
* with pulse width more than one 1588 clock,
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param channel The ENET PTP timer channel number.
|
|
* @param isOutputLow True --- timer channel is configured for output compare
|
|
* pulse output low.
|
|
* false --- timer channel is configured for output compare
|
|
* pulse output high.
|
|
* @param pulseWidth The pulse width control value, range from 0 ~ 31.
|
|
* 0 --- pulse width is one 1588 clock cycle.
|
|
* 31 --- pulse width is thirty two 1588 clock cycles.
|
|
* @param intEnable Enables or disables the interrupt.
|
|
*/
|
|
static inline void ENET_Ptp1588SetChannelOutputPulseWidth(
|
|
ENET_Type *base, enet_ptp_timer_channel_t channel, bool isOutputLow, uint8_t pulseWidth, bool intEnable)
|
|
{
|
|
uint32_t tcrReg;
|
|
|
|
tcrReg = ENET_TCSR_TIE(intEnable) | ENET_TCSR_TPWC(pulseWidth);
|
|
|
|
if (isOutputLow)
|
|
{
|
|
tcrReg |= ENET_TCSR_TMODE(kENET_PtpChannelPulseLowonCompare);
|
|
}
|
|
else
|
|
{
|
|
tcrReg |= ENET_TCSR_TMODE(kENET_PtpChannelPulseHighonCompare);
|
|
}
|
|
|
|
/* Disable channel mode first. */
|
|
base->CHANNEL[channel].TCSR = 0;
|
|
base->CHANNEL[channel].TCSR = tcrReg;
|
|
}
|
|
#endif /* FSL_FEATURE_ENET_HAS_TIMER_PWCONTROL */
|
|
|
|
/*!
|
|
* @brief Sets the ENET PTP 1588 timer channel comparison value.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param channel The PTP timer channel, see "enet_ptp_timer_channel_t".
|
|
* @param cmpValue The compare value for the compare setting.
|
|
*/
|
|
static inline void ENET_Ptp1588SetChannelCmpValue(ENET_Type *base, enet_ptp_timer_channel_t channel, uint32_t cmpValue)
|
|
{
|
|
base->CHANNEL[channel].TCCR = cmpValue;
|
|
}
|
|
|
|
/*!
|
|
* @brief Gets the ENET PTP 1588 timer channel status.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param channel The IEEE 1588 timer channel number.
|
|
* @return True or false, Compare or capture operation status
|
|
*/
|
|
static inline bool ENET_Ptp1588GetChannelStatus(ENET_Type *base, enet_ptp_timer_channel_t channel)
|
|
{
|
|
return (0 != (base->CHANNEL[channel].TCSR & ENET_TCSR_TF_MASK));
|
|
}
|
|
|
|
/*!
|
|
* @brief Clears the ENET PTP 1588 timer channel status.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param channel The IEEE 1588 timer channel number.
|
|
*/
|
|
static inline void ENET_Ptp1588ClearChannelStatus(ENET_Type *base, enet_ptp_timer_channel_t channel)
|
|
{
|
|
base->CHANNEL[channel].TCSR |= ENET_TCSR_TF_MASK;
|
|
base->TGSR = (1U << channel);
|
|
}
|
|
|
|
/*!
|
|
* @brief Gets the current ENET time from the PTP 1588 timer.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET state pointer. This is the same state pointer used in the ENET_Init.
|
|
* @param ptpTime The PTP timer structure.
|
|
*/
|
|
void ENET_Ptp1588GetTimer(ENET_Type *base, enet_handle_t *handle, enet_ptp_time_t *ptpTime);
|
|
|
|
/*!
|
|
* @brief Sets the ENET PTP 1588 timer to the assigned time.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET state pointer. This is the same state pointer used in the ENET_Init.
|
|
* @param ptpTime The timer to be set to the PTP timer.
|
|
*/
|
|
void ENET_Ptp1588SetTimer(ENET_Type *base, enet_handle_t *handle, enet_ptp_time_t *ptpTime);
|
|
|
|
/*!
|
|
* @brief The IEEE 1588 PTP time stamp interrupt handler.
|
|
*
|
|
* @param base ENET peripheral base address.
|
|
* @param handle The ENET state pointer. This is the same state pointer used in the ENET_Init.
|
|
*/
|
|
void ENET_Ptp1588TimerIRQHandler(ENET_Type *base, enet_handle_t *handle);
|
|
|
|
/*!
|
|
* @brief Gets the time stamp of the received frame.
|
|
*
|
|
* This function is used for PTP stack to get the timestamp captured by the ENET driver.
|
|
*
|
|
* @param handle The ENET handler pointer.This is the same state pointer used in
|
|
* ENET_Init.
|
|
* @param ptpTimeData The special PTP timestamp data for search the receive timestamp.
|
|
* @retval kStatus_Success Get 1588 timestamp success.
|
|
* @retval kStatus_ENET_PtpTsRingEmpty 1588 timestamp ring empty.
|
|
* @retval kStatus_ENET_PtpTsRingFull 1588 timestamp ring full.
|
|
*/
|
|
status_t ENET_GetRxFrameTime(enet_handle_t *handle, enet_ptp_time_data_t *ptpTimeData);
|
|
|
|
/*!
|
|
* @brief Gets the time stamp of the transmit frame.
|
|
*
|
|
* This function is used for PTP stack to get the timestamp captured by the ENET driver.
|
|
*
|
|
* @param handle The ENET handler pointer.This is the same state pointer used in
|
|
* ENET_Init.
|
|
* @param ptpTimeData The special PTP timestamp data for search the receive timestamp.
|
|
* @retval kStatus_Success Get 1588 timestamp success.
|
|
* @retval kStatus_ENET_PtpTsRingEmpty 1588 timestamp ring empty.
|
|
* @retval kStatus_ENET_PtpTsRingFull 1588 timestamp ring full.
|
|
*/
|
|
status_t ENET_GetTxFrameTime(enet_handle_t *handle, enet_ptp_time_data_t *ptpTimeData);
|
|
#endif /* ENET_ENHANCEDBUFFERDESCRIPTOR_MODE */
|
|
/* @} */
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
/*! @}*/
|
|
|
|
#endif /* _FSL_ENET_H_ */
|