dp_tx_capture.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547
  1. /*
  2. * Copyright (c) 2017-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. #ifndef _DP_TX_CAPTURE_H_
  19. #define _DP_TX_CAPTURE_H_
  20. #ifdef WLAN_TX_PKT_CAPTURE_ENH
  21. #define DP_TX_PPDU_PROC_MAX_DEPTH 512
  22. struct dp_soc;
  23. struct dp_pdev;
  24. struct dp_vdev;
  25. struct dp_peer;
  26. struct dp_tx_desc_s;
  27. #define TX_CAP_HTT_MAX_FTYPE 19
  28. #define TXCAP_MAX_TYPE \
  29. ((IEEE80211_FC0_TYPE_DATA >> IEEE80211_FC0_TYPE_SHIFT) + 1)
  30. #define TXCAP_MAX_SUBTYPE \
  31. ((IEEE80211_FC0_SUBTYPE_MASK >> IEEE80211_FC0_SUBTYPE_SHIFT) + 1)
  32. #define SIFS_INTERVAL 16
  33. #define RTS_INTERVAL 40
  34. #define MAX_MGMT_PEER_FILTER 16
  35. /* Macro for Debugfs */
  36. #define TX_CAP_DBG_FILE_PERM (QDF_FILE_USR_READ | QDF_FILE_USR_WRITE | \
  37. QDF_FILE_GRP_READ | \
  38. QDF_FILE_OTH_READ)
  39. #define NUM_TX_CAP_DEBUG_INFOS 2
  40. #define MAX_TX_CAP_QUEUE_SIZE 30
  41. #define PPDU_LOG_ENABLE_LIST 1
  42. #define PPDU_LOG_DISPLAY_LIST 2
  43. #define TX_CAPTURE_WORK_Q_TIMER_MS 10
  44. /* stats */
  45. enum CDP_PEER_MSDU_DESC {
  46. PEER_MSDU_SUCC,
  47. PEER_MSDU_ENQ,
  48. PEER_MSDU_DEQ,
  49. PEER_MSDU_FLUSH,
  50. PEER_MSDU_DROP,
  51. PEER_MSDU_XRETRY,
  52. PEER_MSDU_DESC_MAX,
  53. };
  54. enum CDP_PEER_MPDU_DESC {
  55. PEER_MPDU_TRI,
  56. PEER_MPDU_SUCC,
  57. PEER_MPDU_RESTITCH,
  58. PEER_MPDU_ARR,
  59. PEER_MPDU_CLONE,
  60. PEER_MPDU_TO_STACK,
  61. PEER_MPDU_DESC_MAX,
  62. };
  63. #ifdef WLAN_TX_PKT_CAPTURE_ENH_DEBUG
  64. struct dp_peer_tx_capture_stats {
  65. /* mpdu success and restich count */
  66. uint32_t mpdu[PEER_MPDU_DESC_MAX];
  67. /*msdu success and restich count */
  68. uint32_t msdu[PEER_MSDU_DESC_MAX];
  69. };
  70. #endif
  71. struct dp_peer_mgmt_list {
  72. uint8_t mac_addr[QDF_MAC_ADDR_SIZE];
  73. uint32_t mgmt_pkt_counter;
  74. uint16_t peer_id;
  75. bool avail;
  76. };
  77. struct dp_tx_cap_nbuf_list {
  78. qdf_nbuf_t nbuf_ppdu;
  79. uint8_t ref_cnt;
  80. };
  81. struct tx_cap_debugfs_info {
  82. const char *name;
  83. struct qdf_debugfs_fops ops;
  84. };
  85. struct tx_cap_debug_log_info {
  86. struct dentry *debugfs_de[NUM_DEBUG_INFOS];
  87. qdf_spinlock_t tx_cap_record_lock;
  88. qdf_dentry_t tx_cap_debugfs_dir;
  89. qdf_list_t ppdu_dbg_queue;
  90. qdf_spinlock_t dbg_log_lock;
  91. uint8_t ppdu_desc_log;
  92. uint8_t pause_dbg_log;
  93. uint8_t stop_seq;
  94. uint8_t ppdu_queue_size;
  95. struct tx_cap_debugfs_info tx_cap_debugfs_infos[NUM_TX_CAP_DEBUG_INFOS];
  96. };
  97. struct dp_pdev_tx_capture {
  98. /* For deferred PPDU status processing */
  99. qdf_spinlock_t ppdu_stats_lock;
  100. qdf_workqueue_t *ppdu_stats_workqueue;
  101. qdf_work_t ppdu_stats_work;
  102. STAILQ_HEAD(, ppdu_info) ppdu_stats_queue;
  103. STAILQ_HEAD(, ppdu_info) ppdu_stats_defer_queue;
  104. uint32_t ppdu_stats_queue_depth;
  105. uint32_t ppdu_stats_defer_queue_depth;
  106. uint32_t ppdu_stats_next_sched;
  107. qdf_spinlock_t msdu_comp_q_list_lock;
  108. qdf_timer_t work_q_timer;
  109. uint32_t missed_ppdu_id;
  110. uint32_t last_msdu_id;
  111. uint16_t last_peer_id;
  112. qdf_event_t miss_ppdu_event;
  113. uint32_t ppdu_dropped;
  114. uint32_t pend_ppdu_dropped;
  115. qdf_nbuf_queue_t ctl_mgmt_q[TXCAP_MAX_TYPE][TXCAP_MAX_SUBTYPE];
  116. qdf_nbuf_queue_t retries_ctl_mgmt_q[TXCAP_MAX_TYPE][TXCAP_MAX_SUBTYPE];
  117. qdf_spinlock_t ctl_mgmt_lock[TXCAP_MAX_TYPE][TXCAP_MAX_SUBTYPE];
  118. uint32_t htt_frame_type[TX_CAP_HTT_MAX_FTYPE];
  119. struct cdp_tx_completion_ppdu *dummy_ppdu_desc;
  120. struct dp_peer_mgmt_list *ptr_peer_mgmt_list;
  121. qdf_atomic_t tx_cap_usr_mode;
  122. struct tx_cap_debug_log_info log_info;
  123. struct dp_tx_cap_nbuf_list *last_nbuf_ppdu_list;
  124. uint32_t last_nbuf_ppdu_list_arr_sz;
  125. uint64_t peer_mismatch;
  126. };
  127. /* Tx TID */
  128. struct dp_tx_tid {
  129. /* TID */
  130. uint8_t tid;
  131. /* peer id */
  132. uint16_t peer_id;
  133. /* max ppdu_id in a tid */
  134. uint32_t max_ppdu_id;
  135. /* tx_tid lock */
  136. qdf_spinlock_t tid_lock;
  137. qdf_spinlock_t tasklet_tid_lock;
  138. qdf_nbuf_queue_t defer_msdu_q;
  139. qdf_nbuf_queue_t msdu_comp_q;
  140. qdf_nbuf_queue_t pending_ppdu_q;
  141. struct cdp_tx_completion_ppdu *xretry_ppdu;
  142. uint16_t first_data_seq_ctrl;
  143. uint32_t mpdu_cnt;
  144. uint32_t mpdu_fcs_ok_bitmap[QDF_MON_STATUS_MPDU_FCS_BMAP_NWORDS];
  145. unsigned long tid_flags;
  146. };
  147. struct dp_peer_tx_capture {
  148. struct dp_tx_tid tx_tid[DP_MAX_TIDS];
  149. /*
  150. * for a ppdu, framectrl and qos ctrl is same
  151. * for each ppdu, we update and used on rest of mpdu
  152. */
  153. uint32_t tx_wifi_ppdu_id;
  154. union {
  155. struct ieee80211_frame tx_wifi_hdr;
  156. struct ieee80211_qosframe tx_wifi_qos_hdr;
  157. };
  158. union {
  159. struct ieee80211_frame_addr4 tx_wifi_addr4_hdr;
  160. struct ieee80211_qosframe_addr4 tx_wifi_addr4_qos_hdr;
  161. };
  162. #ifdef WLAN_TX_PKT_CAPTURE_ENH_DEBUG
  163. struct dp_peer_tx_capture_stats stats;
  164. #endif
  165. /* TID is not initialized for a STA VAP */
  166. bool is_tid_initialized;
  167. };
  168. /* per user ppdu desc structure for debugfs */
  169. struct dbg_tx_comp_ppdu_user {
  170. uint32_t completion_status:8,
  171. tid:8,
  172. peer_id:16;
  173. uint8_t mac_addr[6];
  174. uint32_t frame_ctrl:16,
  175. qos_ctrl:16;
  176. uint32_t mpdu_tried;
  177. uint16_t mpdu_success:16;
  178. uint32_t ltf_size:2,
  179. stbc:1,
  180. he_re:1,
  181. txbf:4,
  182. bw:4,
  183. nss:4,
  184. mcs:4,
  185. preamble:4,
  186. gi:4,
  187. dcm:1,
  188. ldpc:1,
  189. delayed_ba:1,
  190. ack_ba_tlv:1;
  191. uint32_t ba_seq_no;
  192. uint32_t ba_bitmap[CDP_BA_256_BIT_MAP_SIZE_DWORDS];
  193. uint32_t start_seq;
  194. uint32_t enq_bitmap[CDP_BA_256_BIT_MAP_SIZE_DWORDS];
  195. uint32_t num_mpdu:9,
  196. num_msdu:16;
  197. bool is_mcast;
  198. uint32_t tlv_bitmap;
  199. };
  200. /* ppdu desc structure for debugfs */
  201. struct dbg_tx_comp_ppdu {
  202. qdf_list_node_t node;
  203. uint32_t ppdu_id;
  204. uint32_t bar_ppdu_id;
  205. uint16_t vdev_id;
  206. uint16_t bar_num_users;
  207. uint32_t num_users;
  208. uint16_t sched_cmdid;
  209. uint32_t tlv_bitmap;
  210. uint16_t htt_frame_type;
  211. uint16_t frame_ctrl;
  212. uint64_t ppdu_start_timestamp;
  213. uint64_t ppdu_end_timestamp;
  214. uint32_t bar_ppdu_start_timestamp;
  215. uint32_t bar_ppdu_end_timestamp;
  216. struct dbg_tx_comp_ppdu_user user[];
  217. };
  218. struct tid_q_len {
  219. uint64_t defer_msdu_len;
  220. uint64_t tasklet_msdu_len;
  221. uint64_t pending_q_len;
  222. };
  223. /*
  224. * dp_peer_tid_peer_id_update() – update peer_id to tid structure
  225. * @peer: Datapath peer
  226. * @peer_id: peer_id
  227. *
  228. */
  229. void dp_peer_tid_peer_id_update(struct dp_peer *peer, uint16_t peer_id);
  230. /*
  231. * dp_peer_tid_queue_init() – Initialize ppdu stats queue per TID
  232. * @peer: Datapath peer
  233. *
  234. */
  235. void dp_peer_tid_queue_init(struct dp_peer *peer);
  236. /*
  237. * dp_peer_tid_queue_cleanup() – remove ppdu stats queue per TID
  238. * @peer: Datapath peer
  239. *
  240. */
  241. void dp_peer_tid_queue_cleanup(struct dp_peer *peer);
  242. /*
  243. * dp_peer_update_80211_hdr: update 80211 hdr
  244. * @vdev: DP VDEV
  245. * @peer: DP PEER
  246. *
  247. * return: void
  248. */
  249. void dp_peer_update_80211_hdr(struct dp_vdev *vdev, struct dp_peer *peer);
  250. /**
  251. * dp_tx_ppdu_stats_attach - Initialize Tx PPDU stats and enhanced capture
  252. * @pdev: DP PDEV
  253. * Return: none
  254. */
  255. void dp_tx_ppdu_stats_attach(struct dp_pdev *pdev);
  256. /**
  257. * dp_tx_ppdu_stats_detach - Cleanup Tx PPDU stats and enhanced capture
  258. * @pdev: DP PDEV
  259. *
  260. * Return: none
  261. */
  262. void dp_tx_ppdu_stats_detach(struct dp_pdev *pdev);
  263. /**
  264. * dp_process_ppdu_stats_update_failed_bitmap(): Function to
  265. * get ppdu stats update
  266. * @pdev: dp_pdev
  267. * @data: tx completion ppdu desc
  268. * @ppdu_id: ppdu id
  269. * @size: bitmap size
  270. *
  271. * return: status
  272. */
  273. void dp_process_ppdu_stats_update_failed_bitmap(struct dp_pdev *pdev,
  274. void *data,
  275. uint32_t ppdu_id,
  276. uint32_t size);
  277. /**
  278. * dp_update_msdu_to_list(): Function to queue msdu from wbm
  279. * @pdev: dp_pdev
  280. * @peer: dp_peer
  281. * @ts: hal tx completion status
  282. * @netbuf: msdu
  283. *
  284. * return: status
  285. */
  286. QDF_STATUS
  287. dp_update_msdu_to_list(struct dp_soc *soc,
  288. struct dp_pdev *pdev,
  289. struct dp_peer *peer,
  290. struct hal_tx_completion_status *ts,
  291. qdf_nbuf_t netbuf);
  292. /**
  293. * dp_tx_add_to_comp_queue() - add completion msdu to queue
  294. * @soc: DP Soc handle
  295. * @tx_desc: software Tx descriptor
  296. * @ts : Tx completion status from HAL/HTT descriptor
  297. * @peer: DP peer
  298. *
  299. * Return: none
  300. */
  301. QDF_STATUS dp_tx_add_to_comp_queue(struct dp_soc *soc,
  302. struct dp_tx_desc_s *desc,
  303. struct hal_tx_completion_status *ts,
  304. struct dp_peer *peer);
  305. /*
  306. * dp_config_enh_tx_capture()- API to enable/disable enhanced tx capture
  307. * @pdev_handle: DP_PDEV handle
  308. * @val: user provided value
  309. *
  310. * Return: QDF_STATUS
  311. */
  312. QDF_STATUS
  313. dp_config_enh_tx_capture(struct dp_pdev *pdev_handle, uint8_t val);
  314. /*
  315. * dp_deliver_mgmt_frm: Process
  316. * @pdev: DP PDEV handle
  317. * @nbuf: buffer containing the htt_ppdu_stats_tx_mgmtctrl_payload_tlv
  318. *
  319. * return: void
  320. */
  321. void dp_deliver_mgmt_frm(struct dp_pdev *pdev, qdf_nbuf_t nbuf);
  322. /**
  323. * dp_process_ppdu_stats_process(): workqueue function for ppdu stats
  324. * @context: context
  325. *
  326. * return: status
  327. */
  328. void dp_tx_ppdu_stats_process(void *context);
  329. /**
  330. * dp_ppdu_desc_deliver(): Function to deliver Tx PPDU status descriptor
  331. * to upper layer
  332. * @pdev: DP pdev handle
  333. * @ppdu_info: per PPDU TLV descriptor
  334. *
  335. * return: void
  336. */
  337. void dp_ppdu_desc_deliver(struct dp_pdev *pdev,
  338. struct ppdu_info *ppdu_info);
  339. /*
  340. * dp_tx_capture_htt_frame_counter: increment counter for htt_frame_type
  341. * pdev: DP pdev handle
  342. * htt_frame_type: htt frame type received from fw
  343. *
  344. * return: void
  345. */
  346. void dp_tx_capture_htt_frame_counter(struct dp_pdev *pdev,
  347. uint32_t htt_frame_type);
  348. /*
  349. * dp_print_pdev_tx_capture_stats: print tx capture stats
  350. * @pdev: DP PDEV handle
  351. *
  352. * return: void
  353. */
  354. void dp_print_pdev_tx_capture_stats(struct dp_pdev *pdev);
  355. /*
  356. * dp_iterate_print_tid_qlen_per_peer()- API to print peer tid msdu queue
  357. * @pdev_handle: DP_PDEV handle
  358. * @consolidated: consolidated flag
  359. *
  360. * Return: void
  361. */
  362. void dp_print_tid_qlen_per_peer(void *pdev_hdl, uint8_t consolidated);
  363. /**
  364. * dp_send_ack_frame_to_stack(): Function to generate BA or ACK frame and
  365. * send to upper layer on received unicast frame
  366. * @soc: core txrx main context
  367. * @pdev: DP pdev object
  368. * @ppdu_info: HAL RX PPDU info retrieved from status ring TLV
  369. *
  370. * return: status
  371. */
  372. QDF_STATUS dp_send_ack_frame_to_stack(struct dp_soc *soc,
  373. struct dp_pdev *pdev,
  374. struct hal_rx_ppdu_info *ppdu_info);
  375. /**
  376. * dp_handle_tx_capture_from_dest: Handle any TX capture frames from
  377. * monitor destination path.
  378. * @soc: SoC handle
  379. * @pdev: PDEV pointer
  380. * @mon_mpdu: mpdu from monitor destination path
  381. *
  382. * Return: QDF_STATUS
  383. */
  384. QDF_STATUS
  385. dp_handle_tx_capture_from_dest(struct dp_soc *soc, struct dp_pdev *pdev,
  386. qdf_nbuf_t mon_mpdu);
  387. /**
  388. * dp_bar_send_ack_frm_to_stack(): send ACK frame
  389. * to upper layers on received BAR packet for tx capture feature
  390. *
  391. * @soc: soc handle
  392. * @pdev: pdev handle
  393. * @nbuf: received packet
  394. *
  395. * Return: QDF_STATUS_SUCCESS on success
  396. * others on error
  397. */
  398. QDF_STATUS dp_bar_send_ack_frm_to_stack(struct dp_soc *soc,
  399. struct dp_pdev *pdev,
  400. qdf_nbuf_t nbuf);
  401. /**
  402. * dp_peer_set_tx_capture_enabled: Set tx_cap_enabled bit in peer
  403. * @pdev: DP PDEV handle
  404. * @peer: Peer handle
  405. * @value: Enable/disable setting for tx_cap_enabled
  406. * @peer_mac: peer_mac Enable/disable setting for tx_cap_enabled
  407. *
  408. * Return: QDF_STATUS
  409. */
  410. QDF_STATUS
  411. dp_peer_set_tx_capture_enabled(struct dp_pdev *pdev,
  412. struct dp_peer *peer, uint8_t value,
  413. uint8_t *peer_mac);
  414. /*
  415. * dp_peer_tx_cap_add_filter: add peer filter mgmt pkt based on peer
  416. * and mac address
  417. * @pdev: DP PDEV handle
  418. * @peer_id: DP PEER ID
  419. * @mac_addr: pointer to mac address
  420. *
  421. * return: true on added and false on not failed
  422. */
  423. bool dp_pdev_tx_cap_add_filter(struct dp_pdev *pdev,
  424. uint16_t peer_id, uint8_t *mac_addr);
  425. /*
  426. * dp_peer_tx_cap_del_filter: delete peer filter mgmt pkt based on peer
  427. * and mac address
  428. * @pdev: DP PDEV handle
  429. * @peer_id: DP PEER ID
  430. * @mac_addr: pointer to mac address
  431. *
  432. * return: true on added and false on not failed
  433. */
  434. bool dp_peer_tx_cap_del_filter(struct dp_pdev *pdev,
  435. uint16_t peer_id, uint8_t *mac_addr);
  436. /*
  437. * dp_peer_tx_cap_print_mgmt_filter: pradd peer filter mgmt pkt based on peer
  438. * and mac address
  439. * @pdev: DP PDEV handle
  440. * @peer_id: DP PEER ID
  441. * @mac_addr: pointer to mac address
  442. *
  443. * return: true on added and false on not failed
  444. */
  445. void dp_peer_tx_cap_print_mgmt_filter(struct dp_pdev *pdev,
  446. uint16_t peer_id, uint8_t *mac_addr);
  447. /*
  448. * dp_peer_mgmt_pkt_filter: filter mgmt pkt based on peer and mac address
  449. * @pdev: DP PDEV handle
  450. * @nbuf: buffer containing the ppdu_desc
  451. *
  452. * return: status
  453. */
  454. bool is_dp_peer_mgmt_pkt_filter(struct dp_pdev *pdev,
  455. uint32_t peer_id, uint8_t *mac_addr);
  456. /*
  457. * dp_peer_tx_capture_filter_check: check filter is enable for the filter
  458. * and update tx_cap_enabled flag
  459. * @pdev: DP PDEV handle
  460. * @peer: DP PEER handle
  461. *
  462. * return: void
  463. */
  464. void dp_peer_tx_capture_filter_check(struct dp_pdev *pdev,
  465. struct dp_peer *peer);
  466. /*
  467. * dp_tx_capture_debugfs_init: tx capture debugfs init
  468. * @pdev: DP PDEV handle
  469. *
  470. * return: QDF_STATUS
  471. */
  472. QDF_STATUS dp_tx_capture_debugfs_init(struct dp_pdev *pdev);
  473. /*
  474. * dp_tx_capture_debugfs_deinit: tx capture debugfs deinit
  475. * @pdev: DP PDEV handle
  476. *
  477. * return: void
  478. */
  479. void dp_tx_capture_debugfs_deinit(struct dp_pdev *pdev);
  480. /*
  481. * tx_cap_debugfs_log_ppdu_desc: tx capture logging ppdu desc
  482. * @pdev: DP PDEV handle
  483. * @nbuf_ppdu: nbuf ppdu
  484. *
  485. * return: void
  486. */
  487. void tx_cap_debugfs_log_ppdu_desc(struct dp_pdev *pdev, qdf_nbuf_t nbuf_ppdu);
  488. #endif
  489. #endif