ru_allocation_160_info.h 12 KB

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