drivers/net/sfc/falcon.h

   1 /****************************************************************************
   2  * Driver for Solarflare Solarstorm network controllers and boards
   3  * Copyright 2005-2006 Fen Systems Ltd.
   4  * Copyright 2006-2008 Solarflare Communications Inc.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License version 2 as published
   8  * by the Free Software Foundation, incorporated herein by reference.
   9  */
  10
  11 #ifndef EFX_FALCON_H
  12 #define EFX_FALCON_H
  13
  14 #include <linux/i2c-algo-bit.h>
  15 #include "net_driver.h"
  16 #include "efx.h"
  17
  18 /*
  19  * Falcon hardware control
  20  */
  21
  22 enum {
  23         EFX_REV_FALCON_A0 = 0,
  24         EFX_REV_FALCON_A1 = 1,
  25         EFX_REV_FALCON_B0 = 2,
  26 };
  27
  28 static inline int efx_nic_rev(struct efx_nic *efx)
  29 {
  30         return efx->type->revision;
  31 }
  32
  33 /**
  34  * struct falcon_board_type - board operations and type information
  35  * @id: Board type id, as found in NVRAM
  36  * @ref_model: Model number of Solarflare reference design
  37  * @gen_type: Generic board type description
  38  * @init: Allocate resources and initialise peripheral hardware
  39  * @init_phy: Do board-specific PHY initialisation
  40  * @fini: Shut down hardware and free resources
  41  * @set_id_led: Set state of identifying LED or revert to automatic function
  42  * @monitor: Board-specific health check function
  43  */
  44 struct falcon_board_type {
  45         u8 id;
  46         const char *ref_model;
  47         const char *gen_type;
  48         int (*init) (struct efx_nic *nic);
  49         void (*init_phy) (struct efx_nic *efx);
  50         void (*fini) (struct efx_nic *nic);
  51         void (*set_id_led) (struct efx_nic *efx, enum efx_led_mode mode);
  52         int (*monitor) (struct efx_nic *nic);
  53 };
  54
  55 /**
  56  * struct falcon_board - board information
  57  * @type: Type of board
  58  * @major: Major rev. ('A', 'B' ...)
  59  * @minor: Minor rev. (0, 1, ...)
  60  * @i2c_adap: I2C adapter for on-board peripherals
  61  * @i2c_data: Data for bit-banging algorithm
  62  * @hwmon_client: I2C client for hardware monitor
  63  * @ioexp_client: I2C client for power/port control
  64  */
  65 struct falcon_board {
  66         const struct falcon_board_type *type;
  67         int major;
  68         int minor;
  69         struct i2c_adapter i2c_adap;
  70         struct i2c_algo_bit_data i2c_data;
  71         struct i2c_client *hwmon_client, *ioexp_client;
  72 };
  73
  74 /**
  75  * struct falcon_nic_data - Falcon NIC state
  76  * @pci_dev2: Secondary function of Falcon A
  77  * @board: Board state and functions
  78  * @stats_disable_count: Nest count for disabling statistics fetches
  79  * @stats_pending: Is there a pending DMA of MAC statistics.
  80  * @stats_timer: A timer for regularly fetching MAC statistics.
  81  * @stats_dma_done: Pointer to the flag which indicates DMA completion.
  82  */
  83 struct falcon_nic_data {
  84         struct pci_dev *pci_dev2;
  85         struct falcon_board board;
  86         unsigned int stats_disable_count;
  87         bool stats_pending;
  88         struct timer_list stats_timer;
  89         u32 *stats_dma_done;
  90 };
  91
  92 static inline struct falcon_board *falcon_board(struct efx_nic *efx)
  93 {
  94         struct falcon_nic_data *data = efx->nic_data;
  95         return &data->board;
  96 }
  97
  98 extern struct efx_nic_type falcon_a1_nic_type;
  99 extern struct efx_nic_type falcon_b0_nic_type;
 100
 101 /**************************************************************************
 102  *
 103  * Externs
 104  *
 105  **************************************************************************
 106  */
 107
 108 extern void falcon_probe_board(struct efx_nic *efx, u16 revision_info);
 109
 110 /* TX data path */
 111 extern int falcon_probe_tx(struct efx_tx_queue *tx_queue);
 112 extern void falcon_init_tx(struct efx_tx_queue *tx_queue);
 113 extern void falcon_fini_tx(struct efx_tx_queue *tx_queue);
 114 extern void falcon_remove_tx(struct efx_tx_queue *tx_queue);
 115 extern void falcon_push_buffers(struct efx_tx_queue *tx_queue);
 116
 117 /* RX data path */
 118 extern int falcon_probe_rx(struct efx_rx_queue *rx_queue);
 119 extern void falcon_init_rx(struct efx_rx_queue *rx_queue);
 120 extern void falcon_fini_rx(struct efx_rx_queue *rx_queue);
 121 extern void falcon_remove_rx(struct efx_rx_queue *rx_queue);
 122 extern void falcon_notify_rx_desc(struct efx_rx_queue *rx_queue);
 123
 124 /* Event data path */
 125 extern int falcon_probe_eventq(struct efx_channel *channel);
 126 extern void falcon_init_eventq(struct efx_channel *channel);
 127 extern void falcon_fini_eventq(struct efx_channel *channel);
 128 extern void falcon_remove_eventq(struct efx_channel *channel);
 129 extern int falcon_process_eventq(struct efx_channel *channel, int rx_quota);
 130 extern void falcon_eventq_read_ack(struct efx_channel *channel);
 131
 132 /* MAC/PHY */
 133 extern int falcon_switch_mac(struct efx_nic *efx);
 134 extern bool falcon_xaui_link_ok(struct efx_nic *efx);
 135 extern void falcon_drain_tx_fifo(struct efx_nic *efx);
 136 extern void falcon_deconfigure_mac_wrapper(struct efx_nic *efx);
 137 extern void falcon_reconfigure_mac_wrapper(struct efx_nic *efx);
 138
 139 /* Interrupts and test events */
 140 extern int falcon_init_interrupt(struct efx_nic *efx);
 141 extern void falcon_enable_interrupts(struct efx_nic *efx);
 142 extern void falcon_generate_test_event(struct efx_channel *channel,
 143                                        unsigned int magic);
 144 extern void falcon_generate_interrupt(struct efx_nic *efx);
 145 extern void falcon_disable_interrupts(struct efx_nic *efx);
 146 extern void falcon_fini_interrupt(struct efx_nic *efx);
 147
 148 #define FALCON_IRQ_MOD_RESOLUTION 5
 149
 150 /* Global Resources */
 151 extern int falcon_flush_queues(struct efx_nic *efx);
 152 extern void falcon_start_nic_stats(struct efx_nic *efx);
 153 extern void falcon_stop_nic_stats(struct efx_nic *efx);
 154 extern int falcon_reset_xaui(struct efx_nic *efx);
 155
 156 /* Tests */
 157 struct falcon_nvconfig;
 158 extern int falcon_read_nvram(struct efx_nic *efx,
 159                              struct falcon_nvconfig *nvconfig);
 160 extern int falcon_test_registers(struct efx_nic *efx);
 161
 162 /**************************************************************************
 163  *
 164  * Falcon MAC stats
 165  *
 166  **************************************************************************
 167  */
 168
 169 #define FALCON_STAT_OFFSET(falcon_stat) EFX_VAL(falcon_stat, offset)
 170 #define FALCON_STAT_WIDTH(falcon_stat) EFX_VAL(falcon_stat, WIDTH)
 171
 172 /* Retrieve statistic from statistics block */
 173 #define FALCON_STAT(efx, falcon_stat, efx_stat) do {            \
 174         if (FALCON_STAT_WIDTH(falcon_stat) == 16)               \
 175                 (efx)->mac_stats.efx_stat += le16_to_cpu(       \
 176                         *((__force __le16 *)                            \
 177                           (efx->stats_buffer.addr +             \
 178                            FALCON_STAT_OFFSET(falcon_stat))));  \
 179         else if (FALCON_STAT_WIDTH(falcon_stat) == 32)          \
 180                 (efx)->mac_stats.efx_stat += le32_to_cpu(       \
 181                         *((__force __le32 *)                            \
 182                           (efx->stats_buffer.addr +             \
 183                            FALCON_STAT_OFFSET(falcon_stat))));  \
 184         else                                                    \
 185                 (efx)->mac_stats.efx_stat += le64_to_cpu(       \
 186                         *((__force __le64 *)                            \
 187                           (efx->stats_buffer.addr +             \
 188                            FALCON_STAT_OFFSET(falcon_stat))));  \
 189         } while (0)
 190
 191 #define FALCON_MAC_STATS_SIZE 0x100
 192
 193 #define MAC_DATA_LBN 0
 194 #define MAC_DATA_WIDTH 32
 195
 196 extern void falcon_generate_event(struct efx_channel *channel,
 197                                   efx_qword_t *event);
 198
 199 extern void falcon_poll_xmac(struct efx_nic *efx);
 200
 201 #endif /* EFX_FALCON_H */