// SPDX-License-Identifier: (GPL-2.0-or-later OR BSD-3-Clause)
/*
 * Copyright (c) 2014-2025, Advanced Micro Devices, Inc.
 * Copyright (c) 2014, Synopsys, Inc.
 * All rights reserved
 */

#ifndef __XGBE_H__
#define __XGBE_H__

#include <linux/dma-mapping.h>
#include <linux/netdevice.h>
#include <linux/workqueue.h>
#include <linux/phy.h>
#include <linux/if_vlan.h>
#include <linux/bitops.h>
#include <linux/ptp_clock_kernel.h>
#include <linux/timecounter.h>
#include <linux/net_tstamp.h>
#include <net/dcbnl.h>
#include <linux/completion.h>
#include <linux/cpumask.h>
#include <linux/interrupt.h>
#include <linux/dcache.h>
#include <linux/ethtool.h>
#include <linux/list.h>

#define XGBE_DRV_NAME           "amd-xgbe"
#define XGBE_DRV_DESC           "AMD 10 Gigabit Ethernet Driver"

/* Descriptor related defines */
#define XGBE_TX_DESC_CNT        512
#define XGBE_TX_DESC_MIN_FREE   (XGBE_TX_DESC_CNT >> 3)
#define XGBE_TX_DESC_MAX_PROC   (XGBE_TX_DESC_CNT >> 1)
#define XGBE_RX_DESC_CNT        512

#define XGBE_TX_DESC_CNT_MIN    64
#define XGBE_TX_DESC_CNT_MAX    4096
#define XGBE_RX_DESC_CNT_MIN    64
#define XGBE_RX_DESC_CNT_MAX    4096

#define XGBE_TX_MAX_BUF_SIZE    (0x3fff & ~(64 - 1))

/* Descriptors required for maximum contiguous TSO/GSO packet */
#define XGBE_TX_MAX_SPLIT       \
        ((GSO_LEGACY_MAX_SIZE / XGBE_TX_MAX_BUF_SIZE) + 1)

/* Maximum possible descriptors needed for an SKB:
 * - Maximum number of SKB frags
 * - Maximum descriptors for contiguous TSO/GSO packet
 * - Possible context descriptor
 * - Possible TSO header descriptor
 */
#define XGBE_TX_MAX_DESCS       (MAX_SKB_FRAGS + XGBE_TX_MAX_SPLIT + 2)

#define XGBE_RX_MIN_BUF_SIZE    (ETH_FRAME_LEN + ETH_FCS_LEN + VLAN_HLEN)
#define XGBE_RX_BUF_ALIGN       64
#define XGBE_SKB_ALLOC_SIZE     256
#define XGBE_SPH_HDSMS_SIZE     2       /* Keep in sync with SKB_ALLOC_SIZE */

#define XGBE_MAX_DMA_CHANNELS   16
#define XGBE_MAX_QUEUES         16
#define XGBE_PRIORITY_QUEUES    8
#define XGBE_DMA_STOP_TIMEOUT   1

/* DMA cache settings - Outer sharable, write-back, write-allocate */
#define XGBE_DMA_OS_ARCR        0x002b2b2b
#define XGBE_DMA_OS_AWCR        0x2f2f2f2f

/* DMA cache settings - System, no caches used */
#define XGBE_DMA_SYS_ARCR       0x00303030
#define XGBE_DMA_SYS_AWCR       0x30303030

/* DMA cache settings - PCI device */
#define XGBE_DMA_PCI_ARCR       0x000f0f0f
#define XGBE_DMA_PCI_AWCR       0x0f0f0f0f
#define XGBE_DMA_PCI_AWARCR     0x00000f0f

/* DMA channel interrupt modes */
#define XGBE_IRQ_MODE_EDGE      0
#define XGBE_IRQ_MODE_LEVEL     1

#define XGBE_ETH_FRAME_HDR      (ETH_HLEN + ETH_FCS_LEN + VLAN_HLEN)
#define XGMAC_MIN_PACKET        60
#define XGMAC_STD_PACKET_MTU    1500
#define XGMAC_MAX_STD_PACKET    1518
#define XGMAC_JUMBO_PACKET_MTU  9000
#define XGMAC_MAX_JUMBO_PACKET  9018
#define XGMAC_GIANT_PACKET_MTU  16368
#define XGMAC_ETH_PREAMBLE      (12 + 8)        /* Inter-frame gap + preamble */

#define XGMAC_PFC_DATA_LEN      46
#define XGMAC_PFC_DELAYS        14000

#define XGMAC_PRIO_QUEUES(_cnt)                                 \
        min_t(unsigned int, IEEE_8021QAZ_MAX_TCS, (_cnt))

/* Common property names */
#define XGBE_MAC_ADDR_PROPERTY  "mac-address"
#define XGBE_PHY_MODE_PROPERTY  "phy-mode"
#define XGBE_DMA_IRQS_PROPERTY  "amd,per-channel-interrupt"
#define XGBE_SPEEDSET_PROPERTY  "amd,speed-set"

/* Device-tree clock names */
#define XGBE_DMA_CLOCK          "dma_clk"
#define XGBE_PTP_CLOCK          "ptp_clk"

/* ACPI property names */
#define XGBE_ACPI_DMA_FREQ      "amd,dma-freq"
#define XGBE_ACPI_PTP_FREQ      "amd,ptp-freq"

/* PCI BAR mapping */
#define XGBE_XGMAC_BAR          0
#define XGBE_XPCS_BAR           1
#define XGBE_MAC_PROP_OFFSET    0x1d000
#define XGBE_I2C_CTRL_OFFSET    0x1e000

/* PCI MSI/MSIx support */
#define XGBE_MSI_BASE_COUNT     4
#define XGBE_MSI_MIN_COUNT      (XGBE_MSI_BASE_COUNT + 1)

/* Initial PTP register values based on Link Speed. */
#define MAC_TICNR_1G_INITVAL    0x10
#define MAC_TECNR_1G_INITVAL    0x28

#define MAC_TICSNR_10G_INITVAL  0x33
#define MAC_TECNR_10G_INITVAL   0x14
#define MAC_TECSNR_10G_INITVAL  0xCC

/* PCI clock frequencies */
#define XGBE_V2_DMA_CLOCK_FREQ  500000000       /* 500 MHz */
#define XGBE_V2_PTP_CLOCK_FREQ  125000000       /* 125 MHz */

/* Timestamp support - values based on 50MHz PTP clock
 *   50MHz => 20 nsec
 */
#define XGBE_TSTAMP_SSINC       20
#define XGBE_TSTAMP_SNSINC      0
#define XGBE_PTP_ACT_CLK_FREQ   500000000

#define XGBE_V2_TSTAMP_SSINC    0xA
#define XGBE_V2_TSTAMP_SNSINC   0
#define XGBE_V2_PTP_ACT_CLK_FREQ        1000000000

/* Define maximum supported values */
#define XGBE_MAX_PPS_OUT        4
#define XGBE_MAX_AUX_SNAP       4

/* Driver PMT macros */
#define XGMAC_DRIVER_CONTEXT    1
#define XGMAC_IOCTL_CONTEXT     2

#define XGMAC_FIFO_MIN_ALLOC    2048
#define XGMAC_FIFO_UNIT         256
#define XGMAC_FIFO_ALIGN(_x)                            \
        (((_x) + XGMAC_FIFO_UNIT - 1) & ~(XGMAC_FIFO_UNIT - 1))
#define XGMAC_FIFO_FC_OFF       2048
#define XGMAC_FIFO_FC_MIN       4096

#define XGBE_TC_MIN_QUANTUM     10

/* Helper macro for descriptor handling
 *  Always use XGBE_GET_DESC_DATA to access the descriptor data
 *  since the index is free-running and needs to be and-ed
 *  with the descriptor count value of the ring to index to
 *  the proper descriptor data.
 */
#define XGBE_GET_DESC_DATA(_ring, _idx)                         \
        ((_ring)->rdata +                                       \
         ((_idx) & ((_ring)->rdesc_count - 1)))

/* Default coalescing parameters */
#define XGMAC_INIT_DMA_TX_USECS         1000
#define XGMAC_INIT_DMA_TX_FRAMES        25
#define XGMAC_MAX_COAL_TX_TICK          100000

#define XGMAC_MAX_DMA_RIWT              0xff
#define XGMAC_INIT_DMA_RX_USECS         30
#define XGMAC_INIT_DMA_RX_FRAMES        25

/* Flow control queue count */
#define XGMAC_MAX_FLOW_CONTROL_QUEUES   8

/* Flow control threshold units */
#define XGMAC_FLOW_CONTROL_UNIT         512
#define XGMAC_FLOW_CONTROL_ALIGN(_x)                            \
        (((_x) + XGMAC_FLOW_CONTROL_UNIT - 1) & ~(XGMAC_FLOW_CONTROL_UNIT - 1))
#define XGMAC_FLOW_CONTROL_VALUE(_x)                            \
        (((_x) < 1024) ? 0 : ((_x) / XGMAC_FLOW_CONTROL_UNIT) - 2)
#define XGMAC_FLOW_CONTROL_MAX          33280

/* Maximum MAC address hash table size (256 bits = 8 bytes) */
#define XGBE_MAC_HASH_TABLE_SIZE        8

/* Receive Side Scaling */
#define XGBE_RSS_HASH_KEY_SIZE          40
#define XGBE_RSS_MAX_TABLE_SIZE         256
#define XGBE_RSS_LOOKUP_TABLE_TYPE      0
#define XGBE_RSS_HASH_KEY_TYPE          1

/* Auto-negotiation */
#define XGBE_AN_MS_TIMEOUT              500
#define XGBE_LINK_TIMEOUT               5
#define XGBE_KR_TRAINING_WAIT_ITER      50

#define XGBE_SGMII_AN_LINK_DUPLEX       BIT(1)
#define XGBE_SGMII_AN_LINK_SPEED        (BIT(2) | BIT(3))
#define XGBE_SGMII_AN_LINK_SPEED_10     0x00
#define XGBE_SGMII_AN_LINK_SPEED_100    0x04
#define XGBE_SGMII_AN_LINK_SPEED_1000   0x08
#define XGBE_SGMII_AN_LINK_STATUS       BIT(4)

/* ECC correctable error notification window (seconds) */
#define XGBE_ECC_LIMIT                  60

/* MDIO port types */
#define XGMAC_MAX_C22_PORT              3

/* Link mode bit operations */
#define XGBE_ZERO_SUP(_ls)              \
        ethtool_link_ksettings_zero_link_mode((_ls), supported)

#define XGBE_SET_SUP(_ls, _mode)        \
        ethtool_link_ksettings_add_link_mode((_ls), supported, _mode)

#define XGBE_CLR_SUP(_ls, _mode)        \
        ethtool_link_ksettings_del_link_mode((_ls), supported, _mode)

#define XGBE_IS_SUP(_ls, _mode) \
        ethtool_link_ksettings_test_link_mode((_ls), supported, _mode)

#define XGBE_ZERO_ADV(_ls)              \
        ethtool_link_ksettings_zero_link_mode((_ls), advertising)

#define XGBE_SET_ADV(_ls, _mode)        \
        ethtool_link_ksettings_add_link_mode((_ls), advertising, _mode)

#define XGBE_CLR_ADV(_ls, _mode)        \
        ethtool_link_ksettings_del_link_mode((_ls), advertising, _mode)

#define XGBE_ADV(_ls, _mode)            \
        ethtool_link_ksettings_test_link_mode((_ls), advertising, _mode)

#define XGBE_ZERO_LP_ADV(_ls)           \
        ethtool_link_ksettings_zero_link_mode((_ls), lp_advertising)

#define XGBE_SET_LP_ADV(_ls, _mode)     \
        ethtool_link_ksettings_add_link_mode((_ls), lp_advertising, _mode)

#define XGBE_CLR_LP_ADV(_ls, _mode)     \
        ethtool_link_ksettings_del_link_mode((_ls), lp_advertising, _mode)

#define XGBE_LP_ADV(_ls, _mode)         \
        ethtool_link_ksettings_test_link_mode((_ls), lp_advertising, _mode)

#define XGBE_LM_COPY(_dst, _dname, _src, _sname)        \
        bitmap_copy((_dst)->link_modes._dname,          \
                    (_src)->link_modes._sname,          \
                    __ETHTOOL_LINK_MODE_MASK_NBITS)

/* XGBE PCI device id */
#define XGBE_RV_PCI_DEVICE_ID   0x15d0
#define XGBE_YC_PCI_DEVICE_ID   0x14b5
#define XGBE_RN_PCI_DEVICE_ID   0x1630

 /* Generic low and high masks */
#define XGBE_GEN_HI_MASK        GENMASK(31, 16)
#define XGBE_GEN_LO_MASK        GENMASK(15, 0)

struct xgbe_prv_data;

struct xgbe_packet_data {
        struct sk_buff *skb;

        unsigned int attributes;

        unsigned int errors;

        unsigned int rdesc_count;
        unsigned int length;

        unsigned int header_len;
        unsigned int tcp_header_len;
        unsigned int tcp_payload_len;
        unsigned short mss;

        unsigned short vlan_ctag;

        u64 rx_tstamp;

        u32 rss_hash;
        enum pkt_hash_types rss_hash_type;

        unsigned int tx_packets;
        unsigned int tx_bytes;
};

/* Common Rx and Tx descriptor mapping */
struct xgbe_ring_desc {
        __le32 desc0;
        __le32 desc1;
        __le32 desc2;
        __le32 desc3;
};

/* Page allocation related values */
struct xgbe_page_alloc {
        struct page *pages;
        unsigned int pages_len;
        unsigned int pages_offset;

        dma_addr_t pages_dma;
};

/* Ring entry buffer data */
struct xgbe_buffer_data {
        struct xgbe_page_alloc pa;
        struct xgbe_page_alloc pa_unmap;

        dma_addr_t dma_base;
        unsigned long dma_off;
        unsigned int dma_len;
};

/* Tx-related ring data */
struct xgbe_tx_ring_data {
        unsigned int packets;           /* BQL packet count */
        unsigned int bytes;             /* BQL byte count */
};

/* Rx-related ring data */
struct xgbe_rx_ring_data {
        struct xgbe_buffer_data hdr;    /* Header locations */
        struct xgbe_buffer_data buf;    /* Payload locations */

        unsigned short hdr_len;         /* Length of received header */
        unsigned short len;             /* Length of received packet */
};

/* Structure used to hold information related to the descriptor
 * and the packet associated with the descriptor (always use
 * the XGBE_GET_DESC_DATA macro to access this data from the ring)
 */
struct xgbe_ring_data {
        struct xgbe_ring_desc *rdesc;   /* Virtual address of descriptor */
        dma_addr_t rdesc_dma;           /* DMA address of descriptor */

        struct sk_buff *skb;            /* Virtual address of SKB */
        dma_addr_t skb_dma;             /* DMA address of SKB data */
        unsigned int skb_dma_len;       /* Length of SKB DMA area */

        struct xgbe_tx_ring_data tx;    /* Tx-related data */
        struct xgbe_rx_ring_data rx;    /* Rx-related data */

        unsigned int mapped_as_page;

        /* Incomplete receive save location.  If the budget is exhausted
         * or the last descriptor (last normal descriptor or a following
         * context descriptor) has not been DMA'd yet the current state
         * of the receive processing needs to be saved.
         */
        unsigned int state_saved;
        struct {
                struct sk_buff *skb;
                unsigned int len;
                unsigned int error;
        } state;
};

struct xgbe_ring {
        /* Ring lock - used just for TX rings at the moment */
        spinlock_t lock;

        /* Per packet related information */
        struct xgbe_packet_data packet_data;

        /* Virtual/DMA addresses and count of allocated descriptor memory */
        struct xgbe_ring_desc *rdesc;
        dma_addr_t rdesc_dma;
        unsigned int rdesc_count;

        /* Array of descriptor data corresponding the descriptor memory
         * (always use the XGBE_GET_DESC_DATA macro to access this data)
         */
        struct xgbe_ring_data *rdata;

        /* Page allocation for RX buffers */
        struct xgbe_page_alloc rx_hdr_pa;
        struct xgbe_page_alloc rx_buf_pa;
        int node;

        /* Ring index values
         *  cur   - Tx: index of descriptor to be used for current transfer
         *          Rx: index of descriptor to check for packet availability
         *  dirty - Tx: index of descriptor to check for transfer complete
         *          Rx: index of descriptor to check for buffer reallocation
         */
        unsigned int cur;
        unsigned int dirty;

        /* Coalesce frame count used for interrupt bit setting */
        unsigned int coalesce_count;

        union {
                struct {
                        unsigned int queue_stopped;
                        unsigned int xmit_more;
                        unsigned short cur_mss;
                        unsigned short cur_vlan_ctag;
                } tx;
        };
} ____cacheline_aligned;

/* Structure used to describe the descriptor rings associated with
 * a DMA channel.
 */
struct xgbe_channel {
        char name[20];

        /* Address of private data area for device */
        struct xgbe_prv_data *pdata;

        /* Queue index and base address of queue's DMA registers */
        unsigned int queue_index;
        void __iomem *dma_regs;

        /* Per channel interrupt irq number */
        int dma_irq;
        char dma_irq_name[IFNAMSIZ + 32];

        /* Netdev related settings */
        struct napi_struct napi;

        /* Per channel interrupt enablement tracker */
        unsigned int curr_ier;
        unsigned int saved_ier;

        unsigned int tx_timer_active;
        struct timer_list tx_timer;

        struct xgbe_ring *tx_ring;
        struct xgbe_ring *rx_ring;

        int node;
        cpumask_t affinity_mask;
} ____cacheline_aligned;

enum xgbe_state {
        XGBE_DOWN,
        XGBE_LINK_INIT,
        XGBE_LINK_ERR,
        XGBE_STOPPED,
};

enum xgbe_int {
        XGMAC_INT_DMA_CH_SR_TI,
        XGMAC_INT_DMA_CH_SR_TPS,
        XGMAC_INT_DMA_CH_SR_TBU,
        XGMAC_INT_DMA_CH_SR_RI,
        XGMAC_INT_DMA_CH_SR_RBU,
        XGMAC_INT_DMA_CH_SR_RPS,
        XGMAC_INT_DMA_CH_SR_TI_RI,
        XGMAC_INT_DMA_CH_SR_FBE,
        XGMAC_INT_DMA_ALL,
};

enum xgbe_int_state {
        XGMAC_INT_STATE_SAVE,
        XGMAC_INT_STATE_RESTORE,
};

enum xgbe_ecc_sec {
        XGBE_ECC_SEC_TX,
        XGBE_ECC_SEC_RX,
        XGBE_ECC_SEC_DESC,
};

enum xgbe_speed {
        XGBE_SPEED_1000 = 0,
        XGBE_SPEED_2500,
        XGBE_SPEED_10000,
        XGBE_SPEEDS,
};

enum xgbe_xpcs_access {
        XGBE_XPCS_ACCESS_V1 = 0,
        XGBE_XPCS_ACCESS_V2,
        XGBE_XPCS_ACCESS_V3,
};

enum xgbe_an_mode {
        XGBE_AN_MODE_CL73 = 0,
        XGBE_AN_MODE_CL73_REDRV,
        XGBE_AN_MODE_CL37,
        XGBE_AN_MODE_CL37_SGMII,
        XGBE_AN_MODE_NONE,
};

enum xgbe_an {
        XGBE_AN_READY = 0,
        XGBE_AN_PAGE_RECEIVED,
        XGBE_AN_INCOMPAT_LINK,
        XGBE_AN_COMPLETE,
        XGBE_AN_NO_LINK,
        XGBE_AN_ERROR,
};

enum xgbe_rx {
        XGBE_RX_BPA = 0,
        XGBE_RX_XNP,
        XGBE_RX_COMPLETE,
        XGBE_RX_ERROR,
};

enum xgbe_mode {
        XGBE_MODE_KX_1000 = 0,
        XGBE_MODE_KX_2500,
        XGBE_MODE_KR,
        XGBE_MODE_X,
        XGBE_MODE_SGMII_10,
        XGBE_MODE_SGMII_100,
        XGBE_MODE_SGMII_1000,
        XGBE_MODE_SFI,
        XGBE_MODE_UNKNOWN,
};

enum xgbe_speedset {
        XGBE_SPEEDSET_1000_10000 = 0,
        XGBE_SPEEDSET_2500_10000,
};

enum xgbe_mdio_mode {
        XGBE_MDIO_MODE_NONE = 0,
        XGBE_MDIO_MODE_CL22,
        XGBE_MDIO_MODE_CL45,
};

enum xgbe_mb_cmd {
        XGBE_MB_CMD_POWER_OFF = 0,
        XGBE_MB_CMD_SET_1G,
        XGBE_MB_CMD_SET_2_5G,
        XGBE_MB_CMD_SET_10G_SFI,
        XGBE_MB_CMD_SET_10G_KR,
        XGBE_MB_CMD_RRC
};

enum xgbe_mb_subcmd {
        XGBE_MB_SUBCMD_NONE = 0,
        XGBE_MB_SUBCMD_RX_ADAP,

        /* 10GbE SFP subcommands */
        XGBE_MB_SUBCMD_ACTIVE = 0,
        XGBE_MB_SUBCMD_PASSIVE_1M,
        XGBE_MB_SUBCMD_PASSIVE_3M,
        XGBE_MB_SUBCMD_PASSIVE_OTHER,

        /* 1GbE Mode subcommands */
        XGBE_MB_SUBCMD_10MBITS = 0,
        XGBE_MB_SUBCMD_100MBITS,
        XGBE_MB_SUBCMD_1G_SGMII,
        XGBE_MB_SUBCMD_1G_KX
};

struct xgbe_phy {
        struct ethtool_link_ksettings lks;

        int address;

        int autoneg;
        int speed;
        int duplex;

        int link;

        int pause_autoneg;
        int tx_pause;
        int rx_pause;
};

enum xgbe_i2c_cmd {
        XGBE_I2C_CMD_READ = 0,
        XGBE_I2C_CMD_WRITE,
};

struct xgbe_i2c_op {
        enum xgbe_i2c_cmd cmd;

        unsigned int target;

        void *buf;
        unsigned int len;
};

struct xgbe_i2c_op_state {
        struct xgbe_i2c_op *op;

        unsigned int tx_len;
        unsigned char *tx_buf;

        unsigned int rx_len;
        unsigned char *rx_buf;

        unsigned int tx_abort_source;

        int ret;
};

struct xgbe_i2c {
        unsigned int started;
        unsigned int max_speed_mode;
        unsigned int rx_fifo_size;
        unsigned int tx_fifo_size;

        struct xgbe_i2c_op_state op_state;
};

struct xgbe_mmc_stats {
        /* Tx Stats */
        u64 txoctetcount_gb;
        u64 txframecount_gb;
        u64 txbroadcastframes_g;
        u64 txmulticastframes_g;
        u64 tx64octets_gb;
        u64 tx65to127octets_gb;
        u64 tx128to255octets_gb;
        u64 tx256to511octets_gb;
        u64 tx512to1023octets_gb;
        u64 tx1024tomaxoctets_gb;
        u64 txunicastframes_gb;
        u64 txmulticastframes_gb;
        u64 txbroadcastframes_gb;
        u64 txunderflowerror;
        u64 txoctetcount_g;
        u64 txframecount_g;
        u64 txpauseframes;
        u64 txvlanframes_g;

        /* Rx Stats */
        u64 rxframecount_gb;
        u64 rxoctetcount_gb;
        u64 rxoctetcount_g;
        u64 rxbroadcastframes_g;
        u64 rxmulticastframes_g;
        u64 rxcrcerror;
        u64 rxrunterror;
        u64 rxjabbererror;
        u64 rxundersize_g;
        u64 rxoversize_g;
        u64 rx64octets_gb;
        u64 rx65to127octets_gb;
        u64 rx128to255octets_gb;
        u64 rx256to511octets_gb;
        u64 rx512to1023octets_gb;
        u64 rx1024tomaxoctets_gb;
        u64 rxunicastframes_g;
        u64 rxlengtherror;
        u64 rxoutofrangetype;
        u64 rxpauseframes;
        u64 rxfifooverflow;
        u64 rxvlanframes_gb;
        u64 rxwatchdogerror;
        u64 rxalignmenterror;
};

struct xgbe_ext_stats {
        u64 tx_tso_packets;
        u64 rx_split_header_packets;
        u64 rx_buffer_unavailable;

        u64 txq_packets[XGBE_MAX_DMA_CHANNELS];
        u64 txq_bytes[XGBE_MAX_DMA_CHANNELS];
        u64 rxq_packets[XGBE_MAX_DMA_CHANNELS];
        u64 rxq_bytes[XGBE_MAX_DMA_CHANNELS];

        u64 tx_vxlan_packets;
        u64 rx_vxlan_packets;
        u64 rx_csum_errors;
        u64 rx_vxlan_csum_errors;
};

struct xgbe_pps_config {
        struct timespec64 start;
        struct timespec64 period;
};

struct xgbe_hw_if {
        int (*tx_complete)(struct xgbe_ring_desc *);

        int (*set_mac_address)(struct xgbe_prv_data *, const u8 *addr);
        int (*config_rx_mode)(struct xgbe_prv_data *);

        int (*enable_rx_csum)(struct xgbe_prv_data *);
        int (*disable_rx_csum)(struct xgbe_prv_data *);

        int (*enable_rx_vlan_stripping)(struct xgbe_prv_data *);
        int (*disable_rx_vlan_stripping)(struct xgbe_prv_data *);
        int (*enable_rx_vlan_filtering)(struct xgbe_prv_data *);
        int (*disable_rx_vlan_filtering)(struct xgbe_prv_data *);
        int (*update_vlan_hash_table)(struct xgbe_prv_data *);

        int (*read_mmd_regs)(struct xgbe_prv_data *, int, int);
        void (*write_mmd_regs)(struct xgbe_prv_data *, int, int, int);
        int (*set_speed)(struct xgbe_prv_data *, int);

        int (*set_ext_mii_mode)(struct xgbe_prv_data *, unsigned int,
                                enum xgbe_mdio_mode);
        int (*read_ext_mii_regs_c22)(struct xgbe_prv_data *, int, int);
        int (*write_ext_mii_regs_c22)(struct xgbe_prv_data *, int, int, u16);
        int (*read_ext_mii_regs_c45)(struct xgbe_prv_data *, int, int, int);
        int (*write_ext_mii_regs_c45)(struct xgbe_prv_data *, int, int, int,
                                      u16);

        int (*set_gpio)(struct xgbe_prv_data *, unsigned int);
        int (*clr_gpio)(struct xgbe_prv_data *, unsigned int);

        void (*enable_tx)(struct xgbe_prv_data *);
        void (*disable_tx)(struct xgbe_prv_data *);
        void (*enable_rx)(struct xgbe_prv_data *);
        void (*disable_rx)(struct xgbe_prv_data *);

        void (*powerup_tx)(struct xgbe_prv_data *);
        void (*powerdown_tx)(struct xgbe_prv_data *);
        void (*powerup_rx)(struct xgbe_prv_data *);
        void (*powerdown_rx)(struct xgbe_prv_data *);

        int (*init)(struct xgbe_prv_data *);
        int (*exit)(struct xgbe_prv_data *);

        int (*enable_int)(struct xgbe_channel *, enum xgbe_int);
        int (*disable_int)(struct xgbe_channel *, enum xgbe_int);
        void (*dev_xmit)(struct xgbe_channel *);
        int (*dev_read)(struct xgbe_channel *);
        void (*tx_desc_init)(struct xgbe_channel *);
        void (*rx_desc_init)(struct xgbe_channel *);
        void (*tx_desc_reset)(struct xgbe_ring_data *);
        void (*rx_desc_reset)(struct xgbe_prv_data *, struct xgbe_ring_data *,
                              unsigned int);
        int (*is_last_desc)(struct xgbe_ring_desc *);
        int (*is_context_desc)(struct xgbe_ring_desc *);
        void (*tx_start_xmit)(struct xgbe_channel *, struct xgbe_ring *);

        /* For FLOW ctrl */
        int (*config_tx_flow_control)(struct xgbe_prv_data *);
        int (*config_rx_flow_control)(struct xgbe_prv_data *);

        /* For RX coalescing */
        int (*config_rx_coalesce)(struct xgbe_prv_data *);
        int (*config_tx_coalesce)(struct xgbe_prv_data *);
        unsigned int (*usec_to_riwt)(struct xgbe_prv_data *, unsigned int);
        unsigned int (*riwt_to_usec)(struct xgbe_prv_data *, unsigned int);

        /* For RX and TX threshold config */
        int (*config_rx_threshold)(struct xgbe_prv_data *, unsigned int);
        int (*config_tx_threshold)(struct xgbe_prv_data *, unsigned int);

        /* For RX and TX Store and Forward Mode config */
        int (*config_rsf_mode)(struct xgbe_prv_data *, unsigned int);
        int (*config_tsf_mode)(struct xgbe_prv_data *, unsigned int);

        /* For TX DMA Operate on Second Frame config */
        int (*config_osp_mode)(struct xgbe_prv_data *);

        /* For MMC statistics */
        void (*rx_mmc_int)(struct xgbe_prv_data *);
        void (*tx_mmc_int)(struct xgbe_prv_data *);
        void (*read_mmc_stats)(struct xgbe_prv_data *);

        /* For Data Center Bridging config */
        void (*config_tc)(struct xgbe_prv_data *);
        void (*config_dcb_tc)(struct xgbe_prv_data *);
        void (*config_dcb_pfc)(struct xgbe_prv_data *);

        /* For Receive Side Scaling */
        int (*enable_rss)(struct xgbe_prv_data *);
        int (*disable_rss)(struct xgbe_prv_data *);
        int (*set_rss_hash_key)(struct xgbe_prv_data *, const u8 *);
        int (*set_rss_lookup_table)(struct xgbe_prv_data *, const u32 *);

        /* For ECC */
        void (*disable_ecc_ded)(struct xgbe_prv_data *);
        void (*disable_ecc_sec)(struct xgbe_prv_data *, enum xgbe_ecc_sec);

        /* For VXLAN */
        void (*enable_vxlan)(struct xgbe_prv_data *);
        void (*disable_vxlan)(struct xgbe_prv_data *);
        void (*set_vxlan_id)(struct xgbe_prv_data *);

        /* For Split Header */
        void (*enable_sph)(struct xgbe_prv_data *pdata);
        void (*disable_sph)(struct xgbe_prv_data *pdata);
};

/* This structure represents implementation specific routines for an
 * implementation of a PHY. All routines are required unless noted below.
 *   Optional routines:
 *     an_pre, an_post
 *     kr_training_pre, kr_training_post
 *     module_info, module_eeprom
 */
struct xgbe_phy_impl_if {
        /* Perform Setup/teardown actions */
        int (*init)(struct xgbe_prv_data *);
        void (*exit)(struct xgbe_prv_data *);

        /* Perform start/stop specific actions */
        int (*reset)(struct xgbe_prv_data *);
        int (*start)(struct xgbe_prv_data *);
        void (*stop)(struct xgbe_prv_data *);

        /* Return the link status */
        int (*link_status)(struct xgbe_prv_data *, int *);

        /* Indicate if a particular speed is valid */
        bool (*valid_speed)(struct xgbe_prv_data *, int);

        /* Check if the specified mode can/should be used */
        bool (*use_mode)(struct xgbe_prv_data *, enum xgbe_mode);
        /* Switch the PHY into various modes */
        void (*set_mode)(struct xgbe_prv_data *, enum xgbe_mode);
        /* Retrieve mode needed for a specific speed */
        enum xgbe_mode (*get_mode)(struct xgbe_prv_data *, int);
        /* Retrieve new/next mode when trying to auto-negotiate */
        enum xgbe_mode (*switch_mode)(struct xgbe_prv_data *);
        /* Retrieve current mode */
        enum xgbe_mode (*cur_mode)(struct xgbe_prv_data *);

        /* Retrieve current auto-negotiation mode */
        enum xgbe_an_mode (*an_mode)(struct xgbe_prv_data *);

        /* Configure auto-negotiation settings */
        int (*an_config)(struct xgbe_prv_data *);

        /* Set/override auto-negotiation advertisement settings */
        void (*an_advertising)(struct xgbe_prv_data *,
                               struct ethtool_link_ksettings *);

        /* Process results of auto-negotiation */
        enum xgbe_mode (*an_outcome)(struct xgbe_prv_data *);

        /* Pre/Post auto-negotiation support */
        void (*an_pre)(struct xgbe_prv_data *);
        void (*an_post)(struct xgbe_prv_data *);

        /* Pre/Post KR training enablement support */
        void (*kr_training_pre)(struct xgbe_prv_data *);
        void (*kr_training_post)(struct xgbe_prv_data *);

        /* SFP module related info */
        int (*module_info)(struct xgbe_prv_data *pdata,
                           struct ethtool_modinfo *modinfo);
        int (*module_eeprom)(struct xgbe_prv_data *pdata,
                             struct ethtool_eeprom *eeprom, u8 *data);
};

struct xgbe_phy_if {
        /* For PHY setup/teardown */
        int (*phy_init)(struct xgbe_prv_data *);
        void (*phy_exit)(struct xgbe_prv_data *);

        /* For PHY support when setting device up/down */
        int (*phy_reset)(struct xgbe_prv_data *);
        int (*phy_start)(struct xgbe_prv_data *);
        void (*phy_stop)(struct xgbe_prv_data *);

        /* For PHY support while device is up */
        void (*phy_status)(struct xgbe_prv_data *);
        int (*phy_config_aneg)(struct xgbe_prv_data *);

        /* For PHY settings validation */
        bool (*phy_valid_speed)(struct xgbe_prv_data *, int);

        /* For single interrupt support */
        irqreturn_t (*an_isr)(struct xgbe_prv_data *);

        /* For ethtool PHY support */
        int (*module_info)(struct xgbe_prv_data *pdata,
                           struct ethtool_modinfo *modinfo);
        int (*module_eeprom)(struct xgbe_prv_data *pdata,
                             struct ethtool_eeprom *eeprom, u8 *data);

        /* PHY implementation specific services */
        struct xgbe_phy_impl_if phy_impl;
};

struct xgbe_i2c_if {
        /* For initial I2C setup */
        int (*i2c_init)(struct xgbe_prv_data *);

        /* For I2C support when setting device up/down */
        int (*i2c_start)(struct xgbe_prv_data *);
        void (*i2c_stop)(struct xgbe_prv_data *);

        /* For performing I2C operations */
        int (*i2c_xfer)(struct xgbe_prv_data *, struct xgbe_i2c_op *);

        /* For single interrupt support */
        irqreturn_t (*i2c_isr)(struct xgbe_prv_data *);
};

struct xgbe_desc_if {
        int (*alloc_ring_resources)(struct xgbe_prv_data *);
        void (*free_ring_resources)(struct xgbe_prv_data *);
        int (*map_tx_skb)(struct xgbe_channel *, struct sk_buff *);
        int (*map_rx_buffer)(struct xgbe_prv_data *, struct xgbe_ring *,
                             struct xgbe_ring_data *);
        void (*unmap_rdata)(struct xgbe_prv_data *, struct xgbe_ring_data *);
        void (*wrapper_tx_desc_init)(struct xgbe_prv_data *);
        void (*wrapper_rx_desc_init)(struct xgbe_prv_data *);
};

/* This structure contains flags that indicate what hardware features
 * or configurations are present in the device.
 */
struct xgbe_hw_features {
        /* HW Version */
        unsigned int version;

        /* HW Feature Register0 */
        unsigned int gmii;              /* 1000 Mbps support */
        unsigned int vlhash;            /* VLAN Hash Filter */
        unsigned int sma;               /* SMA(MDIO) Interface */
        unsigned int rwk;               /* PMT remote wake-up packet */
        unsigned int mgk;               /* PMT magic packet */
        unsigned int mmc;               /* RMON module */
        unsigned int aoe;               /* ARP Offload */
        unsigned int ts;                /* IEEE 1588-2008 Advanced Timestamp */
        unsigned int eee;               /* Energy Efficient Ethernet */
        unsigned int tx_coe;            /* Tx Checksum Offload */
        unsigned int rx_coe;            /* Rx Checksum Offload */
        unsigned int addn_mac;          /* Additional MAC Addresses */
        unsigned int ts_src;            /* Timestamp Source */
        unsigned int sa_vlan_ins;       /* Source Address or VLAN Insertion */
        unsigned int vxn;               /* VXLAN/NVGRE */

        /* HW Feature Register1 */
        unsigned int rx_fifo_size;      /* MTL Receive FIFO Size */
        unsigned int tx_fifo_size;      /* MTL Transmit FIFO Size */
        unsigned int adv_ts_hi;         /* Advance Timestamping High Word */
        unsigned int dma_width;         /* DMA width */
        unsigned int dcb;               /* DCB Feature */
        unsigned int sph;               /* Split Header Feature */
        unsigned int tso;               /* TCP Segmentation Offload */
        unsigned int dma_debug;         /* DMA Debug Registers */
        unsigned int rss;               /* Receive Side Scaling */
        unsigned int tc_cnt;            /* Number of Traffic Classes */
        unsigned int hash_table_size;   /* Hash Table Size */
        unsigned int l3l4_filter_num;   /* Number of L3-L4 Filters */

        /* HW Feature Register2 */
        unsigned int rx_q_cnt;          /* Number of MTL Receive Queues */
        unsigned int tx_q_cnt;          /* Number of MTL Transmit Queues */
        unsigned int rx_ch_cnt;         /* Number of DMA Receive Channels */
        unsigned int tx_ch_cnt;         /* Number of DMA Transmit Channels */
        unsigned int pps_out_num;       /* Number of PPS outputs */
        unsigned int aux_snap_num;      /* Number of Aux snapshot inputs */
};

struct xgbe_version_data {
        void (*init_function_ptrs_phy_impl)(struct xgbe_phy_if *);
        enum xgbe_xpcs_access xpcs_access;
        unsigned int mmc_64bit;
        unsigned int tx_max_fifo_size;
        unsigned int rx_max_fifo_size;
        unsigned int tx_tstamp_workaround;
        unsigned int tstamp_ptp_clock_freq;
        unsigned int ecc_support;
        unsigned int i2c_support;
        unsigned int irq_reissue_support;
        unsigned int tx_desc_prefetch;
        unsigned int rx_desc_prefetch;
        unsigned int an_cdr_workaround;
        unsigned int enable_rrc;
};

struct xgbe_prv_data {
        struct net_device *netdev;
        struct pci_dev *pcidev;
        struct platform_device *platdev;
        struct acpi_device *adev;
        struct device *dev;
        struct platform_device *phy_platdev;
        struct device *phy_dev;
        unsigned int smn_base;

        /* Version related data */
        struct xgbe_version_data *vdata;

        /* ACPI or DT flag */
        unsigned int use_acpi;

        /* XGMAC/XPCS related mmio registers */
        void __iomem *xgmac_regs;       /* XGMAC CSRs */
        void __iomem *xpcs_regs;        /* XPCS MMD registers */
        void __iomem *rxtx_regs;        /* SerDes Rx/Tx CSRs */
        void __iomem *sir0_regs;        /* SerDes integration registers (1/2) */
        void __iomem *sir1_regs;        /* SerDes integration registers (2/2) */
        void __iomem *xprop_regs;       /* XGBE property registers */
        void __iomem *xi2c_regs;        /* XGBE I2C CSRs */

        /* Port property registers */
        unsigned int pp0;
        unsigned int pp1;
        unsigned int pp2;
        unsigned int pp3;
        unsigned int pp4;

        /* XPCS indirect addressing lock */
        spinlock_t xpcs_lock;
        unsigned int xpcs_window_def_reg;
        unsigned int xpcs_window_sel_reg;
        unsigned int xpcs_window;
        unsigned int xpcs_window_size;
        unsigned int xpcs_window_mask;

        /* RSS addressing mutex */
        struct mutex rss_mutex;

        /* Flags representing xgbe_state */
        unsigned long dev_state;

        /* ECC support */
        unsigned long tx_sec_period;
        unsigned long tx_ded_period;
        unsigned long rx_sec_period;
        unsigned long rx_ded_period;
        unsigned long desc_sec_period;
        unsigned long desc_ded_period;

        unsigned int tx_sec_count;
        unsigned int tx_ded_count;
        unsigned int rx_sec_count;
        unsigned int rx_ded_count;
        unsigned int desc_ded_count;
        unsigned int desc_sec_count;

        int dev_irq;
        int ecc_irq;
        int i2c_irq;
        int channel_irq[XGBE_MAX_DMA_CHANNELS];

        unsigned int per_channel_irq;
        unsigned int irq_count;
        unsigned int channel_irq_count;
        unsigned int channel_irq_mode;

        char ecc_name[IFNAMSIZ + 32];

        struct xgbe_hw_if hw_if;
        struct xgbe_phy_if phy_if;
        struct xgbe_desc_if desc_if;
        struct xgbe_i2c_if i2c_if;

        /* AXI DMA settings */
        unsigned int coherent;
        unsigned int arcr;
        unsigned int awcr;
        unsigned int awarcr;

        /* Service routine support */
        struct workqueue_struct *dev_workqueue;
        struct work_struct service_work;
        struct timer_list service_timer;

        /* Rings for Tx/Rx on a DMA channel */
        struct xgbe_channel *channel[XGBE_MAX_DMA_CHANNELS];
        unsigned int tx_max_channel_count;
        unsigned int rx_max_channel_count;
        unsigned int channel_count;
        unsigned int tx_ring_count;
        unsigned int tx_desc_count;
        unsigned int rx_ring_count;
        unsigned int rx_desc_count;

        unsigned int new_tx_ring_count;
        unsigned int new_rx_ring_count;

        unsigned int tx_max_q_count;
        unsigned int rx_max_q_count;
        unsigned int tx_q_count;
        unsigned int rx_q_count;

        /* Tx/Rx common settings */
        unsigned int blen;
        unsigned int pbl;
        unsigned int aal;
        unsigned int rd_osr_limit;
        unsigned int wr_osr_limit;

        /* Tx settings */
        unsigned int tx_sf_mode;
        unsigned int tx_threshold;
        unsigned int tx_osp_mode;
        unsigned int tx_max_fifo_size;

        /* Rx settings */
        unsigned int rx_sf_mode;
        unsigned int rx_threshold;
        unsigned int rx_max_fifo_size;

        /* Tx coalescing settings */
        unsigned int tx_usecs;
        unsigned int tx_frames;

        /* Rx coalescing settings */
        unsigned int rx_riwt;
        unsigned int rx_usecs;
        unsigned int rx_frames;

        /* Current Rx buffer size */
        unsigned int rx_buf_size;

        /* Flow control settings */
        unsigned int pause_autoneg;
        unsigned int tx_pause;
        unsigned int rx_pause;
        unsigned int rx_rfa[XGBE_MAX_QUEUES];
        unsigned int rx_rfd[XGBE_MAX_QUEUES];

        /* Receive Side Scaling settings */
        u8 rss_key[XGBE_RSS_HASH_KEY_SIZE];
        u32 rss_table[XGBE_RSS_MAX_TABLE_SIZE];
        u32 rss_options;

        /* VXLAN settings */
        u16 vxlan_port;

        /* Netdev related settings */
        unsigned char mac_addr[ETH_ALEN];
        netdev_features_t netdev_features;
        struct napi_struct napi;
        struct xgbe_mmc_stats mmc_stats;
        struct xgbe_ext_stats ext_stats;

        /* Filtering support */
        unsigned long active_vlans[BITS_TO_LONGS(VLAN_N_VID)];

        /* Device clocks */
        struct clk *sysclk;
        unsigned long sysclk_rate;
        struct clk *ptpclk;
        unsigned long ptpclk_rate;

        /* Timestamp support */
        spinlock_t tstamp_lock;
        struct ptp_clock_info ptp_clock_info;
        struct ptp_clock *ptp_clock;
        struct kernel_hwtstamp_config tstamp_config;
        unsigned int tstamp_addend;
        struct work_struct tx_tstamp_work;
        struct sk_buff *tx_tstamp_skb;
        u64 tx_tstamp;

        /* Pulse Per Second output */
        struct xgbe_pps_config pps[XGBE_MAX_PPS_OUT];

        /* DCB support */
        struct ieee_ets *ets;
        struct ieee_pfc *pfc;
        unsigned int q2tc_map[XGBE_MAX_QUEUES];
        unsigned int prio2q_map[IEEE_8021QAZ_MAX_TCS];
        unsigned int pfcq[XGBE_MAX_QUEUES];
        unsigned int pfc_rfa;
        u8 num_tcs;

        /* Hardware features of the device */
        struct xgbe_hw_features hw_feat;

        /* Device work structures */
        struct work_struct restart_work;
        struct work_struct stopdev_work;

        /* Keeps track of power mode */
        unsigned int power_down;

        /* Network interface message level setting */
        u32 msg_enable;

        /* Current PHY settings */
        phy_interface_t phy_mode;
        int phy_link;
        int phy_speed;

        /* MDIO/PHY related settings */
        unsigned int phy_started;
        void *phy_data;
        struct xgbe_phy phy;
        int mdio_mmd;
        unsigned long link_check;
        struct completion mdio_complete;

        unsigned int kr_redrv;

        char an_name[IFNAMSIZ + 32];
        struct workqueue_struct *an_workqueue;

        int an_irq;
        struct work_struct an_irq_work;

        /* Auto-negotiation state machine support */
        unsigned int an_int;
        unsigned int an_status;
        struct mutex an_mutex;
        enum xgbe_an an_result;
        enum xgbe_an an_state;
        enum xgbe_rx kr_state;
        enum xgbe_rx kx_state;
        struct work_struct an_work;
        unsigned int an_again;
        unsigned int an_supported;
        unsigned int parallel_detect;
        unsigned int fec_ability;
        unsigned long an_start;
        unsigned long kr_start_time;
        enum xgbe_an_mode an_mode;

        /* I2C support */
        struct xgbe_i2c i2c;
        struct mutex i2c_mutex;
        struct completion i2c_complete;
        char i2c_name[IFNAMSIZ + 32];

        unsigned int lpm_ctrl;          /* CTRL1 for resume */

        unsigned int isr_as_bh_work;
        struct work_struct dev_bh_work;
        struct work_struct ecc_bh_work;
        struct work_struct i2c_bh_work;
        struct work_struct an_bh_work;

        struct dentry *xgbe_debugfs;

        unsigned int debugfs_xgmac_reg;

        unsigned int debugfs_xpcs_mmd;
        unsigned int debugfs_xpcs_reg;

        unsigned int debugfs_xprop_reg;

        unsigned int debugfs_xi2c_reg;

        bool debugfs_an_cdr_workaround;
        bool debugfs_an_cdr_track_early;
        bool en_rx_adap;
        int rx_adapt_retries;
        bool rx_adapt_done;
        /* Flag to track if data path (TX/RX) was stopped for RX adaptation.
         * This prevents packet corruption during the adaptation window.
         */
        bool data_path_stopped;
        bool mode_set;
        bool sph;
};

/* Function prototypes*/
struct xgbe_prv_data *xgbe_alloc_pdata(struct device *);
void xgbe_free_pdata(struct xgbe_prv_data *);
void xgbe_set_counts(struct xgbe_prv_data *);
int xgbe_config_netdev(struct xgbe_prv_data *);
void xgbe_deconfig_netdev(struct xgbe_prv_data *);

int xgbe_platform_init(void);
void xgbe_platform_exit(void);
#ifdef CONFIG_PCI
int xgbe_pci_init(void);
void xgbe_pci_exit(void);
#else
static inline int xgbe_pci_init(void) { return 0; }
static inline void xgbe_pci_exit(void) { }
#endif

void xgbe_init_function_ptrs_dev(struct xgbe_hw_if *);
void xgbe_init_function_ptrs_phy(struct xgbe_phy_if *);
void xgbe_init_function_ptrs_phy_v1(struct xgbe_phy_if *);
void xgbe_init_function_ptrs_phy_v2(struct xgbe_phy_if *);
void xgbe_init_function_ptrs_desc(struct xgbe_desc_if *);
void xgbe_init_function_ptrs_i2c(struct xgbe_i2c_if *);
const struct net_device_ops *xgbe_get_netdev_ops(void);
const struct ethtool_ops *xgbe_get_ethtool_ops(void);
const struct udp_tunnel_nic_info *xgbe_get_udp_tunnel_info(void);

#ifdef CONFIG_AMD_XGBE_DCB
const struct dcbnl_rtnl_ops *xgbe_get_dcbnl_ops(void);
#endif

void xgbe_ptp_register(struct xgbe_prv_data *);
void xgbe_ptp_unregister(struct xgbe_prv_data *);
void xgbe_dump_tx_desc(struct xgbe_prv_data *, struct xgbe_ring *,
                       unsigned int, unsigned int, unsigned int);
void xgbe_dump_rx_desc(struct xgbe_prv_data *, struct xgbe_ring *,
                       unsigned int);
void xgbe_print_pkt(struct net_device *, struct sk_buff *, bool);
void xgbe_get_all_hw_features(struct xgbe_prv_data *);
int xgbe_powerup(struct net_device *, unsigned int);
int xgbe_powerdown(struct net_device *, unsigned int);
void xgbe_init_rx_coalesce(struct xgbe_prv_data *);
void xgbe_init_tx_coalesce(struct xgbe_prv_data *);
void xgbe_restart_dev(struct xgbe_prv_data *pdata);
void xgbe_full_restart_dev(struct xgbe_prv_data *pdata);

/* For Timestamp config */
void xgbe_config_tstamp(struct xgbe_prv_data *pdata, unsigned int mac_tscr);
u64 xgbe_get_tstamp_time(struct xgbe_prv_data *pdata);
u64 xgbe_get_tx_tstamp(struct xgbe_prv_data *pdata);
void xgbe_get_rx_tstamp(struct xgbe_packet_data *packet,
                        struct xgbe_ring_desc *rdesc);
void xgbe_get_rx_tstamp(struct xgbe_packet_data *packet,
                        struct xgbe_ring_desc *rdesc);
void xgbe_update_tstamp_addend(struct xgbe_prv_data *pdata,
                               unsigned int addend);
void xgbe_set_tstamp_time(struct xgbe_prv_data *pdata, unsigned int sec,
                          unsigned int nsec);
void xgbe_tx_tstamp(struct work_struct *work);
int xgbe_get_hwtstamp_settings(struct net_device *netdev,
                               struct kernel_hwtstamp_config *config);
int xgbe_set_hwtstamp_settings(struct net_device *netdev,
                               struct kernel_hwtstamp_config *config,
                               struct netlink_ext_ack *extack);
void xgbe_prep_tx_tstamp(struct xgbe_prv_data *pdata,
                         struct sk_buff *skb,
                         struct xgbe_packet_data *packet);
int xgbe_init_ptp(struct xgbe_prv_data *pdata);
void xgbe_update_tstamp_time(struct xgbe_prv_data *pdata, unsigned int sec,
                             unsigned int nsec);

int xgbe_pps_config(struct xgbe_prv_data *pdata, struct xgbe_pps_config *cfg,
                    int index, bool on);

/* Selftest functions */
void xgbe_selftest_run(struct net_device *dev,
                       struct ethtool_test *etest, u64 *buf);
void xgbe_selftest_get_strings(struct xgbe_prv_data *pdata, u8 *data);
int xgbe_selftest_get_count(struct xgbe_prv_data *pdata);

/* Loopback control */
int xgbe_enable_mac_loopback(struct xgbe_prv_data *pdata);
void xgbe_disable_mac_loopback(struct xgbe_prv_data *pdata);

#ifdef CONFIG_DEBUG_FS
void xgbe_debugfs_init(struct xgbe_prv_data *);
void xgbe_debugfs_exit(struct xgbe_prv_data *);
void xgbe_debugfs_rename(struct xgbe_prv_data *pdata);
#else
static inline void xgbe_debugfs_init(struct xgbe_prv_data *pdata) {}
static inline void xgbe_debugfs_exit(struct xgbe_prv_data *pdata) {}
static inline void xgbe_debugfs_rename(struct xgbe_prv_data *pdata) {}
#endif /* CONFIG_DEBUG_FS */

/* NOTE: Uncomment for function trace log messages in KERNEL LOG */
#if 0
#define YDEBUG
#define YDEBUG_MDIO
#endif

/* For debug prints */
#ifdef YDEBUG
#define DBGPR(x...) pr_alert(x)
#else
#define DBGPR(x...) do { } while (0)
#endif

#ifdef YDEBUG_MDIO
#define DBGPR_MDIO(x...) pr_alert(x)
#else
#define DBGPR_MDIO(x...) do { } while (0)
#endif

#endif