drivers/net/ethernet/aquantia/atlantic/aq_hw.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * aQuantia Corporation Network Driver
   4  * Copyright (C) 2014-2019 aQuantia Corporation. All rights reserved
   5  */
   6
   7 /* File aq_hw.h: Declaration of abstract interface for NIC hardware specific
   8  * functions.
   9  */
  10
  11 #ifndef AQ_HW_H
  12 #define AQ_HW_H
  13
  14 #include "aq_common.h"
  15 #include "aq_rss.h"
  16 #include "hw_atl/hw_atl_utils.h"
  17
  18 #define AQ_HW_MAC_COUNTER_HZ   312500000ll
  19 #define AQ_HW_PHY_COUNTER_HZ   160000000ll
  20
  21 #define AQ_RX_FIRST_LOC_FVLANID     0U
  22 #define AQ_RX_LAST_LOC_FVLANID     15U
  23 #define AQ_RX_FIRST_LOC_FETHERT    16U
  24 #define AQ_RX_LAST_LOC_FETHERT     31U
  25 #define AQ_RX_FIRST_LOC_FL3L4      32U
  26 #define AQ_RX_LAST_LOC_FL3L4       39U
  27 #define AQ_RX_MAX_RXNFC_LOC        AQ_RX_LAST_LOC_FL3L4
  28 #define AQ_VLAN_MAX_FILTERS   \
  29                         (AQ_RX_LAST_LOC_FVLANID - AQ_RX_FIRST_LOC_FVLANID + 1U)
  30 #define AQ_RX_QUEUE_NOT_ASSIGNED   0xFFU
  31
  32 /* NIC H/W capabilities */
  33 struct aq_hw_caps_s {
  34         u64 hw_features;
  35         u64 link_speed_msk;
  36         unsigned int hw_priv_flags;
  37         u32 media_type;
  38         u32 rxds_max;
  39         u32 txds_max;
  40         u32 rxds_min;
  41         u32 txds_min;
  42         u32 txhwb_alignment;
  43         u32 irq_mask;
  44         u32 vecs;
  45         u32 mtu;
  46         u32 mac_regs_count;
  47         u32 hw_alive_check_addr;
  48         u8 msix_irqs;
  49         u8 tcs;
  50         u8 rxd_alignment;
  51         u8 rxd_size;
  52         u8 txd_alignment;
  53         u8 txd_size;
  54         u8 tx_rings;
  55         u8 rx_rings;
  56         bool flow_control;
  57         bool is_64_dma;
  58 };
  59
  60 struct aq_hw_link_status_s {
  61         unsigned int mbps;
  62 };
  63
  64 struct aq_stats_s {
  65         u64 uprc;
  66         u64 mprc;
  67         u64 bprc;
  68         u64 erpt;
  69         u64 uptc;
  70         u64 mptc;
  71         u64 bptc;
  72         u64 erpr;
  73         u64 mbtc;
  74         u64 bbtc;
  75         u64 mbrc;
  76         u64 bbrc;
  77         u64 ubrc;
  78         u64 ubtc;
  79         u64 dpc;
  80         u64 dma_pkt_rc;
  81         u64 dma_pkt_tc;
  82         u64 dma_oct_rc;
  83         u64 dma_oct_tc;
  84 };
  85
  86 #define AQ_HW_IRQ_INVALID 0U
  87 #define AQ_HW_IRQ_LEGACY  1U
  88 #define AQ_HW_IRQ_MSI     2U
  89 #define AQ_HW_IRQ_MSIX    3U
  90
  91 #define AQ_HW_SERVICE_IRQS   1U
  92
  93 #define AQ_HW_POWER_STATE_D0   0U
  94 #define AQ_HW_POWER_STATE_D3   3U
  95
  96 #define AQ_HW_FLAG_STARTED     0x00000004U
  97 #define AQ_HW_FLAG_STOPPING    0x00000008U
  98 #define AQ_HW_FLAG_RESETTING   0x00000010U
  99 #define AQ_HW_FLAG_CLOSING     0x00000020U
 100 #define AQ_HW_PTP_AVAILABLE    0x01000000U
 101 #define AQ_HW_LINK_DOWN        0x04000000U
 102 #define AQ_HW_FLAG_ERR_UNPLUG  0x40000000U
 103 #define AQ_HW_FLAG_ERR_HW      0x80000000U
 104
 105 #define AQ_HW_FLAG_ERRORS      (AQ_HW_FLAG_ERR_HW | AQ_HW_FLAG_ERR_UNPLUG)
 106
 107 #define AQ_NIC_FLAGS_IS_NOT_READY (AQ_NIC_FLAG_STOPPING | \
 108                         AQ_NIC_FLAG_RESETTING | AQ_NIC_FLAG_CLOSING | \
 109                         AQ_NIC_FLAG_ERR_UNPLUG | AQ_NIC_FLAG_ERR_HW)
 110
 111 #define AQ_NIC_FLAGS_IS_NOT_TX_READY (AQ_NIC_FLAGS_IS_NOT_READY | \
 112                                         AQ_NIC_LINK_DOWN)
 113
 114 #define AQ_HW_MEDIA_TYPE_TP    1U
 115 #define AQ_HW_MEDIA_TYPE_FIBRE 2U
 116
 117 #define AQ_HW_TXD_MULTIPLE 8U
 118 #define AQ_HW_RXD_MULTIPLE 8U
 119
 120 #define AQ_HW_MULTICAST_ADDRESS_MAX     32U
 121
 122 #define AQ_HW_LED_BLINK    0x2U
 123 #define AQ_HW_LED_DEFAULT  0x0U
 124
 125 enum aq_priv_flags {
 126         AQ_HW_LOOPBACK_DMA_SYS,
 127         AQ_HW_LOOPBACK_PKT_SYS,
 128         AQ_HW_LOOPBACK_DMA_NET,
 129         AQ_HW_LOOPBACK_PHYINT_SYS,
 130         AQ_HW_LOOPBACK_PHYEXT_SYS,
 131 };
 132
 133 #define AQ_HW_LOOPBACK_MASK     (BIT(AQ_HW_LOOPBACK_DMA_SYS) |\
 134                                  BIT(AQ_HW_LOOPBACK_PKT_SYS) |\
 135                                  BIT(AQ_HW_LOOPBACK_DMA_NET) |\
 136                                  BIT(AQ_HW_LOOPBACK_PHYINT_SYS) |\
 137                                  BIT(AQ_HW_LOOPBACK_PHYEXT_SYS))
 138
 139 struct aq_hw_s {
 140         atomic_t flags;
 141         u8 rbl_enabled:1;
 142         struct aq_nic_cfg_s *aq_nic_cfg;
 143         const struct aq_fw_ops *aq_fw_ops;
 144         void __iomem *mmio;
 145         struct aq_hw_link_status_s aq_link_status;
 146         struct hw_atl_utils_mbox mbox;
 147         struct hw_atl_stats_s last_stats;
 148         struct aq_stats_s curr_stats;
 149         u64 speed;
 150         u32 itr_tx;
 151         u32 itr_rx;
 152         unsigned int chip_features;
 153         u32 fw_ver_actual;
 154         atomic_t dpc;
 155         u32 mbox_addr;
 156         u32 rpc_addr;
 157         u32 settings_addr;
 158         u32 rpc_tid;
 159         struct hw_atl_utils_fw_rpc rpc;
 160         s64 ptp_clk_offset;
 161         u16 phy_id;
 162 };
 163
 164 struct aq_ring_s;
 165 struct aq_ring_param_s;
 166 struct sk_buff;
 167 struct aq_rx_filter_l3l4;
 168
 169 struct aq_hw_ops {
 170
 171         int (*hw_ring_tx_xmit)(struct aq_hw_s *self, struct aq_ring_s *aq_ring,
 172                                unsigned int frags);
 173
 174         int (*hw_ring_rx_receive)(struct aq_hw_s *self,
 175                                   struct aq_ring_s *aq_ring);
 176
 177         int (*hw_ring_rx_fill)(struct aq_hw_s *self, struct aq_ring_s *aq_ring,
 178                                unsigned int sw_tail_old);
 179
 180         int (*hw_ring_tx_head_update)(struct aq_hw_s *self,
 181                                       struct aq_ring_s *aq_ring);
 182
 183         int (*hw_set_mac_address)(struct aq_hw_s *self, u8 *mac_addr);
 184
 185         int (*hw_reset)(struct aq_hw_s *self);
 186
 187         int (*hw_init)(struct aq_hw_s *self, u8 *mac_addr);
 188
 189         int (*hw_start)(struct aq_hw_s *self);
 190
 191         int (*hw_stop)(struct aq_hw_s *self);
 192
 193         int (*hw_ring_tx_init)(struct aq_hw_s *self, struct aq_ring_s *aq_ring,
 194                                struct aq_ring_param_s *aq_ring_param);
 195
 196         int (*hw_ring_tx_start)(struct aq_hw_s *self,
 197                                 struct aq_ring_s *aq_ring);
 198
 199         int (*hw_ring_tx_stop)(struct aq_hw_s *self,
 200                                struct aq_ring_s *aq_ring);
 201
 202         int (*hw_ring_rx_init)(struct aq_hw_s *self,
 203                                struct aq_ring_s *aq_ring,
 204                                struct aq_ring_param_s *aq_ring_param);
 205
 206         int (*hw_ring_rx_start)(struct aq_hw_s *self,
 207                                 struct aq_ring_s *aq_ring);
 208
 209         int (*hw_ring_rx_stop)(struct aq_hw_s *self,
 210                                struct aq_ring_s *aq_ring);
 211
 212         int (*hw_irq_enable)(struct aq_hw_s *self, u64 mask);
 213
 214         int (*hw_irq_disable)(struct aq_hw_s *self, u64 mask);
 215
 216         int (*hw_irq_read)(struct aq_hw_s *self, u64 *mask);
 217
 218         int (*hw_packet_filter_set)(struct aq_hw_s *self,
 219                                     unsigned int packet_filter);
 220
 221         int (*hw_filter_l3l4_set)(struct aq_hw_s *self,
 222                                   struct aq_rx_filter_l3l4 *data);
 223
 224         int (*hw_filter_l3l4_clear)(struct aq_hw_s *self,
 225                                     struct aq_rx_filter_l3l4 *data);
 226
 227         int (*hw_filter_l2_set)(struct aq_hw_s *self,
 228                                 struct aq_rx_filter_l2 *data);
 229
 230         int (*hw_filter_l2_clear)(struct aq_hw_s *self,
 231                                   struct aq_rx_filter_l2 *data);
 232
 233         int (*hw_filter_vlan_set)(struct aq_hw_s *self,
 234                                   struct aq_rx_filter_vlan *aq_vlans);
 235
 236         int (*hw_filter_vlan_ctrl)(struct aq_hw_s *self, bool enable);
 237
 238         int (*hw_multicast_list_set)(struct aq_hw_s *self,
 239                                      u8 ar_mac[AQ_HW_MULTICAST_ADDRESS_MAX]
 240                                      [ETH_ALEN],
 241                                      u32 count);
 242
 243         int (*hw_interrupt_moderation_set)(struct aq_hw_s *self);
 244
 245         int (*hw_rss_set)(struct aq_hw_s *self,
 246                           struct aq_rss_parameters *rss_params);
 247
 248         int (*hw_rss_hash_set)(struct aq_hw_s *self,
 249                                struct aq_rss_parameters *rss_params);
 250
 251         int (*hw_get_regs)(struct aq_hw_s *self,
 252                            const struct aq_hw_caps_s *aq_hw_caps,
 253                            u32 *regs_buff);
 254
 255         struct aq_stats_s *(*hw_get_hw_stats)(struct aq_hw_s *self);
 256
 257         int (*hw_get_fw_version)(struct aq_hw_s *self, u32 *fw_version);
 258
 259         int (*hw_set_offload)(struct aq_hw_s *self,
 260                               struct aq_nic_cfg_s *aq_nic_cfg);
 261
 262         int (*hw_tx_tc_mode_get)(struct aq_hw_s *self, u32 *tc_mode);
 263
 264         int (*hw_rx_tc_mode_get)(struct aq_hw_s *self, u32 *tc_mode);
 265
 266         int (*hw_ring_hwts_rx_fill)(struct aq_hw_s *self,
 267                                     struct aq_ring_s *aq_ring);
 268
 269         int (*hw_ring_hwts_rx_receive)(struct aq_hw_s *self,
 270                                        struct aq_ring_s *ring);
 271
 272         void (*hw_get_ptp_ts)(struct aq_hw_s *self, u64 *stamp);
 273
 274         int (*hw_adj_clock_freq)(struct aq_hw_s *self, s32 delta);
 275
 276         int (*hw_adj_sys_clock)(struct aq_hw_s *self, s64 delta);
 277
 278         int (*hw_set_sys_clock)(struct aq_hw_s *self, u64 time, u64 ts);
 279
 280         int (*hw_ts_to_sys_clock)(struct aq_hw_s *self, u64 ts, u64 *time);
 281
 282         int (*hw_gpio_pulse)(struct aq_hw_s *self, u32 index, u64 start,
 283                              u32 period);
 284
 285         int (*hw_extts_gpio_enable)(struct aq_hw_s *self, u32 index,
 286                                     u32 enable);
 287
 288         int (*hw_get_sync_ts)(struct aq_hw_s *self, u64 *ts);
 289
 290         u16 (*rx_extract_ts)(struct aq_hw_s *self, u8 *p, unsigned int len,
 291                              u64 *timestamp);
 292
 293         int (*extract_hwts)(struct aq_hw_s *self, u8 *p, unsigned int len,
 294                             u64 *timestamp);
 295
 296         int (*hw_set_fc)(struct aq_hw_s *self, u32 fc, u32 tc);
 297
 298         int (*hw_set_loopback)(struct aq_hw_s *self, u32 mode, bool enable);
 299 };
 300
 301 struct aq_fw_ops {
 302         int (*init)(struct aq_hw_s *self);
 303
 304         int (*deinit)(struct aq_hw_s *self);
 305
 306         int (*reset)(struct aq_hw_s *self);
 307
 308         int (*renegotiate)(struct aq_hw_s *self);
 309
 310         int (*get_mac_permanent)(struct aq_hw_s *self, u8 *mac);
 311
 312         int (*set_link_speed)(struct aq_hw_s *self, u32 speed);
 313
 314         int (*set_state)(struct aq_hw_s *self,
 315                          enum hal_atl_utils_fw_state_e state);
 316
 317         int (*update_link_status)(struct aq_hw_s *self);
 318
 319         int (*update_stats)(struct aq_hw_s *self);
 320
 321         int (*get_phy_temp)(struct aq_hw_s *self, int *temp);
 322
 323         u32 (*get_flow_control)(struct aq_hw_s *self, u32 *fcmode);
 324
 325         int (*set_flow_control)(struct aq_hw_s *self);
 326
 327         int (*led_control)(struct aq_hw_s *self, u32 mode);
 328
 329         int (*set_phyloopback)(struct aq_hw_s *self, u32 mode, bool enable);
 330
 331         int (*set_power)(struct aq_hw_s *self, unsigned int power_state,
 332                          u8 *mac);
 333
 334         int (*send_fw_request)(struct aq_hw_s *self,
 335                                const struct hw_fw_request_iface *fw_req,
 336                                size_t size);
 337
 338         void (*enable_ptp)(struct aq_hw_s *self, int enable);
 339
 340         void (*adjust_ptp)(struct aq_hw_s *self, uint64_t adj);
 341
 342         int (*set_eee_rate)(struct aq_hw_s *self, u32 speed);
 343
 344         int (*get_eee_rate)(struct aq_hw_s *self, u32 *rate,
 345                             u32 *supported_rates);
 346
 347         u32 (*get_link_capabilities)(struct aq_hw_s *self);
 348
 349         int (*send_macsec_req)(struct aq_hw_s *self,
 350                                struct macsec_msg_fw_request *msg,
 351                                struct macsec_msg_fw_response *resp);
 352 };
 353
 354 #endif /* AQ_HW_H */