tx_rate_stats_info.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268
  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 _TX_RATE_STATS_INFO_H_
  16. #define _TX_RATE_STATS_INFO_H_
  17. #if !defined(__ASSEMBLER__)
  18. #endif
  19. #define NUM_OF_DWORDS_TX_RATE_STATS_INFO 2
  20. struct tx_rate_stats_info {
  21. #ifndef WIFI_BIT_ORDER_BIG_ENDIAN
  22. uint32_t tx_rate_stats_info_valid : 1, // [0:0]
  23. transmit_bw : 3, // [3:1]
  24. transmit_pkt_type : 4, // [7:4]
  25. transmit_stbc : 1, // [8:8]
  26. transmit_ldpc : 1, // [9:9]
  27. transmit_sgi : 2, // [11:10]
  28. transmit_mcs : 4, // [15:12]
  29. ofdma_transmission : 1, // [16:16]
  30. tones_in_ru : 12, // [28:17]
  31. reserved_0a : 3; // [31:29]
  32. uint32_t ppdu_transmission_tsf : 32; // [31:0]
  33. #else
  34. uint32_t reserved_0a : 3, // [31:29]
  35. tones_in_ru : 12, // [28:17]
  36. ofdma_transmission : 1, // [16:16]
  37. transmit_mcs : 4, // [15:12]
  38. transmit_sgi : 2, // [11:10]
  39. transmit_ldpc : 1, // [9:9]
  40. transmit_stbc : 1, // [8:8]
  41. transmit_pkt_type : 4, // [7:4]
  42. transmit_bw : 3, // [3:1]
  43. tx_rate_stats_info_valid : 1; // [0:0]
  44. uint32_t ppdu_transmission_tsf : 32; // [31:0]
  45. #endif
  46. };
  47. /* Description TX_RATE_STATS_INFO_VALID
  48. When set all other fields in this STRUCT contain valid info.
  49. When clear, none of the other fields contain valid info.
  50. <legal all>
  51. */
  52. #define TX_RATE_STATS_INFO_TX_RATE_STATS_INFO_VALID_OFFSET 0x00000000
  53. #define TX_RATE_STATS_INFO_TX_RATE_STATS_INFO_VALID_LSB 0
  54. #define TX_RATE_STATS_INFO_TX_RATE_STATS_INFO_VALID_MSB 0
  55. #define TX_RATE_STATS_INFO_TX_RATE_STATS_INFO_VALID_MASK 0x00000001
  56. /* Description TRANSMIT_BW
  57. Field only valid when Tx_rate_stats_info_valid is set
  58. Indicates the BW of the upcoming transmission that shall
  59. likely start in about 3 -4 us on the medium
  60. <enum 0 20_mhz>20 Mhz BW
  61. <enum 1 40_mhz>40 Mhz BW
  62. <enum 2 80_mhz>80 Mhz BW
  63. <enum 3 160_mhz>160 Mhz BW
  64. <enum 4 320_mhz>320 Mhz BW
  65. <enum 5 240_mhz>240 Mhz BW
  66. */
  67. #define TX_RATE_STATS_INFO_TRANSMIT_BW_OFFSET 0x00000000
  68. #define TX_RATE_STATS_INFO_TRANSMIT_BW_LSB 1
  69. #define TX_RATE_STATS_INFO_TRANSMIT_BW_MSB 3
  70. #define TX_RATE_STATS_INFO_TRANSMIT_BW_MASK 0x0000000e
  71. /* Description TRANSMIT_PKT_TYPE
  72. Field only valid when Tx_rate_stats_info_valid is set
  73. Field filled in by PDG.
  74. Not valid when in SW transmit mode
  75. The packet type
  76. <enum 0 dot11a>802.11a PPDU type
  77. <enum 1 dot11b>802.11b PPDU type
  78. <enum 2 dot11n_mm>802.11n Mixed Mode PPDU type
  79. <enum 3 dot11ac>802.11ac PPDU type
  80. <enum 4 dot11ax>802.11ax PPDU type
  81. <enum 5 dot11ba>802.11ba (WUR) PPDU type
  82. <enum 6 dot11be>802.11be PPDU type
  83. <enum 7 dot11az>802.11az (ranging) PPDU type
  84. <enum 8 dot11n_gf>802.11n Green Field PPDU type (unsupported
  85. & aborted)
  86. */
  87. #define TX_RATE_STATS_INFO_TRANSMIT_PKT_TYPE_OFFSET 0x00000000
  88. #define TX_RATE_STATS_INFO_TRANSMIT_PKT_TYPE_LSB 4
  89. #define TX_RATE_STATS_INFO_TRANSMIT_PKT_TYPE_MSB 7
  90. #define TX_RATE_STATS_INFO_TRANSMIT_PKT_TYPE_MASK 0x000000f0
  91. /* Description TRANSMIT_STBC
  92. Field only valid when Tx_rate_stats_info_valid is set
  93. Field filled in by PDG.
  94. Not valid when in SW transmit mode
  95. When set, STBC transmission rate was used.
  96. */
  97. #define TX_RATE_STATS_INFO_TRANSMIT_STBC_OFFSET 0x00000000
  98. #define TX_RATE_STATS_INFO_TRANSMIT_STBC_LSB 8
  99. #define TX_RATE_STATS_INFO_TRANSMIT_STBC_MSB 8
  100. #define TX_RATE_STATS_INFO_TRANSMIT_STBC_MASK 0x00000100
  101. /* Description TRANSMIT_LDPC
  102. Field only valid when Tx_rate_stats_info_valid is set
  103. Field filled in by PDG.
  104. Not valid when in SW transmit mode
  105. When set, use LDPC transmission rates
  106. */
  107. #define TX_RATE_STATS_INFO_TRANSMIT_LDPC_OFFSET 0x00000000
  108. #define TX_RATE_STATS_INFO_TRANSMIT_LDPC_LSB 9
  109. #define TX_RATE_STATS_INFO_TRANSMIT_LDPC_MSB 9
  110. #define TX_RATE_STATS_INFO_TRANSMIT_LDPC_MASK 0x00000200
  111. /* Description TRANSMIT_SGI
  112. Field only valid when Tx_rate_stats_info_valid is set
  113. Field filled in by PDG.
  114. Not valid when in SW transmit mode
  115. Specify the right GI for HE-Ranging NDPs (11az)/Short NDP.
  116. <enum 0 0_8_us_sgi > Legacy normal GI. Can also be used
  117. for HE
  118. <enum 1 0_4_us_sgi > Legacy short GI. Can also be used
  119. for HE
  120. <enum 2 1_6_us_sgi > HE related GI
  121. <enum 3 3_2_us_sgi > HE related GI
  122. <legal 0 - 3>
  123. */
  124. #define TX_RATE_STATS_INFO_TRANSMIT_SGI_OFFSET 0x00000000
  125. #define TX_RATE_STATS_INFO_TRANSMIT_SGI_LSB 10
  126. #define TX_RATE_STATS_INFO_TRANSMIT_SGI_MSB 11
  127. #define TX_RATE_STATS_INFO_TRANSMIT_SGI_MASK 0x00000c00
  128. /* Description TRANSMIT_MCS
  129. Field only valid when Tx_rate_stats_info_valid is set
  130. Field filled in by PDG.
  131. Not valid when in SW transmit mode
  132. For details, refer to MCS_TYPE description
  133. <legal all>
  134. */
  135. #define TX_RATE_STATS_INFO_TRANSMIT_MCS_OFFSET 0x00000000
  136. #define TX_RATE_STATS_INFO_TRANSMIT_MCS_LSB 12
  137. #define TX_RATE_STATS_INFO_TRANSMIT_MCS_MSB 15
  138. #define TX_RATE_STATS_INFO_TRANSMIT_MCS_MASK 0x0000f000
  139. /* Description OFDMA_TRANSMISSION
  140. Field only valid when Tx_rate_stats_info_valid is set
  141. Field filled in by PDG.
  142. Set when the transmission was an OFDMA transmission (DL
  143. or UL).
  144. <legal all>
  145. */
  146. #define TX_RATE_STATS_INFO_OFDMA_TRANSMISSION_OFFSET 0x00000000
  147. #define TX_RATE_STATS_INFO_OFDMA_TRANSMISSION_LSB 16
  148. #define TX_RATE_STATS_INFO_OFDMA_TRANSMISSION_MSB 16
  149. #define TX_RATE_STATS_INFO_OFDMA_TRANSMISSION_MASK 0x00010000
  150. /* Description TONES_IN_RU
  151. Field only valid when Tx_rate_stats_info_valid is set
  152. Field filled in by PDG.
  153. Not valid when in SW transmit mode
  154. The number of tones in the RU used.
  155. <legal all>
  156. */
  157. #define TX_RATE_STATS_INFO_TONES_IN_RU_OFFSET 0x00000000
  158. #define TX_RATE_STATS_INFO_TONES_IN_RU_LSB 17
  159. #define TX_RATE_STATS_INFO_TONES_IN_RU_MSB 28
  160. #define TX_RATE_STATS_INFO_TONES_IN_RU_MASK 0x1ffe0000
  161. /* Description RESERVED_0A
  162. <legal 0>
  163. */
  164. #define TX_RATE_STATS_INFO_RESERVED_0A_OFFSET 0x00000000
  165. #define TX_RATE_STATS_INFO_RESERVED_0A_LSB 29
  166. #define TX_RATE_STATS_INFO_RESERVED_0A_MSB 31
  167. #define TX_RATE_STATS_INFO_RESERVED_0A_MASK 0xe0000000
  168. /* Description PPDU_TRANSMISSION_TSF
  169. Field only valid when Tx_rate_stats_info_valid is set
  170. Based on a HWSCH configuration register setting, this field
  171. either contains:
  172. Lower 32 bits of the TSF, snapshot of this value when transmission
  173. of the PPDU containing the frame finished.
  174. OR
  175. Lower 32 bits of the TSF, snapshot of this value when transmission
  176. of the PPDU containing the frame started
  177. <legal all>
  178. */
  179. #define TX_RATE_STATS_INFO_PPDU_TRANSMISSION_TSF_OFFSET 0x00000004
  180. #define TX_RATE_STATS_INFO_PPDU_TRANSMISSION_TSF_LSB 0
  181. #define TX_RATE_STATS_INFO_PPDU_TRANSMISSION_TSF_MSB 31
  182. #define TX_RATE_STATS_INFO_PPDU_TRANSMISSION_TSF_MASK 0xffffffff
  183. #endif // TX_RATE_STATS_INFO