doc: whitespace changes in licenses
[dpdk.git] / lib / librte_pmd_ixgbe / ixgbe_ethdev.h
1 /*-
2  *   BSD LICENSE
3  * 
4  *   Copyright(c) 2010-2013 Intel Corporation. All rights reserved.
5  *   All rights reserved.
6  * 
7  *   Redistribution and use in source and binary forms, with or without
8  *   modification, are permitted provided that the following conditions
9  *   are met:
10  * 
11  *     * Redistributions of source code must retain the above copyright
12  *       notice, this list of conditions and the following disclaimer.
13  *     * Redistributions in binary form must reproduce the above copyright
14  *       notice, this list of conditions and the following disclaimer in
15  *       the documentation and/or other materials provided with the
16  *       distribution.
17  *     * Neither the name of Intel Corporation nor the names of its
18  *       contributors may be used to endorse or promote products derived
19  *       from this software without specific prior written permission.
20  * 
21  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33
34 #ifndef _IXGBE_ETHDEV_H_
35 #define _IXGBE_ETHDEV_H_
36 #include "ixgbe/ixgbe_dcb.h"
37 #include "ixgbe/ixgbe_dcb_82599.h"
38 #include "ixgbe/ixgbe_dcb_82598.h"
39
40 /* need update link, bit flag */
41 #define IXGBE_FLAG_NEED_LINK_UPDATE (uint32_t)(1 << 0)
42 #define IXGBE_FLAG_MAILBOX          (uint32_t)(1 << 1)
43
44 /*
45  * Defines that were not part of ixgbe_type.h as they are not used by the
46  * FreeBSD driver.
47  */
48 #define IXGBE_ADVTXD_MAC_1588       0x00080000 /* IEEE1588 Timestamp packet */
49 #define IXGBE_RXD_STAT_TMST         0x10000    /* Timestamped Packet indication */
50 #define IXGBE_ADVTXD_TUCMD_L4T_RSV  0x00001800 /* L4 Packet TYPE, resvd  */
51 #define IXGBE_RXDADV_ERR_CKSUM_BIT  30
52 #define IXGBE_RXDADV_ERR_CKSUM_MSK  3
53 #define IXGBE_ADVTXD_MACLEN_SHIFT   9          /* Bit shift for l2_len */
54 #define IXGBE_NB_STAT_MAPPING_REGS  32
55 #define IXGBE_EXTENDED_VLAN       (uint32_t)(1 << 26) /* EXTENDED VLAN ENABLE */
56 #define IXGBE_VFTA_SIZE 128
57 #define IXGBE_VLAN_TAG_SIZE 4
58 #define IXGBE_MAX_RX_QUEUE_NUM  128
59 #ifndef NBBY
60 #define NBBY    8       /* number of bits in a byte */
61 #endif
62 #define IXGBE_HWSTRIP_BITMAP_SIZE (IXGBE_MAX_RX_QUEUE_NUM / (sizeof(uint32_t) * NBBY))
63
64
65 /*
66  * Information about the fdir mode.
67  */
68 struct ixgbe_hw_fdir_info {
69         uint16_t    collision;
70         uint16_t    free;
71         uint16_t    maxhash;
72         uint8_t     maxlen;
73         uint64_t    add;
74         uint64_t    remove;
75         uint64_t    f_add;
76         uint64_t    f_remove;
77 };
78
79 /* structure for interrupt relative data */
80 struct ixgbe_interrupt {
81         uint32_t flags;
82         uint32_t mask;
83 };
84
85 struct ixgbe_stat_mapping_registers {
86         uint32_t tqsm[IXGBE_NB_STAT_MAPPING_REGS];
87         uint32_t rqsmr[IXGBE_NB_STAT_MAPPING_REGS];
88 };
89
90 struct ixgbe_vfta {
91         uint32_t vfta[IXGBE_VFTA_SIZE];
92 };
93
94 struct ixgbe_hwstrip {
95         uint32_t bitmap[IXGBE_HWSTRIP_BITMAP_SIZE];
96 };
97
98 /*
99  * VF data which used by PF host only
100  */
101 #define IXGBE_MAX_VF_MC_ENTRIES         30
102 struct ixgbe_vf_info {
103         uint8_t vf_mac_addresses[ETHER_ADDR_LEN];
104         uint16_t vf_mc_hashes[IXGBE_MAX_VF_MC_ENTRIES];
105         uint16_t num_vf_mc_hashes;
106         uint16_t default_vf_vlan_id;
107         uint16_t vlans_enabled;
108         bool clear_to_send;
109         uint16_t tx_rate;
110         uint16_t vlan_count;
111         uint8_t spoofchk_enabled;
112 };
113
114 /*
115  * Structure to store private data for each driver instance (for each port).
116  */
117 struct ixgbe_adapter {
118         struct ixgbe_hw             hw;
119         struct ixgbe_hw_stats       stats;
120         struct ixgbe_hw_fdir_info   fdir;
121         struct ixgbe_interrupt      intr;
122         struct ixgbe_stat_mapping_registers stat_mappings;
123         struct ixgbe_vfta           shadow_vfta;
124         struct ixgbe_hwstrip            hwstrip;
125         struct ixgbe_dcb_config     dcb_config;
126         struct ixgbe_vf_info        *vfdata;
127 };
128
129 #define IXGBE_DEV_PRIVATE_TO_HW(adapter)\
130         (&((struct ixgbe_adapter *)adapter)->hw)
131
132 #define IXGBE_DEV_PRIVATE_TO_STATS(adapter) \
133         (&((struct ixgbe_adapter *)adapter)->stats)
134
135 #define IXGBE_DEV_PRIVATE_TO_INTR(adapter) \
136         (&((struct ixgbe_adapter *)adapter)->intr)
137
138 #define IXGBE_DEV_PRIVATE_TO_FDIR_INFO(adapter) \
139         (&((struct ixgbe_adapter *)adapter)->fdir)
140
141 #define IXGBE_DEV_PRIVATE_TO_STAT_MAPPINGS(adapter) \
142         (&((struct ixgbe_adapter *)adapter)->stat_mappings)
143
144 #define IXGBE_DEV_PRIVATE_TO_VFTA(adapter) \
145         (&((struct ixgbe_adapter *)adapter)->shadow_vfta)
146
147 #define IXGBE_DEV_PRIVATE_TO_HWSTRIP_BITMAP(adapter) \
148         (&((struct ixgbe_adapter *)adapter)->hwstrip)
149
150 #define IXGBE_DEV_PRIVATE_TO_DCB_CFG(adapter) \
151         (&((struct ixgbe_adapter *)adapter)->dcb_config)
152
153 #define IXGBE_DEV_PRIVATE_TO_P_VFDATA(adapter) \
154         (&((struct ixgbe_adapter *)adapter)->vfdata)
155
156 /*
157  * RX/TX function prototypes
158  */
159 void ixgbe_dev_clear_queues(struct rte_eth_dev *dev);
160
161 void ixgbe_dev_rx_queue_release(void *rxq);
162
163 void ixgbe_dev_tx_queue_release(void *txq);
164
165 int  ixgbe_dev_rx_queue_setup(struct rte_eth_dev *dev, uint16_t rx_queue_id,
166                 uint16_t nb_rx_desc, unsigned int socket_id,
167                 const struct rte_eth_rxconf *rx_conf,
168                 struct rte_mempool *mb_pool);
169
170 int  ixgbe_dev_tx_queue_setup(struct rte_eth_dev *dev, uint16_t tx_queue_id,
171                 uint16_t nb_tx_desc, unsigned int socket_id,
172                 const struct rte_eth_txconf *tx_conf);
173
174 uint32_t ixgbe_dev_rx_queue_count(struct rte_eth_dev *dev, 
175                 uint16_t rx_queue_id);
176
177 int ixgbe_dev_rx_descriptor_done(void *rx_queue, uint16_t offset);
178
179 int ixgbe_dev_rx_init(struct rte_eth_dev *dev);
180
181 void ixgbe_dev_tx_init(struct rte_eth_dev *dev);
182
183 void ixgbe_dev_rxtx_start(struct rte_eth_dev *dev);
184
185 int ixgbevf_dev_rx_init(struct rte_eth_dev *dev);
186
187 void ixgbevf_dev_tx_init(struct rte_eth_dev *dev);
188
189 void ixgbevf_dev_rxtx_start(struct rte_eth_dev *dev);
190
191 uint16_t ixgbe_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
192                 uint16_t nb_pkts);
193
194 #ifdef RTE_LIBRTE_IXGBE_RX_ALLOW_BULK_ALLOC
195 uint16_t ixgbe_recv_pkts_bulk_alloc(void *rx_queue, struct rte_mbuf **rx_pkts,
196                 uint16_t nb_pkts);
197 #endif
198
199 uint16_t ixgbe_recv_scattered_pkts(void *rx_queue,
200                 struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
201
202 uint16_t ixgbe_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
203                 uint16_t nb_pkts);
204
205 uint16_t ixgbe_xmit_pkts_simple(void *tx_queue, struct rte_mbuf **tx_pkts,
206                 uint16_t nb_pkts);
207
208 /*
209  * Flow director function prototypes
210  */
211 int ixgbe_fdir_configure(struct rte_eth_dev *dev);
212
213 int ixgbe_fdir_add_signature_filter(struct rte_eth_dev *dev,
214                 struct rte_fdir_filter *fdir_filter, uint8_t queue);
215
216 int ixgbe_fdir_update_signature_filter(struct rte_eth_dev *dev,
217                 struct rte_fdir_filter *fdir_filter, uint8_t queue);
218
219 int ixgbe_fdir_remove_signature_filter(struct rte_eth_dev *dev,
220                 struct rte_fdir_filter *fdir_filter);
221
222 void ixgbe_fdir_info_get(struct rte_eth_dev *dev,
223                 struct rte_eth_fdir *fdir);
224
225 int ixgbe_fdir_add_perfect_filter(struct rte_eth_dev *dev,
226                 struct rte_fdir_filter *fdir_filter, uint16_t soft_id,
227                 uint8_t queue, uint8_t drop);
228
229 int ixgbe_fdir_update_perfect_filter(struct rte_eth_dev *dev,
230                 struct rte_fdir_filter *fdir_filter,uint16_t soft_id,
231                 uint8_t queue, uint8_t drop);
232
233 int ixgbe_fdir_remove_perfect_filter(struct rte_eth_dev *dev,
234                 struct rte_fdir_filter *fdir_filter, uint16_t soft_id);
235
236 int ixgbe_fdir_set_masks(struct rte_eth_dev *dev,
237                 struct rte_fdir_masks *fdir_masks);
238
239 void ixgbe_configure_dcb(struct rte_eth_dev *dev);
240
241 /*
242  * misc function prototypes
243  */
244 void ixgbe_vlan_hw_filter_enable(struct rte_eth_dev *dev);
245
246 void ixgbe_vlan_hw_filter_disable(struct rte_eth_dev *dev);
247
248 void ixgbe_vlan_hw_strip_enable_all(struct rte_eth_dev *dev);
249
250 void ixgbe_vlan_hw_strip_disable_all(struct rte_eth_dev *dev);
251
252 void ixgbe_pf_host_init(struct rte_eth_dev *eth_dev);
253
254 void ixgbe_pf_mbx_process(struct rte_eth_dev *eth_dev);
255
256 int ixgbe_pf_host_configure(struct rte_eth_dev *eth_dev);
257
258
259 #endif /* _IXGBE_ETHDEV_H_ */