dp_tx_capture.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546
  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. };
  126. /* Tx TID */
  127. struct dp_tx_tid {
  128. /* TID */
  129. uint8_t tid;
  130. /* peer id */
  131. uint16_t peer_id;
  132. /* max ppdu_id in a tid */
  133. uint32_t max_ppdu_id;
  134. /* tx_tid lock */
  135. qdf_spinlock_t tid_lock;
  136. qdf_spinlock_t tasklet_tid_lock;
  137. qdf_nbuf_queue_t defer_msdu_q;
  138. qdf_nbuf_queue_t msdu_comp_q;
  139. qdf_nbuf_queue_t pending_ppdu_q;
  140. struct cdp_tx_completion_ppdu *xretry_ppdu;
  141. uint16_t first_data_seq_ctrl;
  142. uint32_t mpdu_cnt;
  143. uint32_t mpdu_fcs_ok_bitmap[QDF_MON_STATUS_MPDU_FCS_BMAP_NWORDS];
  144. unsigned long tid_flags;
  145. };
  146. struct dp_peer_tx_capture {
  147. struct dp_tx_tid tx_tid[DP_MAX_TIDS];
  148. /*
  149. * for a ppdu, framectrl and qos ctrl is same
  150. * for each ppdu, we update and used on rest of mpdu
  151. */
  152. uint32_t tx_wifi_ppdu_id;
  153. union {
  154. struct ieee80211_frame tx_wifi_hdr;
  155. struct ieee80211_qosframe tx_wifi_qos_hdr;
  156. };
  157. union {
  158. struct ieee80211_frame_addr4 tx_wifi_addr4_hdr;
  159. struct ieee80211_qosframe_addr4 tx_wifi_addr4_qos_hdr;
  160. };
  161. #ifdef WLAN_TX_PKT_CAPTURE_ENH_DEBUG
  162. struct dp_peer_tx_capture_stats stats;
  163. #endif
  164. /* TID is not initialized for a STA VAP */
  165. bool is_tid_initialized;
  166. };
  167. /* per user ppdu desc structure for debugfs */
  168. struct dbg_tx_comp_ppdu_user {
  169. uint32_t completion_status:8,
  170. tid:8,
  171. peer_id:16;
  172. uint8_t mac_addr[6];
  173. uint32_t frame_ctrl:16,
  174. qos_ctrl:16;
  175. uint32_t mpdu_tried;
  176. uint16_t mpdu_success:16;
  177. uint32_t ltf_size:2,
  178. stbc:1,
  179. he_re:1,
  180. txbf:4,
  181. bw:4,
  182. nss:4,
  183. mcs:4,
  184. preamble:4,
  185. gi:4,
  186. dcm:1,
  187. ldpc:1,
  188. delayed_ba:1,
  189. ack_ba_tlv:1;
  190. uint32_t ba_seq_no;
  191. uint32_t ba_bitmap[CDP_BA_256_BIT_MAP_SIZE_DWORDS];
  192. uint32_t start_seq;
  193. uint32_t enq_bitmap[CDP_BA_256_BIT_MAP_SIZE_DWORDS];
  194. uint32_t num_mpdu:9,
  195. num_msdu:16;
  196. bool is_mcast;
  197. uint32_t tlv_bitmap;
  198. };
  199. /* ppdu desc structure for debugfs */
  200. struct dbg_tx_comp_ppdu {
  201. qdf_list_node_t node;
  202. uint32_t ppdu_id;
  203. uint32_t bar_ppdu_id;
  204. uint16_t vdev_id;
  205. uint16_t bar_num_users;
  206. uint32_t num_users;
  207. uint16_t sched_cmdid;
  208. uint32_t tlv_bitmap;
  209. uint16_t htt_frame_type;
  210. uint16_t frame_ctrl;
  211. uint64_t ppdu_start_timestamp;
  212. uint64_t ppdu_end_timestamp;
  213. uint32_t bar_ppdu_start_timestamp;
  214. uint32_t bar_ppdu_end_timestamp;
  215. struct dbg_tx_comp_ppdu_user user[];
  216. };
  217. struct tid_q_len {
  218. uint64_t defer_msdu_len;
  219. uint64_t tasklet_msdu_len;
  220. uint64_t pending_q_len;
  221. };
  222. /*
  223. * dp_peer_tid_peer_id_update() – update peer_id to tid structure
  224. * @peer: Datapath peer
  225. * @peer_id: peer_id
  226. *
  227. */
  228. void dp_peer_tid_peer_id_update(struct dp_peer *peer, uint16_t peer_id);
  229. /*
  230. * dp_peer_tid_queue_init() – Initialize ppdu stats queue per TID
  231. * @peer: Datapath peer
  232. *
  233. */
  234. void dp_peer_tid_queue_init(struct dp_peer *peer);
  235. /*
  236. * dp_peer_tid_queue_cleanup() – remove ppdu stats queue per TID
  237. * @peer: Datapath peer
  238. *
  239. */
  240. void dp_peer_tid_queue_cleanup(struct dp_peer *peer);
  241. /*
  242. * dp_peer_update_80211_hdr: update 80211 hdr
  243. * @vdev: DP VDEV
  244. * @peer: DP PEER
  245. *
  246. * return: void
  247. */
  248. void dp_peer_update_80211_hdr(struct dp_vdev *vdev, struct dp_peer *peer);
  249. /**
  250. * dp_tx_ppdu_stats_attach - Initialize Tx PPDU stats and enhanced capture
  251. * @pdev: DP PDEV
  252. * Return: none
  253. */
  254. void dp_tx_ppdu_stats_attach(struct dp_pdev *pdev);
  255. /**
  256. * dp_tx_ppdu_stats_detach - Cleanup Tx PPDU stats and enhanced capture
  257. * @pdev: DP PDEV
  258. *
  259. * Return: none
  260. */
  261. void dp_tx_ppdu_stats_detach(struct dp_pdev *pdev);
  262. /**
  263. * dp_process_ppdu_stats_update_failed_bitmap(): Function to
  264. * get ppdu stats update
  265. * @pdev: dp_pdev
  266. * @data: tx completion ppdu desc
  267. * @ppdu_id: ppdu id
  268. * @size: bitmap size
  269. *
  270. * return: status
  271. */
  272. void dp_process_ppdu_stats_update_failed_bitmap(struct dp_pdev *pdev,
  273. void *data,
  274. uint32_t ppdu_id,
  275. uint32_t size);
  276. /**
  277. * dp_update_msdu_to_list(): Function to queue msdu from wbm
  278. * @pdev: dp_pdev
  279. * @peer: dp_peer
  280. * @ts: hal tx completion status
  281. * @netbuf: msdu
  282. *
  283. * return: status
  284. */
  285. QDF_STATUS
  286. dp_update_msdu_to_list(struct dp_soc *soc,
  287. struct dp_pdev *pdev,
  288. struct dp_peer *peer,
  289. struct hal_tx_completion_status *ts,
  290. qdf_nbuf_t netbuf);
  291. /**
  292. * dp_tx_add_to_comp_queue() - add completion msdu to queue
  293. * @soc: DP Soc handle
  294. * @tx_desc: software Tx descriptor
  295. * @ts : Tx completion status from HAL/HTT descriptor
  296. * @peer: DP peer
  297. *
  298. * Return: none
  299. */
  300. QDF_STATUS dp_tx_add_to_comp_queue(struct dp_soc *soc,
  301. struct dp_tx_desc_s *desc,
  302. struct hal_tx_completion_status *ts,
  303. struct dp_peer *peer);
  304. /*
  305. * dp_config_enh_tx_capture()- API to enable/disable enhanced tx capture
  306. * @pdev_handle: DP_PDEV handle
  307. * @val: user provided value
  308. *
  309. * Return: QDF_STATUS
  310. */
  311. QDF_STATUS
  312. dp_config_enh_tx_capture(struct dp_pdev *pdev_handle, uint8_t val);
  313. /*
  314. * dp_deliver_mgmt_frm: Process
  315. * @pdev: DP PDEV handle
  316. * @nbuf: buffer containing the htt_ppdu_stats_tx_mgmtctrl_payload_tlv
  317. *
  318. * return: void
  319. */
  320. void dp_deliver_mgmt_frm(struct dp_pdev *pdev, qdf_nbuf_t nbuf);
  321. /**
  322. * dp_process_ppdu_stats_process(): workqueue function for ppdu stats
  323. * @context: context
  324. *
  325. * return: status
  326. */
  327. void dp_tx_ppdu_stats_process(void *context);
  328. /**
  329. * dp_ppdu_desc_deliver(): Function to deliver Tx PPDU status descriptor
  330. * to upper layer
  331. * @pdev: DP pdev handle
  332. * @ppdu_info: per PPDU TLV descriptor
  333. *
  334. * return: void
  335. */
  336. void dp_ppdu_desc_deliver(struct dp_pdev *pdev,
  337. struct ppdu_info *ppdu_info);
  338. /*
  339. * dp_tx_capture_htt_frame_counter: increment counter for htt_frame_type
  340. * pdev: DP pdev handle
  341. * htt_frame_type: htt frame type received from fw
  342. *
  343. * return: void
  344. */
  345. void dp_tx_capture_htt_frame_counter(struct dp_pdev *pdev,
  346. uint32_t htt_frame_type);
  347. /*
  348. * dp_print_pdev_tx_capture_stats: print tx capture stats
  349. * @pdev: DP PDEV handle
  350. *
  351. * return: void
  352. */
  353. void dp_print_pdev_tx_capture_stats(struct dp_pdev *pdev);
  354. /*
  355. * dp_iterate_print_tid_qlen_per_peer()- API to print peer tid msdu queue
  356. * @pdev_handle: DP_PDEV handle
  357. * @consolidated: consolidated flag
  358. *
  359. * Return: void
  360. */
  361. void dp_print_tid_qlen_per_peer(void *pdev_hdl, uint8_t consolidated);
  362. /**
  363. * dp_send_ack_frame_to_stack(): Function to generate BA or ACK frame and
  364. * send to upper layer on received unicast frame
  365. * @soc: core txrx main context
  366. * @pdev: DP pdev object
  367. * @ppdu_info: HAL RX PPDU info retrieved from status ring TLV
  368. *
  369. * return: status
  370. */
  371. QDF_STATUS dp_send_ack_frame_to_stack(struct dp_soc *soc,
  372. struct dp_pdev *pdev,
  373. struct hal_rx_ppdu_info *ppdu_info);
  374. /**
  375. * dp_handle_tx_capture_from_dest: Handle any TX capture frames from
  376. * monitor destination path.
  377. * @soc: SoC handle
  378. * @pdev: PDEV pointer
  379. * @mon_mpdu: mpdu from monitor destination path
  380. *
  381. * Return: QDF_STATUS
  382. */
  383. QDF_STATUS
  384. dp_handle_tx_capture_from_dest(struct dp_soc *soc, struct dp_pdev *pdev,
  385. qdf_nbuf_t mon_mpdu);
  386. /**
  387. * dp_bar_send_ack_frm_to_stack(): send ACK frame
  388. * to upper layers on received BAR packet for tx capture feature
  389. *
  390. * @soc: soc handle
  391. * @pdev: pdev handle
  392. * @nbuf: received packet
  393. *
  394. * Return: QDF_STATUS_SUCCESS on success
  395. * others on error
  396. */
  397. QDF_STATUS dp_bar_send_ack_frm_to_stack(struct dp_soc *soc,
  398. struct dp_pdev *pdev,
  399. qdf_nbuf_t nbuf);
  400. /**
  401. * dp_peer_set_tx_capture_enabled: Set tx_cap_enabled bit in peer
  402. * @pdev: DP PDEV handle
  403. * @peer: Peer handle
  404. * @value: Enable/disable setting for tx_cap_enabled
  405. * @peer_mac: peer_mac Enable/disable setting for tx_cap_enabled
  406. *
  407. * Return: QDF_STATUS
  408. */
  409. QDF_STATUS
  410. dp_peer_set_tx_capture_enabled(struct dp_pdev *pdev,
  411. struct dp_peer *peer, uint8_t value,
  412. uint8_t *peer_mac);
  413. /*
  414. * dp_peer_tx_cap_add_filter: add peer filter mgmt pkt based on peer
  415. * and mac address
  416. * @pdev: DP PDEV handle
  417. * @peer_id: DP PEER ID
  418. * @mac_addr: pointer to mac address
  419. *
  420. * return: true on added and false on not failed
  421. */
  422. bool dp_pdev_tx_cap_add_filter(struct dp_pdev *pdev,
  423. uint16_t peer_id, uint8_t *mac_addr);
  424. /*
  425. * dp_peer_tx_cap_del_filter: delete peer filter mgmt pkt based on peer
  426. * and mac address
  427. * @pdev: DP PDEV handle
  428. * @peer_id: DP PEER ID
  429. * @mac_addr: pointer to mac address
  430. *
  431. * return: true on added and false on not failed
  432. */
  433. bool dp_peer_tx_cap_del_filter(struct dp_pdev *pdev,
  434. uint16_t peer_id, uint8_t *mac_addr);
  435. /*
  436. * dp_peer_tx_cap_print_mgmt_filter: pradd peer filter mgmt pkt based on peer
  437. * and mac address
  438. * @pdev: DP PDEV handle
  439. * @peer_id: DP PEER ID
  440. * @mac_addr: pointer to mac address
  441. *
  442. * return: true on added and false on not failed
  443. */
  444. void dp_peer_tx_cap_print_mgmt_filter(struct dp_pdev *pdev,
  445. uint16_t peer_id, uint8_t *mac_addr);
  446. /*
  447. * dp_peer_mgmt_pkt_filter: filter mgmt pkt based on peer and mac address
  448. * @pdev: DP PDEV handle
  449. * @nbuf: buffer containing the ppdu_desc
  450. *
  451. * return: status
  452. */
  453. bool is_dp_peer_mgmt_pkt_filter(struct dp_pdev *pdev,
  454. uint32_t peer_id, uint8_t *mac_addr);
  455. /*
  456. * dp_peer_tx_capture_filter_check: check filter is enable for the filter
  457. * and update tx_cap_enabled flag
  458. * @pdev: DP PDEV handle
  459. * @peer: DP PEER handle
  460. *
  461. * return: void
  462. */
  463. void dp_peer_tx_capture_filter_check(struct dp_pdev *pdev,
  464. struct dp_peer *peer);
  465. /*
  466. * dp_tx_capture_debugfs_init: tx capture debugfs init
  467. * @pdev: DP PDEV handle
  468. *
  469. * return: QDF_STATUS
  470. */
  471. QDF_STATUS dp_tx_capture_debugfs_init(struct dp_pdev *pdev);
  472. /*
  473. * dp_tx_capture_debugfs_deinit: tx capture debugfs deinit
  474. * @pdev: DP PDEV handle
  475. *
  476. * return: void
  477. */
  478. void dp_tx_capture_debugfs_deinit(struct dp_pdev *pdev);
  479. /*
  480. * tx_cap_debugfs_log_ppdu_desc: tx capture logging ppdu desc
  481. * @pdev: DP PDEV handle
  482. * @nbuf_ppdu: nbuf ppdu
  483. *
  484. * return: void
  485. */
  486. void tx_cap_debugfs_log_ppdu_desc(struct dp_pdev *pdev, qdf_nbuf_t nbuf_ppdu);
  487. #endif
  488. #endif