dp_tx.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872
  1. /*
  2. * Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
  3. * Copyright (c) 2021 Qualcomm Innovation Center, Inc. All rights reserved.
  4. *
  5. * Permission to use, copy, modify, and/or distribute this software for
  6. * any purpose with or without fee is hereby granted, provided that the
  7. * above copyright notice and this permission notice appear in all
  8. * copies.
  9. *
  10. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  11. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  12. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  13. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  14. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  15. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  16. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  17. * PERFORMANCE OF THIS SOFTWARE.
  18. */
  19. #ifndef __DP_TX_H
  20. #define __DP_TX_H
  21. #include <qdf_types.h>
  22. #include <qdf_nbuf.h>
  23. #include "dp_types.h"
  24. #if defined(MESH_MODE_SUPPORT) || defined(FEATURE_PERPKT_INFO)
  25. #include "if_meta_hdr.h"
  26. #endif
  27. #include "dp_internal.h"
  28. #include "hal_tx.h"
  29. #include <qdf_tracepoint.h>
  30. #define DP_INVALID_VDEV_ID 0xFF
  31. #define DP_TX_MAX_NUM_FRAGS 6
  32. /*
  33. * DP_TX_DESC_FLAG_FRAG flags should always be defined to 0x1
  34. * please do not change this flag's definition
  35. */
  36. #define DP_TX_DESC_FLAG_FRAG 0x1
  37. #define DP_TX_DESC_FLAG_TO_FW 0x2
  38. #define DP_TX_DESC_FLAG_SIMPLE 0x4
  39. #define DP_TX_DESC_FLAG_RAW 0x8
  40. #define DP_TX_DESC_FLAG_MESH 0x10
  41. #define DP_TX_DESC_FLAG_QUEUED_TX 0x20
  42. #define DP_TX_DESC_FLAG_COMPLETED_TX 0x40
  43. #define DP_TX_DESC_FLAG_ME 0x80
  44. #define DP_TX_DESC_FLAG_TDLS_FRAME 0x100
  45. #define DP_TX_DESC_FLAG_ALLOCATED 0x200
  46. #define DP_TX_DESC_FLAG_MESH_MODE 0x400
  47. #define DP_TX_DESC_FLAG_UNMAP_DONE 0x800
  48. #define DP_TX_DESC_FLAG_TX_COMP_ERR 0x1000
  49. #define DP_TX_DESC_FLAG_FLUSH 0x2000
  50. #define DP_TX_EXT_DESC_FLAG_METADATA_VALID 0x1
  51. #define DP_TX_FREE_SINGLE_BUF(soc, buf) \
  52. do { \
  53. qdf_nbuf_unmap(soc->osdev, buf, QDF_DMA_TO_DEVICE); \
  54. qdf_nbuf_free(buf); \
  55. } while (0)
  56. #define OCB_HEADER_VERSION 1
  57. #ifdef TX_PER_PDEV_DESC_POOL
  58. #ifdef QCA_LL_TX_FLOW_CONTROL_V2
  59. #define DP_TX_GET_DESC_POOL_ID(vdev) (vdev->vdev_id)
  60. #else /* QCA_LL_TX_FLOW_CONTROL_V2 */
  61. #define DP_TX_GET_DESC_POOL_ID(vdev) (vdev->pdev->pdev_id)
  62. #endif /* QCA_LL_TX_FLOW_CONTROL_V2 */
  63. #define DP_TX_GET_RING_ID(vdev) (vdev->pdev->pdev_id)
  64. #else
  65. #ifdef TX_PER_VDEV_DESC_POOL
  66. #define DP_TX_GET_DESC_POOL_ID(vdev) (vdev->vdev_id)
  67. #define DP_TX_GET_RING_ID(vdev) (vdev->pdev->pdev_id)
  68. #endif /* TX_PER_VDEV_DESC_POOL */
  69. #endif /* TX_PER_PDEV_DESC_POOL */
  70. #define DP_TX_QUEUE_MASK 0x3
  71. #define MAX_CDP_SEC_TYPE 12
  72. /* number of dwords for htt_tx_msdu_desc_ext2_t */
  73. #define DP_TX_MSDU_INFO_META_DATA_DWORDS 7
  74. #define dp_tx_alert(params...) QDF_TRACE_FATAL(QDF_MODULE_ID_DP_TX, params)
  75. #define dp_tx_err(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_DP_TX, params)
  76. #define dp_tx_err_rl(params...) QDF_TRACE_ERROR_RL(QDF_MODULE_ID_DP_TX, params)
  77. #define dp_tx_warn(params...) QDF_TRACE_WARN(QDF_MODULE_ID_DP_TX, params)
  78. #define dp_tx_info(params...) \
  79. __QDF_TRACE_FL(QDF_TRACE_LEVEL_INFO_HIGH, QDF_MODULE_ID_DP_TX, ## params)
  80. #define dp_tx_debug(params...) QDF_TRACE_DEBUG(QDF_MODULE_ID_DP_TX, params)
  81. #define dp_tx_comp_alert(params...) QDF_TRACE_FATAL(QDF_MODULE_ID_DP_TX_COMP, params)
  82. #define dp_tx_comp_err(params...) QDF_TRACE_ERROR(QDF_MODULE_ID_DP_TX_COMP, params)
  83. #define dp_tx_comp_warn(params...) QDF_TRACE_WARN(QDF_MODULE_ID_DP_TX_COMP, params)
  84. #define dp_tx_comp_info(params...) \
  85. __QDF_TRACE_FL(QDF_TRACE_LEVEL_INFO_HIGH, QDF_MODULE_ID_DP_TX_COMP, ## params)
  86. #define dp_tx_comp_info_rl(params...) \
  87. __QDF_TRACE_RL(QDF_TRACE_LEVEL_INFO_HIGH, QDF_MODULE_ID_DP_TX_COMP, ## params)
  88. #define dp_tx_comp_debug(params...) QDF_TRACE_DEBUG(QDF_MODULE_ID_DP_TX_COMP, params)
  89. #ifndef QCA_HOST_MODE_WIFI_DISABLED
  90. /**
  91. * struct dp_tx_frag_info_s
  92. * @vaddr: hlos vritual address for buffer
  93. * @paddr_lo: physical address lower 32bits
  94. * @paddr_hi: physical address higher bits
  95. * @len: length of the buffer
  96. */
  97. struct dp_tx_frag_info_s {
  98. uint8_t *vaddr;
  99. uint32_t paddr_lo;
  100. uint16_t paddr_hi;
  101. uint16_t len;
  102. };
  103. /**
  104. * struct dp_tx_seg_info_s - Segmentation Descriptor
  105. * @nbuf: NBUF pointer if segment corresponds to separate nbuf
  106. * @frag_cnt: Fragment count in this segment
  107. * @total_len: Total length of segment
  108. * @frags: per-Fragment information
  109. * @next: pointer to next MSDU segment
  110. */
  111. struct dp_tx_seg_info_s {
  112. qdf_nbuf_t nbuf;
  113. uint16_t frag_cnt;
  114. uint16_t total_len;
  115. struct dp_tx_frag_info_s frags[DP_TX_MAX_NUM_FRAGS];
  116. struct dp_tx_seg_info_s *next;
  117. };
  118. #endif /* QCA_HOST_MODE_WIFI_DISABLED */
  119. /**
  120. * struct dp_tx_sg_info_s - Scatter Gather Descriptor
  121. * @num_segs: Number of segments (TSO/ME) in the frame
  122. * @total_len: Total length of the frame
  123. * @curr_seg: Points to current segment descriptor to be processed. Chain of
  124. * descriptors for SG frames/multicast-unicast converted packets.
  125. *
  126. * Used for SG (802.3 or Raw) frames and Multicast-Unicast converted frames to
  127. * carry fragmentation information
  128. * Raw Frames will be handed over to driver as an SKB chain with MPDU boundaries
  129. * indicated through flags in SKB CB (first_msdu and last_msdu). This will be
  130. * converted into set of skb sg (nr_frags) structures.
  131. */
  132. struct dp_tx_sg_info_s {
  133. uint32_t num_segs;
  134. uint32_t total_len;
  135. struct dp_tx_seg_info_s *curr_seg;
  136. };
  137. /**
  138. * struct dp_tx_queue - Tx queue
  139. * @desc_pool_id: Descriptor Pool to be used for the tx queue
  140. * @ring_id: TCL descriptor ring ID corresponding to the tx queue
  141. *
  142. * Tx queue contains information of the software (Descriptor pool)
  143. * and hardware resources (TCL ring id) to be used for a particular
  144. * transmit queue (obtained from skb_queue_mapping in case of linux)
  145. */
  146. struct dp_tx_queue {
  147. uint8_t desc_pool_id;
  148. uint8_t ring_id;
  149. };
  150. /**
  151. * struct dp_tx_msdu_info_s - MSDU Descriptor
  152. * @frm_type: Frame type - Regular/TSO/SG/Multicast enhancement
  153. * @tx_queue: Tx queue on which this MSDU should be transmitted
  154. * @num_seg: Number of segments (TSO)
  155. * @tid: TID (override) that is sent from HLOS
  156. * @u.tso_info: TSO information for TSO frame types
  157. * (chain of the TSO segments, number of segments)
  158. * @u.sg_info: Scatter Gather information for non-TSO SG frames
  159. * @meta_data: Mesh meta header information
  160. * @exception_fw: Duplicate frame to be sent to firmware
  161. * @ppdu_cookie: 16-bit ppdu_cookie that has to be replayed back in completions
  162. * @ix_tx_sniffer: Indicates if the packet has to be sniffed
  163. * @gsn: global sequence for reinjected mcast packets
  164. * @vdev_id : vdev_id for reinjected mcast packets
  165. *
  166. * This structure holds the complete MSDU information needed to program the
  167. * Hardware TCL and MSDU extension descriptors for different frame types
  168. *
  169. */
  170. struct dp_tx_msdu_info_s {
  171. enum dp_tx_frm_type frm_type;
  172. struct dp_tx_queue tx_queue;
  173. uint32_t num_seg;
  174. uint8_t tid;
  175. uint8_t exception_fw;
  176. uint8_t is_tx_sniffer;
  177. union {
  178. struct qdf_tso_info_t tso_info;
  179. struct dp_tx_sg_info_s sg_info;
  180. } u;
  181. uint32_t meta_data[DP_TX_MSDU_INFO_META_DATA_DWORDS];
  182. uint16_t ppdu_cookie;
  183. #if defined(WLAN_FEATURE_11BE_MLO) && defined(WLAN_MLO_MULTI_CHIP)
  184. #ifdef WLAN_MCAST_MLO
  185. uint16_t gsn;
  186. uint8_t vdev_id;
  187. #endif
  188. #endif
  189. };
  190. #ifndef QCA_HOST_MODE_WIFI_DISABLED
  191. /**
  192. * dp_tx_deinit_pair_by_index() - Deinit TX rings based on index
  193. * @soc: core txrx context
  194. * @index: index of ring to deinit
  195. *
  196. * Deinit 1 TCL and 1 WBM2SW release ring on as needed basis using
  197. * index of the respective TCL/WBM2SW release in soc structure.
  198. * For example, if the index is 2 then &soc->tcl_data_ring[2]
  199. * and &soc->tx_comp_ring[2] will be deinitialized.
  200. *
  201. * Return: none
  202. */
  203. void dp_tx_deinit_pair_by_index(struct dp_soc *soc, int index);
  204. #endif /* QCA_HOST_MODE_WIFI_DISABLED */
  205. void dp_tx_tso_cmn_desc_pool_deinit(struct dp_soc *soc, uint8_t num_pool);
  206. void dp_tx_tso_cmn_desc_pool_free(struct dp_soc *soc, uint8_t num_pool);
  207. QDF_STATUS dp_tx_tso_cmn_desc_pool_alloc(struct dp_soc *soc,
  208. uint8_t num_pool,
  209. uint16_t num_desc);
  210. QDF_STATUS dp_tx_tso_cmn_desc_pool_init(struct dp_soc *soc,
  211. uint8_t num_pool,
  212. uint16_t num_desc);
  213. void dp_tx_tso_cmn_desc_pool_deinit(struct dp_soc *soc, uint8_t num_pool);
  214. void dp_tx_tso_cmn_desc_pool_free(struct dp_soc *soc, uint8_t num_pool);
  215. QDF_STATUS dp_tx_tso_cmn_desc_pool_alloc(struct dp_soc *soc,
  216. uint8_t num_pool,
  217. uint16_t num_desc);
  218. QDF_STATUS dp_tx_tso_cmn_desc_pool_init(struct dp_soc *soc,
  219. uint8_t num_pool,
  220. uint16_t num_desc);
  221. #ifndef QCA_HOST_MODE_WIFI_DISABLED
  222. /**
  223. * dp_tso_attach() - TSO Attach handler
  224. * @txrx_soc: Opaque Dp handle
  225. *
  226. * Reserve TSO descriptor buffers
  227. *
  228. * Return: QDF_STATUS_E_FAILURE on failure or
  229. * QDF_STATUS_SUCCESS on success
  230. */
  231. QDF_STATUS dp_tso_soc_attach(struct cdp_soc_t *txrx_soc);
  232. /**
  233. * dp_tso_detach() - TSO Detach handler
  234. * @txrx_soc: Opaque Dp handle
  235. *
  236. * Deallocate TSO descriptor buffers
  237. *
  238. * Return: QDF_STATUS_E_FAILURE on failure or
  239. * QDF_STATUS_SUCCESS on success
  240. */
  241. QDF_STATUS dp_tso_soc_detach(struct cdp_soc_t *txrx_soc);
  242. qdf_nbuf_t dp_tx_send(struct cdp_soc_t *soc, uint8_t vdev_id, qdf_nbuf_t nbuf);
  243. qdf_nbuf_t dp_tx_send_vdev_id_check(struct cdp_soc_t *soc, uint8_t vdev_id,
  244. qdf_nbuf_t nbuf);
  245. qdf_nbuf_t dp_tx_send_exception(struct cdp_soc_t *soc, uint8_t vdev_id,
  246. qdf_nbuf_t nbuf,
  247. struct cdp_tx_exception_metadata *tx_exc);
  248. qdf_nbuf_t dp_tx_send_exception_vdev_id_check(struct cdp_soc_t *soc,
  249. uint8_t vdev_id,
  250. qdf_nbuf_t nbuf,
  251. struct cdp_tx_exception_metadata *tx_exc);
  252. qdf_nbuf_t dp_tx_send_mesh(struct cdp_soc_t *soc, uint8_t vdev_id,
  253. qdf_nbuf_t nbuf);
  254. qdf_nbuf_t
  255. dp_tx_send_msdu_single(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
  256. struct dp_tx_msdu_info_s *msdu_info, uint16_t peer_id,
  257. struct cdp_tx_exception_metadata *tx_exc_metadata);
  258. #if QDF_LOCK_STATS
  259. noinline qdf_nbuf_t
  260. dp_tx_send_msdu_multiple(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
  261. struct dp_tx_msdu_info_s *msdu_info);
  262. #else
  263. qdf_nbuf_t dp_tx_send_msdu_multiple(struct dp_vdev *vdev, qdf_nbuf_t nbuf,
  264. struct dp_tx_msdu_info_s *msdu_info);
  265. #endif
  266. #ifdef FEATURE_WLAN_TDLS
  267. /**
  268. * dp_tx_non_std() - Allow the control-path SW to send data frames
  269. * @soc_hdl: Datapath soc handle
  270. * @vdev_id: id of vdev
  271. * @tx_spec: what non-standard handling to apply to the tx data frames
  272. * @msdu_list: NULL-terminated list of tx MSDUs
  273. *
  274. * Return: NULL on success,
  275. * nbuf when it fails to send
  276. */
  277. qdf_nbuf_t dp_tx_non_std(struct cdp_soc_t *soc_hdl, uint8_t vdev_id,
  278. enum ol_tx_spec tx_spec, qdf_nbuf_t msdu_list);
  279. #endif
  280. int dp_tx_frame_is_drop(struct dp_vdev *vdev, uint8_t *srcmac, uint8_t *dstmac);
  281. /**
  282. * dp_tx_comp_handler() - Tx completion handler
  283. * @int_ctx: pointer to DP interrupt context
  284. * @soc: core txrx main context
  285. * @hal_srng: Opaque HAL SRNG pointer
  286. * @ring_id: completion ring id
  287. * @quota: No. of packets/descriptors that can be serviced in one loop
  288. *
  289. * This function will collect hardware release ring element contents and
  290. * handle descriptor contents. Based on contents, free packet or handle error
  291. * conditions
  292. *
  293. * Return: Number of TX completions processed
  294. */
  295. uint32_t dp_tx_comp_handler(struct dp_intr *int_ctx, struct dp_soc *soc,
  296. hal_ring_handle_t hal_srng, uint8_t ring_id,
  297. uint32_t quota);
  298. QDF_STATUS
  299. dp_tx_prepare_send_me(struct dp_vdev *vdev, qdf_nbuf_t nbuf);
  300. QDF_STATUS
  301. dp_tx_prepare_send_igmp_me(struct dp_vdev *vdev, qdf_nbuf_t nbuf);
  302. #endif /* QCA_HOST_MODE_WIFI_DISABLED */
  303. #if defined(QCA_HOST_MODE_WIFI_DISABLED) || !defined(ATH_SUPPORT_IQUE)
  304. static inline void dp_tx_me_exit(struct dp_pdev *pdev)
  305. {
  306. return;
  307. }
  308. #endif
  309. /**
  310. * dp_tx_pdev_init() - dp tx pdev init
  311. * @pdev: physical device instance
  312. *
  313. * Return: QDF_STATUS_SUCCESS: success
  314. * QDF_STATUS_E_RESOURCES: Error return
  315. */
  316. static inline QDF_STATUS dp_tx_pdev_init(struct dp_pdev *pdev)
  317. {
  318. struct dp_soc *soc = pdev->soc;
  319. /* Initialize Flow control counters */
  320. qdf_atomic_init(&pdev->num_tx_outstanding);
  321. pdev->tx_descs_max = 0;
  322. if (wlan_cfg_per_pdev_tx_ring(soc->wlan_cfg_ctx)) {
  323. /* Initialize descriptors in TCL Ring */
  324. hal_tx_init_data_ring(soc->hal_soc,
  325. soc->tcl_data_ring[pdev->pdev_id].hal_srng);
  326. }
  327. return QDF_STATUS_SUCCESS;
  328. }
  329. #ifndef FEATURE_WDS
  330. static inline void dp_tx_mec_handler(struct dp_vdev *vdev, uint8_t *status)
  331. {
  332. return;
  333. }
  334. #endif
  335. #ifndef QCA_MULTIPASS_SUPPORT
  336. static inline
  337. bool dp_tx_multipass_process(struct dp_soc *soc, struct dp_vdev *vdev,
  338. qdf_nbuf_t nbuf,
  339. struct dp_tx_msdu_info_s *msdu_info)
  340. {
  341. return true;
  342. }
  343. static inline
  344. void dp_tx_vdev_multipass_deinit(struct dp_vdev *vdev)
  345. {
  346. }
  347. #else
  348. bool dp_tx_multipass_process(struct dp_soc *soc, struct dp_vdev *vdev,
  349. qdf_nbuf_t nbuf,
  350. struct dp_tx_msdu_info_s *msdu_info);
  351. void dp_tx_vdev_multipass_deinit(struct dp_vdev *vdev);
  352. #endif
  353. /**
  354. * dp_tx_hw_to_qdf()- convert hw status to qdf status
  355. * @status: hw status
  356. *
  357. * Return: qdf tx rx status
  358. */
  359. static inline enum qdf_dp_tx_rx_status dp_tx_hw_to_qdf(uint16_t status)
  360. {
  361. switch (status) {
  362. case HAL_TX_TQM_RR_FRAME_ACKED:
  363. return QDF_TX_RX_STATUS_OK;
  364. case HAL_TX_TQM_RR_REM_CMD_TX:
  365. return QDF_TX_RX_STATUS_NO_ACK;
  366. case HAL_TX_TQM_RR_REM_CMD_REM:
  367. case HAL_TX_TQM_RR_REM_CMD_NOTX:
  368. case HAL_TX_TQM_RR_REM_CMD_AGED:
  369. return QDF_TX_RX_STATUS_FW_DISCARD;
  370. default:
  371. return QDF_TX_RX_STATUS_DEFAULT;
  372. }
  373. }
  374. #ifndef QCA_HOST_MODE_WIFI_DISABLED
  375. /**
  376. * dp_tx_get_queue() - Returns Tx queue IDs to be used for this Tx frame
  377. * @vdev: DP Virtual device handle
  378. * @nbuf: Buffer pointer
  379. * @queue: queue ids container for nbuf
  380. *
  381. * TX packet queue has 2 instances, software descriptors id and dma ring id
  382. * Based on tx feature and hardware configuration queue id combination could be
  383. * different.
  384. * For example -
  385. * With XPS enabled,all TX descriptor pools and dma ring are assigned per cpu id
  386. * With no XPS,lock based resource protection, Descriptor pool ids are different
  387. * for each vdev, dma ring id will be same as single pdev id
  388. *
  389. * Return: None
  390. */
  391. #ifdef QCA_OL_TX_MULTIQ_SUPPORT
  392. static inline void dp_tx_get_queue(struct dp_vdev *vdev,
  393. qdf_nbuf_t nbuf, struct dp_tx_queue *queue)
  394. {
  395. uint16_t queue_offset = qdf_nbuf_get_queue_mapping(nbuf) &
  396. DP_TX_QUEUE_MASK;
  397. queue->desc_pool_id = queue_offset;
  398. queue->ring_id = qdf_get_cpu();
  399. dp_tx_debug("pool_id:%d ring_id: %d",
  400. queue->desc_pool_id, queue->ring_id);
  401. }
  402. /*
  403. * dp_tx_get_hal_ring_hdl()- Get the hal_tx_ring_hdl for data transmission
  404. * @dp_soc - DP soc structure pointer
  405. * @ring_id - Transmit Queue/ring_id to be used when XPS is enabled
  406. *
  407. * Return - HAL ring handle
  408. */
  409. static inline hal_ring_handle_t dp_tx_get_hal_ring_hdl(struct dp_soc *soc,
  410. uint8_t ring_id)
  411. {
  412. if (ring_id == soc->num_tcl_data_rings)
  413. return soc->tcl_cmd_credit_ring.hal_srng;
  414. return soc->tcl_data_ring[ring_id].hal_srng;
  415. }
  416. #else /* QCA_OL_TX_MULTIQ_SUPPORT */
  417. #ifdef TX_MULTI_TCL
  418. #ifdef IPA_OFFLOAD
  419. static inline void dp_tx_get_queue(struct dp_vdev *vdev,
  420. qdf_nbuf_t nbuf, struct dp_tx_queue *queue)
  421. {
  422. /* get flow id */
  423. queue->desc_pool_id = DP_TX_GET_DESC_POOL_ID(vdev);
  424. if (vdev->pdev->soc->wlan_cfg_ctx->ipa_enabled)
  425. queue->ring_id = DP_TX_GET_RING_ID(vdev);
  426. else
  427. queue->ring_id = (qdf_nbuf_get_queue_mapping(nbuf) %
  428. vdev->pdev->soc->num_tcl_data_rings);
  429. }
  430. #else
  431. static inline void dp_tx_get_queue(struct dp_vdev *vdev,
  432. qdf_nbuf_t nbuf, struct dp_tx_queue *queue)
  433. {
  434. /* get flow id */
  435. queue->desc_pool_id = DP_TX_GET_DESC_POOL_ID(vdev);
  436. queue->ring_id = (qdf_nbuf_get_queue_mapping(nbuf) %
  437. vdev->pdev->soc->num_tcl_data_rings);
  438. }
  439. #endif
  440. #else
  441. static inline void dp_tx_get_queue(struct dp_vdev *vdev,
  442. qdf_nbuf_t nbuf, struct dp_tx_queue *queue)
  443. {
  444. /* get flow id */
  445. queue->desc_pool_id = DP_TX_GET_DESC_POOL_ID(vdev);
  446. queue->ring_id = DP_TX_GET_RING_ID(vdev);
  447. }
  448. #endif
  449. static inline hal_ring_handle_t dp_tx_get_hal_ring_hdl(struct dp_soc *soc,
  450. uint8_t ring_id)
  451. {
  452. return soc->tcl_data_ring[ring_id].hal_srng;
  453. }
  454. #endif
  455. #ifdef QCA_OL_TX_LOCK_LESS_ACCESS
  456. /*
  457. * dp_tx_hal_ring_access_start()- hal_tx_ring access for data transmission
  458. * @dp_soc - DP soc structure pointer
  459. * @hal_ring_hdl - HAL ring handle
  460. *
  461. * Return - None
  462. */
  463. static inline int dp_tx_hal_ring_access_start(struct dp_soc *soc,
  464. hal_ring_handle_t hal_ring_hdl)
  465. {
  466. return hal_srng_access_start_unlocked(soc->hal_soc, hal_ring_hdl);
  467. }
  468. /*
  469. * dp_tx_hal_ring_access_end()- hal_tx_ring access for data transmission
  470. * @dp_soc - DP soc structure pointer
  471. * @hal_ring_hdl - HAL ring handle
  472. *
  473. * Return - None
  474. */
  475. static inline void dp_tx_hal_ring_access_end(struct dp_soc *soc,
  476. hal_ring_handle_t hal_ring_hdl)
  477. {
  478. hal_srng_access_end_unlocked(soc->hal_soc, hal_ring_hdl);
  479. }
  480. /*
  481. * dp_tx_hal_ring_access_reap()- hal_tx_ring access for data transmission
  482. * @dp_soc - DP soc structure pointer
  483. * @hal_ring_hdl - HAL ring handle
  484. *
  485. * Return - None
  486. */
  487. static inline void dp_tx_hal_ring_access_end_reap(struct dp_soc *soc,
  488. hal_ring_handle_t
  489. hal_ring_hdl)
  490. {
  491. }
  492. #else
  493. static inline int dp_tx_hal_ring_access_start(struct dp_soc *soc,
  494. hal_ring_handle_t hal_ring_hdl)
  495. {
  496. return hal_srng_access_start(soc->hal_soc, hal_ring_hdl);
  497. }
  498. static inline void dp_tx_hal_ring_access_end(struct dp_soc *soc,
  499. hal_ring_handle_t hal_ring_hdl)
  500. {
  501. hal_srng_access_end(soc->hal_soc, hal_ring_hdl);
  502. }
  503. static inline void dp_tx_hal_ring_access_end_reap(struct dp_soc *soc,
  504. hal_ring_handle_t
  505. hal_ring_hdl)
  506. {
  507. hal_srng_access_end_reap(soc->hal_soc, hal_ring_hdl);
  508. }
  509. #endif
  510. #ifdef ATH_TX_PRI_OVERRIDE
  511. #define DP_TX_TID_OVERRIDE(_msdu_info, _nbuf) \
  512. ((_msdu_info)->tid = qdf_nbuf_get_priority(_nbuf))
  513. #else
  514. #define DP_TX_TID_OVERRIDE(_msdu_info, _nbuf)
  515. #endif
  516. /* TODO TX_FEATURE_NOT_YET */
  517. static inline void dp_tx_comp_process_exception(struct dp_tx_desc_s *tx_desc)
  518. {
  519. return;
  520. }
  521. /* TODO TX_FEATURE_NOT_YET */
  522. void dp_tx_desc_flush(struct dp_pdev *pdev, struct dp_vdev *vdev,
  523. bool force_free);
  524. QDF_STATUS dp_tx_vdev_attach(struct dp_vdev *vdev);
  525. QDF_STATUS dp_tx_vdev_detach(struct dp_vdev *vdev);
  526. void dp_tx_vdev_update_search_flags(struct dp_vdev *vdev);
  527. QDF_STATUS dp_soc_tx_desc_sw_pools_alloc(struct dp_soc *soc);
  528. QDF_STATUS dp_soc_tx_desc_sw_pools_init(struct dp_soc *soc);
  529. void dp_soc_tx_desc_sw_pools_free(struct dp_soc *soc);
  530. void dp_soc_tx_desc_sw_pools_deinit(struct dp_soc *soc);
  531. void
  532. dp_handle_wbm_internal_error(struct dp_soc *soc, void *hal_desc,
  533. uint32_t buf_type);
  534. #else /* QCA_HOST_MODE_WIFI_DISABLED */
  535. static inline
  536. QDF_STATUS dp_soc_tx_desc_sw_pools_alloc(struct dp_soc *soc)
  537. {
  538. return QDF_STATUS_SUCCESS;
  539. }
  540. static inline
  541. QDF_STATUS dp_soc_tx_desc_sw_pools_init(struct dp_soc *soc)
  542. {
  543. return QDF_STATUS_SUCCESS;
  544. }
  545. static inline void dp_soc_tx_desc_sw_pools_free(struct dp_soc *soc)
  546. {
  547. }
  548. static inline void dp_soc_tx_desc_sw_pools_deinit(struct dp_soc *soc)
  549. {
  550. }
  551. static inline
  552. void dp_tx_desc_flush(struct dp_pdev *pdev, struct dp_vdev *vdev,
  553. bool force_free)
  554. {
  555. }
  556. static inline QDF_STATUS dp_tx_vdev_attach(struct dp_vdev *vdev)
  557. {
  558. return QDF_STATUS_SUCCESS;
  559. }
  560. static inline QDF_STATUS dp_tx_vdev_detach(struct dp_vdev *vdev)
  561. {
  562. return QDF_STATUS_SUCCESS;
  563. }
  564. static inline void dp_tx_vdev_update_search_flags(struct dp_vdev *vdev)
  565. {
  566. }
  567. #endif /* QCA_HOST_MODE_WIFI_DISABLED */
  568. #ifdef FEATURE_PERPKT_INFO
  569. QDF_STATUS
  570. dp_get_completion_indication_for_stack(struct dp_soc *soc,
  571. struct dp_pdev *pdev,
  572. struct dp_peer *peer,
  573. struct hal_tx_completion_status *ts,
  574. qdf_nbuf_t netbuf,
  575. uint64_t time_latency);
  576. void dp_send_completion_to_stack(struct dp_soc *soc, struct dp_pdev *pdev,
  577. uint16_t peer_id, uint32_t ppdu_id,
  578. qdf_nbuf_t netbuf);
  579. #else
  580. static inline
  581. QDF_STATUS dp_get_completion_indication_for_stack(struct dp_soc *soc,
  582. struct dp_pdev *pdev,
  583. struct dp_peer *peer,
  584. struct hal_tx_completion_status *ts,
  585. qdf_nbuf_t netbuf,
  586. uint64_t time_latency)
  587. {
  588. return QDF_STATUS_E_NOSUPPORT;
  589. }
  590. static inline
  591. void dp_send_completion_to_stack(struct dp_soc *soc, struct dp_pdev *pdev,
  592. uint16_t peer_id, uint32_t ppdu_id,
  593. qdf_nbuf_t netbuf)
  594. {
  595. }
  596. #endif
  597. #ifdef WLAN_FEATURE_PKT_CAPTURE_V2
  598. void dp_send_completion_to_pkt_capture(struct dp_soc *soc,
  599. struct dp_tx_desc_s *desc,
  600. struct hal_tx_completion_status *ts);
  601. #else
  602. static inline void
  603. dp_send_completion_to_pkt_capture(struct dp_soc *soc,
  604. struct dp_tx_desc_s *desc,
  605. struct hal_tx_completion_status *ts)
  606. {
  607. }
  608. #endif
  609. #ifndef QCA_HOST_MODE_WIFI_DISABLED
  610. #ifdef WLAN_DP_FEATURE_SW_LATENCY_MGR
  611. /**
  612. * dp_tx_update_stats() - Update soc level tx stats
  613. * @soc: DP soc handle
  614. * @nbuf: packet being transmitted
  615. *
  616. * Returns: none
  617. */
  618. void dp_tx_update_stats(struct dp_soc *soc,
  619. qdf_nbuf_t nbuf);
  620. /**
  621. * dp_tx_attempt_coalescing() - Check and attempt TCL register write coalescing
  622. * @soc: Datapath soc handle
  623. * @tx_desc: tx packet descriptor
  624. * @tid: TID for pkt transmission
  625. *
  626. * Returns: 1, if coalescing is to be done
  627. * 0, if coalescing is not to be done
  628. */
  629. int
  630. dp_tx_attempt_coalescing(struct dp_soc *soc, struct dp_vdev *vdev,
  631. struct dp_tx_desc_s *tx_desc,
  632. uint8_t tid);
  633. /**
  634. * dp_tx_ring_access_end() - HAL ring access end for data transmission
  635. * @soc: Datapath soc handle
  636. * @hal_ring_hdl: HAL ring handle
  637. * @coalesce: Coalesce the current write or not
  638. *
  639. * Returns: none
  640. */
  641. void
  642. dp_tx_ring_access_end(struct dp_soc *soc, hal_ring_handle_t hal_ring_hdl,
  643. int coalesce);
  644. #else
  645. /**
  646. * dp_tx_update_stats() - Update soc level tx stats
  647. * @soc: DP soc handle
  648. * @nbuf: packet being transmitted
  649. *
  650. * Returns: none
  651. */
  652. static inline void dp_tx_update_stats(struct dp_soc *soc,
  653. qdf_nbuf_t nbuf) { }
  654. static inline void
  655. dp_tx_ring_access_end(struct dp_soc *soc, hal_ring_handle_t hal_ring_hdl,
  656. int coalesce)
  657. {
  658. dp_tx_hal_ring_access_end(soc, hal_ring_hdl);
  659. }
  660. static inline int
  661. dp_tx_attempt_coalescing(struct dp_soc *soc, struct dp_vdev *vdev,
  662. struct dp_tx_desc_s *tx_desc,
  663. uint8_t tid)
  664. {
  665. return 0;
  666. }
  667. #endif /* WLAN_DP_FEATURE_SW_LATENCY_MGR */
  668. #ifdef FEATURE_RUNTIME_PM
  669. /**
  670. * dp_set_rtpm_tput_policy_requirement() - Update RTPM throughput policy
  671. * @soc_hdl: DP soc handle
  672. * @is_high_tput: flag to indicate whether throughput is high
  673. *
  674. * Returns: none
  675. */
  676. static inline
  677. void dp_set_rtpm_tput_policy_requirement(struct cdp_soc_t *soc_hdl,
  678. bool is_high_tput)
  679. {
  680. struct dp_soc *soc = cdp_soc_t_to_dp_soc(soc_hdl);
  681. qdf_atomic_set(&soc->rtpm_high_tput_flag, is_high_tput);
  682. }
  683. void
  684. dp_tx_ring_access_end_wrapper(struct dp_soc *soc,
  685. hal_ring_handle_t hal_ring_hdl,
  686. int coalesce);
  687. #else
  688. #ifdef DP_POWER_SAVE
  689. void
  690. dp_tx_ring_access_end_wrapper(struct dp_soc *soc,
  691. hal_ring_handle_t hal_ring_hdl,
  692. int coalesce);
  693. #else
  694. static inline void
  695. dp_tx_ring_access_end_wrapper(struct dp_soc *soc,
  696. hal_ring_handle_t hal_ring_hdl,
  697. int coalesce)
  698. {
  699. dp_tx_ring_access_end(soc, hal_ring_hdl, coalesce);
  700. }
  701. #endif
  702. static inline void
  703. dp_set_rtpm_tput_policy_requirement(struct cdp_soc_t *soc_hdl,
  704. bool is_high_tput)
  705. { }
  706. #endif
  707. #endif /* QCA_HOST_MODE_WIFI_DISABLED */
  708. #ifdef DP_TX_HW_DESC_HISTORY
  709. static inline void
  710. dp_tx_hw_desc_update_evt(uint8_t *hal_tx_desc_cached,
  711. hal_ring_handle_t hal_ring_hdl,
  712. struct dp_soc *soc)
  713. {
  714. struct dp_tx_hw_desc_evt *evt;
  715. uint64_t idx = 0;
  716. if (!soc->tx_hw_desc_history)
  717. return;
  718. idx = ++soc->tx_hw_desc_history->index;
  719. if (idx == DP_TX_HW_DESC_HIST_MAX)
  720. soc->tx_hw_desc_history->index = 0;
  721. idx = qdf_do_div_rem(idx, DP_TX_HW_DESC_HIST_MAX);
  722. evt = &soc->tx_hw_desc_history->entry[idx];
  723. qdf_mem_copy(evt->tcl_desc, hal_tx_desc_cached, HAL_TX_DESC_LEN_BYTES);
  724. evt->posted = qdf_get_log_timestamp();
  725. hal_get_sw_hptp(soc->hal_soc, hal_ring_hdl, &evt->tp, &evt->hp);
  726. }
  727. #else
  728. static inline void
  729. dp_tx_hw_desc_update_evt(uint8_t *hal_tx_desc_cached,
  730. hal_ring_handle_t hal_ring_hdl,
  731. struct dp_soc *soc)
  732. {
  733. }
  734. #endif
  735. #ifdef WLAN_FEATURE_TSF_UPLINK_DELAY
  736. /**
  737. * dp_set_delta_tsf() - Set delta_tsf to dp_soc structure
  738. * @soc_hdl: cdp soc pointer
  739. * @vdev_id: vdev id
  740. * @delta_tsf: difference between TSF clock and qtimer
  741. *
  742. * Return: None
  743. */
  744. void dp_set_delta_tsf(struct cdp_soc_t *soc_hdl, uint8_t vdev_id,
  745. uint32_t delta_tsf);
  746. /**
  747. * dp_set_tsf_report_ul_delay() - Enable or disable reporting uplink delay
  748. * @soc_hdl: cdp soc pointer
  749. * @vdev_id: vdev id
  750. * @enable: true to enable and false to disable
  751. *
  752. * Return: QDF_STATUS
  753. */
  754. QDF_STATUS dp_set_tsf_ul_delay_report(struct cdp_soc_t *soc_hdl,
  755. uint8_t vdev_id, bool enable);
  756. /**
  757. * dp_get_uplink_delay() - Get uplink delay value
  758. * @soc_hdl: cdp soc pointer
  759. * @vdev_id: vdev id
  760. * @val: pointer to save uplink delay value
  761. *
  762. * Return: QDF_STATUS
  763. */
  764. QDF_STATUS dp_get_uplink_delay(struct cdp_soc_t *soc_hdl, uint8_t vdev_id,
  765. uint32_t *val);
  766. #endif /* WLAN_FEATURE_TSF_UPLINK_TSF */
  767. /**
  768. * dp_tx_pkt_tracepoints_enabled() - Get the state of tx pkt tracepoint
  769. *
  770. * Return: True if any tx pkt tracepoint is enabled else false
  771. */
  772. static inline
  773. bool dp_tx_pkt_tracepoints_enabled(void)
  774. {
  775. return (qdf_trace_dp_tx_comp_tcp_pkt_enabled() ||
  776. qdf_trace_dp_tx_comp_udp_pkt_enabled() ||
  777. qdf_trace_dp_tx_comp_pkt_enabled());
  778. }
  779. #endif