WCN6450 is a chip based on Rhine architecture. Unlike LI/BE targets, chipsets based on Rhine (RH) do not have host facing UMAC HW blocks. Their corresponding SRNG interfaces are also removed. The functionality of these UMAC HW blocks is replaced with a software implementation in the firmware. Communication between the driver and firmware will happen over copy engine (CE). Although there are no host facing UMAC HW blocks, the CE hardware used in WCN6450 expects the host driver to use the TX descriptor (HW) format of LI targets during TX packet enqueue. Therefore it is required to create a new pool of TX descriptors (HW) pool for WCN6450 that is used during TX. The logic to create/free/init/deinit these descriptors is specific to WCN6450/Rhine, therefore it is implemented in architecture specific Rhine code. Introduce new APIs in struct dp_arch_ops {} to allocate and free arch specific TX descriptors. These ops will be no-op for LI/BE architectures. Also for Rhine targets, allocate/free other TX descriptors like TX EXT & TSO descriptors as part of the arch APIs. Change-Id: I452ac69143395881ab8580355a0f75571dc3e929 CRs-Fixed: 3381711
130 lignes
4.1 KiB
C
130 lignes
4.1 KiB
C
/*
|
|
* Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
|
|
* Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for
|
|
* any purpose with or without fee is hereby granted, provided that the
|
|
* above copyright notice and this permission notice appear in all
|
|
* copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
|
|
* WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
|
|
* AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
|
|
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
* PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
#ifndef __DP_LI_TX_H
|
|
#define __DP_LI_TX_H
|
|
|
|
#include <dp_types.h>
|
|
|
|
/**
|
|
* dp_tx_hw_enqueue_li() - Enqueue to TCL HW for transmit
|
|
* @soc: DP Soc Handle
|
|
* @vdev: DP vdev handle
|
|
* @tx_desc: Tx Descriptor Handle
|
|
* @fw_metadata: Metadata to send to Target Firmware along with frame
|
|
* @tx_exc_metadata: Handle that holds exception path meta data
|
|
* @msdu_info: MSDU information
|
|
*
|
|
* Gets the next free TCL HW DMA descriptor and sets up required parameters
|
|
* from software Tx descriptor
|
|
*
|
|
* Return: QDF_STATUS_SUCCESS: success
|
|
* QDF_STATUS_E_RESOURCES: Error return
|
|
*/
|
|
QDF_STATUS
|
|
dp_tx_hw_enqueue_li(struct dp_soc *soc, struct dp_vdev *vdev,
|
|
struct dp_tx_desc_s *tx_desc, uint16_t fw_metadata,
|
|
struct cdp_tx_exception_metadata *tx_exc_metadata,
|
|
struct dp_tx_msdu_info_s *msdu_info);
|
|
/**
|
|
* dp_tx_comp_get_params_from_hal_desc_li() - Get TX desc from HAL comp desc
|
|
* @soc: DP soc handle
|
|
* @tx_comp_hal_desc: HAL TX Comp Descriptor
|
|
* @r_tx_desc: SW Tx Descriptor retrieved from HAL desc.
|
|
*
|
|
* Return: None
|
|
*/
|
|
void dp_tx_comp_get_params_from_hal_desc_li(struct dp_soc *soc,
|
|
void *tx_comp_hal_desc,
|
|
struct dp_tx_desc_s **r_tx_desc);
|
|
|
|
/**
|
|
* dp_tx_process_htt_completion_li() - Tx HTT Completion Indication Handler
|
|
* @soc: Handle to DP soc structure
|
|
* @tx_desc: software descriptor head pointer
|
|
* @status: Tx completion status from HTT descriptor
|
|
* @ring_id: ring number
|
|
*
|
|
* This function will process HTT Tx indication messages from Target
|
|
*
|
|
* Return: none
|
|
*/
|
|
void dp_tx_process_htt_completion_li(struct dp_soc *soc,
|
|
struct dp_tx_desc_s *tx_desc,
|
|
uint8_t *status,
|
|
uint8_t ring_id);
|
|
|
|
/**
|
|
* dp_tx_desc_pool_init_li() - Initialize Tx Descriptor pool(s)
|
|
* @soc: Handle to DP Soc structure
|
|
* @num_elem: pool descriptor number
|
|
* @pool_id: pool to allocate
|
|
*
|
|
* Return: QDF_STATUS_SUCCESS - success, others - failure
|
|
*/
|
|
QDF_STATUS dp_tx_desc_pool_init_li(struct dp_soc *soc,
|
|
uint32_t num_elem,
|
|
uint8_t pool_id);
|
|
|
|
/**
|
|
* dp_tx_desc_pool_deinit_li() - De-initialize Tx Descriptor pool(s)
|
|
* @soc: Handle to DP Soc structure
|
|
* @tx_desc_pool: Tx descriptor pool handler
|
|
* @pool_id: pool to deinit
|
|
*
|
|
* Return: None.
|
|
*/
|
|
void dp_tx_desc_pool_deinit_li(struct dp_soc *soc,
|
|
struct dp_tx_desc_pool_s *tx_desc_pool,
|
|
uint8_t pool_id);
|
|
|
|
/**
|
|
* dp_tx_compute_tx_delay_li() - Compute HW Tx completion delay
|
|
* @soc: Handle to DP Soc structure
|
|
* @vdev: vdev
|
|
* @ts: Tx completion status
|
|
* @delay_us: Delay to be calculated in microseconds
|
|
*
|
|
* Return: QDF_STATUS
|
|
*/
|
|
QDF_STATUS dp_tx_compute_tx_delay_li(struct dp_soc *soc,
|
|
struct dp_vdev *vdev,
|
|
struct hal_tx_completion_status *ts,
|
|
uint32_t *delay_us);
|
|
|
|
/**
|
|
* dp_tx_desc_pool_alloc_li() - Allocate TX descriptor pool
|
|
* @soc: Handle to DP Soc structure
|
|
* @num_elem: Number of elements to allocate
|
|
* @pool_id: TCL descriptor pool ID
|
|
*
|
|
* Return: QDF_STATUS
|
|
*/
|
|
QDF_STATUS dp_tx_desc_pool_alloc_li(struct dp_soc *soc, uint32_t num_elem,
|
|
uint8_t pool_id);
|
|
|
|
/**
|
|
* dp_tx_desc_pool_free_li() - Free TX descriptor pool
|
|
* @soc: Handle to DP Soc structure
|
|
* @pool_id: TCL descriptor pool ID
|
|
*
|
|
* Return: none
|
|
*/
|
|
void dp_tx_desc_pool_free_li(struct dp_soc *soc, uint8_t pool_id);
|
|
#endif
|