u_sig_eht_tb_info.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277
  1. /* Copyright (c) 2022, Qualcomm Innovation Center, Inc. All rights reserved.
  2. *
  3. * Permission to use, copy, modify, and/or distribute this software for any
  4. * purpose with or without fee is hereby granted, provided that the above
  5. * copyright notice and this permission notice appear in all copies.
  6. *
  7. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  8. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  9. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  10. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  11. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  12. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  13. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  14. */
  15. #ifndef _U_SIG_EHT_TB_INFO_H_
  16. #define _U_SIG_EHT_TB_INFO_H_
  17. #if !defined(__ASSEMBLER__)
  18. #endif
  19. #define NUM_OF_DWORDS_U_SIG_EHT_TB_INFO 2
  20. struct u_sig_eht_tb_info {
  21. #ifndef WIFI_BIT_ORDER_BIG_ENDIAN
  22. uint32_t phy_version : 3, // [2:0]
  23. transmit_bw : 3, // [5:3]
  24. dl_ul_flag : 1, // [6:6]
  25. bss_color_id : 6, // [12:7]
  26. txop_duration : 7, // [19:13]
  27. disregard_0a : 6, // [25:20]
  28. reserved_0c : 6; // [31:26]
  29. uint32_t eht_ppdu_sig_cmn_type : 2, // [1:0]
  30. validate_1a : 1, // [2:2]
  31. spatial_reuse : 8, // [10:3]
  32. disregard_1b : 5, // [15:11]
  33. crc : 4, // [19:16]
  34. tail : 6, // [25:20]
  35. reserved_1c : 5, // [30:26]
  36. rx_integrity_check_passed : 1; // [31:31]
  37. #else
  38. uint32_t reserved_0c : 6, // [31:26]
  39. disregard_0a : 6, // [25:20]
  40. txop_duration : 7, // [19:13]
  41. bss_color_id : 6, // [12:7]
  42. dl_ul_flag : 1, // [6:6]
  43. transmit_bw : 3, // [5:3]
  44. phy_version : 3; // [2:0]
  45. uint32_t rx_integrity_check_passed : 1, // [31:31]
  46. reserved_1c : 5, // [30:26]
  47. tail : 6, // [25:20]
  48. crc : 4, // [19:16]
  49. disregard_1b : 5, // [15:11]
  50. spatial_reuse : 8, // [10:3]
  51. validate_1a : 1, // [2:2]
  52. eht_ppdu_sig_cmn_type : 2; // [1:0]
  53. #endif
  54. };
  55. /* Description PHY_VERSION
  56. <enum 0 U_SIG_VERSION_EHT>
  57. Values 1 - 7 are reserved.
  58. <legal 0>
  59. */
  60. #define U_SIG_EHT_TB_INFO_PHY_VERSION_OFFSET 0x00000000
  61. #define U_SIG_EHT_TB_INFO_PHY_VERSION_LSB 0
  62. #define U_SIG_EHT_TB_INFO_PHY_VERSION_MSB 2
  63. #define U_SIG_EHT_TB_INFO_PHY_VERSION_MASK 0x00000007
  64. /* Description TRANSMIT_BW
  65. Bandwidth of the PPDU, as indicated in the trigger frame
  66. <enum 0 U_SIG_BW20> 20 MHz
  67. <enum 1 U_SIG_BW40> 40 MHz
  68. <enum 2 U_SIG_BW80> 80 MHz
  69. <enum 3 U_SIG_BW160> 160 MHz
  70. <enum 4 U_SIG_BW320> 320 MHz channelization scheme 1
  71. <enum 5 U_SIG_BW320_2> 320 MHz channelization scheme 2
  72. On RX side, field used by MAC HW
  73. <legal all>
  74. */
  75. #define U_SIG_EHT_TB_INFO_TRANSMIT_BW_OFFSET 0x00000000
  76. #define U_SIG_EHT_TB_INFO_TRANSMIT_BW_LSB 3
  77. #define U_SIG_EHT_TB_INFO_TRANSMIT_BW_MSB 5
  78. #define U_SIG_EHT_TB_INFO_TRANSMIT_BW_MASK 0x00000038
  79. /* Description DL_UL_FLAG
  80. Differentiates between DL and UL transmission
  81. <enum 0 DL_UL_FLAG_IS_DL_OR_TDLS>
  82. <enum 1 DL_UL_FLAG_IS_UL>
  83. <legal all>
  84. */
  85. #define U_SIG_EHT_TB_INFO_DL_UL_FLAG_OFFSET 0x00000000
  86. #define U_SIG_EHT_TB_INFO_DL_UL_FLAG_LSB 6
  87. #define U_SIG_EHT_TB_INFO_DL_UL_FLAG_MSB 6
  88. #define U_SIG_EHT_TB_INFO_DL_UL_FLAG_MASK 0x00000040
  89. /* Description BSS_COLOR_ID
  90. BSS color ID
  91. Field used by MAC HW
  92. <legal all>
  93. */
  94. #define U_SIG_EHT_TB_INFO_BSS_COLOR_ID_OFFSET 0x00000000
  95. #define U_SIG_EHT_TB_INFO_BSS_COLOR_ID_LSB 7
  96. #define U_SIG_EHT_TB_INFO_BSS_COLOR_ID_MSB 12
  97. #define U_SIG_EHT_TB_INFO_BSS_COLOR_ID_MASK 0x00001f80
  98. /* Description TXOP_DURATION
  99. Indicates the remaining time in the current TXOP
  100. Field used by MAC HW
  101. <legal all>
  102. */
  103. #define U_SIG_EHT_TB_INFO_TXOP_DURATION_OFFSET 0x00000000
  104. #define U_SIG_EHT_TB_INFO_TXOP_DURATION_LSB 13
  105. #define U_SIG_EHT_TB_INFO_TXOP_DURATION_MSB 19
  106. #define U_SIG_EHT_TB_INFO_TXOP_DURATION_MASK 0x000fe000
  107. /* Description DISREGARD_0A
  108. Set to value indicated in the trigger frame
  109. <legal all>
  110. */
  111. #define U_SIG_EHT_TB_INFO_DISREGARD_0A_OFFSET 0x00000000
  112. #define U_SIG_EHT_TB_INFO_DISREGARD_0A_LSB 20
  113. #define U_SIG_EHT_TB_INFO_DISREGARD_0A_MSB 25
  114. #define U_SIG_EHT_TB_INFO_DISREGARD_0A_MASK 0x03f00000
  115. /* Description RESERVED_0C
  116. <legal 0>
  117. */
  118. #define U_SIG_EHT_TB_INFO_RESERVED_0C_OFFSET 0x00000000
  119. #define U_SIG_EHT_TB_INFO_RESERVED_0C_LSB 26
  120. #define U_SIG_EHT_TB_INFO_RESERVED_0C_MSB 31
  121. #define U_SIG_EHT_TB_INFO_RESERVED_0C_MASK 0xfc000000
  122. /* Description EHT_PPDU_SIG_CMN_TYPE
  123. <enum 3 EHT_PPDU_SIG_rsvd> DO NOT USE
  124. <enum 0 EHT_PPDU_SIG_TB_or_DL_OFDMA> Need to look at both
  125. EHT-SIG content channels for DL OFDMA (including OFDMA+MU-MIMO)
  126. <enum 2 EHT_PPDU_SIG_DL_MU_MIMO> Need to look at both EHT-SIG
  127. content channels
  128. <enum 1 EHT_PPDU_SIG_SU> Need to look at only one EHT-SIG
  129. content channel
  130. <legal all>
  131. */
  132. #define U_SIG_EHT_TB_INFO_EHT_PPDU_SIG_CMN_TYPE_OFFSET 0x00000004
  133. #define U_SIG_EHT_TB_INFO_EHT_PPDU_SIG_CMN_TYPE_LSB 0
  134. #define U_SIG_EHT_TB_INFO_EHT_PPDU_SIG_CMN_TYPE_MSB 1
  135. #define U_SIG_EHT_TB_INFO_EHT_PPDU_SIG_CMN_TYPE_MASK 0x00000003
  136. /* Description VALIDATE_1A
  137. Set to value indicated in the trigger frame
  138. <legal 1>
  139. */
  140. #define U_SIG_EHT_TB_INFO_VALIDATE_1A_OFFSET 0x00000004
  141. #define U_SIG_EHT_TB_INFO_VALIDATE_1A_LSB 2
  142. #define U_SIG_EHT_TB_INFO_VALIDATE_1A_MSB 2
  143. #define U_SIG_EHT_TB_INFO_VALIDATE_1A_MASK 0x00000004
  144. /* Description SPATIAL_REUSE
  145. TODO: Placeholder
  146. <legal all>
  147. */
  148. #define U_SIG_EHT_TB_INFO_SPATIAL_REUSE_OFFSET 0x00000004
  149. #define U_SIG_EHT_TB_INFO_SPATIAL_REUSE_LSB 3
  150. #define U_SIG_EHT_TB_INFO_SPATIAL_REUSE_MSB 10
  151. #define U_SIG_EHT_TB_INFO_SPATIAL_REUSE_MASK 0x000007f8
  152. /* Description DISREGARD_1B
  153. Set to value indicated in the trigger frame
  154. <legal all>
  155. */
  156. #define U_SIG_EHT_TB_INFO_DISREGARD_1B_OFFSET 0x00000004
  157. #define U_SIG_EHT_TB_INFO_DISREGARD_1B_LSB 11
  158. #define U_SIG_EHT_TB_INFO_DISREGARD_1B_MSB 15
  159. #define U_SIG_EHT_TB_INFO_DISREGARD_1B_MASK 0x0000f800
  160. /* Description CRC
  161. CRC for U-SIG contents
  162. <legal all>
  163. */
  164. #define U_SIG_EHT_TB_INFO_CRC_OFFSET 0x00000004
  165. #define U_SIG_EHT_TB_INFO_CRC_LSB 16
  166. #define U_SIG_EHT_TB_INFO_CRC_MSB 19
  167. #define U_SIG_EHT_TB_INFO_CRC_MASK 0x000f0000
  168. /* Description TAIL
  169. <legal 0>
  170. */
  171. #define U_SIG_EHT_TB_INFO_TAIL_OFFSET 0x00000004
  172. #define U_SIG_EHT_TB_INFO_TAIL_LSB 20
  173. #define U_SIG_EHT_TB_INFO_TAIL_MSB 25
  174. #define U_SIG_EHT_TB_INFO_TAIL_MASK 0x03f00000
  175. /* Description RESERVED_1C
  176. <legal 0>
  177. */
  178. #define U_SIG_EHT_TB_INFO_RESERVED_1C_OFFSET 0x00000004
  179. #define U_SIG_EHT_TB_INFO_RESERVED_1C_LSB 26
  180. #define U_SIG_EHT_TB_INFO_RESERVED_1C_MSB 30
  181. #define U_SIG_EHT_TB_INFO_RESERVED_1C_MASK 0x7c000000
  182. /* Description RX_INTEGRITY_CHECK_PASSED
  183. TX side: Set to 0
  184. RX side: Set to 1 if PHY determines the U-SIG CRC check
  185. has passed, else set to 0
  186. <legal all>
  187. */
  188. #define U_SIG_EHT_TB_INFO_RX_INTEGRITY_CHECK_PASSED_OFFSET 0x00000004
  189. #define U_SIG_EHT_TB_INFO_RX_INTEGRITY_CHECK_PASSED_LSB 31
  190. #define U_SIG_EHT_TB_INFO_RX_INTEGRITY_CHECK_PASSED_MSB 31
  191. #define U_SIG_EHT_TB_INFO_RX_INTEGRITY_CHECK_PASSED_MASK 0x80000000
  192. #endif // U_SIG_EHT_TB_INFO