igb.h revision cd14ef54d25bcf0b8e9205e75369e33b1d188417
1/******************************************************************************* 2 3 Intel(R) Gigabit Ethernet Linux driver 4 Copyright(c) 2007-2013 Intel Corporation. 5 6 This program is free software; you can redistribute it and/or modify it 7 under the terms and conditions of the GNU General Public License, 8 version 2, as published by the Free Software Foundation. 9 10 This program is distributed in the hope it will be useful, but WITHOUT 11 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 12 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 13 more details. 14 15 You should have received a copy of the GNU General Public License along with 16 this program; if not, write to the Free Software Foundation, Inc., 17 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA. 18 19 The full GNU General Public License is included in this distribution in 20 the file called "COPYING". 21 22 Contact Information: 23 e1000-devel Mailing List <e1000-devel@lists.sourceforge.net> 24 Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 25 26*******************************************************************************/ 27 28 29/* Linux PRO/1000 Ethernet Driver main header file */ 30 31#ifndef _IGB_H_ 32#define _IGB_H_ 33 34#include "e1000_mac.h" 35#include "e1000_82575.h" 36 37#include <linux/clocksource.h> 38#include <linux/net_tstamp.h> 39#include <linux/ptp_clock_kernel.h> 40#include <linux/bitops.h> 41#include <linux/if_vlan.h> 42#include <linux/i2c.h> 43#include <linux/i2c-algo-bit.h> 44#include <linux/pci.h> 45 46struct igb_adapter; 47 48#define E1000_PCS_CFG_IGN_SD 1 49 50/* Interrupt defines */ 51#define IGB_START_ITR 648 /* ~6000 ints/sec */ 52#define IGB_4K_ITR 980 53#define IGB_20K_ITR 196 54#define IGB_70K_ITR 56 55 56/* TX/RX descriptor defines */ 57#define IGB_DEFAULT_TXD 256 58#define IGB_DEFAULT_TX_WORK 128 59#define IGB_MIN_TXD 80 60#define IGB_MAX_TXD 4096 61 62#define IGB_DEFAULT_RXD 256 63#define IGB_MIN_RXD 80 64#define IGB_MAX_RXD 4096 65 66#define IGB_DEFAULT_ITR 3 /* dynamic */ 67#define IGB_MAX_ITR_USECS 10000 68#define IGB_MIN_ITR_USECS 10 69#define NON_Q_VECTORS 1 70#define MAX_Q_VECTORS 8 71#define MAX_MSIX_ENTRIES 10 72 73/* Transmit and receive queues */ 74#define IGB_MAX_RX_QUEUES 8 75#define IGB_MAX_RX_QUEUES_82575 4 76#define IGB_MAX_RX_QUEUES_I211 2 77#define IGB_MAX_TX_QUEUES 8 78#define IGB_MAX_VF_MC_ENTRIES 30 79#define IGB_MAX_VF_FUNCTIONS 8 80#define IGB_MAX_VFTA_ENTRIES 128 81#define IGB_82576_VF_DEV_ID 0x10CA 82#define IGB_I350_VF_DEV_ID 0x1520 83 84/* NVM version defines */ 85#define IGB_MAJOR_MASK 0xF000 86#define IGB_MINOR_MASK 0x0FF0 87#define IGB_BUILD_MASK 0x000F 88#define IGB_COMB_VER_MASK 0x00FF 89#define IGB_MAJOR_SHIFT 12 90#define IGB_MINOR_SHIFT 4 91#define IGB_COMB_VER_SHFT 8 92#define IGB_NVM_VER_INVALID 0xFFFF 93#define IGB_ETRACK_SHIFT 16 94#define NVM_ETRACK_WORD 0x0042 95#define NVM_COMB_VER_OFF 0x0083 96#define NVM_COMB_VER_PTR 0x003d 97 98struct vf_data_storage { 99 unsigned char vf_mac_addresses[ETH_ALEN]; 100 u16 vf_mc_hashes[IGB_MAX_VF_MC_ENTRIES]; 101 u16 num_vf_mc_hashes; 102 u16 vlans_enabled; 103 u32 flags; 104 unsigned long last_nack; 105 u16 pf_vlan; /* When set, guest VLAN config not allowed. */ 106 u16 pf_qos; 107 u16 tx_rate; 108 bool spoofchk_enabled; 109}; 110 111#define IGB_VF_FLAG_CTS 0x00000001 /* VF is clear to send data */ 112#define IGB_VF_FLAG_UNI_PROMISC 0x00000002 /* VF has unicast promisc */ 113#define IGB_VF_FLAG_MULTI_PROMISC 0x00000004 /* VF has multicast promisc */ 114#define IGB_VF_FLAG_PF_SET_MAC 0x00000008 /* PF has set MAC address */ 115 116/* RX descriptor control thresholds. 117 * PTHRESH - MAC will consider prefetch if it has fewer than this number of 118 * descriptors available in its onboard memory. 119 * Setting this to 0 disables RX descriptor prefetch. 120 * HTHRESH - MAC will only prefetch if there are at least this many descriptors 121 * available in host memory. 122 * If PTHRESH is 0, this should also be 0. 123 * WTHRESH - RX descriptor writeback threshold - MAC will delay writing back 124 * descriptors until either it has this many to write back, or the 125 * ITR timer expires. 126 */ 127#define IGB_RX_PTHRESH ((hw->mac.type == e1000_i354) ? 12 : 8) 128#define IGB_RX_HTHRESH 8 129#define IGB_TX_PTHRESH ((hw->mac.type == e1000_i354) ? 20 : 8) 130#define IGB_TX_HTHRESH 1 131#define IGB_RX_WTHRESH ((hw->mac.type == e1000_82576 && \ 132 (adapter->flags & IGB_FLAG_HAS_MSIX)) ? 1 : 4) 133#define IGB_TX_WTHRESH ((hw->mac.type == e1000_82576 && \ 134 (adapter->flags & IGB_FLAG_HAS_MSIX)) ? 1 : 16) 135 136/* this is the size past which hardware will drop packets when setting LPE=0 */ 137#define MAXIMUM_ETHERNET_VLAN_SIZE 1522 138 139/* Supported Rx Buffer Sizes */ 140#define IGB_RXBUFFER_256 256 141#define IGB_RXBUFFER_2048 2048 142#define IGB_RX_HDR_LEN IGB_RXBUFFER_256 143#define IGB_RX_BUFSZ IGB_RXBUFFER_2048 144 145/* How many Rx Buffers do we bundle into one write to the hardware ? */ 146#define IGB_RX_BUFFER_WRITE 16 /* Must be power of 2 */ 147 148#define AUTO_ALL_MODES 0 149#define IGB_EEPROM_APME 0x0400 150 151#ifndef IGB_MASTER_SLAVE 152/* Switch to override PHY master/slave setting */ 153#define IGB_MASTER_SLAVE e1000_ms_hw_default 154#endif 155 156#define IGB_MNG_VLAN_NONE -1 157 158enum igb_tx_flags { 159 /* cmd_type flags */ 160 IGB_TX_FLAGS_VLAN = 0x01, 161 IGB_TX_FLAGS_TSO = 0x02, 162 IGB_TX_FLAGS_TSTAMP = 0x04, 163 164 /* olinfo flags */ 165 IGB_TX_FLAGS_IPV4 = 0x10, 166 IGB_TX_FLAGS_CSUM = 0x20, 167}; 168 169/* VLAN info */ 170#define IGB_TX_FLAGS_VLAN_MASK 0xffff0000 171#define IGB_TX_FLAGS_VLAN_SHIFT 16 172 173/* The largest size we can write to the descriptor is 65535. In order to 174 * maintain a power of two alignment we have to limit ourselves to 32K. 175 */ 176#define IGB_MAX_TXD_PWR 15 177#define IGB_MAX_DATA_PER_TXD (1 << IGB_MAX_TXD_PWR) 178 179/* Tx Descriptors needed, worst case */ 180#define TXD_USE_COUNT(S) DIV_ROUND_UP((S), IGB_MAX_DATA_PER_TXD) 181#define DESC_NEEDED (MAX_SKB_FRAGS + 4) 182 183/* EEPROM byte offsets */ 184#define IGB_SFF_8472_SWAP 0x5C 185#define IGB_SFF_8472_COMP 0x5E 186 187/* Bitmasks */ 188#define IGB_SFF_ADDRESSING_MODE 0x4 189#define IGB_SFF_8472_UNSUP 0x00 190 191/* wrapper around a pointer to a socket buffer, 192 * so a DMA handle can be stored along with the buffer 193 */ 194struct igb_tx_buffer { 195 union e1000_adv_tx_desc *next_to_watch; 196 unsigned long time_stamp; 197 struct sk_buff *skb; 198 unsigned int bytecount; 199 u16 gso_segs; 200 __be16 protocol; 201 DEFINE_DMA_UNMAP_ADDR(dma); 202 DEFINE_DMA_UNMAP_LEN(len); 203 u32 tx_flags; 204}; 205 206struct igb_rx_buffer { 207 dma_addr_t dma; 208 struct page *page; 209 unsigned int page_offset; 210}; 211 212struct igb_tx_queue_stats { 213 u64 packets; 214 u64 bytes; 215 u64 restart_queue; 216 u64 restart_queue2; 217}; 218 219struct igb_rx_queue_stats { 220 u64 packets; 221 u64 bytes; 222 u64 drops; 223 u64 csum_err; 224 u64 alloc_failed; 225}; 226 227struct igb_ring_container { 228 struct igb_ring *ring; /* pointer to linked list of rings */ 229 unsigned int total_bytes; /* total bytes processed this int */ 230 unsigned int total_packets; /* total packets processed this int */ 231 u16 work_limit; /* total work allowed per interrupt */ 232 u8 count; /* total number of rings in vector */ 233 u8 itr; /* current ITR setting for ring */ 234}; 235 236struct igb_ring { 237 struct igb_q_vector *q_vector; /* backlink to q_vector */ 238 struct net_device *netdev; /* back pointer to net_device */ 239 struct device *dev; /* device pointer for dma mapping */ 240 union { /* array of buffer info structs */ 241 struct igb_tx_buffer *tx_buffer_info; 242 struct igb_rx_buffer *rx_buffer_info; 243 }; 244 unsigned long last_rx_timestamp; 245 void *desc; /* descriptor ring memory */ 246 unsigned long flags; /* ring specific flags */ 247 void __iomem *tail; /* pointer to ring tail register */ 248 dma_addr_t dma; /* phys address of the ring */ 249 unsigned int size; /* length of desc. ring in bytes */ 250 251 u16 count; /* number of desc. in the ring */ 252 u8 queue_index; /* logical index of the ring*/ 253 u8 reg_idx; /* physical index of the ring */ 254 255 /* everything past this point are written often */ 256 u16 next_to_clean; 257 u16 next_to_use; 258 u16 next_to_alloc; 259 260 union { 261 /* TX */ 262 struct { 263 struct igb_tx_queue_stats tx_stats; 264 struct u64_stats_sync tx_syncp; 265 struct u64_stats_sync tx_syncp2; 266 }; 267 /* RX */ 268 struct { 269 struct sk_buff *skb; 270 struct igb_rx_queue_stats rx_stats; 271 struct u64_stats_sync rx_syncp; 272 }; 273 }; 274} ____cacheline_internodealigned_in_smp; 275 276struct igb_q_vector { 277 struct igb_adapter *adapter; /* backlink */ 278 int cpu; /* CPU for DCA */ 279 u32 eims_value; /* EIMS mask value */ 280 281 u16 itr_val; 282 u8 set_itr; 283 void __iomem *itr_register; 284 285 struct igb_ring_container rx, tx; 286 287 struct napi_struct napi; 288 struct rcu_head rcu; /* to avoid race with update stats on free */ 289 char name[IFNAMSIZ + 9]; 290 291 /* for dynamic allocation of rings associated with this q_vector */ 292 struct igb_ring ring[0] ____cacheline_internodealigned_in_smp; 293}; 294 295enum e1000_ring_flags_t { 296 IGB_RING_FLAG_RX_SCTP_CSUM, 297 IGB_RING_FLAG_RX_LB_VLAN_BSWAP, 298 IGB_RING_FLAG_TX_CTX_IDX, 299 IGB_RING_FLAG_TX_DETECT_HANG 300}; 301 302#define IGB_TXD_DCMD (E1000_ADVTXD_DCMD_EOP | E1000_ADVTXD_DCMD_RS) 303 304#define IGB_RX_DESC(R, i) \ 305 (&(((union e1000_adv_rx_desc *)((R)->desc))[i])) 306#define IGB_TX_DESC(R, i) \ 307 (&(((union e1000_adv_tx_desc *)((R)->desc))[i])) 308#define IGB_TX_CTXTDESC(R, i) \ 309 (&(((struct e1000_adv_tx_context_desc *)((R)->desc))[i])) 310 311/* igb_test_staterr - tests bits within Rx descriptor status and error fields */ 312static inline __le32 igb_test_staterr(union e1000_adv_rx_desc *rx_desc, 313 const u32 stat_err_bits) 314{ 315 return rx_desc->wb.upper.status_error & cpu_to_le32(stat_err_bits); 316} 317 318/* igb_desc_unused - calculate if we have unused descriptors */ 319static inline int igb_desc_unused(struct igb_ring *ring) 320{ 321 if (ring->next_to_clean > ring->next_to_use) 322 return ring->next_to_clean - ring->next_to_use - 1; 323 324 return ring->count + ring->next_to_clean - ring->next_to_use - 1; 325} 326 327#ifdef CONFIG_IGB_HWMON 328 329#define IGB_HWMON_TYPE_LOC 0 330#define IGB_HWMON_TYPE_TEMP 1 331#define IGB_HWMON_TYPE_CAUTION 2 332#define IGB_HWMON_TYPE_MAX 3 333 334struct hwmon_attr { 335 struct device_attribute dev_attr; 336 struct e1000_hw *hw; 337 struct e1000_thermal_diode_data *sensor; 338 char name[12]; 339 }; 340 341struct hwmon_buff { 342 struct attribute_group group; 343 const struct attribute_group *groups[2]; 344 struct attribute *attrs[E1000_MAX_SENSORS * 4 + 1]; 345 struct hwmon_attr hwmon_list[E1000_MAX_SENSORS * 4]; 346 unsigned int n_hwmon; 347 }; 348#endif 349 350#define IGB_RETA_SIZE 128 351 352/* board specific private data structure */ 353struct igb_adapter { 354 unsigned long active_vlans[BITS_TO_LONGS(VLAN_N_VID)]; 355 356 struct net_device *netdev; 357 358 unsigned long state; 359 unsigned int flags; 360 361 unsigned int num_q_vectors; 362 struct msix_entry msix_entries[MAX_MSIX_ENTRIES]; 363 364 /* Interrupt Throttle Rate */ 365 u32 rx_itr_setting; 366 u32 tx_itr_setting; 367 u16 tx_itr; 368 u16 rx_itr; 369 370 /* TX */ 371 u16 tx_work_limit; 372 u32 tx_timeout_count; 373 int num_tx_queues; 374 struct igb_ring *tx_ring[16]; 375 376 /* RX */ 377 int num_rx_queues; 378 struct igb_ring *rx_ring[16]; 379 380 u32 max_frame_size; 381 u32 min_frame_size; 382 383 struct timer_list watchdog_timer; 384 struct timer_list phy_info_timer; 385 386 u16 mng_vlan_id; 387 u32 bd_number; 388 u32 wol; 389 u32 en_mng_pt; 390 u16 link_speed; 391 u16 link_duplex; 392 393 struct work_struct reset_task; 394 struct work_struct watchdog_task; 395 bool fc_autoneg; 396 u8 tx_timeout_factor; 397 struct timer_list blink_timer; 398 unsigned long led_status; 399 400 /* OS defined structs */ 401 struct pci_dev *pdev; 402 403 spinlock_t stats64_lock; 404 struct rtnl_link_stats64 stats64; 405 406 /* structs defined in e1000_hw.h */ 407 struct e1000_hw hw; 408 struct e1000_hw_stats stats; 409 struct e1000_phy_info phy_info; 410 struct e1000_phy_stats phy_stats; 411 412 u32 test_icr; 413 struct igb_ring test_tx_ring; 414 struct igb_ring test_rx_ring; 415 416 int msg_enable; 417 418 struct igb_q_vector *q_vector[MAX_Q_VECTORS]; 419 u32 eims_enable_mask; 420 u32 eims_other; 421 422 /* to not mess up cache alignment, always add to the bottom */ 423 u16 tx_ring_count; 424 u16 rx_ring_count; 425 unsigned int vfs_allocated_count; 426 struct vf_data_storage *vf_data; 427 int vf_rate_link_speed; 428 u32 rss_queues; 429 u32 wvbr; 430 u32 *shadow_vfta; 431 432 struct ptp_clock *ptp_clock; 433 struct ptp_clock_info ptp_caps; 434 struct delayed_work ptp_overflow_work; 435 struct work_struct ptp_tx_work; 436 struct sk_buff *ptp_tx_skb; 437 unsigned long ptp_tx_start; 438 unsigned long last_rx_ptp_check; 439 spinlock_t tmreg_lock; 440 struct cyclecounter cc; 441 struct timecounter tc; 442 u32 tx_hwtstamp_timeouts; 443 u32 rx_hwtstamp_cleared; 444 445 char fw_version[32]; 446#ifdef CONFIG_IGB_HWMON 447 struct hwmon_buff *igb_hwmon_buff; 448 bool ets; 449#endif 450 struct i2c_algo_bit_data i2c_algo; 451 struct i2c_adapter i2c_adap; 452 struct i2c_client *i2c_client; 453 u32 rss_indir_tbl_init; 454 u8 rss_indir_tbl[IGB_RETA_SIZE]; 455 456 unsigned long link_check_timeout; 457 int copper_tries; 458 struct e1000_info ei; 459}; 460 461#define IGB_FLAG_HAS_MSI (1 << 0) 462#define IGB_FLAG_DCA_ENABLED (1 << 1) 463#define IGB_FLAG_QUAD_PORT_A (1 << 2) 464#define IGB_FLAG_QUEUE_PAIRS (1 << 3) 465#define IGB_FLAG_DMAC (1 << 4) 466#define IGB_FLAG_PTP (1 << 5) 467#define IGB_FLAG_RSS_FIELD_IPV4_UDP (1 << 6) 468#define IGB_FLAG_RSS_FIELD_IPV6_UDP (1 << 7) 469#define IGB_FLAG_WOL_SUPPORTED (1 << 8) 470#define IGB_FLAG_NEED_LINK_UPDATE (1 << 9) 471#define IGB_FLAG_MEDIA_RESET (1 << 10) 472#define IGB_FLAG_MAS_CAPABLE (1 << 11) 473#define IGB_FLAG_MAS_ENABLE (1 << 12) 474#define IGB_FLAG_HAS_MSIX (1 << 13) 475 476/* Media Auto Sense */ 477#define IGB_MAS_ENABLE_0 0X0001 478#define IGB_MAS_ENABLE_1 0X0002 479#define IGB_MAS_ENABLE_2 0X0004 480#define IGB_MAS_ENABLE_3 0X0008 481 482/* DMA Coalescing defines */ 483#define IGB_MIN_TXPBSIZE 20408 484#define IGB_TX_BUF_4096 4096 485#define IGB_DMCTLX_DCFLUSH_DIS 0x80000000 /* Disable DMA Coal Flush */ 486 487#define IGB_82576_TSYNC_SHIFT 19 488#define IGB_TS_HDR_LEN 16 489enum e1000_state_t { 490 __IGB_TESTING, 491 __IGB_RESETTING, 492 __IGB_DOWN 493}; 494 495enum igb_boards { 496 board_82575, 497}; 498 499extern char igb_driver_name[]; 500extern char igb_driver_version[]; 501 502int igb_up(struct igb_adapter *); 503void igb_down(struct igb_adapter *); 504void igb_reinit_locked(struct igb_adapter *); 505void igb_reset(struct igb_adapter *); 506int igb_reinit_queues(struct igb_adapter *); 507void igb_write_rss_indir_tbl(struct igb_adapter *); 508int igb_set_spd_dplx(struct igb_adapter *, u32, u8); 509int igb_setup_tx_resources(struct igb_ring *); 510int igb_setup_rx_resources(struct igb_ring *); 511void igb_free_tx_resources(struct igb_ring *); 512void igb_free_rx_resources(struct igb_ring *); 513void igb_configure_tx_ring(struct igb_adapter *, struct igb_ring *); 514void igb_configure_rx_ring(struct igb_adapter *, struct igb_ring *); 515void igb_setup_tctl(struct igb_adapter *); 516void igb_setup_rctl(struct igb_adapter *); 517netdev_tx_t igb_xmit_frame_ring(struct sk_buff *, struct igb_ring *); 518void igb_unmap_and_free_tx_resource(struct igb_ring *, struct igb_tx_buffer *); 519void igb_alloc_rx_buffers(struct igb_ring *, u16); 520void igb_update_stats(struct igb_adapter *, struct rtnl_link_stats64 *); 521bool igb_has_link(struct igb_adapter *adapter); 522void igb_set_ethtool_ops(struct net_device *); 523void igb_power_up_link(struct igb_adapter *); 524void igb_set_fw_version(struct igb_adapter *); 525void igb_ptp_init(struct igb_adapter *adapter); 526void igb_ptp_stop(struct igb_adapter *adapter); 527void igb_ptp_reset(struct igb_adapter *adapter); 528void igb_ptp_tx_work(struct work_struct *work); 529void igb_ptp_rx_hang(struct igb_adapter *adapter); 530void igb_ptp_tx_hwtstamp(struct igb_adapter *adapter); 531void igb_ptp_rx_rgtstamp(struct igb_q_vector *q_vector, struct sk_buff *skb); 532void igb_ptp_rx_pktstamp(struct igb_q_vector *q_vector, unsigned char *va, 533 struct sk_buff *skb); 534static inline void igb_ptp_rx_hwtstamp(struct igb_ring *rx_ring, 535 union e1000_adv_rx_desc *rx_desc, 536 struct sk_buff *skb) 537{ 538 if (igb_test_staterr(rx_desc, E1000_RXDADV_STAT_TS) && 539 !igb_test_staterr(rx_desc, E1000_RXDADV_STAT_TSIP)) 540 igb_ptp_rx_rgtstamp(rx_ring->q_vector, skb); 541 542 /* Update the last_rx_timestamp timer in order to enable watchdog check 543 * for error case of latched timestamp on a dropped packet. 544 */ 545 rx_ring->last_rx_timestamp = jiffies; 546} 547 548int igb_ptp_hwtstamp_ioctl(struct net_device *netdev, struct ifreq *ifr, 549 int cmd); 550#ifdef CONFIG_IGB_HWMON 551void igb_sysfs_exit(struct igb_adapter *adapter); 552int igb_sysfs_init(struct igb_adapter *adapter); 553#endif 554static inline s32 igb_reset_phy(struct e1000_hw *hw) 555{ 556 if (hw->phy.ops.reset) 557 return hw->phy.ops.reset(hw); 558 559 return 0; 560} 561 562static inline s32 igb_read_phy_reg(struct e1000_hw *hw, u32 offset, u16 *data) 563{ 564 if (hw->phy.ops.read_reg) 565 return hw->phy.ops.read_reg(hw, offset, data); 566 567 return 0; 568} 569 570static inline s32 igb_write_phy_reg(struct e1000_hw *hw, u32 offset, u16 data) 571{ 572 if (hw->phy.ops.write_reg) 573 return hw->phy.ops.write_reg(hw, offset, data); 574 575 return 0; 576} 577 578static inline s32 igb_get_phy_info(struct e1000_hw *hw) 579{ 580 if (hw->phy.ops.get_phy_info) 581 return hw->phy.ops.get_phy_info(hw); 582 583 return 0; 584} 585 586static inline struct netdev_queue *txring_txq(const struct igb_ring *tx_ring) 587{ 588 return netdev_get_tx_queue(tx_ring->netdev, tx_ring->queue_index); 589} 590 591#endif /* _IGB_H_ */ 592