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#include "i40e_osdep.h"
28#include "i40e_register.h"
29#include "i40e_type.h"
30#include "i40e_hmc.h"
31#include "i40e_lan_hmc.h"
32#include "i40e_prototype.h"
33
34/* lan specific interface functions */
35
36/**
37 * i40e_align_l2obj_base - aligns base object pointer to 512 bytes
38 * @offset: base address offset needing alignment
39 *
40 * Aligns the layer 2 function private memory so it's 512-byte aligned.
41 **/
42static u64 i40e_align_l2obj_base(u64 offset)
43{
44	u64 aligned_offset = offset;
45
46	if ((offset % I40E_HMC_L2OBJ_BASE_ALIGNMENT) > 0)
47		aligned_offset += (I40E_HMC_L2OBJ_BASE_ALIGNMENT -
48				   (offset % I40E_HMC_L2OBJ_BASE_ALIGNMENT));
49
50	return aligned_offset;
51}
52
53/**
54 * i40e_calculate_l2fpm_size - calculates layer 2 FPM memory size
55 * @txq_num: number of Tx queues needing backing context
56 * @rxq_num: number of Rx queues needing backing context
57 * @fcoe_cntx_num: amount of FCoE statefull contexts needing backing context
58 * @fcoe_filt_num: number of FCoE filters needing backing context
59 *
60 * Calculates the maximum amount of memory for the function required, based
61 * on the number of resources it must provide context for.
62 **/
63static u64 i40e_calculate_l2fpm_size(u32 txq_num, u32 rxq_num,
64			      u32 fcoe_cntx_num, u32 fcoe_filt_num)
65{
66	u64 fpm_size = 0;
67
68	fpm_size = txq_num * I40E_HMC_OBJ_SIZE_TXQ;
69	fpm_size = i40e_align_l2obj_base(fpm_size);
70
71	fpm_size += (rxq_num * I40E_HMC_OBJ_SIZE_RXQ);
72	fpm_size = i40e_align_l2obj_base(fpm_size);
73
74	fpm_size += (fcoe_cntx_num * I40E_HMC_OBJ_SIZE_FCOE_CNTX);
75	fpm_size = i40e_align_l2obj_base(fpm_size);
76
77	fpm_size += (fcoe_filt_num * I40E_HMC_OBJ_SIZE_FCOE_FILT);
78	fpm_size = i40e_align_l2obj_base(fpm_size);
79
80	return fpm_size;
81}
82
83/**
84 * i40e_init_lan_hmc - initialize i40e_hmc_info struct
85 * @hw: pointer to the HW structure
86 * @txq_num: number of Tx queues needing backing context
87 * @rxq_num: number of Rx queues needing backing context
88 * @fcoe_cntx_num: amount of FCoE statefull contexts needing backing context
89 * @fcoe_filt_num: number of FCoE filters needing backing context
90 *
91 * This function will be called once per physical function initialization.
92 * It will fill out the i40e_hmc_obj_info structure for LAN objects based on
93 * the driver's provided input, as well as information from the HMC itself
94 * loaded from NVRAM.
95 *
96 * Assumptions:
97 *   - HMC Resource Profile has been selected before calling this function.
98 **/
99i40e_status i40e_init_lan_hmc(struct i40e_hw *hw, u32 txq_num,
100					u32 rxq_num, u32 fcoe_cntx_num,
101					u32 fcoe_filt_num)
102{
103	struct i40e_hmc_obj_info *obj, *full_obj;
104	i40e_status ret_code = 0;
105	u64 l2fpm_size;
106	u32 size_exp;
107
108	hw->hmc.signature = I40E_HMC_INFO_SIGNATURE;
109	hw->hmc.hmc_fn_id = hw->pf_id;
110
111	/* allocate memory for hmc_obj */
112	ret_code = i40e_allocate_virt_mem(hw, &hw->hmc.hmc_obj_virt_mem,
113			sizeof(struct i40e_hmc_obj_info) * I40E_HMC_LAN_MAX);
114	if (ret_code)
115		goto init_lan_hmc_out;
116	hw->hmc.hmc_obj = (struct i40e_hmc_obj_info *)
117			  hw->hmc.hmc_obj_virt_mem.va;
118
119	/* The full object will be used to create the LAN HMC SD */
120	full_obj = &hw->hmc.hmc_obj[I40E_HMC_LAN_FULL];
121	full_obj->max_cnt = 0;
122	full_obj->cnt = 0;
123	full_obj->base = 0;
124	full_obj->size = 0;
125
126	/* Tx queue context information */
127	obj = &hw->hmc.hmc_obj[I40E_HMC_LAN_TX];
128	obj->max_cnt = rd32(hw, I40E_GLHMC_LANQMAX);
129	obj->cnt = txq_num;
130	obj->base = 0;
131	size_exp = rd32(hw, I40E_GLHMC_LANTXOBJSZ);
132	obj->size = (u64)1 << size_exp;
133
134	/* validate values requested by driver don't exceed HMC capacity */
135	if (txq_num > obj->max_cnt) {
136		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
137		hw_dbg(hw, "i40e_init_lan_hmc: Tx context: asks for 0x%x but max allowed is 0x%x, returns error %d\n",
138			  txq_num, obj->max_cnt, ret_code);
139		goto init_lan_hmc_out;
140	}
141
142	/* aggregate values into the full LAN object for later */
143	full_obj->max_cnt += obj->max_cnt;
144	full_obj->cnt += obj->cnt;
145
146	/* Rx queue context information */
147	obj = &hw->hmc.hmc_obj[I40E_HMC_LAN_RX];
148	obj->max_cnt = rd32(hw, I40E_GLHMC_LANQMAX);
149	obj->cnt = rxq_num;
150	obj->base = hw->hmc.hmc_obj[I40E_HMC_LAN_TX].base +
151		    (hw->hmc.hmc_obj[I40E_HMC_LAN_TX].cnt *
152		     hw->hmc.hmc_obj[I40E_HMC_LAN_TX].size);
153	obj->base = i40e_align_l2obj_base(obj->base);
154	size_exp = rd32(hw, I40E_GLHMC_LANRXOBJSZ);
155	obj->size = (u64)1 << size_exp;
156
157	/* validate values requested by driver don't exceed HMC capacity */
158	if (rxq_num > obj->max_cnt) {
159		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
160		hw_dbg(hw, "i40e_init_lan_hmc: Rx context: asks for 0x%x but max allowed is 0x%x, returns error %d\n",
161			  rxq_num, obj->max_cnt, ret_code);
162		goto init_lan_hmc_out;
163	}
164
165	/* aggregate values into the full LAN object for later */
166	full_obj->max_cnt += obj->max_cnt;
167	full_obj->cnt += obj->cnt;
168
169	/* FCoE context information */
170	obj = &hw->hmc.hmc_obj[I40E_HMC_FCOE_CTX];
171	obj->max_cnt = rd32(hw, I40E_GLHMC_FCOEMAX);
172	obj->cnt = fcoe_cntx_num;
173	obj->base = hw->hmc.hmc_obj[I40E_HMC_LAN_RX].base +
174		    (hw->hmc.hmc_obj[I40E_HMC_LAN_RX].cnt *
175		     hw->hmc.hmc_obj[I40E_HMC_LAN_RX].size);
176	obj->base = i40e_align_l2obj_base(obj->base);
177	size_exp = rd32(hw, I40E_GLHMC_FCOEDDPOBJSZ);
178	obj->size = (u64)1 << size_exp;
179
180	/* validate values requested by driver don't exceed HMC capacity */
181	if (fcoe_cntx_num > obj->max_cnt) {
182		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
183		hw_dbg(hw, "i40e_init_lan_hmc: FCoE context: asks for 0x%x but max allowed is 0x%x, returns error %d\n",
184			  fcoe_cntx_num, obj->max_cnt, ret_code);
185		goto init_lan_hmc_out;
186	}
187
188	/* aggregate values into the full LAN object for later */
189	full_obj->max_cnt += obj->max_cnt;
190	full_obj->cnt += obj->cnt;
191
192	/* FCoE filter information */
193	obj = &hw->hmc.hmc_obj[I40E_HMC_FCOE_FILT];
194	obj->max_cnt = rd32(hw, I40E_GLHMC_FCOEFMAX);
195	obj->cnt = fcoe_filt_num;
196	obj->base = hw->hmc.hmc_obj[I40E_HMC_FCOE_CTX].base +
197		    (hw->hmc.hmc_obj[I40E_HMC_FCOE_CTX].cnt *
198		     hw->hmc.hmc_obj[I40E_HMC_FCOE_CTX].size);
199	obj->base = i40e_align_l2obj_base(obj->base);
200	size_exp = rd32(hw, I40E_GLHMC_FCOEFOBJSZ);
201	obj->size = (u64)1 << size_exp;
202
203	/* validate values requested by driver don't exceed HMC capacity */
204	if (fcoe_filt_num > obj->max_cnt) {
205		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
206		hw_dbg(hw, "i40e_init_lan_hmc: FCoE filter: asks for 0x%x but max allowed is 0x%x, returns error %d\n",
207			  fcoe_filt_num, obj->max_cnt, ret_code);
208		goto init_lan_hmc_out;
209	}
210
211	/* aggregate values into the full LAN object for later */
212	full_obj->max_cnt += obj->max_cnt;
213	full_obj->cnt += obj->cnt;
214
215	hw->hmc.first_sd_index = 0;
216	hw->hmc.sd_table.ref_cnt = 0;
217	l2fpm_size = i40e_calculate_l2fpm_size(txq_num, rxq_num, fcoe_cntx_num,
218					       fcoe_filt_num);
219	if (NULL == hw->hmc.sd_table.sd_entry) {
220		hw->hmc.sd_table.sd_cnt = (u32)
221				   (l2fpm_size + I40E_HMC_DIRECT_BP_SIZE - 1) /
222				   I40E_HMC_DIRECT_BP_SIZE;
223
224		/* allocate the sd_entry members in the sd_table */
225		ret_code = i40e_allocate_virt_mem(hw, &hw->hmc.sd_table.addr,
226					  (sizeof(struct i40e_hmc_sd_entry) *
227					  hw->hmc.sd_table.sd_cnt));
228		if (ret_code)
229			goto init_lan_hmc_out;
230		hw->hmc.sd_table.sd_entry =
231			(struct i40e_hmc_sd_entry *)hw->hmc.sd_table.addr.va;
232	}
233	/* store in the LAN full object for later */
234	full_obj->size = l2fpm_size;
235
236init_lan_hmc_out:
237	return ret_code;
238}
239
240/**
241 * i40e_remove_pd_page - Remove a page from the page descriptor table
242 * @hw: pointer to the HW structure
243 * @hmc_info: pointer to the HMC configuration information structure
244 * @idx: segment descriptor index to find the relevant page descriptor
245 *
246 * This function:
247 *	1. Marks the entry in pd table (for paged address mode) invalid
248 *	2. write to register PMPDINV to invalidate the backing page in FV cache
249 *	3. Decrement the ref count for  pd_entry
250 * assumptions:
251 *	1. caller can deallocate the memory used by pd after this function
252 *	   returns.
253 **/
254static i40e_status i40e_remove_pd_page(struct i40e_hw *hw,
255						 struct i40e_hmc_info *hmc_info,
256						 u32 idx)
257{
258	i40e_status ret_code = 0;
259
260	if (!i40e_prep_remove_pd_page(hmc_info, idx))
261		ret_code = i40e_remove_pd_page_new(hw, hmc_info, idx, true);
262
263	return ret_code;
264}
265
266/**
267 * i40e_remove_sd_bp - remove a backing page from a segment descriptor
268 * @hw: pointer to our HW structure
269 * @hmc_info: pointer to the HMC configuration information structure
270 * @idx: the page index
271 *
272 * This function:
273 *	1. Marks the entry in sd table (for direct address mode) invalid
274 *	2. write to register PMSDCMD, PMSDDATALOW(PMSDDATALOW.PMSDVALID set
275 *	   to 0) and PMSDDATAHIGH to invalidate the sd page
276 *	3. Decrement the ref count for the sd_entry
277 * assumptions:
278 *	1. caller can deallocate the memory used by backing storage after this
279 *	   function returns.
280 **/
281static i40e_status i40e_remove_sd_bp(struct i40e_hw *hw,
282					       struct i40e_hmc_info *hmc_info,
283					       u32 idx)
284{
285	i40e_status ret_code = 0;
286
287	if (!i40e_prep_remove_sd_bp(hmc_info, idx))
288		ret_code = i40e_remove_sd_bp_new(hw, hmc_info, idx, true);
289
290	return ret_code;
291}
292
293/**
294 * i40e_create_lan_hmc_object - allocate backing store for hmc objects
295 * @hw: pointer to the HW structure
296 * @info: pointer to i40e_hmc_create_obj_info struct
297 *
298 * This will allocate memory for PDs and backing pages and populate
299 * the sd and pd entries.
300 **/
301static i40e_status i40e_create_lan_hmc_object(struct i40e_hw *hw,
302				struct i40e_hmc_lan_create_obj_info *info)
303{
304	i40e_status ret_code = 0;
305	struct i40e_hmc_sd_entry *sd_entry;
306	u32 pd_idx1 = 0, pd_lmt1 = 0;
307	u32 pd_idx = 0, pd_lmt = 0;
308	bool pd_error = false;
309	u32 sd_idx, sd_lmt;
310	u64 sd_size;
311	u32 i, j;
312
313	if (NULL == info) {
314		ret_code = I40E_ERR_BAD_PTR;
315		hw_dbg(hw, "i40e_create_lan_hmc_object: bad info ptr\n");
316		goto exit;
317	}
318	if (NULL == info->hmc_info) {
319		ret_code = I40E_ERR_BAD_PTR;
320		hw_dbg(hw, "i40e_create_lan_hmc_object: bad hmc_info ptr\n");
321		goto exit;
322	}
323	if (I40E_HMC_INFO_SIGNATURE != info->hmc_info->signature) {
324		ret_code = I40E_ERR_BAD_PTR;
325		hw_dbg(hw, "i40e_create_lan_hmc_object: bad signature\n");
326		goto exit;
327	}
328
329	if (info->start_idx >= info->hmc_info->hmc_obj[info->rsrc_type].cnt) {
330		ret_code = I40E_ERR_INVALID_HMC_OBJ_INDEX;
331		hw_dbg(hw, "i40e_create_lan_hmc_object: returns error %d\n",
332			  ret_code);
333		goto exit;
334	}
335	if ((info->start_idx + info->count) >
336	    info->hmc_info->hmc_obj[info->rsrc_type].cnt) {
337		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
338		hw_dbg(hw, "i40e_create_lan_hmc_object: returns error %d\n",
339			  ret_code);
340		goto exit;
341	}
342
343	/* find sd index and limit */
344	I40E_FIND_SD_INDEX_LIMIT(info->hmc_info, info->rsrc_type,
345				 info->start_idx, info->count,
346				 &sd_idx, &sd_lmt);
347	if (sd_idx >= info->hmc_info->sd_table.sd_cnt ||
348	    sd_lmt > info->hmc_info->sd_table.sd_cnt) {
349			ret_code = I40E_ERR_INVALID_SD_INDEX;
350			goto exit;
351	}
352	/* find pd index */
353	I40E_FIND_PD_INDEX_LIMIT(info->hmc_info, info->rsrc_type,
354				 info->start_idx, info->count, &pd_idx,
355				 &pd_lmt);
356
357	/* This is to cover for cases where you may not want to have an SD with
358	 * the full 2M memory but something smaller. By not filling out any
359	 * size, the function will default the SD size to be 2M.
360	 */
361	if (info->direct_mode_sz == 0)
362		sd_size = I40E_HMC_DIRECT_BP_SIZE;
363	else
364		sd_size = info->direct_mode_sz;
365
366	/* check if all the sds are valid. If not, allocate a page and
367	 * initialize it.
368	 */
369	for (j = sd_idx; j < sd_lmt; j++) {
370		/* update the sd table entry */
371		ret_code = i40e_add_sd_table_entry(hw, info->hmc_info, j,
372						   info->entry_type,
373						   sd_size);
374		if (ret_code)
375			goto exit_sd_error;
376		sd_entry = &info->hmc_info->sd_table.sd_entry[j];
377		if (I40E_SD_TYPE_PAGED == sd_entry->entry_type) {
378			/* check if all the pds in this sd are valid. If not,
379			 * allocate a page and initialize it.
380			 */
381
382			/* find pd_idx and pd_lmt in this sd */
383			pd_idx1 = max(pd_idx, (j * I40E_HMC_MAX_BP_COUNT));
384			pd_lmt1 = min(pd_lmt,
385				      ((j + 1) * I40E_HMC_MAX_BP_COUNT));
386			for (i = pd_idx1; i < pd_lmt1; i++) {
387				/* update the pd table entry */
388				ret_code = i40e_add_pd_table_entry(hw,
389								info->hmc_info,
390								i);
391				if (ret_code) {
392					pd_error = true;
393					break;
394				}
395			}
396			if (pd_error) {
397				/* remove the backing pages from pd_idx1 to i */
398				while (i && (i > pd_idx1)) {
399					i40e_remove_pd_bp(hw, info->hmc_info,
400							  (i - 1));
401					i--;
402				}
403			}
404		}
405		if (!sd_entry->valid) {
406			sd_entry->valid = true;
407			switch (sd_entry->entry_type) {
408			case I40E_SD_TYPE_PAGED:
409				I40E_SET_PF_SD_ENTRY(hw,
410					sd_entry->u.pd_table.pd_page_addr.pa,
411					j, sd_entry->entry_type);
412				break;
413			case I40E_SD_TYPE_DIRECT:
414				I40E_SET_PF_SD_ENTRY(hw, sd_entry->u.bp.addr.pa,
415						     j, sd_entry->entry_type);
416				break;
417			default:
418				ret_code = I40E_ERR_INVALID_SD_TYPE;
419				goto exit;
420			}
421		}
422	}
423	goto exit;
424
425exit_sd_error:
426	/* cleanup for sd entries from j to sd_idx */
427	while (j && (j > sd_idx)) {
428		sd_entry = &info->hmc_info->sd_table.sd_entry[j - 1];
429		switch (sd_entry->entry_type) {
430		case I40E_SD_TYPE_PAGED:
431			pd_idx1 = max(pd_idx,
432				      ((j - 1) * I40E_HMC_MAX_BP_COUNT));
433			pd_lmt1 = min(pd_lmt, (j * I40E_HMC_MAX_BP_COUNT));
434			for (i = pd_idx1; i < pd_lmt1; i++) {
435				i40e_remove_pd_bp(hw, info->hmc_info, i);
436			}
437			i40e_remove_pd_page(hw, info->hmc_info, (j - 1));
438			break;
439		case I40E_SD_TYPE_DIRECT:
440			i40e_remove_sd_bp(hw, info->hmc_info, (j - 1));
441			break;
442		default:
443			ret_code = I40E_ERR_INVALID_SD_TYPE;
444			break;
445		}
446		j--;
447	}
448exit:
449	return ret_code;
450}
451
452/**
453 * i40e_configure_lan_hmc - prepare the HMC backing store
454 * @hw: pointer to the hw structure
455 * @model: the model for the layout of the SD/PD tables
456 *
457 * - This function will be called once per physical function initialization.
458 * - This function will be called after i40e_init_lan_hmc() and before
459 *   any LAN/FCoE HMC objects can be created.
460 **/
461i40e_status i40e_configure_lan_hmc(struct i40e_hw *hw,
462					     enum i40e_hmc_model model)
463{
464	struct i40e_hmc_lan_create_obj_info info;
465	i40e_status ret_code = 0;
466	u8 hmc_fn_id = hw->hmc.hmc_fn_id;
467	struct i40e_hmc_obj_info *obj;
468
469	/* Initialize part of the create object info struct */
470	info.hmc_info = &hw->hmc;
471	info.rsrc_type = I40E_HMC_LAN_FULL;
472	info.start_idx = 0;
473	info.direct_mode_sz = hw->hmc.hmc_obj[I40E_HMC_LAN_FULL].size;
474
475	/* Build the SD entry for the LAN objects */
476	switch (model) {
477	case I40E_HMC_MODEL_DIRECT_PREFERRED:
478	case I40E_HMC_MODEL_DIRECT_ONLY:
479		info.entry_type = I40E_SD_TYPE_DIRECT;
480		/* Make one big object, a single SD */
481		info.count = 1;
482		ret_code = i40e_create_lan_hmc_object(hw, &info);
483		if (ret_code && (model == I40E_HMC_MODEL_DIRECT_PREFERRED))
484			goto try_type_paged;
485		else if (ret_code)
486			goto configure_lan_hmc_out;
487		/* else clause falls through the break */
488		break;
489	case I40E_HMC_MODEL_PAGED_ONLY:
490try_type_paged:
491		info.entry_type = I40E_SD_TYPE_PAGED;
492		/* Make one big object in the PD table */
493		info.count = 1;
494		ret_code = i40e_create_lan_hmc_object(hw, &info);
495		if (ret_code)
496			goto configure_lan_hmc_out;
497		break;
498	default:
499		/* unsupported type */
500		ret_code = I40E_ERR_INVALID_SD_TYPE;
501		hw_dbg(hw, "i40e_configure_lan_hmc: Unknown SD type: %d\n",
502			  ret_code);
503		goto configure_lan_hmc_out;
504	}
505
506	/* Configure and program the FPM registers so objects can be created */
507
508	/* Tx contexts */
509	obj = &hw->hmc.hmc_obj[I40E_HMC_LAN_TX];
510	wr32(hw, I40E_GLHMC_LANTXBASE(hmc_fn_id),
511	     (u32)((obj->base & I40E_GLHMC_LANTXBASE_FPMLANTXBASE_MASK) / 512));
512	wr32(hw, I40E_GLHMC_LANTXCNT(hmc_fn_id), obj->cnt);
513
514	/* Rx contexts */
515	obj = &hw->hmc.hmc_obj[I40E_HMC_LAN_RX];
516	wr32(hw, I40E_GLHMC_LANRXBASE(hmc_fn_id),
517	     (u32)((obj->base & I40E_GLHMC_LANRXBASE_FPMLANRXBASE_MASK) / 512));
518	wr32(hw, I40E_GLHMC_LANRXCNT(hmc_fn_id), obj->cnt);
519
520	/* FCoE contexts */
521	obj = &hw->hmc.hmc_obj[I40E_HMC_FCOE_CTX];
522	wr32(hw, I40E_GLHMC_FCOEDDPBASE(hmc_fn_id),
523	 (u32)((obj->base & I40E_GLHMC_FCOEDDPBASE_FPMFCOEDDPBASE_MASK) / 512));
524	wr32(hw, I40E_GLHMC_FCOEDDPCNT(hmc_fn_id), obj->cnt);
525
526	/* FCoE filters */
527	obj = &hw->hmc.hmc_obj[I40E_HMC_FCOE_FILT];
528	wr32(hw, I40E_GLHMC_FCOEFBASE(hmc_fn_id),
529	     (u32)((obj->base & I40E_GLHMC_FCOEFBASE_FPMFCOEFBASE_MASK) / 512));
530	wr32(hw, I40E_GLHMC_FCOEFCNT(hmc_fn_id), obj->cnt);
531
532configure_lan_hmc_out:
533	return ret_code;
534}
535
536/**
537 * i40e_delete_hmc_object - remove hmc objects
538 * @hw: pointer to the HW structure
539 * @info: pointer to i40e_hmc_delete_obj_info struct
540 *
541 * This will de-populate the SDs and PDs.  It frees
542 * the memory for PDS and backing storage.  After this function is returned,
543 * caller should deallocate memory allocated previously for
544 * book-keeping information about PDs and backing storage.
545 **/
546static i40e_status i40e_delete_lan_hmc_object(struct i40e_hw *hw,
547				struct i40e_hmc_lan_delete_obj_info *info)
548{
549	i40e_status ret_code = 0;
550	struct i40e_hmc_pd_table *pd_table;
551	u32 pd_idx, pd_lmt, rel_pd_idx;
552	u32 sd_idx, sd_lmt;
553	u32 i, j;
554
555	if (NULL == info) {
556		ret_code = I40E_ERR_BAD_PTR;
557		hw_dbg(hw, "i40e_delete_hmc_object: bad info ptr\n");
558		goto exit;
559	}
560	if (NULL == info->hmc_info) {
561		ret_code = I40E_ERR_BAD_PTR;
562		hw_dbg(hw, "i40e_delete_hmc_object: bad info->hmc_info ptr\n");
563		goto exit;
564	}
565	if (I40E_HMC_INFO_SIGNATURE != info->hmc_info->signature) {
566		ret_code = I40E_ERR_BAD_PTR;
567		hw_dbg(hw, "i40e_delete_hmc_object: bad hmc_info->signature\n");
568		goto exit;
569	}
570
571	if (NULL == info->hmc_info->sd_table.sd_entry) {
572		ret_code = I40E_ERR_BAD_PTR;
573		hw_dbg(hw, "i40e_delete_hmc_object: bad sd_entry\n");
574		goto exit;
575	}
576
577	if (NULL == info->hmc_info->hmc_obj) {
578		ret_code = I40E_ERR_BAD_PTR;
579		hw_dbg(hw, "i40e_delete_hmc_object: bad hmc_info->hmc_obj\n");
580		goto exit;
581	}
582	if (info->start_idx >= info->hmc_info->hmc_obj[info->rsrc_type].cnt) {
583		ret_code = I40E_ERR_INVALID_HMC_OBJ_INDEX;
584		hw_dbg(hw, "i40e_delete_hmc_object: returns error %d\n",
585			  ret_code);
586		goto exit;
587	}
588
589	if ((info->start_idx + info->count) >
590	    info->hmc_info->hmc_obj[info->rsrc_type].cnt) {
591		ret_code = I40E_ERR_INVALID_HMC_OBJ_COUNT;
592		hw_dbg(hw, "i40e_delete_hmc_object: returns error %d\n",
593			  ret_code);
594		goto exit;
595	}
596
597	I40E_FIND_PD_INDEX_LIMIT(info->hmc_info, info->rsrc_type,
598				 info->start_idx, info->count, &pd_idx,
599				 &pd_lmt);
600
601	for (j = pd_idx; j < pd_lmt; j++) {
602		sd_idx = j / I40E_HMC_PD_CNT_IN_SD;
603
604		if (I40E_SD_TYPE_PAGED !=
605		    info->hmc_info->sd_table.sd_entry[sd_idx].entry_type)
606			continue;
607
608		rel_pd_idx = j % I40E_HMC_PD_CNT_IN_SD;
609
610		pd_table =
611			&info->hmc_info->sd_table.sd_entry[sd_idx].u.pd_table;
612		if (pd_table->pd_entry[rel_pd_idx].valid) {
613			ret_code = i40e_remove_pd_bp(hw, info->hmc_info, j);
614			if (ret_code)
615				goto exit;
616		}
617	}
618
619	/* find sd index and limit */
620	I40E_FIND_SD_INDEX_LIMIT(info->hmc_info, info->rsrc_type,
621				 info->start_idx, info->count,
622				 &sd_idx, &sd_lmt);
623	if (sd_idx >= info->hmc_info->sd_table.sd_cnt ||
624	    sd_lmt > info->hmc_info->sd_table.sd_cnt) {
625		ret_code = I40E_ERR_INVALID_SD_INDEX;
626		goto exit;
627	}
628
629	for (i = sd_idx; i < sd_lmt; i++) {
630		if (!info->hmc_info->sd_table.sd_entry[i].valid)
631			continue;
632		switch (info->hmc_info->sd_table.sd_entry[i].entry_type) {
633		case I40E_SD_TYPE_DIRECT:
634			ret_code = i40e_remove_sd_bp(hw, info->hmc_info, i);
635			if (ret_code)
636				goto exit;
637			break;
638		case I40E_SD_TYPE_PAGED:
639			ret_code = i40e_remove_pd_page(hw, info->hmc_info, i);
640			if (ret_code)
641				goto exit;
642			break;
643		default:
644			break;
645		}
646	}
647exit:
648	return ret_code;
649}
650
651/**
652 * i40e_shutdown_lan_hmc - Remove HMC backing store, free allocated memory
653 * @hw: pointer to the hw structure
654 *
655 * This must be called by drivers as they are shutting down and being
656 * removed from the OS.
657 **/
658i40e_status i40e_shutdown_lan_hmc(struct i40e_hw *hw)
659{
660	struct i40e_hmc_lan_delete_obj_info info;
661	i40e_status ret_code;
662
663	info.hmc_info = &hw->hmc;
664	info.rsrc_type = I40E_HMC_LAN_FULL;
665	info.start_idx = 0;
666	info.count = 1;
667
668	/* delete the object */
669	ret_code = i40e_delete_lan_hmc_object(hw, &info);
670
671	/* free the SD table entry for LAN */
672	i40e_free_virt_mem(hw, &hw->hmc.sd_table.addr);
673	hw->hmc.sd_table.sd_cnt = 0;
674	hw->hmc.sd_table.sd_entry = NULL;
675
676	/* free memory used for hmc_obj */
677	i40e_free_virt_mem(hw, &hw->hmc.hmc_obj_virt_mem);
678	hw->hmc.hmc_obj = NULL;
679
680	return ret_code;
681}
682
683#define I40E_HMC_STORE(_struct, _ele)		\
684	offsetof(struct _struct, _ele),		\
685	FIELD_SIZEOF(struct _struct, _ele)
686
687struct i40e_context_ele {
688	u16 offset;
689	u16 size_of;
690	u16 width;
691	u16 lsb;
692};
693
694/* LAN Tx Queue Context */
695static struct i40e_context_ele i40e_hmc_txq_ce_info[] = {
696					     /* Field      Width    LSB */
697	{I40E_HMC_STORE(i40e_hmc_obj_txq, head),           13,      0 },
698	{I40E_HMC_STORE(i40e_hmc_obj_txq, new_context),     1,     30 },
699	{I40E_HMC_STORE(i40e_hmc_obj_txq, base),           57,     32 },
700	{I40E_HMC_STORE(i40e_hmc_obj_txq, fc_ena),          1,     89 },
701	{I40E_HMC_STORE(i40e_hmc_obj_txq, timesync_ena),    1,     90 },
702	{I40E_HMC_STORE(i40e_hmc_obj_txq, fd_ena),          1,     91 },
703	{I40E_HMC_STORE(i40e_hmc_obj_txq, alt_vlan_ena),    1,     92 },
704	{I40E_HMC_STORE(i40e_hmc_obj_txq, cpuid),           8,     96 },
705/* line 1 */
706	{I40E_HMC_STORE(i40e_hmc_obj_txq, thead_wb),       13,  0 + 128 },
707	{I40E_HMC_STORE(i40e_hmc_obj_txq, head_wb_ena),     1, 32 + 128 },
708	{I40E_HMC_STORE(i40e_hmc_obj_txq, qlen),           13, 33 + 128 },
709	{I40E_HMC_STORE(i40e_hmc_obj_txq, tphrdesc_ena),    1, 46 + 128 },
710	{I40E_HMC_STORE(i40e_hmc_obj_txq, tphrpacket_ena),  1, 47 + 128 },
711	{I40E_HMC_STORE(i40e_hmc_obj_txq, tphwdesc_ena),    1, 48 + 128 },
712	{I40E_HMC_STORE(i40e_hmc_obj_txq, head_wb_addr),   64, 64 + 128 },
713/* line 7 */
714	{I40E_HMC_STORE(i40e_hmc_obj_txq, crc),            32,  0 + (7 * 128) },
715	{I40E_HMC_STORE(i40e_hmc_obj_txq, rdylist),        10, 84 + (7 * 128) },
716	{I40E_HMC_STORE(i40e_hmc_obj_txq, rdylist_act),     1, 94 + (7 * 128) },
717	{ 0 }
718};
719
720/* LAN Rx Queue Context */
721static struct i40e_context_ele i40e_hmc_rxq_ce_info[] = {
722					 /* Field      Width    LSB */
723	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, head),        13,	0   },
724	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, cpuid),        8,	13  },
725	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, base),        57,	32  },
726	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, qlen),        13,	89  },
727	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, dbuff),        7,	102 },
728	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, hbuff),        5,	109 },
729	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, dtype),        2,	114 },
730	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, dsize),        1,	116 },
731	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, crcstrip),     1,	117 },
732	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, fc_ena),       1,	118 },
733	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, l2tsel),       1,	119 },
734	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, hsplit_0),     4,	120 },
735	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, hsplit_1),     2,	124 },
736	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, showiv),       1,	127 },
737	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, rxmax),       14,	174 },
738	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, tphrdesc_ena), 1,	193 },
739	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, tphwdesc_ena), 1,	194 },
740	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, tphdata_ena),  1,	195 },
741	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, tphhead_ena),  1,	196 },
742	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, lrxqthresh),   3,	198 },
743	{ I40E_HMC_STORE(i40e_hmc_obj_rxq, prefena),      1,	201 },
744	{ 0 }
745};
746
747/**
748 * i40e_write_byte - replace HMC context byte
749 * @hmc_bits: pointer to the HMC memory
750 * @ce_info: a description of the struct to be read from
751 * @src: the struct to be read from
752 **/
753static void i40e_write_byte(u8 *hmc_bits,
754			    struct i40e_context_ele *ce_info,
755			    u8 *src)
756{
757	u8 src_byte, dest_byte, mask;
758	u8 *from, *dest;
759	u16 shift_width;
760
761	/* copy from the next struct field */
762	from = src + ce_info->offset;
763
764	/* prepare the bits and mask */
765	shift_width = ce_info->lsb % 8;
766	mask = ((u8)1 << ce_info->width) - 1;
767
768	src_byte = *from;
769	src_byte &= mask;
770
771	/* shift to correct alignment */
772	mask <<= shift_width;
773	src_byte <<= shift_width;
774
775	/* get the current bits from the target bit string */
776	dest = hmc_bits + (ce_info->lsb / 8);
777
778	memcpy(&dest_byte, dest, sizeof(dest_byte));
779
780	dest_byte &= ~mask;	/* get the bits not changing */
781	dest_byte |= src_byte;	/* add in the new bits */
782
783	/* put it all back */
784	memcpy(dest, &dest_byte, sizeof(dest_byte));
785}
786
787/**
788 * i40e_write_word - replace HMC context word
789 * @hmc_bits: pointer to the HMC memory
790 * @ce_info: a description of the struct to be read from
791 * @src: the struct to be read from
792 **/
793static void i40e_write_word(u8 *hmc_bits,
794			    struct i40e_context_ele *ce_info,
795			    u8 *src)
796{
797	u16 src_word, mask;
798	u8 *from, *dest;
799	u16 shift_width;
800	__le16 dest_word;
801
802	/* copy from the next struct field */
803	from = src + ce_info->offset;
804
805	/* prepare the bits and mask */
806	shift_width = ce_info->lsb % 8;
807	mask = ((u16)1 << ce_info->width) - 1;
808
809	/* don't swizzle the bits until after the mask because the mask bits
810	 * will be in a different bit position on big endian machines
811	 */
812	src_word = *(u16 *)from;
813	src_word &= mask;
814
815	/* shift to correct alignment */
816	mask <<= shift_width;
817	src_word <<= shift_width;
818
819	/* get the current bits from the target bit string */
820	dest = hmc_bits + (ce_info->lsb / 8);
821
822	memcpy(&dest_word, dest, sizeof(dest_word));
823
824	dest_word &= ~(cpu_to_le16(mask));	/* get the bits not changing */
825	dest_word |= cpu_to_le16(src_word);	/* add in the new bits */
826
827	/* put it all back */
828	memcpy(dest, &dest_word, sizeof(dest_word));
829}
830
831/**
832 * i40e_write_dword - replace HMC context dword
833 * @hmc_bits: pointer to the HMC memory
834 * @ce_info: a description of the struct to be read from
835 * @src: the struct to be read from
836 **/
837static void i40e_write_dword(u8 *hmc_bits,
838			     struct i40e_context_ele *ce_info,
839			     u8 *src)
840{
841	u32 src_dword, mask;
842	u8 *from, *dest;
843	u16 shift_width;
844	__le32 dest_dword;
845
846	/* copy from the next struct field */
847	from = src + ce_info->offset;
848
849	/* prepare the bits and mask */
850	shift_width = ce_info->lsb % 8;
851
852	/* if the field width is exactly 32 on an x86 machine, then the shift
853	 * operation will not work because the SHL instructions count is masked
854	 * to 5 bits so the shift will do nothing
855	 */
856	if (ce_info->width < 32)
857		mask = ((u32)1 << ce_info->width) - 1;
858	else
859		mask = ~(u32)0;
860
861	/* don't swizzle the bits until after the mask because the mask bits
862	 * will be in a different bit position on big endian machines
863	 */
864	src_dword = *(u32 *)from;
865	src_dword &= mask;
866
867	/* shift to correct alignment */
868	mask <<= shift_width;
869	src_dword <<= shift_width;
870
871	/* get the current bits from the target bit string */
872	dest = hmc_bits + (ce_info->lsb / 8);
873
874	memcpy(&dest_dword, dest, sizeof(dest_dword));
875
876	dest_dword &= ~(cpu_to_le32(mask));	/* get the bits not changing */
877	dest_dword |= cpu_to_le32(src_dword);	/* add in the new bits */
878
879	/* put it all back */
880	memcpy(dest, &dest_dword, sizeof(dest_dword));
881}
882
883/**
884 * i40e_write_qword - replace HMC context qword
885 * @hmc_bits: pointer to the HMC memory
886 * @ce_info: a description of the struct to be read from
887 * @src: the struct to be read from
888 **/
889static void i40e_write_qword(u8 *hmc_bits,
890			     struct i40e_context_ele *ce_info,
891			     u8 *src)
892{
893	u64 src_qword, mask;
894	u8 *from, *dest;
895	u16 shift_width;
896	__le64 dest_qword;
897
898	/* copy from the next struct field */
899	from = src + ce_info->offset;
900
901	/* prepare the bits and mask */
902	shift_width = ce_info->lsb % 8;
903
904	/* if the field width is exactly 64 on an x86 machine, then the shift
905	 * operation will not work because the SHL instructions count is masked
906	 * to 6 bits so the shift will do nothing
907	 */
908	if (ce_info->width < 64)
909		mask = ((u64)1 << ce_info->width) - 1;
910	else
911		mask = ~(u64)0;
912
913	/* don't swizzle the bits until after the mask because the mask bits
914	 * will be in a different bit position on big endian machines
915	 */
916	src_qword = *(u64 *)from;
917	src_qword &= mask;
918
919	/* shift to correct alignment */
920	mask <<= shift_width;
921	src_qword <<= shift_width;
922
923	/* get the current bits from the target bit string */
924	dest = hmc_bits + (ce_info->lsb / 8);
925
926	memcpy(&dest_qword, dest, sizeof(dest_qword));
927
928	dest_qword &= ~(cpu_to_le64(mask));	/* get the bits not changing */
929	dest_qword |= cpu_to_le64(src_qword);	/* add in the new bits */
930
931	/* put it all back */
932	memcpy(dest, &dest_qword, sizeof(dest_qword));
933}
934
935/**
936 * i40e_clear_hmc_context - zero out the HMC context bits
937 * @hw:       the hardware struct
938 * @context_bytes: pointer to the context bit array (DMA memory)
939 * @hmc_type: the type of HMC resource
940 **/
941static i40e_status i40e_clear_hmc_context(struct i40e_hw *hw,
942					u8 *context_bytes,
943					enum i40e_hmc_lan_rsrc_type hmc_type)
944{
945	/* clean the bit array */
946	memset(context_bytes, 0, (u32)hw->hmc.hmc_obj[hmc_type].size);
947
948	return 0;
949}
950
951/**
952 * i40e_set_hmc_context - replace HMC context bits
953 * @context_bytes: pointer to the context bit array
954 * @ce_info:  a description of the struct to be filled
955 * @dest:     the struct to be filled
956 **/
957static i40e_status i40e_set_hmc_context(u8 *context_bytes,
958					struct i40e_context_ele *ce_info,
959					u8 *dest)
960{
961	int f;
962
963	for (f = 0; ce_info[f].width != 0; f++) {
964
965		/* we have to deal with each element of the HMC using the
966		 * correct size so that we are correct regardless of the
967		 * endianness of the machine
968		 */
969		switch (ce_info[f].size_of) {
970		case 1:
971			i40e_write_byte(context_bytes, &ce_info[f], dest);
972			break;
973		case 2:
974			i40e_write_word(context_bytes, &ce_info[f], dest);
975			break;
976		case 4:
977			i40e_write_dword(context_bytes, &ce_info[f], dest);
978			break;
979		case 8:
980			i40e_write_qword(context_bytes, &ce_info[f], dest);
981			break;
982		}
983	}
984
985	return 0;
986}
987
988/**
989 * i40e_hmc_get_object_va - retrieves an object's virtual address
990 * @hmc_info: pointer to i40e_hmc_info struct
991 * @object_base: pointer to u64 to get the va
992 * @rsrc_type: the hmc resource type
993 * @obj_idx: hmc object index
994 *
995 * This function retrieves the object's virtual address from the object
996 * base pointer.  This function is used for LAN Queue contexts.
997 **/
998static
999i40e_status i40e_hmc_get_object_va(struct i40e_hmc_info *hmc_info,
1000					u8 **object_base,
1001					enum i40e_hmc_lan_rsrc_type rsrc_type,
1002					u32 obj_idx)
1003{
1004	u32 obj_offset_in_sd, obj_offset_in_pd;
1005	i40e_status ret_code = 0;
1006	struct i40e_hmc_sd_entry *sd_entry;
1007	struct i40e_hmc_pd_entry *pd_entry;
1008	u32 pd_idx, pd_lmt, rel_pd_idx;
1009	u64 obj_offset_in_fpm;
1010	u32 sd_idx, sd_lmt;
1011
1012	if (NULL == hmc_info) {
1013		ret_code = I40E_ERR_BAD_PTR;
1014		hw_dbg(hw, "i40e_hmc_get_object_va: bad hmc_info ptr\n");
1015		goto exit;
1016	}
1017	if (NULL == hmc_info->hmc_obj) {
1018		ret_code = I40E_ERR_BAD_PTR;
1019		hw_dbg(hw, "i40e_hmc_get_object_va: bad hmc_info->hmc_obj ptr\n");
1020		goto exit;
1021	}
1022	if (NULL == object_base) {
1023		ret_code = I40E_ERR_BAD_PTR;
1024		hw_dbg(hw, "i40e_hmc_get_object_va: bad object_base ptr\n");
1025		goto exit;
1026	}
1027	if (I40E_HMC_INFO_SIGNATURE != hmc_info->signature) {
1028		ret_code = I40E_ERR_BAD_PTR;
1029		hw_dbg(hw, "i40e_hmc_get_object_va: bad hmc_info->signature\n");
1030		goto exit;
1031	}
1032	if (obj_idx >= hmc_info->hmc_obj[rsrc_type].cnt) {
1033		hw_dbg(hw, "i40e_hmc_get_object_va: returns error %d\n",
1034			  ret_code);
1035		ret_code = I40E_ERR_INVALID_HMC_OBJ_INDEX;
1036		goto exit;
1037	}
1038	/* find sd index and limit */
1039	I40E_FIND_SD_INDEX_LIMIT(hmc_info, rsrc_type, obj_idx, 1,
1040				 &sd_idx, &sd_lmt);
1041
1042	sd_entry = &hmc_info->sd_table.sd_entry[sd_idx];
1043	obj_offset_in_fpm = hmc_info->hmc_obj[rsrc_type].base +
1044			    hmc_info->hmc_obj[rsrc_type].size * obj_idx;
1045
1046	if (I40E_SD_TYPE_PAGED == sd_entry->entry_type) {
1047		I40E_FIND_PD_INDEX_LIMIT(hmc_info, rsrc_type, obj_idx, 1,
1048					 &pd_idx, &pd_lmt);
1049		rel_pd_idx = pd_idx % I40E_HMC_PD_CNT_IN_SD;
1050		pd_entry = &sd_entry->u.pd_table.pd_entry[rel_pd_idx];
1051		obj_offset_in_pd = (u32)(obj_offset_in_fpm %
1052					 I40E_HMC_PAGED_BP_SIZE);
1053		*object_base = (u8 *)pd_entry->bp.addr.va + obj_offset_in_pd;
1054	} else {
1055		obj_offset_in_sd = (u32)(obj_offset_in_fpm %
1056					 I40E_HMC_DIRECT_BP_SIZE);
1057		*object_base = (u8 *)sd_entry->u.bp.addr.va + obj_offset_in_sd;
1058	}
1059exit:
1060	return ret_code;
1061}
1062
1063/**
1064 * i40e_clear_lan_tx_queue_context - clear the HMC context for the queue
1065 * @hw:    the hardware struct
1066 * @queue: the queue we care about
1067 **/
1068i40e_status i40e_clear_lan_tx_queue_context(struct i40e_hw *hw,
1069						      u16 queue)
1070{
1071	i40e_status err;
1072	u8 *context_bytes;
1073
1074	err = i40e_hmc_get_object_va(&hw->hmc, &context_bytes,
1075				     I40E_HMC_LAN_TX, queue);
1076	if (err < 0)
1077		return err;
1078
1079	return i40e_clear_hmc_context(hw, context_bytes, I40E_HMC_LAN_TX);
1080}
1081
1082/**
1083 * i40e_set_lan_tx_queue_context - set the HMC context for the queue
1084 * @hw:    the hardware struct
1085 * @queue: the queue we care about
1086 * @s:     the struct to be filled
1087 **/
1088i40e_status i40e_set_lan_tx_queue_context(struct i40e_hw *hw,
1089						    u16 queue,
1090						    struct i40e_hmc_obj_txq *s)
1091{
1092	i40e_status err;
1093	u8 *context_bytes;
1094
1095	err = i40e_hmc_get_object_va(&hw->hmc, &context_bytes,
1096				     I40E_HMC_LAN_TX, queue);
1097	if (err < 0)
1098		return err;
1099
1100	return i40e_set_hmc_context(context_bytes,
1101				    i40e_hmc_txq_ce_info, (u8 *)s);
1102}
1103
1104/**
1105 * i40e_clear_lan_rx_queue_context - clear the HMC context for the queue
1106 * @hw:    the hardware struct
1107 * @queue: the queue we care about
1108 **/
1109i40e_status i40e_clear_lan_rx_queue_context(struct i40e_hw *hw,
1110						      u16 queue)
1111{
1112	i40e_status err;
1113	u8 *context_bytes;
1114
1115	err = i40e_hmc_get_object_va(&hw->hmc, &context_bytes,
1116				     I40E_HMC_LAN_RX, queue);
1117	if (err < 0)
1118		return err;
1119
1120	return i40e_clear_hmc_context(hw, context_bytes, I40E_HMC_LAN_RX);
1121}
1122
1123/**
1124 * i40e_set_lan_rx_queue_context - set the HMC context for the queue
1125 * @hw:    the hardware struct
1126 * @queue: the queue we care about
1127 * @s:     the struct to be filled
1128 **/
1129i40e_status i40e_set_lan_rx_queue_context(struct i40e_hw *hw,
1130						    u16 queue,
1131						    struct i40e_hmc_obj_rxq *s)
1132{
1133	i40e_status err;
1134	u8 *context_bytes;
1135
1136	err = i40e_hmc_get_object_va(&hw->hmc, &context_bytes,
1137				     I40E_HMC_LAN_RX, queue);
1138	if (err < 0)
1139		return err;
1140
1141	return i40e_set_hmc_context(context_bytes,
1142				    i40e_hmc_rxq_ce_info, (u8 *)s);
1143}
1144