drivers/net/e1000e/e1000.h

   1 /*******************************************************************************
   2
   3   Intel PRO/1000 Linux driver
   4   Copyright(c) 1999 - 2007 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   Linux NICS <linux.nics@intel.com>
  24   e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
  25   Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  26
  27 *******************************************************************************/
  28
  29 /* Linux PRO/1000 Ethernet Driver main header file */
  30
  31 #ifndef _E1000_H_
  32 #define _E1000_H_
  33
  34 #include <linux/types.h>
  35 #include <linux/timer.h>
  36 #include <linux/workqueue.h>
  37 #include <linux/io.h>
  38 #include <linux/netdevice.h>
  39
  40 #include "hw.h"
  41
  42 struct e1000_info;
  43
  44 #define ndev_printk(level, netdev, format, arg...) \
  45 <<<<<<< HEAD:drivers/net/e1000e/e1000.h
  46         printk(level "%s: %s: " format, (netdev)->dev.parent->bus_id, \
  47                (netdev)->name, ## arg)
  48 =======
  49         printk(level "%s: " format, (netdev)->name, ## arg)
  50 >>>>>>> 264e3e889d86e552b4191d69bb60f4f3b383135a:drivers/net/e1000e/e1000.h
  51
  52 #ifdef DEBUG
  53 #define ndev_dbg(netdev, format, arg...) \
  54         ndev_printk(KERN_DEBUG , netdev, format, ## arg)
  55 #else
  56 #define ndev_dbg(netdev, format, arg...) do { (void)(netdev); } while (0)
  57 #endif
  58
  59 #define ndev_err(netdev, format, arg...) \
  60         ndev_printk(KERN_ERR , netdev, format, ## arg)
  61 #define ndev_info(netdev, format, arg...) \
  62         ndev_printk(KERN_INFO , netdev, format, ## arg)
  63 #define ndev_warn(netdev, format, arg...) \
  64         ndev_printk(KERN_WARNING , netdev, format, ## arg)
  65 #define ndev_notice(netdev, format, arg...) \
  66         ndev_printk(KERN_NOTICE , netdev, format, ## arg)
  67
  68
  69 /* TX/RX descriptor defines */
  70 #define E1000_DEFAULT_TXD               256
  71 #define E1000_MAX_TXD                   4096
  72 #define E1000_MIN_TXD                   80
  73
  74 #define E1000_DEFAULT_RXD               256
  75 #define E1000_MAX_RXD                   4096
  76 #define E1000_MIN_RXD                   80
  77
  78 /* Early Receive defines */
  79 #define E1000_ERT_2048                  0x100
  80
  81 #define E1000_FC_PAUSE_TIME             0x0680 /* 858 usec */
  82
  83 /* How many Tx Descriptors do we need to call netif_wake_queue ? */
  84 /* How many Rx Buffers do we bundle into one write to the hardware ? */
  85 #define E1000_RX_BUFFER_WRITE           16 /* Must be power of 2 */
  86
  87 #define AUTO_ALL_MODES                  0
  88 #define E1000_EEPROM_APME               0x0400
  89
  90 #define E1000_MNG_VLAN_NONE             (-1)
  91
  92 /* Number of packet split data buffers (not including the header buffer) */
  93 #define PS_PAGE_BUFFERS                 (MAX_PS_BUFFERS - 1)
  94
  95 enum e1000_boards {
  96         board_82571,
  97         board_82572,
  98         board_82573,
  99         board_80003es2lan,
 100         board_ich8lan,
 101         board_ich9lan,
 102 };
 103
 104 struct e1000_queue_stats {
 105         u64 packets;
 106         u64 bytes;
 107 };
 108
 109 struct e1000_ps_page {
 110         struct page *page;
 111         u64 dma; /* must be u64 - written to hw */
 112 };
 113
 114 /*
 115  * wrappers around a pointer to a socket buffer,
 116  * so a DMA handle can be stored along with the buffer
 117  */
 118 struct e1000_buffer {
 119         dma_addr_t dma;
 120         struct sk_buff *skb;
 121         union {
 122                 /* TX */
 123                 struct {
 124                         unsigned long time_stamp;
 125                         u16 length;
 126                         u16 next_to_watch;
 127                 };
 128                 /* RX */
 129                 /* arrays of page information for packet split */
 130                 struct e1000_ps_page *ps_pages;
 131         };
 132
 133 };
 134
 135 struct e1000_ring {
 136         void *desc;                     /* pointer to ring memory  */
 137         dma_addr_t dma;                 /* phys address of ring    */
 138         unsigned int size;              /* length of ring in bytes */
 139         unsigned int count;             /* number of desc. in ring */
 140
 141         u16 next_to_use;
 142         u16 next_to_clean;
 143
 144         u16 head;
 145         u16 tail;
 146
 147         /* array of buffer information structs */
 148         struct e1000_buffer *buffer_info;
 149
 150         struct sk_buff *rx_skb_top;
 151
 152         struct e1000_queue_stats stats;
 153 };
 154
 155 /* board specific private data structure */
 156 struct e1000_adapter {
 157         struct timer_list watchdog_timer;
 158         struct timer_list phy_info_timer;
 159         struct timer_list blink_timer;
 160
 161         struct work_struct reset_task;
 162         struct work_struct watchdog_task;
 163
 164         const struct e1000_info *ei;
 165
 166         struct vlan_group *vlgrp;
 167         u32 bd_number;
 168         u32 rx_buffer_len;
 169         u16 mng_vlan_id;
 170         u16 link_speed;
 171         u16 link_duplex;
 172
 173         spinlock_t tx_queue_lock; /* prevent concurrent tail updates */
 174
 175         /* this is still needed for 82571 and above */
 176         atomic_t irq_sem;
 177
 178         /* track device up/down/testing state */
 179         unsigned long state;
 180
 181         /* Interrupt Throttle Rate */
 182         u32 itr;
 183         u32 itr_setting;
 184         u16 tx_itr;
 185         u16 rx_itr;
 186
 187         /*
 188          * TX
 189          */
 190         struct e1000_ring *tx_ring /* One per active queue */
 191                                                 ____cacheline_aligned_in_smp;
 192
 193         struct napi_struct napi;
 194
 195         unsigned long tx_queue_len;
 196         unsigned int restart_queue;
 197         u32 txd_cmd;
 198
 199         bool detect_tx_hung;
 200         u8 tx_timeout_factor;
 201
 202         u32 tx_int_delay;
 203         u32 tx_abs_int_delay;
 204
 205         unsigned int total_tx_bytes;
 206         unsigned int total_tx_packets;
 207         unsigned int total_rx_bytes;
 208         unsigned int total_rx_packets;
 209
 210         /* TX stats */
 211         u64 tpt_old;
 212         u64 colc_old;
 213         u64 gotcl_old;
 214         u32 gotcl;
 215         u32 tx_timeout_count;
 216         u32 tx_fifo_head;
 217         u32 tx_head_addr;
 218         u32 tx_fifo_size;
 219         u32 tx_dma_failed;
 220
 221         /*
 222          * RX
 223          */
 224         bool (*clean_rx) (struct e1000_adapter *adapter,
 225                           int *work_done, int work_to_do)
 226                                                 ____cacheline_aligned_in_smp;
 227         void (*alloc_rx_buf) (struct e1000_adapter *adapter,
 228                               int cleaned_count);
 229         struct e1000_ring *rx_ring;
 230
 231         u32 rx_int_delay;
 232         u32 rx_abs_int_delay;
 233
 234         /* RX stats */
 235         u64 hw_csum_err;
 236         u64 hw_csum_good;
 237         u64 rx_hdr_split;
 238         u64 gorcl_old;
 239         u32 gorcl;
 240         u32 alloc_rx_buff_failed;
 241         u32 rx_dma_failed;
 242
 243         unsigned int rx_ps_pages;
 244         u16 rx_ps_bsize0;
 245
 246         /* OS defined structs */
 247         struct net_device *netdev;
 248         struct pci_dev *pdev;
 249         struct net_device_stats net_stats;
 250         spinlock_t stats_lock;      /* prevent concurrent stats updates */
 251
 252         /* structs defined in e1000_hw.h */
 253         struct e1000_hw hw;
 254
 255         struct e1000_hw_stats stats;
 256         struct e1000_phy_info phy_info;
 257         struct e1000_phy_stats phy_stats;
 258
 259         struct e1000_ring test_tx_ring;
 260         struct e1000_ring test_rx_ring;
 261         u32 test_icr;
 262
 263         u32 msg_enable;
 264
 265         u32 eeprom_wol;
 266         u32 wol;
 267         u32 pba;
 268
 269         u8 fc_autoneg;
 270
 271         unsigned long led_status;
 272
 273         unsigned int flags;
 274 };
 275
 276 struct e1000_info {
 277         enum e1000_mac_type     mac;
 278         unsigned int            flags;
 279         u32                     pba;
 280         s32                     (*get_invariants)(struct e1000_adapter *);
 281         struct e1000_mac_operations *mac_ops;
 282         struct e1000_phy_operations *phy_ops;
 283         struct e1000_nvm_operations *nvm_ops;
 284 };
 285
 286 /* hardware capability, feature, and workaround flags */
 287 #define FLAG_HAS_AMT                      (1 << 0)
 288 #define FLAG_HAS_FLASH                    (1 << 1)
 289 #define FLAG_HAS_HW_VLAN_FILTER           (1 << 2)
 290 #define FLAG_HAS_WOL                      (1 << 3)
 291 #define FLAG_HAS_ERT                      (1 << 4)
 292 #define FLAG_HAS_CTRLEXT_ON_LOAD          (1 << 5)
 293 #define FLAG_HAS_SWSM_ON_LOAD             (1 << 6)
 294 #define FLAG_HAS_JUMBO_FRAMES             (1 << 7)
 295 #define FLAG_HAS_STATS_ICR_ICT            (1 << 9)
 296 #define FLAG_HAS_STATS_PTC_PRC            (1 << 10)
 297 #define FLAG_HAS_SMART_POWER_DOWN         (1 << 11)
 298 #define FLAG_IS_QUAD_PORT_A               (1 << 12)
 299 #define FLAG_IS_QUAD_PORT                 (1 << 13)
 300 #define FLAG_TIPG_MEDIUM_FOR_80003ESLAN   (1 << 14)
 301 #define FLAG_APME_IN_WUC                  (1 << 15)
 302 #define FLAG_APME_IN_CTRL3                (1 << 16)
 303 #define FLAG_APME_CHECK_PORT_B            (1 << 17)
 304 #define FLAG_DISABLE_FC_PAUSE_TIME        (1 << 18)
 305 #define FLAG_NO_WAKE_UCAST                (1 << 19)
 306 #define FLAG_MNG_PT_ENABLED               (1 << 20)
 307 #define FLAG_RESET_OVERWRITES_LAA         (1 << 21)
 308 #define FLAG_TARC_SPEED_MODE_BIT          (1 << 22)
 309 #define FLAG_TARC_SET_BIT_ZERO            (1 << 23)
 310 #define FLAG_RX_NEEDS_RESTART             (1 << 24)
 311 #define FLAG_LSC_GIG_SPEED_DROP           (1 << 25)
 312 #define FLAG_SMART_POWER_DOWN             (1 << 26)
 313 #define FLAG_MSI_ENABLED                  (1 << 27)
 314 #define FLAG_RX_CSUM_ENABLED              (1 << 28)
 315 #define FLAG_TSO_FORCE                    (1 << 29)
 316
 317 #define E1000_RX_DESC_PS(R, i)      \
 318         (&(((union e1000_rx_desc_packet_split *)((R).desc))[i]))
 319 #define E1000_GET_DESC(R, i, type)      (&(((struct type *)((R).desc))[i]))
 320 #define E1000_RX_DESC(R, i)             E1000_GET_DESC(R, i, e1000_rx_desc)
 321 #define E1000_TX_DESC(R, i)             E1000_GET_DESC(R, i, e1000_tx_desc)
 322 #define E1000_CONTEXT_DESC(R, i)        E1000_GET_DESC(R, i, e1000_context_desc)
 323
 324 enum e1000_state_t {
 325         __E1000_TESTING,
 326         __E1000_RESETTING,
 327         __E1000_DOWN
 328 };
 329
 330 enum latency_range {
 331         lowest_latency = 0,
 332         low_latency = 1,
 333         bulk_latency = 2,
 334         latency_invalid = 255
 335 };
 336
 337 extern char e1000e_driver_name[];
 338 extern const char e1000e_driver_version[];
 339
 340 extern void e1000e_check_options(struct e1000_adapter *adapter);
 341 extern void e1000e_set_ethtool_ops(struct net_device *netdev);
 342
 343 extern int e1000e_up(struct e1000_adapter *adapter);
 344 extern void e1000e_down(struct e1000_adapter *adapter);
 345 extern void e1000e_reinit_locked(struct e1000_adapter *adapter);
 346 extern void e1000e_reset(struct e1000_adapter *adapter);
 347 extern void e1000e_power_up_phy(struct e1000_adapter *adapter);
 348 extern int e1000e_setup_rx_resources(struct e1000_adapter *adapter);
 349 extern int e1000e_setup_tx_resources(struct e1000_adapter *adapter);
 350 extern void e1000e_free_rx_resources(struct e1000_adapter *adapter);
 351 extern void e1000e_free_tx_resources(struct e1000_adapter *adapter);
 352 extern void e1000e_update_stats(struct e1000_adapter *adapter);
 353
 354 extern unsigned int copybreak;
 355
 356 extern char *e1000e_get_hw_dev_name(struct e1000_hw *hw);
 357
 358 extern struct e1000_info e1000_82571_info;
 359 extern struct e1000_info e1000_82572_info;
 360 extern struct e1000_info e1000_82573_info;
 361 extern struct e1000_info e1000_ich8_info;
 362 extern struct e1000_info e1000_ich9_info;
 363 extern struct e1000_info e1000_es2_info;
 364
 365 extern s32 e1000e_read_part_num(struct e1000_hw *hw, u32 *part_num);
 366
 367 extern s32  e1000e_commit_phy(struct e1000_hw *hw);
 368
 369 extern bool e1000e_enable_mng_pass_thru(struct e1000_hw *hw);
 370
 371 extern bool e1000e_get_laa_state_82571(struct e1000_hw *hw);
 372 extern void e1000e_set_laa_state_82571(struct e1000_hw *hw, bool state);
 373
 374 extern void e1000e_set_kmrn_lock_loss_workaround_ich8lan(struct e1000_hw *hw,
 375                                                  bool state);
 376 extern void e1000e_igp3_phy_powerdown_workaround_ich8lan(struct e1000_hw *hw);
 377 extern void e1000e_gig_downshift_workaround_ich8lan(struct e1000_hw *hw);
 378
 379 extern s32 e1000e_check_for_copper_link(struct e1000_hw *hw);
 380 extern s32 e1000e_check_for_fiber_link(struct e1000_hw *hw);
 381 extern s32 e1000e_check_for_serdes_link(struct e1000_hw *hw);
 382 extern s32 e1000e_cleanup_led_generic(struct e1000_hw *hw);
 383 extern s32 e1000e_led_on_generic(struct e1000_hw *hw);
 384 extern s32 e1000e_led_off_generic(struct e1000_hw *hw);
 385 extern s32 e1000e_get_bus_info_pcie(struct e1000_hw *hw);
 386 extern s32 e1000e_get_speed_and_duplex_copper(struct e1000_hw *hw, u16 *speed, u16 *duplex);
 387 extern s32 e1000e_get_speed_and_duplex_fiber_serdes(struct e1000_hw *hw, u16 *speed, u16 *duplex);
 388 extern s32 e1000e_disable_pcie_master(struct e1000_hw *hw);
 389 extern s32 e1000e_get_auto_rd_done(struct e1000_hw *hw);
 390 extern s32 e1000e_id_led_init(struct e1000_hw *hw);
 391 extern void e1000e_clear_hw_cntrs_base(struct e1000_hw *hw);
 392 extern s32 e1000e_setup_fiber_serdes_link(struct e1000_hw *hw);
 393 extern s32 e1000e_copper_link_setup_m88(struct e1000_hw *hw);
 394 extern s32 e1000e_copper_link_setup_igp(struct e1000_hw *hw);
 395 extern s32 e1000e_setup_link(struct e1000_hw *hw);
 396 extern void e1000e_clear_vfta(struct e1000_hw *hw);
 397 extern void e1000e_init_rx_addrs(struct e1000_hw *hw, u16 rar_count);
 398 extern void e1000e_mc_addr_list_update_generic(struct e1000_hw *hw,
 399                                        u8 *mc_addr_list, u32 mc_addr_count,
 400                                        u32 rar_used_count, u32 rar_count);
 401 extern void e1000e_rar_set(struct e1000_hw *hw, u8 *addr, u32 index);
 402 extern s32 e1000e_set_fc_watermarks(struct e1000_hw *hw);
 403 extern void e1000e_set_pcie_no_snoop(struct e1000_hw *hw, u32 no_snoop);
 404 extern s32 e1000e_get_hw_semaphore(struct e1000_hw *hw);
 405 extern s32 e1000e_valid_led_default(struct e1000_hw *hw, u16 *data);
 406 extern void e1000e_config_collision_dist(struct e1000_hw *hw);
 407 extern s32 e1000e_config_fc_after_link_up(struct e1000_hw *hw);
 408 extern s32 e1000e_force_mac_fc(struct e1000_hw *hw);
 409 extern s32 e1000e_blink_led(struct e1000_hw *hw);
 410 extern void e1000e_write_vfta(struct e1000_hw *hw, u32 offset, u32 value);
 411 extern void e1000e_reset_adaptive(struct e1000_hw *hw);
 412 extern void e1000e_update_adaptive(struct e1000_hw *hw);
 413
 414 extern s32 e1000e_setup_copper_link(struct e1000_hw *hw);
 415 extern s32 e1000e_get_phy_id(struct e1000_hw *hw);
 416 extern void e1000e_put_hw_semaphore(struct e1000_hw *hw);
 417 extern s32 e1000e_check_reset_block_generic(struct e1000_hw *hw);
 418 extern s32 e1000e_phy_force_speed_duplex_igp(struct e1000_hw *hw);
 419 extern s32 e1000e_get_cable_length_igp_2(struct e1000_hw *hw);
 420 extern s32 e1000e_get_phy_info_igp(struct e1000_hw *hw);
 421 extern s32 e1000e_read_phy_reg_igp(struct e1000_hw *hw, u32 offset, u16 *data);
 422 extern s32 e1000e_phy_hw_reset_generic(struct e1000_hw *hw);
 423 extern s32 e1000e_set_d3_lplu_state(struct e1000_hw *hw, bool active);
 424 extern s32 e1000e_write_phy_reg_igp(struct e1000_hw *hw, u32 offset, u16 data);
 425 extern s32 e1000e_phy_sw_reset(struct e1000_hw *hw);
 426 extern s32 e1000e_phy_force_speed_duplex_m88(struct e1000_hw *hw);
 427 extern s32 e1000e_get_cfg_done(struct e1000_hw *hw);
 428 extern s32 e1000e_get_cable_length_m88(struct e1000_hw *hw);
 429 extern s32 e1000e_get_phy_info_m88(struct e1000_hw *hw);
 430 extern s32 e1000e_read_phy_reg_m88(struct e1000_hw *hw, u32 offset, u16 *data);
 431 extern s32 e1000e_write_phy_reg_m88(struct e1000_hw *hw, u32 offset, u16 data);
 432 extern enum e1000_phy_type e1000e_get_phy_type_from_id(u32 phy_id);
 433 extern void e1000e_phy_force_speed_duplex_setup(struct e1000_hw *hw, u16 *phy_ctrl);
 434 extern s32 e1000e_write_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 data);
 435 extern s32 e1000e_read_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 *data);
 436 extern s32 e1000e_phy_has_link_generic(struct e1000_hw *hw, u32 iterations,
 437                                u32 usec_interval, bool *success);
 438 extern s32 e1000e_phy_reset_dsp(struct e1000_hw *hw);
 439 extern s32 e1000e_check_downshift(struct e1000_hw *hw);
 440
 441 static inline s32 e1000_phy_hw_reset(struct e1000_hw *hw)
 442 {
 443         return hw->phy.ops.reset_phy(hw);
 444 }
 445
 446 static inline s32 e1000_check_reset_block(struct e1000_hw *hw)
 447 {
 448         return hw->phy.ops.check_reset_block(hw);
 449 }
 450
 451 static inline s32 e1e_rphy(struct e1000_hw *hw, u32 offset, u16 *data)
 452 {
 453         return hw->phy.ops.read_phy_reg(hw, offset, data);
 454 }
 455
 456 static inline s32 e1e_wphy(struct e1000_hw *hw, u32 offset, u16 data)
 457 {
 458         return hw->phy.ops.write_phy_reg(hw, offset, data);
 459 }
 460
 461 static inline s32 e1000_get_cable_length(struct e1000_hw *hw)
 462 {
 463         return hw->phy.ops.get_cable_length(hw);
 464 }
 465
 466 extern s32 e1000e_acquire_nvm(struct e1000_hw *hw);
 467 extern s32 e1000e_write_nvm_spi(struct e1000_hw *hw, u16 offset, u16 words, u16 *data);
 468 extern s32 e1000e_update_nvm_checksum_generic(struct e1000_hw *hw);
 469 extern s32 e1000e_poll_eerd_eewr_done(struct e1000_hw *hw, int ee_reg);
 470 extern s32 e1000e_read_nvm_spi(struct e1000_hw *hw, u16 offset, u16 words, u16 *data);
 471 extern s32 e1000e_read_nvm_eerd(struct e1000_hw *hw, u16 offset, u16 words, u16 *data);
 472 extern s32 e1000e_validate_nvm_checksum_generic(struct e1000_hw *hw);
 473 extern void e1000e_release_nvm(struct e1000_hw *hw);
 474 extern void e1000e_reload_nvm(struct e1000_hw *hw);
 475 extern s32 e1000e_read_mac_addr(struct e1000_hw *hw);
 476
 477 static inline s32 e1000_validate_nvm_checksum(struct e1000_hw *hw)
 478 {
 479         return hw->nvm.ops.validate_nvm(hw);
 480 }
 481
 482 static inline s32 e1000e_update_nvm_checksum(struct e1000_hw *hw)
 483 {
 484         return hw->nvm.ops.update_nvm(hw);
 485 }
 486
 487 static inline s32 e1000_read_nvm(struct e1000_hw *hw, u16 offset, u16 words, u16 *data)
 488 {
 489         return hw->nvm.ops.read_nvm(hw, offset, words, data);
 490 }
 491
 492 static inline s32 e1000_write_nvm(struct e1000_hw *hw, u16 offset, u16 words, u16 *data)
 493 {
 494         return hw->nvm.ops.write_nvm(hw, offset, words, data);
 495 }
 496
 497 static inline s32 e1000_get_phy_info(struct e1000_hw *hw)
 498 {
 499         return hw->phy.ops.get_phy_info(hw);
 500 }
 501
 502 extern bool e1000e_check_mng_mode(struct e1000_hw *hw);
 503 extern bool e1000e_enable_tx_pkt_filtering(struct e1000_hw *hw);
 504 extern s32 e1000e_mng_write_dhcp_info(struct e1000_hw *hw, u8 *buffer, u16 length);
 505
 506 static inline u32 __er32(struct e1000_hw *hw, unsigned long reg)
 507 {
 508         return readl(hw->hw_addr + reg);
 509 }
 510
 511 static inline void __ew32(struct e1000_hw *hw, unsigned long reg, u32 val)
 512 {
 513         writel(val, hw->hw_addr + reg);
 514 }
 515
 516 #endif /* _E1000_H_ */