rx_msdu_start.h 33 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135
  1. /*
  2. * Copyright (c) 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. #ifndef _RX_MSDU_START_H_
  19. #define _RX_MSDU_START_H_
  20. #if !defined(__ASSEMBLER__)
  21. #endif
  22. // ################ START SUMMARY #################
  23. //
  24. // Dword Fields
  25. // 0 rxpcu_mpdu_filter_in_category[1:0], sw_frame_group_id[8:2], reserved_0[15:9], phy_ppdu_id[31:16]
  26. // 1 msdu_length[13:0], reserved_1a[14], ipsec_esp[15], l3_offset[22:16], ipsec_ah[23], l4_offset[31:24]
  27. // 2 msdu_number[7:0], decap_format[9:8], ipv4_proto[10], ipv6_proto[11], tcp_proto[12], udp_proto[13], ip_frag[14], tcp_only_ack[15], da_is_bcast_mcast[16], toeplitz_hash_sel[18:17], ip_fixed_header_valid[19], ip_extn_header_valid[20], tcp_udp_header_valid[21], mesh_control_present[22], ldpc[23], ip4_protocol_ip6_next_header[31:24]
  28. // 3 toeplitz_hash_2_or_4[31:0]
  29. // 4 flow_id_toeplitz[31:0]
  30. // 5 user_rssi[7:0], pkt_type[11:8], stbc[12], sgi[14:13], rate_mcs[18:15], receive_bandwidth[20:19], reception_type[23:21], mimo_ss_bitmap[31:24]
  31. // 6 ppdu_start_timestamp[31:0]
  32. // 7 sw_phy_meta_data[31:0]
  33. //
  34. // ################ END SUMMARY #################
  35. #define NUM_OF_DWORDS_RX_MSDU_START 8
  36. struct rx_msdu_start {
  37. uint32_t rxpcu_mpdu_filter_in_category : 2, //[1:0]
  38. sw_frame_group_id : 7, //[8:2]
  39. reserved_0 : 7, //[15:9]
  40. phy_ppdu_id : 16; //[31:16]
  41. uint32_t msdu_length : 14, //[13:0]
  42. reserved_1a : 1, //[14]
  43. ipsec_esp : 1, //[15]
  44. l3_offset : 7, //[22:16]
  45. ipsec_ah : 1, //[23]
  46. l4_offset : 8; //[31:24]
  47. uint32_t msdu_number : 8, //[7:0]
  48. decap_format : 2, //[9:8]
  49. ipv4_proto : 1, //[10]
  50. ipv6_proto : 1, //[11]
  51. tcp_proto : 1, //[12]
  52. udp_proto : 1, //[13]
  53. ip_frag : 1, //[14]
  54. tcp_only_ack : 1, //[15]
  55. da_is_bcast_mcast : 1, //[16]
  56. toeplitz_hash_sel : 2, //[18:17]
  57. ip_fixed_header_valid : 1, //[19]
  58. ip_extn_header_valid : 1, //[20]
  59. tcp_udp_header_valid : 1, //[21]
  60. mesh_control_present : 1, //[22]
  61. ldpc : 1, //[23]
  62. ip4_protocol_ip6_next_header : 8; //[31:24]
  63. uint32_t toeplitz_hash_2_or_4 : 32; //[31:0]
  64. uint32_t flow_id_toeplitz : 32; //[31:0]
  65. uint32_t user_rssi : 8, //[7:0]
  66. pkt_type : 4, //[11:8]
  67. stbc : 1, //[12]
  68. sgi : 2, //[14:13]
  69. rate_mcs : 4, //[18:15]
  70. receive_bandwidth : 2, //[20:19]
  71. reception_type : 3, //[23:21]
  72. mimo_ss_bitmap : 8; //[31:24]
  73. uint32_t ppdu_start_timestamp : 32; //[31:0]
  74. uint32_t sw_phy_meta_data : 32; //[31:0]
  75. };
  76. /*
  77. rxpcu_mpdu_filter_in_category
  78. Field indicates what the reason was that this MPDU frame
  79. was allowed to come into the receive path by RXPCU
  80. <enum 0 rxpcu_filter_pass> This MPDU passed the normal
  81. frame filter programming of rxpcu
  82. <enum 1 rxpcu_monitor_client> This MPDU did NOT pass the
  83. regular frame filter and would have been dropped, were it
  84. not for the frame fitting into the 'monitor_client'
  85. category.
  86. <enum 2 rxpcu_monitor_other> This MPDU did NOT pass the
  87. regular frame filter and also did not pass the
  88. rxpcu_monitor_client filter. It would have been dropped
  89. accept that it did pass the 'monitor_other' category.
  90. <legal 0-2>
  91. sw_frame_group_id
  92. SW processes frames based on certain classifications.
  93. This field indicates to what sw classification this MPDU is
  94. mapped.
  95. The classification is given in priority order
  96. <enum 0 sw_frame_group_NDP_frame>
  97. <enum 1 sw_frame_group_Multicast_data>
  98. <enum 2 sw_frame_group_Unicast_data>
  99. <enum 3 sw_frame_group_Null_data > This includes mpdus
  100. of type Data Null as well as QoS Data Null
  101. <enum 4 sw_frame_group_mgmt_0000 >
  102. <enum 5 sw_frame_group_mgmt_0001 >
  103. <enum 6 sw_frame_group_mgmt_0010 >
  104. <enum 7 sw_frame_group_mgmt_0011 >
  105. <enum 8 sw_frame_group_mgmt_0100 >
  106. <enum 9 sw_frame_group_mgmt_0101 >
  107. <enum 10 sw_frame_group_mgmt_0110 >
  108. <enum 11 sw_frame_group_mgmt_0111 >
  109. <enum 12 sw_frame_group_mgmt_1000 >
  110. <enum 13 sw_frame_group_mgmt_1001 >
  111. <enum 14 sw_frame_group_mgmt_1010 >
  112. <enum 15 sw_frame_group_mgmt_1011 >
  113. <enum 16 sw_frame_group_mgmt_1100 >
  114. <enum 17 sw_frame_group_mgmt_1101 >
  115. <enum 18 sw_frame_group_mgmt_1110 >
  116. <enum 19 sw_frame_group_mgmt_1111 >
  117. <enum 20 sw_frame_group_ctrl_0000 >
  118. <enum 21 sw_frame_group_ctrl_0001 >
  119. <enum 22 sw_frame_group_ctrl_0010 >
  120. <enum 23 sw_frame_group_ctrl_0011 >
  121. <enum 24 sw_frame_group_ctrl_0100 >
  122. <enum 25 sw_frame_group_ctrl_0101 >
  123. <enum 26 sw_frame_group_ctrl_0110 >
  124. <enum 27 sw_frame_group_ctrl_0111 >
  125. <enum 28 sw_frame_group_ctrl_1000 >
  126. <enum 29 sw_frame_group_ctrl_1001 >
  127. <enum 30 sw_frame_group_ctrl_1010 >
  128. <enum 31 sw_frame_group_ctrl_1011 >
  129. <enum 32 sw_frame_group_ctrl_1100 >
  130. <enum 33 sw_frame_group_ctrl_1101 >
  131. <enum 34 sw_frame_group_ctrl_1110 >
  132. <enum 35 sw_frame_group_ctrl_1111 >
  133. <enum 36 sw_frame_group_unsupported> This covers type 3
  134. and protocol version != 0
  135. <legal 0-37>
  136. reserved_0
  137. <legal 0>
  138. phy_ppdu_id
  139. A ppdu counter value that PHY increments for every PPDU
  140. received. The counter value wraps around
  141. <legal all>
  142. msdu_length
  143. MSDU length in bytes after decapsulation.
  144. This field is still valid for MPDU frames without
  145. reserved_1a
  146. <legal 0>
  147. ipsec_esp
  148. Set if IPv4/v6 packet is using IPsec ESP
  149. l3_offset
  150. Depending upon mode bit, this field either indicates the
  151. L3 offset in bytes from the start of the RX_HEADER or the IP
  152. offset in bytes from the start of the packet after
  153. decapsulation.  The latter is only valid if ipv4_proto or
  154. ipv6_proto is set.
  155. ipsec_ah
  156. Set if IPv4/v6 packet is using IPsec AH
  157. l4_offset
  158. Depending upon mode bit, this field either indicates the
  159. L4 offset nin bytes from the start of RX_HEADER(only valid
  160. if either ipv4_proto or ipv6_proto is set to 1) or indicates
  161. the offset in bytes to the start of TCP or UDP header from
  162. the start of the IP header after decapsulation(Only valid if
  163. tcp_proto or udp_proto is set).  The value 0 indicates that
  164. the offset is longer than 127 bytes.
  165. msdu_number
  166. Indicates the MSDU number within a MPDU. This value is
  167. reset to zero at the start of each MPDU. If the number of
  168. MSDU exceeds 255 this number will wrap using modulo 256.
  169. decap_format
  170. Indicates the format after decapsulation:
  171. <enum 0 RAW> No encapsulation
  172. <enum 1 Native_WiFi>
  173. <enum 2 Ethernet> Ethernet 2 (DIX) or 802.3 (uses
  174. SNAP/LLC)
  175. <enum 3 802_3> Indicate Ethernet
  176. <legal all>
  177. ipv4_proto
  178. Set if L2 layer indicates IPv4 protocol.
  179. ipv6_proto
  180. Set if L2 layer indicates IPv6 protocol.
  181. tcp_proto
  182. Set if the ipv4_proto or ipv6_proto are set and the IP
  183. protocol indicates TCP.
  184. udp_proto
  185. Set if the ipv4_proto or ipv6_proto are set and the IP
  186. protocol indicates UDP.
  187. ip_frag
  188. Indicates that either the IP More frag bit is set or IP
  189. frag number is non-zero. If set indicates that this is a
  190. fragmented IP packet.
  191. tcp_only_ack
  192. Set if only the TCP Ack bit is set in the TCP flags and
  193. if the TCP payload is 0.
  194. da_is_bcast_mcast
  195. The destination address is broadcast or multicast.
  196. toeplitz_hash_sel
  197. Actual choosen Hash.
  198. 0 -> Toeplitz hash of 2-tuple (IP source address, IP
  199. destination address)1 -> Toeplitz hash of 4-tuple (IP source
  200. address, IP destination address, L4 (TCP/UDP) source port,
  201. L4 (TCP/UDP) destination port)
  202. 2 -> Toeplitz of flow_id
  203. 3 -> Zero is used
  204. <legal all>
  205. ip_fixed_header_valid
  206. Fixed 20-byte IPv4 header or 40-byte IPv6 header parsed
  207. fully within first 256 bytes of the packet
  208. ip_extn_header_valid
  209. IPv6/IPv6 header, including IPv4 options and
  210. recognizable extension headers parsed fully within first 256
  211. bytes of the packet
  212. tcp_udp_header_valid
  213. Fixed 20-byte TCP (excluding TCP options) or 8-byte UDP
  214. header parsed fully within first 256 bytes of the packet
  215. mesh_control_present
  216. When set, this MSDU includes the 'Mesh Control' field
  217. <legal all>
  218. ldpc
  219. When set, indicates that LDPC coding was used.
  220. <legal all>
  221. ip4_protocol_ip6_next_header
  222. For IPv4 this is the 8 bit protocol field (when
  223. ipv4_proto is set). For IPv6 this is the 8 bit next_header
  224. field (when ipv6_proto is set).
  225. toeplitz_hash_2_or_4
  226. Controlled by RxOLE register - If register bit set to 0,
  227. Toeplitz hash is computed over 2-tuple IPv4 or IPv6 src/dest
  228. addresses; otherwise, toeplitz hash is computed over 4-tuple
  229. IPv4 or IPv6 src/dest addresses and src/dest ports
  230. flow_id_toeplitz
  231. Toeplitz hash of 5-tuple
  232. {IP source address, IP destination address, IP source
  233. port, IP destination port, L4 protocol} in case of
  234. non-IPSec.
  235. In case of IPSec - Toeplitz hash of 4-tuple
  236. {IP source address, IP destination address, SPI, L4
  237. protocol}
  238. The relevant Toeplitz key registers are provided in
  239. RxOLE's instance of common parser module. These registers
  240. are separate from the Toeplitz keys used by ASE/FSE modules
  241. inside RxOLE.The actual value will be passed on from common
  242. parser module to RxOLE in one of the WHO_* TLVs.
  243. <legal all>
  244. user_rssi
  245. RSSI for this user
  246. <legal all>
  247. pkt_type
  248. Packet type:
  249. <enum 0 dot11a>802.11a PPDU type
  250. <enum 1 dot11b>802.11b PPDU type
  251. <enum 2 dot11n_mm>802.11n Mixed Mode PPDU type
  252. <enum 3 dot11ac>802.11ac PPDU type
  253. <enum 4 dot11ax>802.11ax PPDU type
  254. stbc
  255. When set, use STBC transmission rates
  256. sgi
  257. Field only valid when pkt type is HT, VHT or HE.
  258. <enum 0 0_8_us_sgi > Legacy normal GI. Can also be
  259. used for HE
  260. <enum 1 0_4_us_sgi > Legacy short GI. Can also be
  261. used for HE
  262. <enum 2 1_6_us_sgi > HE related GI
  263. <enum 3 3_2_us_sgi > HE related GI
  264. <legal 0 - 3>
  265. rate_mcs
  266. For details, refer to MCS_TYPE description
  267. Note: This is rate in case of 11a/11b
  268. <legal all>
  269. receive_bandwidth
  270. Full receive Bandwidth
  271. <enum 0 full_rx_bw_20_mhz>
  272. <enum 1 full_rx_bw_40_mhz>
  273. <enum 2 full_rx_bw_80_mhz>
  274. <enum 3 full_rx_bw_160_mhz>
  275. <legal 0-3>
  276. reception_type
  277. Indicates what type of reception this is.
  278. <enum 0 reception_type_SU > Basic SU reception (not
  279. part of OFDMA or MIMO)
  280. <enum 1 reception_type_MU_MIMO > This is related to
  281. DL type of reception
  282. <enum 2 reception_type_MU_OFDMA > This is related
  283. to DL type of reception
  284. <enum 3 reception_type_MU_OFDMA_MIMO > This is
  285. related to DL type of reception
  286. <enum 4 reception_type_UL_MU_MIMO > This is related
  287. to UL type of reception
  288. <enum 5 reception_type_UL_MU_OFDMA > This is
  289. related to UL type of reception
  290. <enum 6 reception_type_UL_MU_OFDMA_MIMO > This is
  291. related to UL type of reception
  292. <legal 0-6>
  293. mimo_ss_bitmap
  294. Field only valid when Reception_type =
  295. reception_type_MU_MIMO or reception_type_MU_OFDMA_MIMO
  296. Bitmap, with each bit indicating if the related spatial
  297. stream is used for this STA
  298. LSB related to SS 0
  299. 0: spatial stream not used for this reception
  300. 1: spatial stream used for this reception
  301. <legal all>
  302. ppdu_start_timestamp
  303. Timestamp that indicates when the PPDU that contained
  304. this MPDU started on the medium.
  305. <legal all>
  306. sw_phy_meta_data
  307. SW programmed Meta data provided by the PHY.
  308. Can be used for SW to indicate the channel the device is
  309. on.
  310. <legal all>
  311. */
  312. /* Description RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY
  313. Field indicates what the reason was that this MPDU frame
  314. was allowed to come into the receive path by RXPCU
  315. <enum 0 rxpcu_filter_pass> This MPDU passed the normal
  316. frame filter programming of rxpcu
  317. <enum 1 rxpcu_monitor_client> This MPDU did NOT pass the
  318. regular frame filter and would have been dropped, were it
  319. not for the frame fitting into the 'monitor_client'
  320. category.
  321. <enum 2 rxpcu_monitor_other> This MPDU did NOT pass the
  322. regular frame filter and also did not pass the
  323. rxpcu_monitor_client filter. It would have been dropped
  324. accept that it did pass the 'monitor_other' category.
  325. <legal 0-2>
  326. */
  327. #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_OFFSET 0x00000000
  328. #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_LSB 0
  329. #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_MASK 0x00000003
  330. /* Description RX_MSDU_START_0_SW_FRAME_GROUP_ID
  331. SW processes frames based on certain classifications.
  332. This field indicates to what sw classification this MPDU is
  333. mapped.
  334. The classification is given in priority order
  335. <enum 0 sw_frame_group_NDP_frame>
  336. <enum 1 sw_frame_group_Multicast_data>
  337. <enum 2 sw_frame_group_Unicast_data>
  338. <enum 3 sw_frame_group_Null_data > This includes mpdus
  339. of type Data Null as well as QoS Data Null
  340. <enum 4 sw_frame_group_mgmt_0000 >
  341. <enum 5 sw_frame_group_mgmt_0001 >
  342. <enum 6 sw_frame_group_mgmt_0010 >
  343. <enum 7 sw_frame_group_mgmt_0011 >
  344. <enum 8 sw_frame_group_mgmt_0100 >
  345. <enum 9 sw_frame_group_mgmt_0101 >
  346. <enum 10 sw_frame_group_mgmt_0110 >
  347. <enum 11 sw_frame_group_mgmt_0111 >
  348. <enum 12 sw_frame_group_mgmt_1000 >
  349. <enum 13 sw_frame_group_mgmt_1001 >
  350. <enum 14 sw_frame_group_mgmt_1010 >
  351. <enum 15 sw_frame_group_mgmt_1011 >
  352. <enum 16 sw_frame_group_mgmt_1100 >
  353. <enum 17 sw_frame_group_mgmt_1101 >
  354. <enum 18 sw_frame_group_mgmt_1110 >
  355. <enum 19 sw_frame_group_mgmt_1111 >
  356. <enum 20 sw_frame_group_ctrl_0000 >
  357. <enum 21 sw_frame_group_ctrl_0001 >
  358. <enum 22 sw_frame_group_ctrl_0010 >
  359. <enum 23 sw_frame_group_ctrl_0011 >
  360. <enum 24 sw_frame_group_ctrl_0100 >
  361. <enum 25 sw_frame_group_ctrl_0101 >
  362. <enum 26 sw_frame_group_ctrl_0110 >
  363. <enum 27 sw_frame_group_ctrl_0111 >
  364. <enum 28 sw_frame_group_ctrl_1000 >
  365. <enum 29 sw_frame_group_ctrl_1001 >
  366. <enum 30 sw_frame_group_ctrl_1010 >
  367. <enum 31 sw_frame_group_ctrl_1011 >
  368. <enum 32 sw_frame_group_ctrl_1100 >
  369. <enum 33 sw_frame_group_ctrl_1101 >
  370. <enum 34 sw_frame_group_ctrl_1110 >
  371. <enum 35 sw_frame_group_ctrl_1111 >
  372. <enum 36 sw_frame_group_unsupported> This covers type 3
  373. and protocol version != 0
  374. <legal 0-37>
  375. */
  376. #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_OFFSET 0x00000000
  377. #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_LSB 2
  378. #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_MASK 0x000001fc
  379. /* Description RX_MSDU_START_0_RESERVED_0
  380. <legal 0>
  381. */
  382. #define RX_MSDU_START_0_RESERVED_0_OFFSET 0x00000000
  383. #define RX_MSDU_START_0_RESERVED_0_LSB 9
  384. #define RX_MSDU_START_0_RESERVED_0_MASK 0x0000fe00
  385. /* Description RX_MSDU_START_0_PHY_PPDU_ID
  386. A ppdu counter value that PHY increments for every PPDU
  387. received. The counter value wraps around
  388. <legal all>
  389. */
  390. #define RX_MSDU_START_0_PHY_PPDU_ID_OFFSET 0x00000000
  391. #define RX_MSDU_START_0_PHY_PPDU_ID_LSB 16
  392. #define RX_MSDU_START_0_PHY_PPDU_ID_MASK 0xffff0000
  393. /* Description RX_MSDU_START_1_MSDU_LENGTH
  394. MSDU length in bytes after decapsulation.
  395. This field is still valid for MPDU frames without
  396. */
  397. #define RX_MSDU_START_1_MSDU_LENGTH_OFFSET 0x00000004
  398. #define RX_MSDU_START_1_MSDU_LENGTH_LSB 0
  399. #define RX_MSDU_START_1_MSDU_LENGTH_MASK 0x00003fff
  400. /* Description RX_MSDU_START_1_RESERVED_1A
  401. <legal 0>
  402. */
  403. #define RX_MSDU_START_1_RESERVED_1A_OFFSET 0x00000004
  404. #define RX_MSDU_START_1_RESERVED_1A_LSB 14
  405. #define RX_MSDU_START_1_RESERVED_1A_MASK 0x00004000
  406. /* Description RX_MSDU_START_1_IPSEC_ESP
  407. Set if IPv4/v6 packet is using IPsec ESP
  408. */
  409. #define RX_MSDU_START_1_IPSEC_ESP_OFFSET 0x00000004
  410. #define RX_MSDU_START_1_IPSEC_ESP_LSB 15
  411. #define RX_MSDU_START_1_IPSEC_ESP_MASK 0x00008000
  412. /* Description RX_MSDU_START_1_L3_OFFSET
  413. Depending upon mode bit, this field either indicates the
  414. L3 offset in bytes from the start of the RX_HEADER or the IP
  415. offset in bytes from the start of the packet after
  416. decapsulation.  The latter is only valid if ipv4_proto or
  417. ipv6_proto is set.
  418. */
  419. #define RX_MSDU_START_1_L3_OFFSET_OFFSET 0x00000004
  420. #define RX_MSDU_START_1_L3_OFFSET_LSB 16
  421. #define RX_MSDU_START_1_L3_OFFSET_MASK 0x007f0000
  422. /* Description RX_MSDU_START_1_IPSEC_AH
  423. Set if IPv4/v6 packet is using IPsec AH
  424. */
  425. #define RX_MSDU_START_1_IPSEC_AH_OFFSET 0x00000004
  426. #define RX_MSDU_START_1_IPSEC_AH_LSB 23
  427. #define RX_MSDU_START_1_IPSEC_AH_MASK 0x00800000
  428. /* Description RX_MSDU_START_1_L4_OFFSET
  429. Depending upon mode bit, this field either indicates the
  430. L4 offset nin bytes from the start of RX_HEADER(only valid
  431. if either ipv4_proto or ipv6_proto is set to 1) or indicates
  432. the offset in bytes to the start of TCP or UDP header from
  433. the start of the IP header after decapsulation(Only valid if
  434. tcp_proto or udp_proto is set).  The value 0 indicates that
  435. the offset is longer than 127 bytes.
  436. */
  437. #define RX_MSDU_START_1_L4_OFFSET_OFFSET 0x00000004
  438. #define RX_MSDU_START_1_L4_OFFSET_LSB 24
  439. #define RX_MSDU_START_1_L4_OFFSET_MASK 0xff000000
  440. /* Description RX_MSDU_START_2_MSDU_NUMBER
  441. Indicates the MSDU number within a MPDU. This value is
  442. reset to zero at the start of each MPDU. If the number of
  443. MSDU exceeds 255 this number will wrap using modulo 256.
  444. */
  445. #define RX_MSDU_START_2_MSDU_NUMBER_OFFSET 0x00000008
  446. #define RX_MSDU_START_2_MSDU_NUMBER_LSB 0
  447. #define RX_MSDU_START_2_MSDU_NUMBER_MASK 0x000000ff
  448. /* Description RX_MSDU_START_2_DECAP_FORMAT
  449. Indicates the format after decapsulation:
  450. <enum 0 RAW> No encapsulation
  451. <enum 1 Native_WiFi>
  452. <enum 2 Ethernet> Ethernet 2 (DIX) or 802.3 (uses
  453. SNAP/LLC)
  454. <enum 3 802_3> Indicate Ethernet
  455. <legal all>
  456. */
  457. #define RX_MSDU_START_2_DECAP_FORMAT_OFFSET 0x00000008
  458. #define RX_MSDU_START_2_DECAP_FORMAT_LSB 8
  459. #define RX_MSDU_START_2_DECAP_FORMAT_MASK 0x00000300
  460. /* Description RX_MSDU_START_2_IPV4_PROTO
  461. Set if L2 layer indicates IPv4 protocol.
  462. */
  463. #define RX_MSDU_START_2_IPV4_PROTO_OFFSET 0x00000008
  464. #define RX_MSDU_START_2_IPV4_PROTO_LSB 10
  465. #define RX_MSDU_START_2_IPV4_PROTO_MASK 0x00000400
  466. /* Description RX_MSDU_START_2_IPV6_PROTO
  467. Set if L2 layer indicates IPv6 protocol.
  468. */
  469. #define RX_MSDU_START_2_IPV6_PROTO_OFFSET 0x00000008
  470. #define RX_MSDU_START_2_IPV6_PROTO_LSB 11
  471. #define RX_MSDU_START_2_IPV6_PROTO_MASK 0x00000800
  472. /* Description RX_MSDU_START_2_TCP_PROTO
  473. Set if the ipv4_proto or ipv6_proto are set and the IP
  474. protocol indicates TCP.
  475. */
  476. #define RX_MSDU_START_2_TCP_PROTO_OFFSET 0x00000008
  477. #define RX_MSDU_START_2_TCP_PROTO_LSB 12
  478. #define RX_MSDU_START_2_TCP_PROTO_MASK 0x00001000
  479. /* Description RX_MSDU_START_2_UDP_PROTO
  480. Set if the ipv4_proto or ipv6_proto are set and the IP
  481. protocol indicates UDP.
  482. */
  483. #define RX_MSDU_START_2_UDP_PROTO_OFFSET 0x00000008
  484. #define RX_MSDU_START_2_UDP_PROTO_LSB 13
  485. #define RX_MSDU_START_2_UDP_PROTO_MASK 0x00002000
  486. /* Description RX_MSDU_START_2_IP_FRAG
  487. Indicates that either the IP More frag bit is set or IP
  488. frag number is non-zero. If set indicates that this is a
  489. fragmented IP packet.
  490. */
  491. #define RX_MSDU_START_2_IP_FRAG_OFFSET 0x00000008
  492. #define RX_MSDU_START_2_IP_FRAG_LSB 14
  493. #define RX_MSDU_START_2_IP_FRAG_MASK 0x00004000
  494. /* Description RX_MSDU_START_2_TCP_ONLY_ACK
  495. Set if only the TCP Ack bit is set in the TCP flags and
  496. if the TCP payload is 0.
  497. */
  498. #define RX_MSDU_START_2_TCP_ONLY_ACK_OFFSET 0x00000008
  499. #define RX_MSDU_START_2_TCP_ONLY_ACK_LSB 15
  500. #define RX_MSDU_START_2_TCP_ONLY_ACK_MASK 0x00008000
  501. /* Description RX_MSDU_START_2_DA_IS_BCAST_MCAST
  502. The destination address is broadcast or multicast.
  503. */
  504. #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_OFFSET 0x00000008
  505. #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_LSB 16
  506. #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_MASK 0x00010000
  507. /* Description RX_MSDU_START_2_TOEPLITZ_HASH_SEL
  508. Actual choosen Hash.
  509. 0 -> Toeplitz hash of 2-tuple (IP source address, IP
  510. destination address)1 -> Toeplitz hash of 4-tuple (IP source
  511. address, IP destination address, L4 (TCP/UDP) source port,
  512. L4 (TCP/UDP) destination port)
  513. 2 -> Toeplitz of flow_id
  514. 3 -> Zero is used
  515. <legal all>
  516. */
  517. #define RX_MSDU_START_2_TOEPLITZ_HASH_SEL_OFFSET 0x00000008
  518. #define RX_MSDU_START_2_TOEPLITZ_HASH_SEL_LSB 17
  519. #define RX_MSDU_START_2_TOEPLITZ_HASH_SEL_MASK 0x00060000
  520. /* Description RX_MSDU_START_2_IP_FIXED_HEADER_VALID
  521. Fixed 20-byte IPv4 header or 40-byte IPv6 header parsed
  522. fully within first 256 bytes of the packet
  523. */
  524. #define RX_MSDU_START_2_IP_FIXED_HEADER_VALID_OFFSET 0x00000008
  525. #define RX_MSDU_START_2_IP_FIXED_HEADER_VALID_LSB 19
  526. #define RX_MSDU_START_2_IP_FIXED_HEADER_VALID_MASK 0x00080000
  527. /* Description RX_MSDU_START_2_IP_EXTN_HEADER_VALID
  528. IPv6/IPv6 header, including IPv4 options and
  529. recognizable extension headers parsed fully within first 256
  530. bytes of the packet
  531. */
  532. #define RX_MSDU_START_2_IP_EXTN_HEADER_VALID_OFFSET 0x00000008
  533. #define RX_MSDU_START_2_IP_EXTN_HEADER_VALID_LSB 20
  534. #define RX_MSDU_START_2_IP_EXTN_HEADER_VALID_MASK 0x00100000
  535. /* Description RX_MSDU_START_2_TCP_UDP_HEADER_VALID
  536. Fixed 20-byte TCP (excluding TCP options) or 8-byte UDP
  537. header parsed fully within first 256 bytes of the packet
  538. */
  539. #define RX_MSDU_START_2_TCP_UDP_HEADER_VALID_OFFSET 0x00000008
  540. #define RX_MSDU_START_2_TCP_UDP_HEADER_VALID_LSB 21
  541. #define RX_MSDU_START_2_TCP_UDP_HEADER_VALID_MASK 0x00200000
  542. /* Description RX_MSDU_START_2_MESH_CONTROL_PRESENT
  543. When set, this MSDU includes the 'Mesh Control' field
  544. <legal all>
  545. */
  546. #define RX_MSDU_START_2_MESH_CONTROL_PRESENT_OFFSET 0x00000008
  547. #define RX_MSDU_START_2_MESH_CONTROL_PRESENT_LSB 22
  548. #define RX_MSDU_START_2_MESH_CONTROL_PRESENT_MASK 0x00400000
  549. /* Description RX_MSDU_START_2_LDPC
  550. When set, indicates that LDPC coding was used.
  551. <legal all>
  552. */
  553. #define RX_MSDU_START_2_LDPC_OFFSET 0x00000008
  554. #define RX_MSDU_START_2_LDPC_LSB 23
  555. #define RX_MSDU_START_2_LDPC_MASK 0x00800000
  556. /* Description RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER
  557. For IPv4 this is the 8 bit protocol field (when
  558. ipv4_proto is set). For IPv6 this is the 8 bit next_header
  559. field (when ipv6_proto is set).
  560. */
  561. #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_OFFSET 0x00000008
  562. #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_LSB 24
  563. #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_MASK 0xff000000
  564. /* Description RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4
  565. Controlled by RxOLE register - If register bit set to 0,
  566. Toeplitz hash is computed over 2-tuple IPv4 or IPv6 src/dest
  567. addresses; otherwise, toeplitz hash is computed over 4-tuple
  568. IPv4 or IPv6 src/dest addresses and src/dest ports
  569. */
  570. #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_OFFSET 0x0000000c
  571. #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_LSB 0
  572. #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_MASK 0xffffffff
  573. /* Description RX_MSDU_START_4_FLOW_ID_TOEPLITZ
  574. Toeplitz hash of 5-tuple
  575. {IP source address, IP destination address, IP source
  576. port, IP destination port, L4 protocol} in case of
  577. non-IPSec.
  578. In case of IPSec - Toeplitz hash of 4-tuple
  579. {IP source address, IP destination address, SPI, L4
  580. protocol}
  581. The relevant Toeplitz key registers are provided in
  582. RxOLE's instance of common parser module. These registers
  583. are separate from the Toeplitz keys used by ASE/FSE modules
  584. inside RxOLE.The actual value will be passed on from common
  585. parser module to RxOLE in one of the WHO_* TLVs.
  586. <legal all>
  587. */
  588. #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_OFFSET 0x00000010
  589. #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_LSB 0
  590. #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_MASK 0xffffffff
  591. /* Description RX_MSDU_START_5_USER_RSSI
  592. RSSI for this user
  593. <legal all>
  594. */
  595. #define RX_MSDU_START_5_USER_RSSI_OFFSET 0x00000014
  596. #define RX_MSDU_START_5_USER_RSSI_LSB 0
  597. #define RX_MSDU_START_5_USER_RSSI_MASK 0x000000ff
  598. /* Description RX_MSDU_START_5_PKT_TYPE
  599. Packet type:
  600. <enum 0 dot11a>802.11a PPDU type
  601. <enum 1 dot11b>802.11b PPDU type
  602. <enum 2 dot11n_mm>802.11n Mixed Mode PPDU type
  603. <enum 3 dot11ac>802.11ac PPDU type
  604. <enum 4 dot11ax>802.11ax PPDU type
  605. */
  606. #define RX_MSDU_START_5_PKT_TYPE_OFFSET 0x00000014
  607. #define RX_MSDU_START_5_PKT_TYPE_LSB 8
  608. #define RX_MSDU_START_5_PKT_TYPE_MASK 0x00000f00
  609. /* Description RX_MSDU_START_5_STBC
  610. When set, use STBC transmission rates
  611. */
  612. #define RX_MSDU_START_5_STBC_OFFSET 0x00000014
  613. #define RX_MSDU_START_5_STBC_LSB 12
  614. #define RX_MSDU_START_5_STBC_MASK 0x00001000
  615. /* Description RX_MSDU_START_5_SGI
  616. Field only valid when pkt type is HT, VHT or HE.
  617. <enum 0 0_8_us_sgi > Legacy normal GI. Can also be
  618. used for HE
  619. <enum 1 0_4_us_sgi > Legacy short GI. Can also be
  620. used for HE
  621. <enum 2 1_6_us_sgi > HE related GI
  622. <enum 3 3_2_us_sgi > HE related GI
  623. <legal 0 - 3>
  624. */
  625. #define RX_MSDU_START_5_SGI_OFFSET 0x00000014
  626. #define RX_MSDU_START_5_SGI_LSB 13
  627. #define RX_MSDU_START_5_SGI_MASK 0x00006000
  628. /* Description RX_MSDU_START_5_RATE_MCS
  629. For details, refer to MCS_TYPE description
  630. Note: This is rate in case of 11a/11b
  631. <legal all>
  632. */
  633. #define RX_MSDU_START_5_RATE_MCS_OFFSET 0x00000014
  634. #define RX_MSDU_START_5_RATE_MCS_LSB 15
  635. #define RX_MSDU_START_5_RATE_MCS_MASK 0x00078000
  636. /* Description RX_MSDU_START_5_RECEIVE_BANDWIDTH
  637. Full receive Bandwidth
  638. <enum 0 full_rx_bw_20_mhz>
  639. <enum 1 full_rx_bw_40_mhz>
  640. <enum 2 full_rx_bw_80_mhz>
  641. <enum 3 full_rx_bw_160_mhz>
  642. <legal 0-3>
  643. */
  644. #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_OFFSET 0x00000014
  645. #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_LSB 19
  646. #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_MASK 0x00180000
  647. /* Description RX_MSDU_START_5_RECEPTION_TYPE
  648. Indicates what type of reception this is.
  649. <enum 0 reception_type_SU > Basic SU reception (not
  650. part of OFDMA or MIMO)
  651. <enum 1 reception_type_MU_MIMO > This is related to
  652. DL type of reception
  653. <enum 2 reception_type_MU_OFDMA > This is related
  654. to DL type of reception
  655. <enum 3 reception_type_MU_OFDMA_MIMO > This is
  656. related to DL type of reception
  657. <enum 4 reception_type_UL_MU_MIMO > This is related
  658. to UL type of reception
  659. <enum 5 reception_type_UL_MU_OFDMA > This is
  660. related to UL type of reception
  661. <enum 6 reception_type_UL_MU_OFDMA_MIMO > This is
  662. related to UL type of reception
  663. <legal 0-6>
  664. */
  665. #define RX_MSDU_START_5_RECEPTION_TYPE_OFFSET 0x00000014
  666. #define RX_MSDU_START_5_RECEPTION_TYPE_LSB 21
  667. #define RX_MSDU_START_5_RECEPTION_TYPE_MASK 0x00e00000
  668. /* Description RX_MSDU_START_5_MIMO_SS_BITMAP
  669. Field only valid when Reception_type =
  670. reception_type_MU_MIMO or reception_type_MU_OFDMA_MIMO
  671. Bitmap, with each bit indicating if the related spatial
  672. stream is used for this STA
  673. LSB related to SS 0
  674. 0: spatial stream not used for this reception
  675. 1: spatial stream used for this reception
  676. <legal all>
  677. */
  678. #define RX_MSDU_START_5_MIMO_SS_BITMAP_OFFSET 0x00000014
  679. #define RX_MSDU_START_5_MIMO_SS_BITMAP_LSB 24
  680. #define RX_MSDU_START_5_MIMO_SS_BITMAP_MASK 0xff000000
  681. /* Description RX_MSDU_START_6_PPDU_START_TIMESTAMP
  682. Timestamp that indicates when the PPDU that contained
  683. this MPDU started on the medium.
  684. <legal all>
  685. */
  686. #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_OFFSET 0x00000018
  687. #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_LSB 0
  688. #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_MASK 0xffffffff
  689. /* Description RX_MSDU_START_7_SW_PHY_META_DATA
  690. SW programmed Meta data provided by the PHY.
  691. Can be used for SW to indicate the channel the device is
  692. on.
  693. <legal all>
  694. */
  695. #define RX_MSDU_START_7_SW_PHY_META_DATA_OFFSET 0x0000001c
  696. #define RX_MSDU_START_7_SW_PHY_META_DATA_LSB 0
  697. #define RX_MSDU_START_7_SW_PHY_META_DATA_MASK 0xffffffff
  698. #endif // _RX_MSDU_START_H_