dp_rx_defrag.h 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252
  1. /*
  2. * Copyright (c) 2017-2021 The Linux Foundation. All rights reserved.
  3. * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
  4. *
  5. * Permission to use, copy, modify, and/or distribute this software for
  6. * any purpose with or without fee is hereby granted, provided that the
  7. * above copyright notice and this permission notice appear in all
  8. * copies.
  9. *
  10. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  11. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  12. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  13. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  14. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  15. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  16. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  17. * PERFORMANCE OF THIS SOFTWARE.
  18. */
  19. #ifndef _DP_RX_DEFRAG_H
  20. #define _DP_RX_DEFRAG_H
  21. #include "hal_rx.h"
  22. #define DEFRAG_IEEE80211_KEY_LEN 8
  23. #define DEFRAG_IEEE80211_FCS_LEN 4
  24. #define DP_RX_DEFRAG_IEEE80211_ADDR_COPY(dst, src) \
  25. qdf_mem_copy(dst, src, QDF_MAC_ADDR_SIZE)
  26. #define DP_RX_DEFRAG_IEEE80211_QOS_HAS_SEQ(wh) \
  27. (((wh) & \
  28. (IEEE80211_FC0_TYPE_MASK | QDF_IEEE80211_FC0_SUBTYPE_QOS)) == \
  29. (IEEE80211_FC0_TYPE_DATA | QDF_IEEE80211_FC0_SUBTYPE_QOS))
  30. #define UNI_DESC_OWNER_SW 0x1
  31. #define UNI_DESC_BUF_TYPE_RX_MSDU_LINK 0x6
  32. /**
  33. * struct dp_rx_defrag_cipher: structure to indicate cipher header
  34. * @ic_name: Name
  35. * @ic_header: header length
  36. * @ic_trailer: trail length
  37. * @ic_miclen: MIC length
  38. */
  39. struct dp_rx_defrag_cipher {
  40. const char *ic_name;
  41. uint16_t ic_header;
  42. uint8_t ic_trailer;
  43. uint8_t ic_miclen;
  44. };
  45. #ifndef WLAN_SOFTUMAC_SUPPORT /* WLAN_SOFTUMAC_SUPPORT */
  46. /**
  47. * dp_rx_frag_handle() - Handles fragmented Rx frames
  48. *
  49. * @soc: core txrx main context
  50. * @ring_desc: opaque pointer to the REO error ring descriptor
  51. * @mpdu_desc_info: MPDU descriptor information from ring descriptor
  52. * @rx_desc:
  53. * @mac_id:
  54. * @quota: No. of units (packets) that can be serviced in one shot.
  55. *
  56. * This function implements RX 802.11 fragmentation handling
  57. * The handling is mostly same as legacy fragmentation handling.
  58. * If required, this function can re-inject the frames back to
  59. * REO ring (with proper setting to by-pass fragmentation check
  60. * but use duplicate detection / re-ordering and routing these frames
  61. * to a different core.
  62. *
  63. * Return: uint32_t: No. of elements processed
  64. */
  65. uint32_t dp_rx_frag_handle(struct dp_soc *soc, hal_ring_desc_t ring_desc,
  66. struct hal_rx_mpdu_desc_info *mpdu_desc_info,
  67. struct dp_rx_desc *rx_desc,
  68. uint8_t *mac_id,
  69. uint32_t quota);
  70. #endif /* WLAN_SOFTUMAC_SUPPORT */
  71. /**
  72. * dp_rx_frag_get_mac_hdr() - Return pointer to the mac hdr
  73. * @soc: DP SOC
  74. * @rx_desc_info: Pointer to the pkt_tlvs in the
  75. * nbuf (pkt_tlvs->mac_hdr->data)
  76. *
  77. * It is inefficient to peek into the packet for received
  78. * frames but these APIs are required to get to some of
  79. * 802.11 fields that hardware does not populate in the
  80. * rx meta data.
  81. *
  82. * Return: pointer to ieee80211_frame
  83. */
  84. static inline struct ieee80211_frame *
  85. dp_rx_frag_get_mac_hdr(struct dp_soc *soc, uint8_t *rx_desc_info)
  86. {
  87. int rx_desc_len = soc->rx_pkt_tlv_size;
  88. return (struct ieee80211_frame *)(rx_desc_info + rx_desc_len);
  89. }
  90. /**
  91. * dp_rx_frag_get_mpdu_seq_number() - Get mpdu sequence number
  92. * @soc: DP SOC
  93. * @rx_desc_info: Pointer to the pkt_tlvs in the
  94. * nbuf (pkt_tlvs->mac_hdr->data)
  95. *
  96. * Return: uint16_t, rx sequence number
  97. */
  98. static inline uint16_t
  99. dp_rx_frag_get_mpdu_seq_number(struct dp_soc *soc, int8_t *rx_desc_info)
  100. {
  101. struct ieee80211_frame *mac_hdr;
  102. mac_hdr = dp_rx_frag_get_mac_hdr(soc, rx_desc_info);
  103. return qdf_le16_to_cpu(*(uint16_t *) mac_hdr->i_seq) >>
  104. IEEE80211_SEQ_SEQ_SHIFT;
  105. }
  106. /**
  107. * dp_rx_frag_get_mpdu_frag_number() - Get mpdu fragment number
  108. * @soc: DP SOC
  109. * @rx_desc_info: Pointer to the pkt_tlvs in the
  110. * nbuf (pkt_tlvs->mac_hdr->data)
  111. *
  112. * Return: uint8_t, receive fragment number
  113. */
  114. static inline uint8_t
  115. dp_rx_frag_get_mpdu_frag_number(struct dp_soc *soc, uint8_t *rx_desc_info)
  116. {
  117. struct ieee80211_frame *mac_hdr;
  118. mac_hdr = dp_rx_frag_get_mac_hdr(soc, rx_desc_info);
  119. return qdf_le16_to_cpu(*(uint16_t *) mac_hdr->i_seq) &
  120. IEEE80211_SEQ_FRAG_MASK;
  121. }
  122. /**
  123. * dp_rx_frag_get_more_frag_bit() - Get more fragment bit
  124. * @soc: DP SOC
  125. * @rx_desc_info: Pointer to the pkt_tlvs in the
  126. * nbuf (pkt_tlvs->mac_hdr->data)
  127. *
  128. * Return: uint8_t, get more fragment bit
  129. */
  130. static inline
  131. uint8_t dp_rx_frag_get_more_frag_bit(struct dp_soc *soc, uint8_t *rx_desc_info)
  132. {
  133. struct ieee80211_frame *mac_hdr;
  134. mac_hdr = dp_rx_frag_get_mac_hdr(soc, rx_desc_info);
  135. return (mac_hdr->i_fc[1] & IEEE80211_FC1_MORE_FRAG) >> 2;
  136. }
  137. static inline
  138. uint8_t dp_rx_get_pkt_dir(struct dp_soc *soc, uint8_t *rx_desc_info)
  139. {
  140. struct ieee80211_frame *mac_hdr;
  141. mac_hdr = dp_rx_frag_get_mac_hdr(soc, rx_desc_info);
  142. return mac_hdr->i_fc[1] & IEEE80211_FC1_DIR_MASK;
  143. }
  144. /**
  145. * dp_rx_defrag_fraglist_insert() - Create a per-sequence fragment list
  146. * @txrx_peer: Pointer to the peer data structure
  147. * @tid: Transmit ID (TID)
  148. * @head_addr: Pointer to head list
  149. * @tail_addr: Pointer to tail list
  150. * @frag: Incoming fragment
  151. * @all_frag_present: Flag to indicate whether all fragments are received
  152. *
  153. * Build a per-tid, per-sequence fragment list.
  154. *
  155. * Return: Success, if inserted
  156. */
  157. QDF_STATUS
  158. dp_rx_defrag_fraglist_insert(struct dp_txrx_peer *txrx_peer, unsigned int tid,
  159. qdf_nbuf_t *head_addr, qdf_nbuf_t *tail_addr,
  160. qdf_nbuf_t frag, uint8_t *all_frag_present);
  161. /**
  162. * dp_rx_defrag_waitlist_add() - Update per-PDEV defrag wait list
  163. * @txrx_peer: Pointer to the peer data structure
  164. * @tid: Transmit ID (TID)
  165. *
  166. * Appends per-tid fragments to global fragment wait list
  167. *
  168. * Return: None
  169. */
  170. void dp_rx_defrag_waitlist_add(struct dp_txrx_peer *txrx_peer,
  171. unsigned int tid);
  172. /**
  173. * dp_rx_defrag() - Defragment the fragment chain
  174. * @txrx_peer: Pointer to the peer
  175. * @tid: Transmit Identifier
  176. * @frag_list_head: Pointer to head list
  177. * @frag_list_tail: Pointer to tail list
  178. *
  179. * Defragment the fragment chain
  180. *
  181. * Return: QDF_STATUS
  182. */
  183. QDF_STATUS dp_rx_defrag(struct dp_txrx_peer *txrx_peer, unsigned int tid,
  184. qdf_nbuf_t frag_list_head,
  185. qdf_nbuf_t frag_list_tail);
  186. /**
  187. * dp_rx_defrag_waitlist_flush() - Flush SOC defrag wait list
  188. * @soc: DP SOC
  189. *
  190. * Flush fragments of all waitlisted TID's
  191. *
  192. * Return: None
  193. */
  194. void dp_rx_defrag_waitlist_flush(struct dp_soc *soc);
  195. /**
  196. * dp_rx_reorder_flush_frag() - Flush the frag list
  197. * @txrx_peer: Pointer to the peer data structure
  198. * @tid: Transmit ID (TID)
  199. *
  200. * Flush the per-TID frag list
  201. *
  202. * Return: None
  203. */
  204. void dp_rx_reorder_flush_frag(struct dp_txrx_peer *txrx_peer,
  205. unsigned int tid);
  206. /**
  207. * dp_rx_defrag_waitlist_remove() - Remove fragments from waitlist
  208. * @txrx_peer: Pointer to the peer data structure
  209. * @tid: Transmit ID (TID)
  210. *
  211. * Remove fragments from waitlist
  212. *
  213. * Return: None
  214. */
  215. void dp_rx_defrag_waitlist_remove(struct dp_txrx_peer *txrx_peer,
  216. unsigned int tid);
  217. /**
  218. * dp_rx_defrag_cleanup() - Clean up activities
  219. * @txrx_peer: Pointer to the peer
  220. * @tid: Transmit Identifier
  221. *
  222. * Return: None
  223. */
  224. void dp_rx_defrag_cleanup(struct dp_txrx_peer *txrx_peer, unsigned int tid);
  225. QDF_STATUS dp_rx_defrag_add_last_frag(struct dp_soc *soc,
  226. struct dp_txrx_peer *peer, uint16_t tid,
  227. uint16_t rxseq, qdf_nbuf_t nbuf);
  228. #endif /* _DP_RX_DEFRAG_H */