xref: /wlan-dirver/qca-wifi-host-cmn/dp/wifi3.0/dp_rx.h (revision 4865edfd190c086bbe2c69aae12a8226f877b91e)
1 /*
2  * Copyright (c) 2016-2018 The Linux Foundation. All rights reserved.
3  *
4  * Permission to use, copy, modify, and/or distribute this software for
5  * any purpose with or without fee is hereby granted, provided that the
6  * above copyright notice and this permission notice appear in all
7  * copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16  * PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 #ifndef _DP_RX_H
20 #define _DP_RX_H
21 
22 #include "hal_rx.h"
23 #include "dp_tx.h"
24 #include "dp_peer.h"
25 #include "dp_internal.h"
26 
27 #ifdef RXDMA_OPTIMIZATION
28 #define RX_BUFFER_ALIGNMENT     128
29 #else /* RXDMA_OPTIMIZATION */
30 #define RX_BUFFER_ALIGNMENT     4
31 #endif /* RXDMA_OPTIMIZATION */
32 
33 #ifdef QCA_HOST2FW_RXBUF_RING
34 #define DP_WBM2SW_RBM HAL_RX_BUF_RBM_SW1_BM
35 #else
36 #define DP_WBM2SW_RBM HAL_RX_BUF_RBM_SW3_BM
37 #endif
38 #define RX_BUFFER_SIZE			2048
39 #define RX_BUFFER_RESERVATION   0
40 
41 #define DP_PEER_METADATA_PEER_ID_MASK	0x0000ffff
42 #define DP_PEER_METADATA_PEER_ID_SHIFT	0
43 #define DP_PEER_METADATA_VDEV_ID_MASK	0x00070000
44 #define DP_PEER_METADATA_VDEV_ID_SHIFT	16
45 
46 #define DP_PEER_METADATA_PEER_ID_GET(_peer_metadata)		\
47 	(((_peer_metadata) & DP_PEER_METADATA_PEER_ID_MASK)	\
48 			>> DP_PEER_METADATA_PEER_ID_SHIFT)
49 
50 #define DP_PEER_METADATA_ID_GET(_peer_metadata)			\
51 	(((_peer_metadata) & DP_PEER_METADATA_VDEV_ID_MASK)	\
52 			>> DP_PEER_METADATA_VDEV_ID_SHIFT)
53 
54 #define DP_RX_DESC_MAGIC 0xdec0de
55 
56 /**
57  * struct dp_rx_desc
58  *
59  * @nbuf		: VA of the "skb" posted
60  * @rx_buf_start	: VA of the original Rx buffer, before
61  *			  movement of any skb->data pointer
62  * @cookie		: index into the sw array which holds
63  *			  the sw Rx descriptors
64  *			  Cookie space is 21 bits:
65  *			  lower 18 bits -- index
66  *			  upper  3 bits -- pool_id
67  * @pool_id		: pool Id for which this allocated.
68  *			  Can only be used if there is no flow
69  *			  steering
70  * @in_use		  rx_desc is in use
71  * @unmapped		  used to mark rx_desc an unmapped if the corresponding
72  *			  nbuf is already unmapped
73  */
74 struct dp_rx_desc {
75 	qdf_nbuf_t nbuf;
76 	uint8_t *rx_buf_start;
77 	uint32_t cookie;
78 	uint8_t	 pool_id;
79 #ifdef RX_DESC_DEBUG_CHECK
80 	uint32_t magic;
81 #endif
82 	uint8_t	in_use:1,
83 	unmapped:1;
84 };
85 
86 #define RX_DESC_COOKIE_INDEX_SHIFT		0
87 #define RX_DESC_COOKIE_INDEX_MASK		0x3ffff /* 18 bits */
88 #define RX_DESC_COOKIE_POOL_ID_SHIFT		18
89 #define RX_DESC_COOKIE_POOL_ID_MASK		0x1c0000
90 
91 #define DP_RX_DESC_COOKIE_POOL_ID_GET(_cookie)		\
92 	(((_cookie) & RX_DESC_COOKIE_POOL_ID_MASK) >>	\
93 			RX_DESC_COOKIE_POOL_ID_SHIFT)
94 
95 #define DP_RX_DESC_COOKIE_INDEX_GET(_cookie)		\
96 	(((_cookie) & RX_DESC_COOKIE_INDEX_MASK) >>	\
97 			RX_DESC_COOKIE_INDEX_SHIFT)
98 
99 /*
100  *dp_rx_xor_block() - xor block of data
101  *@b: destination data block
102  *@a: source data block
103  *@len: length of the data to process
104  *
105  *Returns: None
106  */
107 static inline void dp_rx_xor_block(uint8_t *b, const uint8_t *a, qdf_size_t len)
108 {
109 	qdf_size_t i;
110 
111 	for (i = 0; i < len; i++)
112 		b[i] ^= a[i];
113 }
114 
115 /*
116  *dp_rx_rotl() - rotate the bits left
117  *@val: unsigned integer input value
118  *@bits: number of bits
119  *
120  *Returns: Integer with left rotated by number of 'bits'
121  */
122 static inline uint32_t dp_rx_rotl(uint32_t val, int bits)
123 {
124 	return (val << bits) | (val >> (32 - bits));
125 }
126 
127 /*
128  *dp_rx_rotr() - rotate the bits right
129  *@val: unsigned integer input value
130  *@bits: number of bits
131  *
132  *Returns: Integer with right rotated by number of 'bits'
133  */
134 static inline uint32_t dp_rx_rotr(uint32_t val, int bits)
135 {
136 	return (val >> bits) | (val << (32 - bits));
137 }
138 
139 /*
140  * dp_set_rx_queue() - set queue_mapping in skb
141  * @nbuf: skb
142  * @queue_id: rx queue_id
143  *
144  * Return: void
145  */
146 #ifdef QCA_OL_RX_MULTIQ_SUPPORT
147 static inline void dp_set_rx_queue(qdf_nbuf_t nbuf, uint8_t queue_id)
148 {
149 	qdf_nbuf_record_rx_queue(nbuf, queue_id);
150 	return;
151 }
152 #else
153 static inline void dp_set_rx_queue(qdf_nbuf_t nbuf, uint8_t queue_id)
154 {
155 }
156 #endif
157 
158 /*
159  *dp_rx_xswap() - swap the bits left
160  *@val: unsigned integer input value
161  *
162  *Returns: Integer with bits swapped
163  */
164 static inline uint32_t dp_rx_xswap(uint32_t val)
165 {
166 	return ((val & 0x00ff00ff) << 8) | ((val & 0xff00ff00) >> 8);
167 }
168 
169 /*
170  *dp_rx_get_le32_split() - get little endian 32 bits split
171  *@b0: byte 0
172  *@b1: byte 1
173  *@b2: byte 2
174  *@b3: byte 3
175  *
176  *Returns: Integer with split little endian 32 bits
177  */
178 static inline uint32_t dp_rx_get_le32_split(uint8_t b0, uint8_t b1, uint8_t b2,
179 					uint8_t b3)
180 {
181 	return b0 | (b1 << 8) | (b2 << 16) | (b3 << 24);
182 }
183 
184 /*
185  *dp_rx_get_le32() - get little endian 32 bits
186  *@b0: byte 0
187  *@b1: byte 1
188  *@b2: byte 2
189  *@b3: byte 3
190  *
191  *Returns: Integer with little endian 32 bits
192  */
193 static inline uint32_t dp_rx_get_le32(const uint8_t *p)
194 {
195 	return dp_rx_get_le32_split(p[0], p[1], p[2], p[3]);
196 }
197 
198 /*
199  * dp_rx_put_le32() - put little endian 32 bits
200  * @p: destination char array
201  * @v: source 32-bit integer
202  *
203  * Returns: None
204  */
205 static inline void dp_rx_put_le32(uint8_t *p, uint32_t v)
206 {
207 	p[0] = (v) & 0xff;
208 	p[1] = (v >> 8) & 0xff;
209 	p[2] = (v >> 16) & 0xff;
210 	p[3] = (v >> 24) & 0xff;
211 }
212 
213 /* Extract michal mic block of data */
214 #define dp_rx_michael_block(l, r)	\
215 	do {					\
216 		r ^= dp_rx_rotl(l, 17);	\
217 		l += r;				\
218 		r ^= dp_rx_xswap(l);		\
219 		l += r;				\
220 		r ^= dp_rx_rotl(l, 3);	\
221 		l += r;				\
222 		r ^= dp_rx_rotr(l, 2);	\
223 		l += r;				\
224 	} while (0)
225 
226 /**
227  * struct dp_rx_desc_list_elem_t
228  *
229  * @next		: Next pointer to form free list
230  * @rx_desc		: DP Rx descriptor
231  */
232 union dp_rx_desc_list_elem_t {
233 	union dp_rx_desc_list_elem_t *next;
234 	struct dp_rx_desc rx_desc;
235 };
236 
237 /**
238  * dp_rx_cookie_2_va_rxdma_buf() - Converts cookie to a virtual address of
239  *			 the Rx descriptor on Rx DMA source ring buffer
240  * @soc: core txrx main context
241  * @cookie: cookie used to lookup virtual address
242  *
243  * Return: void *: Virtual Address of the Rx descriptor
244  */
245 static inline
246 void *dp_rx_cookie_2_va_rxdma_buf(struct dp_soc *soc, uint32_t cookie)
247 {
248 	uint8_t pool_id = DP_RX_DESC_COOKIE_POOL_ID_GET(cookie);
249 	uint16_t index = DP_RX_DESC_COOKIE_INDEX_GET(cookie);
250 	struct rx_desc_pool *rx_desc_pool;
251 
252 	if (qdf_unlikely(pool_id >= MAX_RXDESC_POOLS))
253 		return NULL;
254 
255 	rx_desc_pool = &soc->rx_desc_buf[pool_id];
256 
257 	if (qdf_unlikely(index >= rx_desc_pool->pool_size))
258 		return NULL;
259 
260 	return &(soc->rx_desc_buf[pool_id].array[index].rx_desc);
261 }
262 
263 /**
264  * dp_rx_cookie_2_va_mon_buf() - Converts cookie to a virtual address of
265  *			 the Rx descriptor on monitor ring buffer
266  * @soc: core txrx main context
267  * @cookie: cookie used to lookup virtual address
268  *
269  * Return: void *: Virtual Address of the Rx descriptor
270  */
271 static inline
272 void *dp_rx_cookie_2_va_mon_buf(struct dp_soc *soc, uint32_t cookie)
273 {
274 	uint8_t pool_id = DP_RX_DESC_COOKIE_POOL_ID_GET(cookie);
275 	uint16_t index = DP_RX_DESC_COOKIE_INDEX_GET(cookie);
276 	/* TODO */
277 	/* Add sanity for pool_id & index */
278 	return &(soc->rx_desc_mon[pool_id].array[index].rx_desc);
279 }
280 
281 /**
282  * dp_rx_cookie_2_va_mon_status() - Converts cookie to a virtual address of
283  *			 the Rx descriptor on monitor status ring buffer
284  * @soc: core txrx main context
285  * @cookie: cookie used to lookup virtual address
286  *
287  * Return: void *: Virtual Address of the Rx descriptor
288  */
289 static inline
290 void *dp_rx_cookie_2_va_mon_status(struct dp_soc *soc, uint32_t cookie)
291 {
292 	uint8_t pool_id = DP_RX_DESC_COOKIE_POOL_ID_GET(cookie);
293 	uint16_t index = DP_RX_DESC_COOKIE_INDEX_GET(cookie);
294 	/* TODO */
295 	/* Add sanity for pool_id & index */
296 	return &(soc->rx_desc_status[pool_id].array[index].rx_desc);
297 }
298 
299 void dp_rx_add_desc_list_to_free_list(struct dp_soc *soc,
300 				union dp_rx_desc_list_elem_t **local_desc_list,
301 				union dp_rx_desc_list_elem_t **tail,
302 				uint16_t pool_id,
303 				struct rx_desc_pool *rx_desc_pool);
304 
305 uint16_t dp_rx_get_free_desc_list(struct dp_soc *soc, uint32_t pool_id,
306 				struct rx_desc_pool *rx_desc_pool,
307 				uint16_t num_descs,
308 				union dp_rx_desc_list_elem_t **desc_list,
309 				union dp_rx_desc_list_elem_t **tail);
310 
311 
312 QDF_STATUS dp_rx_pdev_attach(struct dp_pdev *pdev);
313 
314 void dp_rx_pdev_detach(struct dp_pdev *pdev);
315 
316 
317 uint32_t
318 dp_rx_process(struct dp_intr *int_ctx, void *hal_ring, uint32_t quota);
319 
320 uint32_t dp_rx_err_process(struct dp_soc *soc, void *hal_ring, uint32_t quota);
321 
322 uint32_t
323 dp_rx_wbm_err_process(struct dp_soc *soc, void *hal_ring, uint32_t quota);
324 
325 /**
326  * dp_rx_sg_create() - create a frag_list for MSDUs which are spread across
327  *		     multiple nbufs.
328  * @nbuf: pointer to the first msdu of an amsdu.
329  * @rx_tlv_hdr: pointer to the start of RX TLV headers.
330  *
331  * This function implements the creation of RX frag_list for cases
332  * where an MSDU is spread across multiple nbufs.
333  *
334  * Return: returns the head nbuf which contains complete frag_list.
335  */
336 qdf_nbuf_t dp_rx_sg_create(qdf_nbuf_t nbuf, uint8_t *rx_tlv_hdr);
337 
338 QDF_STATUS dp_rx_desc_pool_alloc(struct dp_soc *soc,
339 				uint32_t pool_id,
340 				uint32_t pool_size,
341 				struct rx_desc_pool *rx_desc_pool);
342 
343 void dp_rx_desc_pool_free(struct dp_soc *soc,
344 				uint32_t pool_id,
345 				struct rx_desc_pool *rx_desc_pool);
346 
347 void dp_rx_deliver_raw(struct dp_vdev *vdev, qdf_nbuf_t nbuf_list,
348 				struct dp_peer *peer);
349 
350 /**
351  * dp_rx_add_to_free_desc_list() - Adds to a local free descriptor list
352  *
353  * @head: pointer to the head of local free list
354  * @tail: pointer to the tail of local free list
355  * @new: new descriptor that is added to the free list
356  *
357  * Return: void:
358  */
359 static inline
360 void dp_rx_add_to_free_desc_list(union dp_rx_desc_list_elem_t **head,
361 				 union dp_rx_desc_list_elem_t **tail,
362 				 struct dp_rx_desc *new)
363 {
364 	qdf_assert(head && new);
365 
366 	new->nbuf = NULL;
367 	new->in_use = 0;
368 	new->unmapped = 0;
369 
370 	((union dp_rx_desc_list_elem_t *)new)->next = *head;
371 	*head = (union dp_rx_desc_list_elem_t *)new;
372 	if (*tail == NULL)
373 		*tail = *head;
374 
375 }
376 
377 /**
378  * dp_rx_wds_srcport_learn() - Add or update the STA PEER which
379  *				is behind the WDS repeater.
380  *
381  * @soc: core txrx main context
382  * @rx_tlv_hdr: base address of RX TLV header
383  * @ta_peer: WDS repeater peer
384  * @nbuf: rx pkt
385  *
386  * Return: void:
387  */
388 #ifdef FEATURE_WDS
389 static inline void
390 dp_rx_wds_srcport_learn(struct dp_soc *soc,
391 			 uint8_t *rx_tlv_hdr,
392 			 struct dp_peer *ta_peer,
393 			 qdf_nbuf_t nbuf)
394 {
395 	uint16_t sa_sw_peer_id = hal_rx_msdu_end_sa_sw_peer_id_get(rx_tlv_hdr);
396 	uint32_t flags = IEEE80211_NODE_F_WDS_HM;
397 	uint32_t ret = 0;
398 	uint8_t wds_src_mac[IEEE80211_ADDR_LEN];
399 	struct dp_ast_entry *ast;
400 	uint16_t sa_idx;
401 
402 	/* Do wds source port learning only if it is a 4-address mpdu */
403 	if (!(qdf_nbuf_is_rx_chfrag_start(nbuf) &&
404 		hal_rx_get_mpdu_mac_ad4_valid(rx_tlv_hdr)))
405 		return;
406 
407 	memcpy(wds_src_mac, (qdf_nbuf_data(nbuf) + IEEE80211_ADDR_LEN),
408 		IEEE80211_ADDR_LEN);
409 
410 	if (qdf_unlikely(!hal_rx_msdu_end_sa_is_valid_get(rx_tlv_hdr))) {
411 		ret = dp_peer_add_ast(soc,
412 					ta_peer,
413 					wds_src_mac,
414 					CDP_TXRX_AST_TYPE_WDS,
415 					flags);
416 		return;
417 
418 	}
419 
420 	/*
421 	 * Get the AST entry from HW SA index and mark it as active
422 	 */
423 	sa_idx = hal_rx_msdu_end_sa_idx_get(rx_tlv_hdr);
424 
425 	qdf_spin_lock_bh(&soc->ast_lock);
426 	ast = soc->ast_table[sa_idx];
427 
428 	if (!ast) {
429 		qdf_spin_unlock_bh(&soc->ast_lock);
430 		return;
431 	}
432 
433 	/*
434 	 * Ensure we are updating the right AST entry by
435 	 * validating ast_idx.
436 	 * There is a possibility we might arrive here without
437 	 * AST MAP event , so this check is mandatory
438 	 */
439 	if (ast->ast_idx == sa_idx)
440 		ast->is_active = TRUE;
441 
442 	/* Handle client roaming */
443 	if (sa_sw_peer_id != ta_peer->peer_ids[0])
444 		dp_peer_update_ast(soc, ta_peer, ast, flags);
445 
446 	qdf_spin_unlock_bh(&soc->ast_lock);
447 
448 	return;
449 }
450 #else
451 static inline void
452 dp_rx_wds_srcport_learn(struct dp_soc *soc,
453 		uint8_t *rx_tlv_hdr,
454 		struct dp_peer *ta_peer,
455 		qdf_nbuf_t nbuf)
456 {
457 }
458 #endif
459 
460 uint8_t dp_rx_process_invalid_peer(struct dp_soc *soc, qdf_nbuf_t nbuf);
461 void dp_rx_process_invalid_peer_wrapper(struct dp_soc *soc,
462 		qdf_nbuf_t mpdu, bool mpdu_done);
463 void dp_rx_process_mic_error(struct dp_soc *soc, qdf_nbuf_t nbuf, uint8_t *rx_tlv_hdr);
464 
465 #define DP_RX_LIST_APPEND(head, tail, elem) \
466 	do {                                                \
467 		if (!(head)) {                              \
468 			(head) = (elem);                    \
469 		} else {                                    \
470 			qdf_nbuf_set_next((tail), (elem));  \
471 		}                                           \
472 		(tail) = (elem);                            \
473 		qdf_nbuf_set_next((tail), NULL);            \
474 	} while (0)
475 
476 #ifndef BUILD_X86
477 static inline int check_x86_paddr(struct dp_soc *dp_soc, qdf_nbuf_t *rx_netbuf,
478 		qdf_dma_addr_t *paddr, struct dp_pdev *pdev)
479 {
480 	return QDF_STATUS_SUCCESS;
481 }
482 #else
483 #define MAX_RETRY 100
484 static inline int check_x86_paddr(struct dp_soc *dp_soc, qdf_nbuf_t *rx_netbuf,
485 		qdf_dma_addr_t *paddr, struct dp_pdev *pdev)
486 {
487 	uint32_t nbuf_retry = 0;
488 	int32_t ret;
489 	const uint32_t x86_phy_addr = 0x50000000;
490 	/*
491 	 * in M2M emulation platforms (x86) the memory below 0x50000000
492 	 * is reserved for target use, so any memory allocated in this
493 	 * region should not be used by host
494 	 */
495 	do {
496 		if (qdf_likely(*paddr > x86_phy_addr))
497 			return QDF_STATUS_SUCCESS;
498 		else {
499 			QDF_TRACE(QDF_MODULE_ID_DP, QDF_TRACE_LEVEL_INFO,
500 					"phy addr %pK exceded 0x50000000 trying again\n",
501 					paddr);
502 
503 			nbuf_retry++;
504 			if ((*rx_netbuf)) {
505 				qdf_nbuf_unmap_single(dp_soc->osdev, *rx_netbuf,
506 						QDF_DMA_BIDIRECTIONAL);
507 				/* Not freeing buffer intentionally.
508 				 * Observed that same buffer is getting
509 				 * re-allocated resulting in longer load time
510 				 * WMI init timeout.
511 				 * This buffer is anyway not useful so skip it.
512 				 **/
513 			}
514 
515 			*rx_netbuf = qdf_nbuf_alloc(dp_soc->osdev,
516 							RX_BUFFER_SIZE,
517 							RX_BUFFER_RESERVATION,
518 							RX_BUFFER_ALIGNMENT,
519 							FALSE);
520 
521 			if (qdf_unlikely(!(*rx_netbuf)))
522 				return QDF_STATUS_E_FAILURE;
523 
524 			ret = qdf_nbuf_map_single(dp_soc->osdev, *rx_netbuf,
525 							QDF_DMA_BIDIRECTIONAL);
526 
527 			if (qdf_unlikely(ret == QDF_STATUS_E_FAILURE)) {
528 				qdf_nbuf_free(*rx_netbuf);
529 				*rx_netbuf = NULL;
530 				continue;
531 			}
532 
533 			*paddr = qdf_nbuf_get_frag_paddr(*rx_netbuf, 0);
534 		}
535 	} while (nbuf_retry < MAX_RETRY);
536 
537 	if ((*rx_netbuf)) {
538 		qdf_nbuf_unmap_single(dp_soc->osdev, *rx_netbuf,
539 					QDF_DMA_BIDIRECTIONAL);
540 		qdf_nbuf_free(*rx_netbuf);
541 	}
542 
543 	return QDF_STATUS_E_FAILURE;
544 }
545 #endif
546 
547 /**
548  * dp_rx_cookie_2_link_desc_va() - Converts cookie to a virtual address of
549  *				   the MSDU Link Descriptor
550  * @soc: core txrx main context
551  * @buf_info: buf_info include cookie that used to lookup virtual address of
552  * link descriptor Normally this is just an index into a per SOC array.
553  *
554  * This is the VA of the link descriptor, that HAL layer later uses to
555  * retrieve the list of MSDU's for a given MPDU.
556  *
557  * Return: void *: Virtual Address of the Rx descriptor
558  */
559 static inline
560 void *dp_rx_cookie_2_link_desc_va(struct dp_soc *soc,
561 				  struct hal_buf_info *buf_info)
562 {
563 	void *link_desc_va;
564 	uint32_t bank_id = LINK_DESC_COOKIE_BANK_ID(buf_info->sw_cookie);
565 
566 
567 	/* TODO */
568 	/* Add sanity for  cookie */
569 
570 	link_desc_va = soc->link_desc_banks[bank_id].base_vaddr +
571 		(buf_info->paddr -
572 			soc->link_desc_banks[bank_id].base_paddr);
573 
574 	return link_desc_va;
575 }
576 
577 /**
578  * dp_rx_cookie_2_mon_link_desc_va() - Converts cookie to a virtual address of
579  *				   the MSDU Link Descriptor
580  * @pdev: core txrx pdev context
581  * @buf_info: buf_info includes cookie that used to lookup virtual address of
582  * link descriptor. Normally this is just an index into a per pdev array.
583  *
584  * This is the VA of the link descriptor in monitor mode destination ring,
585  * that HAL layer later uses to retrieve the list of MSDU's for a given MPDU.
586  *
587  * Return: void *: Virtual Address of the Rx descriptor
588  */
589 static inline
590 void *dp_rx_cookie_2_mon_link_desc_va(struct dp_pdev *pdev,
591 				  struct hal_buf_info *buf_info,
592 				  int mac_id)
593 {
594 	void *link_desc_va;
595 	int mac_for_pdev = dp_get_mac_id_for_mac(pdev->soc, mac_id);
596 
597 	/* TODO */
598 	/* Add sanity for  cookie */
599 
600 	link_desc_va =
601 	   pdev->link_desc_banks[mac_for_pdev][buf_info->sw_cookie].base_vaddr +
602 	   (buf_info->paddr -
603 	   pdev->link_desc_banks[mac_for_pdev][buf_info->sw_cookie].base_paddr);
604 
605 	return link_desc_va;
606 }
607 
608 /**
609  * dp_rx_defrag_concat() - Concatenate the fragments
610  *
611  * @dst: destination pointer to the buffer
612  * @src: source pointer from where the fragment payload is to be copied
613  *
614  * Return: QDF_STATUS
615  */
616 static inline QDF_STATUS dp_rx_defrag_concat(qdf_nbuf_t dst, qdf_nbuf_t src)
617 {
618 	/*
619 	 * Inside qdf_nbuf_cat, if it is necessary to reallocate dst
620 	 * to provide space for src, the headroom portion is copied from
621 	 * the original dst buffer to the larger new dst buffer.
622 	 * (This is needed, because the headroom of the dst buffer
623 	 * contains the rx desc.)
624 	 */
625 	if (qdf_nbuf_cat(dst, src))
626 		return QDF_STATUS_E_DEFRAG_ERROR;
627 
628 	return QDF_STATUS_SUCCESS;
629 }
630 
631 /*
632  * dp_rx_ast_set_active() - set the active flag of the astentry
633  *				    corresponding to a hw index.
634  * @soc: core txrx main context
635  * @sa_idx: hw idx
636  * @is_active: active flag
637  *
638  */
639 #ifdef FEATURE_WDS
640 static inline QDF_STATUS dp_rx_ast_set_active(struct dp_soc *soc, uint16_t sa_idx, bool is_active)
641 {
642 	struct dp_ast_entry *ast;
643 	qdf_spin_lock_bh(&soc->ast_lock);
644 	ast = soc->ast_table[sa_idx];
645 
646 	/*
647 	 * Ensure we are updating the right AST entry by
648 	 * validating ast_idx.
649 	 * There is a possibility we might arrive here without
650 	 * AST MAP event , so this check is mandatory
651 	 */
652 	if (ast && (ast->ast_idx == sa_idx)) {
653 		ast->is_active = is_active;
654 		qdf_spin_unlock_bh(&soc->ast_lock);
655 		return QDF_STATUS_SUCCESS;
656 	}
657 
658 	qdf_spin_unlock_bh(&soc->ast_lock);
659 	return QDF_STATUS_E_FAILURE;
660 }
661 #else
662 static inline QDF_STATUS dp_rx_ast_set_active(struct dp_soc *soc, uint16_t sa_idx, bool is_active)
663 {
664 	return QDF_STATUS_SUCCESS;
665 }
666 #endif
667 
668 /*
669  * check_qwrap_multicast_loopback() - Check if rx packet is a loopback packet.
670  *					In qwrap mode, packets originated from
671  *					any vdev should not loopback and
672  *					should be dropped.
673  * @vdev: vdev on which rx packet is received
674  * @nbuf: rx pkt
675  *
676  */
677 #if ATH_SUPPORT_WRAP
678 static inline bool check_qwrap_multicast_loopback(struct dp_vdev *vdev,
679 						qdf_nbuf_t nbuf)
680 {
681 	struct dp_vdev *psta_vdev;
682 	struct dp_pdev *pdev = vdev->pdev;
683 	struct dp_soc *soc = pdev->soc;
684 	uint8_t *data = qdf_nbuf_data(nbuf);
685 	uint8_t i;
686 
687 	for (i = 0; i < MAX_PDEV_CNT && soc->pdev_list[i]; i++) {
688 		pdev = soc->pdev_list[i];
689 		if (qdf_unlikely(vdev->proxysta_vdev)) {
690 			/* In qwrap isolation mode, allow loopback packets as all
691 			 * packets go to RootAP and Loopback on the mpsta.
692 			 */
693 			if (vdev->isolation_vdev)
694 				return false;
695 			TAILQ_FOREACH(psta_vdev, &pdev->vdev_list, vdev_list_elem) {
696 				if (qdf_unlikely(psta_vdev->proxysta_vdev &&
697 					!qdf_mem_cmp(psta_vdev->mac_addr.raw,
698 					&data[DP_MAC_ADDR_LEN], DP_MAC_ADDR_LEN))) {
699 					/* Drop packet if source address is equal to
700 					 * any of the vdev addresses.
701 					 */
702 					return true;
703 				}
704 			}
705 		}
706 	}
707 	return false;
708 }
709 #else
710 static inline bool check_qwrap_multicast_loopback(struct dp_vdev *vdev,
711 						qdf_nbuf_t nbuf)
712 {
713 	return false;
714 }
715 #endif
716 
717 /*
718  * dp_rx_buffers_replenish() - replenish rxdma ring with rx nbufs
719  *			       called during dp rx initialization
720  *			       and at the end of dp_rx_process.
721  *
722  * @soc: core txrx main context
723  * @mac_id: mac_id which is one of 3 mac_ids
724  * @dp_rxdma_srng: dp rxdma circular ring
725  * @rx_desc_pool: Poiter to free Rx descriptor pool
726  * @num_req_buffers: number of buffer to be replenished
727  * @desc_list: list of descs if called from dp_rx_process
728  *	       or NULL during dp rx initialization or out of buffer
729  *	       interrupt.
730  * @tail: tail of descs list
731  * Return: return success or failure
732  */
733 QDF_STATUS dp_rx_buffers_replenish(struct dp_soc *dp_soc, uint32_t mac_id,
734 				 struct dp_srng *dp_rxdma_srng,
735 				 struct rx_desc_pool *rx_desc_pool,
736 				 uint32_t num_req_buffers,
737 				 union dp_rx_desc_list_elem_t **desc_list,
738 				 union dp_rx_desc_list_elem_t **tail);
739 
740 /**
741  * dp_rx_link_desc_return() - Return a MPDU link descriptor to HW
742  *			      (WBM), following error handling
743  *
744  * @soc: core DP main context
745  * @buf_addr_info: opaque pointer to the REO error ring descriptor
746  * @buf_addr_info: void pointer to the buffer_addr_info
747  * @bm_action: put to idle_list or release to msdu_list
748  * Return: QDF_STATUS
749  */
750 QDF_STATUS
751 dp_rx_link_desc_return(struct dp_soc *soc, void *ring_desc, uint8_t bm_action);
752 
753 QDF_STATUS
754 dp_rx_link_desc_buf_return(struct dp_soc *soc, struct dp_srng *dp_rxdma_srng,
755 				void *buf_addr_info, uint8_t bm_action);
756 /**
757  * dp_rx_link_desc_return_by_addr - Return a MPDU link descriptor to
758  *					(WBM) by address
759  *
760  * @soc: core DP main context
761  * @link_desc_addr: link descriptor addr
762  *
763  * Return: QDF_STATUS
764  */
765 QDF_STATUS
766 dp_rx_link_desc_return_by_addr(struct dp_soc *soc, void *link_desc_addr,
767 					uint8_t bm_action);
768 
769 uint32_t
770 dp_rxdma_err_process(struct dp_soc *soc, uint32_t mac_id,
771 						uint32_t quota);
772 
773 void dp_rx_fill_mesh_stats(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
774 				uint8_t *rx_tlv_hdr, struct dp_peer *peer);
775 QDF_STATUS dp_rx_filter_mesh_packets(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
776 					uint8_t *rx_tlv_hdr);
777 
778 int dp_wds_rx_policy_check(uint8_t *rx_tlv_hdr, struct dp_vdev *vdev,
779 				struct dp_peer *peer, int rx_mcast);
780 
781 qdf_nbuf_t
782 dp_rx_nbuf_prepare(struct dp_soc *soc, struct dp_pdev *pdev);
783 
784 #endif /* _DP_RX_H */
785