dp_rate_stats.h 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  1. /*
  2. * Copyright (c) 2019-2020 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. /**
  19. * @file: dp_rate_stats.h
  20. * @brief: Define peer rate statistics related objects and APIs
  21. */
  22. #ifndef _DP_RATE_STATS_
  23. #define _DP_RATE_STATS_
  24. #include <cdp_txrx_handle.h>
  25. #include <qdf_nbuf.h>
  26. #include <wdi_event_api.h>
  27. #ifdef QCA_SUPPORT_RDK_STATS
  28. #include <qdf_util.h>
  29. #include <cdp_txrx_cmn_struct.h>
  30. #include <cdp_txrx_cmn.h>
  31. #include <dp_ratetable.h>
  32. #include <dp_rate_stats_pub.h>
  33. #define RATE_STATS_LOCK_CREATE(lock) qdf_spinlock_create(lock)
  34. #define RATE_STATS_LOCK_DESTROY(lock) qdf_spinlock_destroy(lock)
  35. #define RATE_STATS_LOCK_ACQUIRE(lock) qdf_spin_lock_bh(lock)
  36. #define RATE_STATS_LOCK_RELEASE(lock) qdf_spin_unlock_bh(lock)
  37. struct cdp_pdev;
  38. /**
  39. * enum dp_ppdu_type - enum for ppdu_type
  40. * @DP_PPDU_TYPE_SU: single user PPDU
  41. * @DP_PPDU_TYPE_MU_MIMO: multi user mimo ppdu
  42. * @DP_PPDU_TYPE_MU_OFDMA: multi user ofdma ppdu
  43. * @DP_PPDU_TYPE_MU_OFDMA_MIMO: multi user mimo/ofdma ppdu
  44. */
  45. enum dp_ppdu_type {
  46. DP_PPDU_TYPE_SU,
  47. DP_PPDU_TYPE_MU_MIMO,
  48. DP_PPDU_TYPE_MU_OFDMA,
  49. DP_PPDU_TYPE_MU_OFDMA_MIMO,
  50. };
  51. /**
  52. * struct wlan_peer_tx_rate_stats - peer tx rate statistics
  53. * @stats: array containing tx rate stats
  54. * @cur_rix: rate index updated last in list
  55. * @lock: lock protecting list
  56. * @sojourn: sojourn statistics
  57. */
  58. struct wlan_peer_tx_rate_stats {
  59. struct wlan_tx_rate_stats stats[WLANSTATS_CACHE_SIZE];
  60. struct wlan_tx_sojourn_stats sojourn;
  61. uint32_t cur_rix;
  62. uint8_t cur_cache_idx;
  63. qdf_spinlock_t lock;
  64. };
  65. /**
  66. * struct wlan_peer_rx_rate_stats - Peer Rx rate statistics
  67. * @stats: array containing rx rate stats
  68. * @cur_rix: rate index updated last in list
  69. * @lock: lock protecting list
  70. */
  71. struct wlan_peer_rx_rate_stats {
  72. struct wlan_rx_rate_stats stats[WLANSTATS_CACHE_SIZE];
  73. uint32_t cur_rix;
  74. uint32_t cur_cache_idx;
  75. qdf_spinlock_t lock;
  76. };
  77. /**
  78. * struct wlan_peer_rx_link_stats - Peer Rx Link statistics
  79. * @stats: array containing rx rate stats
  80. * @lock: lock protecting list
  81. */
  82. struct wlan_peer_rx_link_stats {
  83. struct wlan_rx_link_stats stats;
  84. qdf_spinlock_t lock;
  85. };
  86. /**
  87. * struct wlan_peer_tx_link_stats - Peer Tx Link statistics
  88. * @stats: array containing rx rate stats
  89. * @lock: lock protecting list
  90. */
  91. struct wlan_peer_tx_link_stats {
  92. struct wlan_tx_link_stats stats;
  93. qdf_spinlock_t lock;
  94. };
  95. /**
  96. * struct wlan_peer_rate_stats - Rate statistics
  97. * @tx: tx rate statistics
  98. * @rx: rx rate statistics
  99. */
  100. struct wlan_peer_rate_stats {
  101. struct wlan_peer_tx_rate_stats tx;
  102. struct wlan_peer_rx_rate_stats rx;
  103. };
  104. /**
  105. * struct wlan_peer_link_metrics - Peer link metrics
  106. * @tx: tx link quality stats
  107. * @rx: rx link quality stats
  108. */
  109. struct wlan_peer_link_metrics {
  110. struct wlan_peer_tx_link_stats tx;
  111. struct wlan_peer_rx_link_stats rx;
  112. };
  113. /**
  114. * struct wlan_peer_rate_stats_ctx - Peer statistics context
  115. * @rate_stats: Rate statistics (version 1 stats)
  116. * @link_metrics: Link Metrics (version 2 stats)
  117. * @mac_addr: peer MAC address
  118. * @peer_cookie: cookie for unique session of peer
  119. * @pdev_id: id of dp pdev
  120. */
  121. struct wlan_peer_rate_stats_ctx {
  122. struct wlan_peer_rate_stats *rate_stats;
  123. struct wlan_peer_link_metrics *link_metrics;
  124. uint8_t mac_addr[WLAN_MAC_ADDR_LEN];
  125. uint64_t peer_cookie;
  126. uint8_t pdev_id;
  127. };
  128. /**
  129. * enum rdk_stats_version - Peer statistics versions
  130. * @RDK_STATS_DISABLED: peer statistics disabled
  131. * @RDK_RATE_STATS: peer rate statistics enabled
  132. * @RDK_LINK_STATS: peer link metrics enabled
  133. * @RDK_ALL_STATS: peer all statistics enabled
  134. */
  135. enum rdk_stats_version {
  136. RDK_STATS_DISABLED = 0,
  137. RDK_RATE_STATS = 1,
  138. RDK_LINK_STATS = 2,
  139. RDK_ALL_STATS = 3,
  140. };
  141. /**
  142. * struct wlan_soc_rate_stats_ctx - rate stats context at soc level
  143. * @soc: Opaque soc handle
  144. * @txs_cache_flush: tx stats flush count
  145. * @rxs_cache_flush: rx stats flush count
  146. * @txs_last_idx_cache_hit: cache hit for rate index received as last rate index
  147. * @txs_cache_hit: tx stats cache hit for rate index received from cache db
  148. * @rxs_last_idx_cache_hit: cache hit for rate index received as last rate index
  149. * @rxs_cache_hit: cache hit for rate index received from cache database
  150. * @txs_cache_miss: rate index recevied is not in cache database
  151. * @rxs_cache_miss: rate index recevied is not in cache database
  152. * @stats_ver: peer statistics version
  153. * @is_lithium: is lithium or legacy
  154. */
  155. struct wlan_soc_rate_stats_ctx {
  156. struct cdp_soc_t *soc;
  157. uint32_t txs_cache_flush;
  158. uint32_t rxs_cache_flush;
  159. uint32_t txs_last_idx_cache_hit;
  160. uint32_t txs_cache_hit;
  161. uint32_t rxs_last_idx_cache_hit;
  162. uint32_t rxs_cache_hit;
  163. uint32_t txs_cache_miss;
  164. uint32_t rxs_cache_miss;
  165. enum rdk_stats_version stats_ver;
  166. bool is_lithium;
  167. };
  168. /**
  169. * wlan_peer_update_rate_stats ()- WDI handler to update rate stats
  170. * @ctx: soc level stats context
  171. * @event: WDI event enum
  172. * @stats: buffer containing cdp_peer_tx_rate_stats_intf or
  173. * cdp_peer_rx_rate_stats_intf
  174. * @peer_id: peer id
  175. * @type: enum wlan_rate_stats_type
  176. */
  177. void wlan_peer_update_rate_stats(void *ctx,
  178. enum WDI_EVENT event,
  179. void *stats, uint16_t peer_id,
  180. uint32_t type);
  181. /**
  182. * wlan_cfg80211_flush_rate_stats ()- os_if layer handler to
  183. * flush rate statistics
  184. * @pdev: Ctrl pdev
  185. * @event: WDI event enum
  186. * @ptr: Stats buffer
  187. * @peer_id: peer id
  188. * @status: status
  189. */
  190. void wlan_cfg80211_flush_rate_stats(void *ctrl_pdev, enum WDI_EVENT event,
  191. void *ptr, uint16_t peer_id,
  192. uint32_t status);
  193. /**
  194. * wlan_peer_create_event_handler ()- peer create event handler
  195. * to initialize statistics objects
  196. * @pdev: Ctrl pdev
  197. * @event: WDI event enum
  198. * @peer_mac: Peer MAC address
  199. * @buf: Stats buffer
  200. * @peer_id: peer id
  201. * @status: status
  202. */
  203. void wlan_peer_create_event_handler(void *pdev, enum WDI_EVENT event,
  204. void *buf, uint16_t peer_id,
  205. uint32_t status);
  206. /**
  207. * wlan_peer_destroy_event_handler ()- peer destroy event handler
  208. * to deinitilize statistics objects
  209. * @pdev: Ctrl pdev
  210. * @event: WDI event enum
  211. * @peer_mac: Peer MAC address
  212. * @buf: Stats buffer
  213. * @peer_id: peer id
  214. * @status: status
  215. */
  216. void wlan_peer_destroy_event_handler(void *pdev, enum WDI_EVENT event,
  217. void *buf, uint16_t peer_id,
  218. uint32_t status);
  219. /**
  220. * wlan_peer_rate_stats_flush_req ()- stats flush request event handler
  221. * This flushes statistics to user space entity
  222. * @pdev: Ctrl pdev
  223. * @event: WDI event enum
  224. * @buf: Stats buffer
  225. * @peer_id: peer id
  226. * @status: status
  227. */
  228. void wlan_peer_rate_stats_flush_req(void *pdev, enum WDI_EVENT event,
  229. void *buf, uint16_t peer_id,
  230. uint32_t status);
  231. #else
  232. static inline void
  233. wlan_peer_update_rate_stats(void *pdev, enum WDI_EVENT event,
  234. void *stats, uint16_t peer_id,
  235. uint32_t type)
  236. {
  237. }
  238. static inline void
  239. wlan_cfg80211_flush_rate_stats(void *ctrl_pdev, enum WDI_EVENT event,
  240. void *ptr, uint16_t peer_id,
  241. uint32_t status)
  242. {
  243. }
  244. static inline void
  245. wlan_peer_create_event_handler(void *pdev, enum WDI_EVENT event,
  246. void *buf, uint16_t peer_id,
  247. uint32_t type)
  248. {
  249. }
  250. static inline void
  251. wlan_peer_destroy_event_handler(void *pdev, enum WDI_EVENT event,
  252. void *buf, uint16_t peer_id,
  253. uint32_t type)
  254. {
  255. }
  256. static inline void
  257. wlan_peer_rate_stats_flush_req(void *pdev,
  258. enum WDI_EVENT event,
  259. void *buf, uint16_t peer_id,
  260. uint32_t type)
  261. {
  262. }
  263. #endif /* QCA_SUPPORT_RDK_STATS */
  264. #endif /* _DP_RATE_STATS_ */