xref: /wlan-dirver/qca-wifi-host-cmn/dp/wifi3.0/dp_rx.h (revision 87a8e4458319c60b618522e263ed900e36aab528)
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_peer *sa_peer;
400 	struct dp_ast_entry *ast;
401 	uint16_t sa_idx;
402 
403 	if (qdf_unlikely(!ta_peer))
404 		return;
405 
406 	/* For AP mode : Do wds source port learning only if it is a
407 	 * 4-address mpdu
408 	 *
409 	 * For STA mode : Frames from RootAP backend will be in 3-address mode,
410 	 * till RootAP does the WDS source port learning; Hence in repeater/STA
411 	 * mode, we enable learning even in 3-address mode , to avoid RootAP
412 	 * backbone getting wrongly learnt as MEC on repeater
413 	 */
414 	if (ta_peer->vdev->opmode != wlan_op_mode_sta) {
415 		if (!(qdf_nbuf_is_rx_chfrag_start(nbuf) &&
416 		      hal_rx_get_mpdu_mac_ad4_valid(rx_tlv_hdr)))
417 			return;
418 	}
419 
420 	memcpy(wds_src_mac, (qdf_nbuf_data(nbuf) + IEEE80211_ADDR_LEN),
421 		IEEE80211_ADDR_LEN);
422 
423 	if (qdf_unlikely(!hal_rx_msdu_end_sa_is_valid_get(rx_tlv_hdr))) {
424 		ret = dp_peer_add_ast(soc,
425 					ta_peer,
426 					wds_src_mac,
427 					CDP_TXRX_AST_TYPE_WDS,
428 					flags);
429 		return;
430 	}
431 
432 	/*
433 	 * Get the AST entry from HW SA index and mark it as active
434 	 */
435 	sa_idx = hal_rx_msdu_end_sa_idx_get(rx_tlv_hdr);
436 
437 	qdf_spin_lock_bh(&soc->ast_lock);
438 	ast = soc->ast_table[sa_idx];
439 
440 	if (!ast) {
441 		qdf_spin_unlock_bh(&soc->ast_lock);
442 		return;
443 	}
444 
445 	qdf_spin_unlock_bh(&soc->ast_lock);
446 
447 	/*
448 	 * Ensure we are updating the right AST entry by
449 	 * validating ast_idx.
450 	 * There is a possibility we might arrive here without
451 	 * AST MAP event , so this check is mandatory
452 	 */
453 	if (ast->ast_idx == sa_idx)
454 		ast->is_active = TRUE;
455 
456 	if (sa_sw_peer_id != ta_peer->peer_ids[0]) {
457 		sa_peer = ast->peer;
458 
459 		if ((ast->type != CDP_TXRX_AST_TYPE_STATIC) &&
460 		    (ast->type != CDP_TXRX_AST_TYPE_SELF)) {
461 			if (ast->pdev_id != ta_peer->vdev->pdev->pdev_id) {
462 				ret = dp_peer_add_ast(soc,
463 						      ta_peer, wds_src_mac,
464 						      CDP_TXRX_AST_TYPE_WDS,
465 						      flags);
466 			} else {
467 				qdf_spin_lock_bh(&soc->ast_lock);
468 				dp_peer_update_ast(soc, ta_peer, ast, flags);
469 				qdf_spin_unlock_bh(&soc->ast_lock);
470 				return;
471 			}
472 		}
473 		/*
474 		 * Do not kickout STA if it belongs to a different radio.
475 		 * For DBDC repeater, it is possible to arrive here
476 		 * for multicast loopback frames originated from connected
477 		 * clients and looped back (intrabss) by Root AP
478 		 */
479 		if (ast->pdev_id != ta_peer->vdev->pdev->pdev_id) {
480 			return;
481 		}
482 
483 		/*
484 		 * Kickout, when direct associated peer(SA) roams
485 		 * to another AP and reachable via TA peer
486 		 */
487 		if (!sa_peer->delete_in_progress) {
488 			sa_peer->delete_in_progress = true;
489 			if (soc->cdp_soc.ol_ops->peer_sta_kickout) {
490 				soc->cdp_soc.ol_ops->peer_sta_kickout(
491 						sa_peer->vdev->pdev->ctrl_pdev,
492 						wds_src_mac);
493 			}
494 		}
495 	}
496 
497 	return;
498 }
499 #else
500 static inline void
501 dp_rx_wds_srcport_learn(struct dp_soc *soc,
502 		uint8_t *rx_tlv_hdr,
503 		struct dp_peer *ta_peer,
504 		qdf_nbuf_t nbuf)
505 {
506 }
507 #endif
508 
509 uint8_t dp_rx_process_invalid_peer(struct dp_soc *soc, qdf_nbuf_t nbuf);
510 void dp_rx_process_invalid_peer_wrapper(struct dp_soc *soc,
511 		qdf_nbuf_t mpdu, bool mpdu_done);
512 void dp_rx_process_mic_error(struct dp_soc *soc, qdf_nbuf_t nbuf, uint8_t *rx_tlv_hdr);
513 
514 #define DP_RX_LIST_APPEND(head, tail, elem) \
515 	do {                                                \
516 		if (!(head)) {                              \
517 			(head) = (elem);                    \
518 		} else {                                    \
519 			qdf_nbuf_set_next((tail), (elem));  \
520 		}                                           \
521 		(tail) = (elem);                            \
522 		qdf_nbuf_set_next((tail), NULL);            \
523 	} while (0)
524 
525 #ifndef BUILD_X86
526 static inline int check_x86_paddr(struct dp_soc *dp_soc, qdf_nbuf_t *rx_netbuf,
527 		qdf_dma_addr_t *paddr, struct dp_pdev *pdev)
528 {
529 	return QDF_STATUS_SUCCESS;
530 }
531 #else
532 #define MAX_RETRY 100
533 static inline int check_x86_paddr(struct dp_soc *dp_soc, qdf_nbuf_t *rx_netbuf,
534 		qdf_dma_addr_t *paddr, struct dp_pdev *pdev)
535 {
536 	uint32_t nbuf_retry = 0;
537 	int32_t ret;
538 	const uint32_t x86_phy_addr = 0x50000000;
539 	/*
540 	 * in M2M emulation platforms (x86) the memory below 0x50000000
541 	 * is reserved for target use, so any memory allocated in this
542 	 * region should not be used by host
543 	 */
544 	do {
545 		if (qdf_likely(*paddr > x86_phy_addr))
546 			return QDF_STATUS_SUCCESS;
547 		else {
548 			QDF_TRACE(QDF_MODULE_ID_DP, QDF_TRACE_LEVEL_INFO,
549 					"phy addr %pK exceeded 0x50000000 trying again",
550 					paddr);
551 
552 			nbuf_retry++;
553 			if ((*rx_netbuf)) {
554 				qdf_nbuf_unmap_single(dp_soc->osdev, *rx_netbuf,
555 						QDF_DMA_BIDIRECTIONAL);
556 				/* Not freeing buffer intentionally.
557 				 * Observed that same buffer is getting
558 				 * re-allocated resulting in longer load time
559 				 * WMI init timeout.
560 				 * This buffer is anyway not useful so skip it.
561 				 **/
562 			}
563 
564 			*rx_netbuf = qdf_nbuf_alloc(dp_soc->osdev,
565 							RX_BUFFER_SIZE,
566 							RX_BUFFER_RESERVATION,
567 							RX_BUFFER_ALIGNMENT,
568 							FALSE);
569 
570 			if (qdf_unlikely(!(*rx_netbuf)))
571 				return QDF_STATUS_E_FAILURE;
572 
573 			ret = qdf_nbuf_map_single(dp_soc->osdev, *rx_netbuf,
574 							QDF_DMA_BIDIRECTIONAL);
575 
576 			if (qdf_unlikely(ret == QDF_STATUS_E_FAILURE)) {
577 				qdf_nbuf_free(*rx_netbuf);
578 				*rx_netbuf = NULL;
579 				continue;
580 			}
581 
582 			*paddr = qdf_nbuf_get_frag_paddr(*rx_netbuf, 0);
583 		}
584 	} while (nbuf_retry < MAX_RETRY);
585 
586 	if ((*rx_netbuf)) {
587 		qdf_nbuf_unmap_single(dp_soc->osdev, *rx_netbuf,
588 					QDF_DMA_BIDIRECTIONAL);
589 		qdf_nbuf_free(*rx_netbuf);
590 	}
591 
592 	return QDF_STATUS_E_FAILURE;
593 }
594 #endif
595 
596 /**
597  * dp_rx_cookie_2_link_desc_va() - Converts cookie to a virtual address of
598  *				   the MSDU Link Descriptor
599  * @soc: core txrx main context
600  * @buf_info: buf_info include cookie that used to lookup virtual address of
601  * link descriptor Normally this is just an index into a per SOC array.
602  *
603  * This is the VA of the link descriptor, that HAL layer later uses to
604  * retrieve the list of MSDU's for a given MPDU.
605  *
606  * Return: void *: Virtual Address of the Rx descriptor
607  */
608 static inline
609 void *dp_rx_cookie_2_link_desc_va(struct dp_soc *soc,
610 				  struct hal_buf_info *buf_info)
611 {
612 	void *link_desc_va;
613 	uint32_t bank_id = LINK_DESC_COOKIE_BANK_ID(buf_info->sw_cookie);
614 
615 
616 	/* TODO */
617 	/* Add sanity for  cookie */
618 
619 	link_desc_va = soc->link_desc_banks[bank_id].base_vaddr +
620 		(buf_info->paddr -
621 			soc->link_desc_banks[bank_id].base_paddr);
622 
623 	return link_desc_va;
624 }
625 
626 /**
627  * dp_rx_cookie_2_mon_link_desc_va() - Converts cookie to a virtual address of
628  *				   the MSDU Link Descriptor
629  * @pdev: core txrx pdev context
630  * @buf_info: buf_info includes cookie that used to lookup virtual address of
631  * link descriptor. Normally this is just an index into a per pdev array.
632  *
633  * This is the VA of the link descriptor in monitor mode destination ring,
634  * that HAL layer later uses to retrieve the list of MSDU's for a given MPDU.
635  *
636  * Return: void *: Virtual Address of the Rx descriptor
637  */
638 static inline
639 void *dp_rx_cookie_2_mon_link_desc_va(struct dp_pdev *pdev,
640 				  struct hal_buf_info *buf_info,
641 				  int mac_id)
642 {
643 	void *link_desc_va;
644 	int mac_for_pdev = dp_get_mac_id_for_mac(pdev->soc, mac_id);
645 
646 	/* TODO */
647 	/* Add sanity for  cookie */
648 
649 	link_desc_va =
650 	   pdev->link_desc_banks[mac_for_pdev][buf_info->sw_cookie].base_vaddr +
651 	   (buf_info->paddr -
652 	   pdev->link_desc_banks[mac_for_pdev][buf_info->sw_cookie].base_paddr);
653 
654 	return link_desc_va;
655 }
656 
657 /**
658  * dp_rx_defrag_concat() - Concatenate the fragments
659  *
660  * @dst: destination pointer to the buffer
661  * @src: source pointer from where the fragment payload is to be copied
662  *
663  * Return: QDF_STATUS
664  */
665 static inline QDF_STATUS dp_rx_defrag_concat(qdf_nbuf_t dst, qdf_nbuf_t src)
666 {
667 	/*
668 	 * Inside qdf_nbuf_cat, if it is necessary to reallocate dst
669 	 * to provide space for src, the headroom portion is copied from
670 	 * the original dst buffer to the larger new dst buffer.
671 	 * (This is needed, because the headroom of the dst buffer
672 	 * contains the rx desc.)
673 	 */
674 	if (qdf_nbuf_cat(dst, src))
675 		return QDF_STATUS_E_DEFRAG_ERROR;
676 
677 	return QDF_STATUS_SUCCESS;
678 }
679 
680 /*
681  * dp_rx_ast_set_active() - set the active flag of the astentry
682  *				    corresponding to a hw index.
683  * @soc: core txrx main context
684  * @sa_idx: hw idx
685  * @is_active: active flag
686  *
687  */
688 #ifdef FEATURE_WDS
689 static inline QDF_STATUS dp_rx_ast_set_active(struct dp_soc *soc, uint16_t sa_idx, bool is_active)
690 {
691 	struct dp_ast_entry *ast;
692 	qdf_spin_lock_bh(&soc->ast_lock);
693 	ast = soc->ast_table[sa_idx];
694 
695 	/*
696 	 * Ensure we are updating the right AST entry by
697 	 * validating ast_idx.
698 	 * There is a possibility we might arrive here without
699 	 * AST MAP event , so this check is mandatory
700 	 */
701 	if (ast && (ast->ast_idx == sa_idx)) {
702 		ast->is_active = is_active;
703 		qdf_spin_unlock_bh(&soc->ast_lock);
704 		return QDF_STATUS_SUCCESS;
705 	}
706 
707 	qdf_spin_unlock_bh(&soc->ast_lock);
708 	return QDF_STATUS_E_FAILURE;
709 }
710 #else
711 static inline QDF_STATUS dp_rx_ast_set_active(struct dp_soc *soc, uint16_t sa_idx, bool is_active)
712 {
713 	return QDF_STATUS_SUCCESS;
714 }
715 #endif
716 
717 /*
718  * check_qwrap_multicast_loopback() - Check if rx packet is a loopback packet.
719  *					In qwrap mode, packets originated from
720  *					any vdev should not loopback and
721  *					should be dropped.
722  * @vdev: vdev on which rx packet is received
723  * @nbuf: rx pkt
724  *
725  */
726 #if ATH_SUPPORT_WRAP
727 static inline bool check_qwrap_multicast_loopback(struct dp_vdev *vdev,
728 						qdf_nbuf_t nbuf)
729 {
730 	struct dp_vdev *psta_vdev;
731 	struct dp_pdev *pdev = vdev->pdev;
732 	struct dp_soc *soc = pdev->soc;
733 	uint8_t *data = qdf_nbuf_data(nbuf);
734 	uint8_t i;
735 
736 	for (i = 0; i < MAX_PDEV_CNT && soc->pdev_list[i]; i++) {
737 		pdev = soc->pdev_list[i];
738 		if (qdf_unlikely(vdev->proxysta_vdev)) {
739 			/* In qwrap isolation mode, allow loopback packets as all
740 			 * packets go to RootAP and Loopback on the mpsta.
741 			 */
742 			if (vdev->isolation_vdev)
743 				return false;
744 			TAILQ_FOREACH(psta_vdev, &pdev->vdev_list, vdev_list_elem) {
745 				if (qdf_unlikely(psta_vdev->proxysta_vdev &&
746 					!qdf_mem_cmp(psta_vdev->mac_addr.raw,
747 					&data[DP_MAC_ADDR_LEN], DP_MAC_ADDR_LEN))) {
748 					/* Drop packet if source address is equal to
749 					 * any of the vdev addresses.
750 					 */
751 					return true;
752 				}
753 			}
754 		}
755 	}
756 	return false;
757 }
758 #else
759 static inline bool check_qwrap_multicast_loopback(struct dp_vdev *vdev,
760 						qdf_nbuf_t nbuf)
761 {
762 	return false;
763 }
764 #endif
765 
766 /*
767  * dp_rx_buffers_replenish() - replenish rxdma ring with rx nbufs
768  *			       called during dp rx initialization
769  *			       and at the end of dp_rx_process.
770  *
771  * @soc: core txrx main context
772  * @mac_id: mac_id which is one of 3 mac_ids
773  * @dp_rxdma_srng: dp rxdma circular ring
774  * @rx_desc_pool: Pointer to free Rx descriptor pool
775  * @num_req_buffers: number of buffer to be replenished
776  * @desc_list: list of descs if called from dp_rx_process
777  *	       or NULL during dp rx initialization or out of buffer
778  *	       interrupt.
779  * @tail: tail of descs list
780  * Return: return success or failure
781  */
782 QDF_STATUS dp_rx_buffers_replenish(struct dp_soc *dp_soc, uint32_t mac_id,
783 				 struct dp_srng *dp_rxdma_srng,
784 				 struct rx_desc_pool *rx_desc_pool,
785 				 uint32_t num_req_buffers,
786 				 union dp_rx_desc_list_elem_t **desc_list,
787 				 union dp_rx_desc_list_elem_t **tail);
788 
789 /**
790  * dp_rx_link_desc_return() - Return a MPDU link descriptor to HW
791  *			      (WBM), following error handling
792  *
793  * @soc: core DP main context
794  * @buf_addr_info: opaque pointer to the REO error ring descriptor
795  * @buf_addr_info: void pointer to the buffer_addr_info
796  * @bm_action: put to idle_list or release to msdu_list
797  * Return: QDF_STATUS
798  */
799 QDF_STATUS
800 dp_rx_link_desc_return(struct dp_soc *soc, void *ring_desc, uint8_t bm_action);
801 
802 QDF_STATUS
803 dp_rx_link_desc_buf_return(struct dp_soc *soc, struct dp_srng *dp_rxdma_srng,
804 				void *buf_addr_info, uint8_t bm_action);
805 /**
806  * dp_rx_link_desc_return_by_addr - Return a MPDU link descriptor to
807  *					(WBM) by address
808  *
809  * @soc: core DP main context
810  * @link_desc_addr: link descriptor addr
811  *
812  * Return: QDF_STATUS
813  */
814 QDF_STATUS
815 dp_rx_link_desc_return_by_addr(struct dp_soc *soc, void *link_desc_addr,
816 					uint8_t bm_action);
817 
818 uint32_t
819 dp_rxdma_err_process(struct dp_soc *soc, uint32_t mac_id,
820 						uint32_t quota);
821 
822 void dp_rx_fill_mesh_stats(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
823 				uint8_t *rx_tlv_hdr, struct dp_peer *peer);
824 QDF_STATUS dp_rx_filter_mesh_packets(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
825 					uint8_t *rx_tlv_hdr);
826 
827 int dp_wds_rx_policy_check(uint8_t *rx_tlv_hdr, struct dp_vdev *vdev,
828 				struct dp_peer *peer, int rx_mcast);
829 
830 qdf_nbuf_t
831 dp_rx_nbuf_prepare(struct dp_soc *soc, struct dp_pdev *pdev);
832 
833 #endif /* _DP_RX_H */
834