ru_allocation_160_info.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303
  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 _RU_ALLOCATION_160_INFO_H_
  16. #define _RU_ALLOCATION_160_INFO_H_
  17. #if !defined(__ASSEMBLER__)
  18. #endif
  19. #define NUM_OF_DWORDS_RU_ALLOCATION_160_INFO 4
  20. struct ru_allocation_160_info {
  21. #ifndef WIFI_BIT_ORDER_BIG_ENDIAN
  22. uint32_t ru_allocation_band0_0 : 9, // [8:0]
  23. ru_allocation_band0_1 : 9, // [17:9]
  24. reserved_0a : 6, // [23:18]
  25. ru_allocations_01_subband80_mask : 4, // [27:24]
  26. ru_allocations_23_subband80_mask : 4; // [31:28]
  27. uint32_t ru_allocation_band0_2 : 9, // [8:0]
  28. ru_allocation_band0_3 : 9, // [17:9]
  29. reserved_1a : 14; // [31:18]
  30. uint32_t ru_allocation_band1_0 : 9, // [8:0]
  31. ru_allocation_band1_1 : 9, // [17:9]
  32. reserved_2a : 14; // [31:18]
  33. uint32_t ru_allocation_band1_2 : 9, // [8:0]
  34. ru_allocation_band1_3 : 9, // [17:9]
  35. reserved_3a : 14; // [31:18]
  36. #else
  37. uint32_t ru_allocations_23_subband80_mask : 4, // [31:28]
  38. ru_allocations_01_subband80_mask : 4, // [27:24]
  39. reserved_0a : 6, // [23:18]
  40. ru_allocation_band0_1 : 9, // [17:9]
  41. ru_allocation_band0_0 : 9; // [8:0]
  42. uint32_t reserved_1a : 14, // [31:18]
  43. ru_allocation_band0_3 : 9, // [17:9]
  44. ru_allocation_band0_2 : 9; // [8:0]
  45. uint32_t reserved_2a : 14, // [31:18]
  46. ru_allocation_band1_1 : 9, // [17:9]
  47. ru_allocation_band1_0 : 9; // [8:0]
  48. uint32_t reserved_3a : 14, // [31:18]
  49. ru_allocation_band1_3 : 9, // [17:9]
  50. ru_allocation_band1_2 : 9; // [8:0]
  51. #endif
  52. };
  53. /* Description RU_ALLOCATION_BAND0_0
  54. Field not used for MIMO
  55. Indicates RU arrangement in frequency domain. RU allocated
  56. for MU-MIMO, and number of users in the MU-MIMO.
  57. 0 - valid for HE_20/HE_40/HE_80/HE_160/ EHT_20/EHT_40/EHT_80/EHT_160/
  58. EHT_240/EHT_320
  59. 1 - valid for HE_80/HE_160 (80+80)/ EHT_80/EHT_160/EHT_240/EHT_320
  60. 2 - valid for HE_160 (80+80)/ EHT_160/EHT_240/EHT_320
  61. 3 - valid for HE_160 (80+80)/ EHT_160/EHT_240/EHT_320
  62. The four bands are for HE_SIGB0 & B1 respectively or for
  63. EHT_SIG0, EHT_SIG1, EHT_SIG2 & EHT_SIG3 respectively.
  64. valid for HE_20/HE_40/HE_80/HE_160/ EHT_20/EHT_40/EHT_80/EHT_160/
  65. EHT_240/EHT_320 packets and denotes RU-map of the first
  66. 20MHz band of HE_SIGB0 or EHT_SIG0
  67. <legal all>
  68. */
  69. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_0_OFFSET 0x00000000
  70. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_0_LSB 0
  71. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_0_MSB 8
  72. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_0_MASK 0x000001ff
  73. /* Description RU_ALLOCATION_BAND0_1
  74. Field not used for MIMO
  75. See description of ru_allocation_band0_0
  76. valid for HE_80/HE_160/ EHT_80/EHT_160/EHT_240/EHT_320 packets
  77. and denotes RU-map of the second 20MHz band of HE_SIGB0
  78. or EHT_SIG0
  79. */
  80. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_1_OFFSET 0x00000000
  81. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_1_LSB 9
  82. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_1_MSB 17
  83. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_1_MASK 0x0003fe00
  84. /* Description RESERVED_0A
  85. <legal 0>
  86. */
  87. #define RU_ALLOCATION_160_INFO_RESERVED_0A_OFFSET 0x00000000
  88. #define RU_ALLOCATION_160_INFO_RESERVED_0A_LSB 18
  89. #define RU_ALLOCATION_160_INFO_RESERVED_0A_MSB 23
  90. #define RU_ALLOCATION_160_INFO_RESERVED_0A_MASK 0x00fc0000
  91. /* Description RU_ALLOCATIONS_01_SUBBAND80_MASK
  92. Field not used for HE
  93. Indicates what 80 MHz subbands 'ru_allocation_band{0, 1}_{0,
  94. 1}' are valid for
  95. Bit 0: lowest 80 MHz
  96. Bit 1: 2nd lowest 80 MHz
  97. Bit 2: 2nd highest 80 MHz
  98. Bit 3: highest 80 MHz
  99. In other 80 MHz subbands PHY microcode should override these
  100. with 'zero-user RU996.'
  101. <legal all>
  102. */
  103. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_01_SUBBAND80_MASK_OFFSET 0x00000000
  104. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_01_SUBBAND80_MASK_LSB 24
  105. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_01_SUBBAND80_MASK_MSB 27
  106. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_01_SUBBAND80_MASK_MASK 0x0f000000
  107. /* Description RU_ALLOCATIONS_23_SUBBAND80_MASK
  108. Field not used for HE
  109. Indicates what 80 MHz subbands 'ru_allocation_band{0, 1}_{2,
  110. 3}' are valid for
  111. Bit 0: lowest 80 MHz
  112. Bit 1: 2nd lowest 80 MHz
  113. Bit 2: 2nd highest 80 MHz
  114. Bit 3: highest 80 MHz
  115. In other 80 MHz subbands PHY microcode should override these
  116. with 'zero-user RU996.'
  117. <legal all>
  118. */
  119. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_23_SUBBAND80_MASK_OFFSET 0x00000000
  120. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_23_SUBBAND80_MASK_LSB 28
  121. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_23_SUBBAND80_MASK_MSB 31
  122. #define RU_ALLOCATION_160_INFO_RU_ALLOCATIONS_23_SUBBAND80_MASK_MASK 0xf0000000
  123. /* Description RU_ALLOCATION_BAND0_2
  124. Field not used for MIMO
  125. See description of ru_allocation_band0_0
  126. valid for HE_160/ EHT_160/EHT_240/EHT_320 packets and denotes
  127. RU-map of the third 20MHz band of HE_SIGB0 or EHT_SIG0
  128. */
  129. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_2_OFFSET 0x00000004
  130. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_2_LSB 0
  131. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_2_MSB 8
  132. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_2_MASK 0x000001ff
  133. /* Description RU_ALLOCATION_BAND0_3
  134. Field not used for MIMO
  135. See description of ru_allocation_band0_0
  136. valid for HE_160/ EHT_160/EHT_240/EHT_320 packets and denotes
  137. RU-map of the fourth 20MHz band of HE_SIGB0 or EHT_SIG0
  138. */
  139. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_3_OFFSET 0x00000004
  140. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_3_LSB 9
  141. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_3_MSB 17
  142. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND0_3_MASK 0x0003fe00
  143. /* Description RESERVED_1A
  144. <legal 0>
  145. */
  146. #define RU_ALLOCATION_160_INFO_RESERVED_1A_OFFSET 0x00000004
  147. #define RU_ALLOCATION_160_INFO_RESERVED_1A_LSB 18
  148. #define RU_ALLOCATION_160_INFO_RESERVED_1A_MSB 31
  149. #define RU_ALLOCATION_160_INFO_RESERVED_1A_MASK 0xfffc0000
  150. /* Description RU_ALLOCATION_BAND1_0
  151. Field not used for MIMO
  152. See description of ru_allocation_band0_0
  153. valid for HE_40/HE_80/HE_160/ EHT_40/EHT_80/EHT_160/ EHT_240/EHT_320
  154. packets and denotes RU-map of the first 20MHz band of HE_SIGB1
  155. or EHT_SIG1
  156. */
  157. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_0_OFFSET 0x00000008
  158. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_0_LSB 0
  159. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_0_MSB 8
  160. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_0_MASK 0x000001ff
  161. /* Description RU_ALLOCATION_BAND1_1
  162. Field not used for MIMO
  163. See description of ru_allocation_band0_0
  164. valid for HE_80/HE_160/ EHT_80/EHT_160/EHT_240/EHT_320 packets
  165. and denotes RU-map of the second 20MHz band of HE_SIGB1
  166. or EHT_SIG1
  167. */
  168. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_1_OFFSET 0x00000008
  169. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_1_LSB 9
  170. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_1_MSB 17
  171. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_1_MASK 0x0003fe00
  172. /* Description RESERVED_2A
  173. <legal 0>
  174. */
  175. #define RU_ALLOCATION_160_INFO_RESERVED_2A_OFFSET 0x00000008
  176. #define RU_ALLOCATION_160_INFO_RESERVED_2A_LSB 18
  177. #define RU_ALLOCATION_160_INFO_RESERVED_2A_MSB 31
  178. #define RU_ALLOCATION_160_INFO_RESERVED_2A_MASK 0xfffc0000
  179. /* Description RU_ALLOCATION_BAND1_2
  180. Field not used for MIMO
  181. See description of ru_allocation_band0_0
  182. valid for HE_160/ EHT_160/EHT_240/EHT_320 packets and denotes
  183. RU-map of the third 20MHz band of HE_SIGB1 or EHT_SIG1
  184. */
  185. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_2_OFFSET 0x0000000c
  186. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_2_LSB 0
  187. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_2_MSB 8
  188. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_2_MASK 0x000001ff
  189. /* Description RU_ALLOCATION_BAND1_3
  190. Field not used for MIMO
  191. See description of ru_allocation_band0_0
  192. valid for HE_160/ EHT_160/EHT_240/EHT_320 packets and denotes
  193. RU-map of the fourth 20MHz band of HE_SIGB1 or EHT_SIG1
  194. */
  195. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_3_OFFSET 0x0000000c
  196. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_3_LSB 9
  197. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_3_MSB 17
  198. #define RU_ALLOCATION_160_INFO_RU_ALLOCATION_BAND1_3_MASK 0x0003fe00
  199. /* Description RESERVED_3A
  200. <legal 0>
  201. */
  202. #define RU_ALLOCATION_160_INFO_RESERVED_3A_OFFSET 0x0000000c
  203. #define RU_ALLOCATION_160_INFO_RESERVED_3A_LSB 18
  204. #define RU_ALLOCATION_160_INFO_RESERVED_3A_MSB 31
  205. #define RU_ALLOCATION_160_INFO_RESERVED_3A_MASK 0xfffc0000
  206. #endif // RU_ALLOCATION_160_INFO