1/*******************************************************************************
2 *
3 * Intel Ethernet Controller XL710 Family Linux Driver
4 * Copyright(c) 2013 - 2014 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
16 * with this program.  If not, see <http://www.gnu.org/licenses/>.
17 *
18 * The full GNU General Public License is included in this distribution in
19 * the file called "COPYING".
20 *
21 * Contact Information:
22 * e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
23 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
24 *
25 ******************************************************************************/
26
27#ifndef _I40E_LAN_HMC_H_
28#define _I40E_LAN_HMC_H_
29
30/* forward-declare the HW struct for the compiler */
31struct i40e_hw;
32
33/* HMC element context information */
34
35/* Rx queue context data
36 *
37 * The sizes of the variables may be larger than needed due to crossing byte
38 * boundaries. If we do not have the width of the variable set to the correct
39 * size then we could end up shifting bits off the top of the variable when the
40 * variable is at the top of a byte and crosses over into the next byte.
41 */
42struct i40e_hmc_obj_rxq {
43	u16 head;
44	u16 cpuid; /* bigger than needed, see above for reason */
45	u64 base;
46	u16 qlen;
47#define I40E_RXQ_CTX_DBUFF_SHIFT 7
48	u16 dbuff; /* bigger than needed, see above for reason */
49#define I40E_RXQ_CTX_HBUFF_SHIFT 6
50	u16 hbuff; /* bigger than needed, see above for reason */
51	u8  dtype;
52	u8  dsize;
53	u8  crcstrip;
54	u8  fc_ena;
55	u8  l2tsel;
56	u8  hsplit_0;
57	u8  hsplit_1;
58	u8  showiv;
59	u32 rxmax; /* bigger than needed, see above for reason */
60	u8  tphrdesc_ena;
61	u8  tphwdesc_ena;
62	u8  tphdata_ena;
63	u8  tphhead_ena;
64	u16 lrxqthresh; /* bigger than needed, see above for reason */
65	u8  prefena;	/* NOTE: normally must be set to 1 at init */
66};
67
68/* Tx queue context data
69*
70* The sizes of the variables may be larger than needed due to crossing byte
71* boundaries. If we do not have the width of the variable set to the correct
72* size then we could end up shifting bits off the top of the variable when the
73* variable is at the top of a byte and crosses over into the next byte.
74*/
75struct i40e_hmc_obj_txq {
76	u16 head;
77	u8  new_context;
78	u64 base;
79	u8  fc_ena;
80	u8  timesync_ena;
81	u8  fd_ena;
82	u8  alt_vlan_ena;
83	u16 thead_wb;
84	u8  cpuid;
85	u8  head_wb_ena;
86	u16 qlen;
87	u8  tphrdesc_ena;
88	u8  tphrpacket_ena;
89	u8  tphwdesc_ena;
90	u64 head_wb_addr;
91	u32 crc;
92	u16 rdylist;
93	u8  rdylist_act;
94};
95
96/* for hsplit_0 field of Rx HMC context */
97enum i40e_hmc_obj_rx_hsplit_0 {
98	I40E_HMC_OBJ_RX_HSPLIT_0_NO_SPLIT      = 0,
99	I40E_HMC_OBJ_RX_HSPLIT_0_SPLIT_L2      = 1,
100	I40E_HMC_OBJ_RX_HSPLIT_0_SPLIT_IP      = 2,
101	I40E_HMC_OBJ_RX_HSPLIT_0_SPLIT_TCP_UDP = 4,
102	I40E_HMC_OBJ_RX_HSPLIT_0_SPLIT_SCTP    = 8,
103};
104
105/* fcoe_cntx and fcoe_filt are for debugging purpose only */
106struct i40e_hmc_obj_fcoe_cntx {
107	u32 rsv[32];
108};
109
110struct i40e_hmc_obj_fcoe_filt {
111	u32 rsv[8];
112};
113
114/* Context sizes for LAN objects */
115enum i40e_hmc_lan_object_size {
116	I40E_HMC_LAN_OBJ_SZ_8   = 0x3,
117	I40E_HMC_LAN_OBJ_SZ_16  = 0x4,
118	I40E_HMC_LAN_OBJ_SZ_32  = 0x5,
119	I40E_HMC_LAN_OBJ_SZ_64  = 0x6,
120	I40E_HMC_LAN_OBJ_SZ_128 = 0x7,
121	I40E_HMC_LAN_OBJ_SZ_256 = 0x8,
122	I40E_HMC_LAN_OBJ_SZ_512 = 0x9,
123};
124
125#define I40E_HMC_L2OBJ_BASE_ALIGNMENT 512
126#define I40E_HMC_OBJ_SIZE_TXQ         128
127#define I40E_HMC_OBJ_SIZE_RXQ         32
128#define I40E_HMC_OBJ_SIZE_FCOE_CNTX   64
129#define I40E_HMC_OBJ_SIZE_FCOE_FILT   64
130
131enum i40e_hmc_lan_rsrc_type {
132	I40E_HMC_LAN_FULL  = 0,
133	I40E_HMC_LAN_TX    = 1,
134	I40E_HMC_LAN_RX    = 2,
135	I40E_HMC_FCOE_CTX  = 3,
136	I40E_HMC_FCOE_FILT = 4,
137	I40E_HMC_LAN_MAX   = 5
138};
139
140enum i40e_hmc_model {
141	I40E_HMC_MODEL_DIRECT_PREFERRED = 0,
142	I40E_HMC_MODEL_DIRECT_ONLY      = 1,
143	I40E_HMC_MODEL_PAGED_ONLY       = 2,
144	I40E_HMC_MODEL_UNKNOWN,
145};
146
147struct i40e_hmc_lan_create_obj_info {
148	struct i40e_hmc_info *hmc_info;
149	u32 rsrc_type;
150	u32 start_idx;
151	u32 count;
152	enum i40e_sd_entry_type entry_type;
153	u64 direct_mode_sz;
154};
155
156struct i40e_hmc_lan_delete_obj_info {
157	struct i40e_hmc_info *hmc_info;
158	u32 rsrc_type;
159	u32 start_idx;
160	u32 count;
161};
162
163i40e_status i40e_init_lan_hmc(struct i40e_hw *hw, u32 txq_num,
164					u32 rxq_num, u32 fcoe_cntx_num,
165					u32 fcoe_filt_num);
166i40e_status i40e_configure_lan_hmc(struct i40e_hw *hw,
167					     enum i40e_hmc_model model);
168i40e_status i40e_shutdown_lan_hmc(struct i40e_hw *hw);
169
170i40e_status i40e_clear_lan_tx_queue_context(struct i40e_hw *hw,
171						      u16 queue);
172i40e_status i40e_set_lan_tx_queue_context(struct i40e_hw *hw,
173						    u16 queue,
174						    struct i40e_hmc_obj_txq *s);
175i40e_status i40e_clear_lan_rx_queue_context(struct i40e_hw *hw,
176						      u16 queue);
177i40e_status i40e_set_lan_rx_queue_context(struct i40e_hw *hw,
178						    u16 queue,
179						    struct i40e_hmc_obj_rxq *s);
180
181#endif /* _I40E_LAN_HMC_H_ */
182