dp_tx_capture.h 13 KB

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