samsung-sm8650/android_kernel_samsung_sm8650-modules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

qcacmn: Fix hal/wifi3.0/be documentation

Browse Source 
The kernel-doc script identified some documentation issues in the
hal/wifi3.0/be folder, so fix them.

Change-Id: I9730c36e4d36dbe0ae551067c5c500441f07569f
CRs-Fixed: 3400933
This commit is contained in:
Jeff Johnson
2023-02-08 17:24:55 -08:00
committed by Madan Koyyalamudi
parent 7453254a0c
commit f518df0727
8 changed files with 445 additions and 441 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
hal/wifi3.0/be/hal_be_api.h
View File

@@ -1,6 +1,6 @@
/* /*
* Copyright (c) 2016-2021 The Linux Foundation. All rights reserved. * Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021-2022, Qualcomm Innovation Center, Inc. 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 * Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the * any purpose with or without fee is hereby granted, provided that the
@@ -31,8 +31,8 @@ RX_MSDU_DETAILS_RX_MSDU_EXT_DESC_INFO_DETAILS_RESERVED_0A_OFFSET))
/** /**
* hal_reo_setup_generic_be - Initialize HW REO block * hal_reo_setup_generic_be - Initialize HW REO block
* *
* @hal_soc: Opaque HAL SOC handle * @soc: Opaque HAL SOC handle
* @reo_params: parameters needed by HAL for REO config * @reoparams: parameters needed by HAL for REO config
* @qref_reset: reset qref * @qref_reset: reset qref
*/ */
void hal_reo_setup_generic_be(struct hal_soc *soc, void hal_reo_setup_generic_be(struct hal_soc *soc,
@@ -62,21 +62,37 @@ void hal_set_link_desc_addr_be(void *desc, uint32_t cookie,
uint8_t bm_id); uint8_t bm_id);
/** /**
* hal_hw_txrx_default_ops_attach_be(): Add default ops for BE chips * hal_hw_txrx_default_ops_attach_be() - Add default ops for BE chips
* @ hal_soc_hdl: hal_soc handle * @soc: hal_soc handle
* *
* Return: None * Return: None
*/ */
void hal_hw_txrx_default_ops_attach_be(struct hal_soc *soc); void hal_hw_txrx_default_ops_attach_be(struct hal_soc *soc);
uint32_t hal_tx_comp_get_buffer_source_generic_be(void *hal_desc); uint32_t hal_tx_comp_get_buffer_source_generic_be(void *hal_desc);
/**
* hal_rx_ret_buf_manager_get_be() - Get return buffer manager from ring desc
* @ring_desc: ring descriptor
*
* Return: rbm
*/
uint8_t hal_rx_ret_buf_manager_get_be(hal_ring_desc_t ring_desc); uint8_t hal_rx_ret_buf_manager_get_be(hal_ring_desc_t ring_desc);
/**
* hal_rx_wbm_err_info_get_generic_be() - Retrieves WBM error code and reason and
* save it to hal_wbm_err_desc_info structure passed by caller
* @wbm_desc: wbm ring descriptor
* @wbm_er_info1: hal_wbm_err_desc_info structure, output parameter.
*
* Return: void
*/
void hal_rx_wbm_err_info_get_generic_be(void *wbm_desc, void *wbm_er_info1); void hal_rx_wbm_err_info_get_generic_be(void *wbm_desc, void *wbm_er_info1);
/** /**
* hal_reo_qdesc_setup - Setup HW REO queue descriptor * hal_reo_qdesc_setup_be() - Setup HW REO queue descriptor
* * @hal_soc_hdl: Opaque HAL SOC handle
* @hal_soc: Opaque HAL SOC handle * @tid: TID
* @ba_window_size: BlockAck window size * @ba_window_size: BlockAck window size
* @start_seq: Starting sequence number * @start_seq: Starting sequence number
* @hw_qdesc_vaddr: Virtual address of REO queue descriptor memory * @hw_qdesc_vaddr: Virtual address of REO queue descriptor memory
@@ -93,7 +109,7 @@ void hal_reo_qdesc_setup_be(hal_soc_handle_t hal_soc_hdl,
/** /**
* hal_cookie_conversion_reg_cfg_be() - set cookie conversion relevant register * hal_cookie_conversion_reg_cfg_be() - set cookie conversion relevant register
* for REO/WBM * for REO/WBM
* @soc: HAL soc handle * @hal_soc_hdl: Handle to HAL SoC structure
* @cc_cfg: structure pointer for HW cookie conversion configuration * @cc_cfg: structure pointer for HW cookie conversion configuration
* *
* Return: None * Return: None
@@ -102,13 +118,12 @@ void hal_cookie_conversion_reg_cfg_be(hal_soc_handle_t hal_soc_hdl,
struct hal_hw_cc_config *cc_cfg); struct hal_hw_cc_config *cc_cfg);
/** /**
* hal_reo_ix_remap_value_get() - Calculate reo remap register value from * hal_reo_ix_remap_value_get_be() - Calculate reo remap register value from
* ring_id_mask which is used for hash based * ring_id_mask which is used for hash based
* reo distribution * reo distribution
* * @hal_soc_hdl: Handle to HAL SoC structure
* @hal_soc: Handle to HAL SoC structure * @rx_ring_mask: mask value indicating the rx rings 0th bit set indicate
* @ring_id_mask: mask value indicating the rx rings 0th bit set indicate * REO2SW1 is included in hash distribution
* REO2SW1 is included in hash distribution
* *
* Return: REO remap value * Return: REO remap value
*/ */
@@ -118,8 +133,7 @@ hal_reo_ix_remap_value_get_be(hal_soc_handle_t hal_soc_hdl,
/** /**
* hal_reo_ring_remap_value_get_be() - return REO remap value * hal_reo_ring_remap_value_get_be() - return REO remap value
* * @rx_ring_id: REO2SW ring mask
* @ring_id: REO2SW ring id
* *
* Return: REO remap value * Return: REO remap value
*/ */

55
hal/wifi3.0/be/hal_be_api_mon.h
View File

@@ -622,12 +622,12 @@ struct hal_rx_status_buffer_done {
}; };
/** /**
* hal_mon_status_end_reason : ppdu status buffer end reason * enum hal_mon_status_end_reason - ppdu status buffer end reason
* *
* @HAL_MON_STATUS_BUFFER_FULL: status buffer full * @HAL_MON_STATUS_BUFFER_FULL: status buffer full
* @HAL_MON_FLUSH_DETECTED: flush detected * @HAL_MON_FLUSH_DETECTED: flush detected
* @HAL_MON_END_OF_PPDU: end of ppdu detected * @HAL_MON_END_OF_PPDU: end of ppdu detected
* HAL_MON_PPDU_truncated: truncated ppdu status * @HAL_MON_PPDU_TRUNCATED: truncated ppdu status
*/ */
enum hal_mon_status_end_reason { enum hal_mon_status_end_reason {
HAL_MON_STATUS_BUFFER_FULL, HAL_MON_STATUS_BUFFER_FULL,
@@ -637,7 +637,7 @@ enum hal_mon_status_end_reason {
}; };
/** /**
* struct hal_mon_desc () - HAL Monitor descriptor * struct hal_mon_desc - HAL Monitor descriptor
* *
* @buf_addr: virtual buffer address * @buf_addr: virtual buffer address
* @ppdu_id: ppdu id * @ppdu_id: ppdu id
@@ -645,7 +645,9 @@ enum hal_mon_status_end_reason {
* - RxMON fills phy_ppdu_id * - RxMON fills phy_ppdu_id
* @end_offset: offset (units in 4 bytes) where status buffer ended * @end_offset: offset (units in 4 bytes) where status buffer ended
* i.e offset of TLV + last TLV size * i.e offset of TLV + last TLV size
* @end_reason: 0 - status buffer is full * @reserved_3a: reserved bits
* @end_reason: ppdu end reason
* 0 - status buffer is full
* 1 - flush detected * 1 - flush detected
* 2 - TX_FES_STATUS_END or RX_PPDU_END * 2 - TX_FES_STATUS_END or RX_PPDU_END
* 3 - PPDU truncated due to system error * 3 - PPDU truncated due to system error
@@ -658,7 +660,6 @@ enum hal_mon_status_end_reason {
* @looping_count: count to indicate number of times producer * @looping_count: count to indicate number of times producer
* of entries has looped around the ring * of entries has looped around the ring
* @flush_detected: if flush detected * @flush_detected: if flush detected
* @end_reason: ppdu end reason
* @end_of_ppdu_dropped: if end_of_ppdu is dropped * @end_of_ppdu_dropped: if end_of_ppdu is dropped
* @ppdu_drop_count: PPDU drop count * @ppdu_drop_count: PPDU drop count
* @mpdu_drop_count: MPDU drop count * @mpdu_drop_count: MPDU drop count
@@ -684,14 +685,16 @@ struct hal_mon_desc {
typedef struct hal_mon_desc *hal_mon_desc_t; typedef struct hal_mon_desc *hal_mon_desc_t;
/** /**
* struct hal_mon_buf_addr_status () - HAL buffer address tlv get status * struct hal_mon_buf_addr_status - HAL buffer address tlv get status
* *
* @buf_addr_31_0: Lower 32 bits of virtual address of status buffer * @buffer_virt_addr_31_0: Lower 32 bits of virtual address of status buffer
* @buf_addr_63_32: Upper 32 bits of virtual address of status buffer * @buffer_virt_addr_63_32: Upper 32 bits of virtual address of status buffer
* @dma_length: DMA length * @dma_length: DMA length
* @reserved_2a: reserved bits
* @msdu_continuation: is msdu size more than fragment size * @msdu_continuation: is msdu size more than fragment size
* @truncated: is msdu got truncated * @truncated: is msdu got truncated
* @tlv_padding: tlv paddding * @reserved_2b: reserved bits
* @tlv64_padding: tlv paddding
*/ */
struct hal_mon_buf_addr_status { struct hal_mon_buf_addr_status {
uint32_t buffer_virt_addr_31_0; uint32_t buffer_virt_addr_31_0;
@@ -706,9 +709,10 @@ struct hal_mon_buf_addr_status {
#ifdef QCA_MONITOR_2_0_SUPPORT #ifdef QCA_MONITOR_2_0_SUPPORT
/** /**
* hal_be_get_mon_dest_status() - Get monitor descriptor * hal_be_get_mon_dest_status() - Get monitor descriptor status
* @hal_soc_hdl: HAL Soc handle * @hal_soc: HAL Soc handle
* @desc: HAL monitor descriptor * @hw_desc: HAL monitor descriptor
* @status: pointer to write descriptor status
* *
* Return: none * Return: none
*/ */
@@ -950,7 +954,8 @@ hal_update_frame_type_cnt(hal_rx_mon_mpdu_start_t *rx_mpdu_start,
* hal_mon_buff_addr_info_set() - set desc address in cookie * hal_mon_buff_addr_info_set() - set desc address in cookie
* @hal_soc_hdl: HAL Soc handle * @hal_soc_hdl: HAL Soc handle
* @mon_entry: monitor srng * @mon_entry: monitor srng
* @desc: HAL monitor descriptor * @mon_desc_addr: HAL monitor descriptor virtual address
* @phy_addr: HAL monitor descriptor physical address
* *
* Return: none * Return: none
*/ */
@@ -1087,6 +1092,11 @@ enum txmon_generated_response {
* @transmission_type: su or mu transmission type * @transmission_type: su or mu transmission type
* @medium_prot_type: medium protection type * @medium_prot_type: medium protection type
* @generated_response: Generated frame in response window * @generated_response: Generated frame in response window
* @band_center_freq1:
* @band_center_freq2:
* @freq:
* @phy_mode:
* @schedule_id:
* @no_bitmap_avail: Bitmap available flag * @no_bitmap_avail: Bitmap available flag
* @explicit_ack: Explicit Acknowledge flag * @explicit_ack: Explicit Acknowledge flag
* @explicit_ack_type: Explicit Acknowledge type * @explicit_ack_type: Explicit Acknowledge type
@@ -1094,8 +1104,13 @@ enum txmon_generated_response {
* @response_type: Response type in response window * @response_type: Response type in response window
* @ndp_frame: NDP frame * @ndp_frame: NDP frame
* @num_users: number of users * @num_users: number of users
* @reserved: reserved bits
* @mba_count: MBA count
* @mba_fake_bitmap_count: MBA fake bitmap count
* @sw_frame_group_id: software frame group ID * @sw_frame_group_id: software frame group ID
* @r2r_to_follow: Response to Response follow flag * @r2r_to_follow: Response to Response follow flag
* @phy_abort_reason: Reason for PHY abort
* @phy_abort_user_number: User number for PHY abort
* @buffer: Packet buffer pointer address * @buffer: Packet buffer pointer address
* @offset: Packet buffer offset * @offset: Packet buffer offset
* @length: Packet buffer length * @length: Packet buffer length
@@ -1194,7 +1209,7 @@ hal_tx_status_get_next_tlv(uint8_t *tx_tlv) {
/** /**
* hal_txmon_status_parse_tlv() - process transmit info TLV * hal_txmon_status_parse_tlv() - process transmit info TLV
* @hal_soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @data_ppdu_info: pointer to hal data ppdu info * @data_ppdu_info: pointer to hal data ppdu info
* @prot_ppdu_info: pointer to hal prot ppdu info * @prot_ppdu_info: pointer to hal prot ppdu info
* @data_status_info: pointer to data status info * @data_status_info: pointer to data status info
@@ -1226,7 +1241,7 @@ hal_txmon_status_parse_tlv(hal_soc_handle_t hal_soc_hdl,
/** /**
* hal_txmon_status_get_num_users() - api to get num users from start of fes * hal_txmon_status_get_num_users() - api to get num users from start of fes
* window * window
* @hal_soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @tx_tlv_hdr: pointer to TLV header * @tx_tlv_hdr: pointer to TLV header
* @num_users: reference to number of user * @num_users: reference to number of user
* *
@@ -1261,7 +1276,7 @@ hal_tx_status_get_tlv_tag(void *tx_tlv_hdr)
/** /**
* hal_txmon_is_mon_buf_addr_tlv() - api to find packet buffer addr tlv * hal_txmon_is_mon_buf_addr_tlv() - api to find packet buffer addr tlv
* @hal_soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @tx_tlv_hdr: pointer to TLV header * @tx_tlv_hdr: pointer to TLV header
* *
* Return: bool * Return: bool
@@ -1279,7 +1294,7 @@ hal_txmon_is_mon_buf_addr_tlv(hal_soc_handle_t hal_soc_hdl, void *tx_tlv_hdr)
/** /**
* hal_txmon_populate_packet_info() - api to populate packet info * hal_txmon_populate_packet_info() - api to populate packet info
* @hal_soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @tx_tlv_hdr: pointer to TLV header * @tx_tlv_hdr: pointer to TLV header
* @packet_info: pointer to placeholder for packet info * @packet_info: pointer to placeholder for packet info
* *
@@ -2210,9 +2225,11 @@ hal_update_rx_ctrl_frame_stats(struct hal_rx_ppdu_info *ppdu_info,
#endif /* WLAN_SUPPORT_CTRL_FRAME_STATS */ #endif /* WLAN_SUPPORT_CTRL_FRAME_STATS */
/** /**
* hal_rx_status_get_tlv_info() - process receive info TLV * hal_rx_status_get_tlv_info_generic_be() - process receive info TLV
* @rx_tlv_hdr: pointer to TLV header * @rx_tlv_hdr: pointer to TLV header
* @ppdu_info: pointer to ppdu_info * @ppduinfo: pointer to ppdu_info
* @hal_soc_hdl: HAL version of the SOC pointer
* @nbuf: Network buffer
* *
* Return: HAL_TLV_STATUS_PPDU_NOT_DONE or HAL_TLV_STATUS_PPDU_DONE from tlv * Return: HAL_TLV_STATUS_PPDU_NOT_DONE or HAL_TLV_STATUS_PPDU_DONE from tlv
*/ */

53
hal/wifi3.0/be/hal_be_generic_api.c
View File

@@ -1,6 +1,6 @@
/* /*
* Copyright (c) 2016-2021 The Linux Foundation. All rights reserved. * Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. 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 * Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the * any purpose with or without fee is hereby granted, provided that the
@@ -75,7 +75,7 @@ void hal_setup_reo_swap(struct hal_soc *soc)
/** /**
* hal_tx_init_data_ring_be() - Initialize all the TCL Descriptors in SRNG * hal_tx_init_data_ring_be() - Initialize all the TCL Descriptors in SRNG
* @hal_soc_hdl: Handle to HAL SoC structure * @hal_soc_hdl: Handle to HAL SoC structure
* @hal_srng: Handle to HAL SRNG structure * @hal_ring_hdl: Handle to HAL SRNG structure
* *
* Return: none * Return: none
*/ */
@@ -326,12 +326,6 @@ static uint32_t hal_rx_wbm_err_src_get_be(hal_ring_desc_t ring_desc)
HAL_BE_WBM_RELEASE_DIR_RX); HAL_BE_WBM_RELEASE_DIR_RX);
} }
/**
* hal_rx_ret_buf_manager_get_be() - Get return buffer manager from ring desc
* @ring_desc: ring descriptor
*
* Return: rbm
*/
uint8_t hal_rx_ret_buf_manager_get_be(hal_ring_desc_t ring_desc) uint8_t hal_rx_ret_buf_manager_get_be(hal_ring_desc_t ring_desc)
{ {
/* /*
@@ -364,13 +358,6 @@ uint8_t hal_rx_ret_buf_manager_get_be(hal_ring_desc_t ring_desc)
WBM2SW_COMPLETION_RING_RX_RXDMA_ERROR_CODE_MASK) >> \ WBM2SW_COMPLETION_RING_RX_RXDMA_ERROR_CODE_MASK) >> \
WBM2SW_COMPLETION_RING_RX_RXDMA_ERROR_CODE_LSB) WBM2SW_COMPLETION_RING_RX_RXDMA_ERROR_CODE_LSB)
/**
* hal_rx_wbm_err_info_get_generic_be(): Retrieves WBM error code and reason and
* save it to hal_wbm_err_desc_info structure passed by caller
* @wbm_desc: wbm ring descriptor
* @wbm_er_info1: hal_wbm_err_desc_info structure, output parameter.
* Return: void
*/
void hal_rx_wbm_err_info_get_generic_be(void *wbm_desc, void *wbm_er_info1) void hal_rx_wbm_err_info_get_generic_be(void *wbm_desc, void *wbm_er_info1)
{ {
struct hal_wbm_err_desc_info *wbm_er_info = struct hal_wbm_err_desc_info *wbm_er_info =
@@ -441,13 +428,11 @@ static void hal_rx_msdu_link_desc_set_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_rx_reo_ent_buf_paddr_get_be: Gets the physical address and * hal_rx_buf_cookie_rbm_get_be() - Get the cookie and return buffer
* cookie from the REO entrance ring element * manager from the REO entrance ring desc
* @buf_addr_info_hdl: Buffer address info element from ring desc
* @buf_info_hdl: structure to return the buffer information
* *
* @ hal_rx_desc_cookie: Opaque cookie pointer used by HAL to get to
* the current descriptor
* @ buf_info: structure to return the buffer information
* @ msdu_cnt: pointer to msdu count in MPDU
* Return: void * Return: void
*/ */
static static
@@ -468,7 +453,7 @@ void hal_rx_buf_cookie_rbm_get_be(uint32_t *buf_addr_info_hdl,
(hal_ring_desc_t)buf_addr_info); (hal_ring_desc_t)buf_addr_info);
} }
/* /**
* hal_rxdma_buff_addr_info_set_be() - set the buffer_addr_info of the * hal_rxdma_buff_addr_info_set_be() - set the buffer_addr_info of the
* rxdma ring entry. * rxdma ring entry.
* @rxdma_entry: descriptor entry * @rxdma_entry: descriptor entry
@@ -507,6 +492,7 @@ static uint32_t hal_rx_get_reo_error_code_be(hal_ring_desc_t rx_desc)
/** /**
* hal_gen_reo_remap_val_generic_be() - Generate the reo map value * hal_gen_reo_remap_val_generic_be() - Generate the reo map value
* @remap_reg: remap register
* @ix0_map: mapping values for reo * @ix0_map: mapping values for reo
* *
* Return: IX0 reo remap register value to be written * Return: IX0 reo remap register value to be written
@@ -681,9 +667,9 @@ hal_mpdu_desc_info_set_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_rx_msdu_reo_dst_ind_get: Gets the REO * hal_rx_msdu_reo_dst_ind_get_be() - Gets the REO destination ring ID
* destination ring ID from the msdu desc info * from the msdu desc info
* * @hal_soc_hdl: hal_soc handle
* @msdu_link_desc : Opaque cookie pointer used by HAL to get to * @msdu_link_desc : Opaque cookie pointer used by HAL to get to
* the current descriptor * the current descriptor
* *
@@ -809,7 +795,7 @@ hal_rx_wbm_rel_buf_paddr_get_be(hal_ring_desc_t rx_desc,
#ifdef DP_UMAC_HW_RESET_SUPPORT #ifdef DP_UMAC_HW_RESET_SUPPORT
/** /**
* hal_unregister_reo_send_cmd_be() - Unregister Reo send command callback. * hal_unregister_reo_send_cmd_be() - Unregister Reo send command callback.
* @hal_soc_hdl: HAL soc handle * @hal_soc: HAL soc handle
* *
* Return: None * Return: None
*/ */
@@ -821,7 +807,7 @@ void hal_unregister_reo_send_cmd_be(struct hal_soc *hal_soc)
/** /**
* hal_register_reo_send_cmd_be() - Register Reo send command callback. * hal_register_reo_send_cmd_be() - Register Reo send command callback.
* @hal_soc_hdl: HAL soc handle * @hal_soc: HAL soc handle
* *
* Return: None * Return: None
*/ */
@@ -833,9 +819,9 @@ void hal_register_reo_send_cmd_be(struct hal_soc *hal_soc)
/** /**
* hal_reset_rx_reo_tid_q_be() - reset the reo tid queue. * hal_reset_rx_reo_tid_q_be() - reset the reo tid queue.
* @hal_soc_hdl: HAL soc handle * @hal_soc: HAL soc handle
* @hw_qdesc_vaddr:start address of the tid queue * @hw_qdesc_vaddr: start address of the tid queue
* @size:size of address pointed by hw_qdesc_vaddr * @size: size of address pointed by hw_qdesc_vaddr
* *
* Return: None * Return: None
*/ */
@@ -928,13 +914,6 @@ hal_reset_rx_reo_tid_q_be(struct hal_soc *hal_soc, void *hw_qdesc_vaddr,
} }
#endif #endif
/**
* hal_hw_txrx_default_ops_attach_be() - Attach the default hal ops for
* beryllium chipsets.
* @hal_soc_hdl: HAL soc handle
*
* Return: None
*/
void hal_hw_txrx_default_ops_attach_be(struct hal_soc *hal_soc) void hal_hw_txrx_default_ops_attach_be(struct hal_soc *hal_soc)
{ {
hal_soc->ops->hal_get_reo_qdesc_size = hal_get_reo_qdesc_size_be; hal_soc->ops->hal_get_reo_qdesc_size = hal_get_reo_qdesc_size_be;

72
hal/wifi3.0/be/hal_be_generic_api.h
View File

@@ -27,7 +27,7 @@
#include <hal_generic_api.h> #include <hal_generic_api.h>
#include "txmon_tlvs.h" #include "txmon_tlvs.h"
/** /*
* Debug macro to print the TLV header tag * Debug macro to print the TLV header tag
*/ */
#define SHOW_DEFINED(x) do {} while (0) #define SHOW_DEFINED(x) do {} while (0)
@@ -49,8 +49,10 @@ hal_tx_comp_get_buffer_timestamp_be(void *desc,
#endif /* WLAN_FEATURE_TSF_UPLINK_DELAY || CONFIG_SAWF */ #endif /* WLAN_FEATURE_TSF_UPLINK_DELAY || CONFIG_SAWF */
/** /**
* hal_tx_comp_get_status() - TQM Release reason * hal_tx_comp_get_status_generic_be() - TQM Release reason
* @hal_desc: completion ring Tx status * @desc: WBM descriptor
* @ts1: completion ring Tx status
* @hal: hal_soc
* *
* This function will parse the WBM completion descriptor and populate in * This function will parse the WBM completion descriptor and populate in
* HAL structure * HAL structure
@@ -187,7 +189,7 @@ hal_tx_update_pcp_tid_generic_be(struct hal_soc *soc,
/** /**
* hal_tx_update_tidmap_prty_generic_be() - Update the tid map priority * hal_tx_update_tidmap_prty_generic_be() - Update the tid map priority
* @soc: HAL SoC context * @soc: HAL SoC context
* @val: priority value * @value: priority value
* *
* Return: void * Return: void
*/ */
@@ -220,9 +222,9 @@ static void hal_rx_get_tlv_size_generic_be(uint16_t *rx_pkt_tlv_size,
/** /**
* hal_rx_flow_get_tuple_info_be() - Setup a flow search entry in HW FST * hal_rx_flow_get_tuple_info_be() - Setup a flow search entry in HW FST
* @fst: Pointer to the Rx Flow Search Table * @rx_fst: Pointer to the Rx Flow Search Table
* @hal_hash: HAL 5 tuple hash * @hal_hash: HAL 5 tuple hash
* @tuple_info: 5-tuple info of the flow returned to the caller * @flow_tuple_info: 5-tuple info of the flow returned to the caller
* *
* Return: Success/Failure * Return: Success/Failure
*/ */
@@ -291,7 +293,7 @@ hal_rx_flow_get_tuple_info_be(uint8_t *rx_fst, uint32_t hal_hash,
/** /**
* hal_rx_flow_delete_entry_be() - Setup a flow search entry in HW FST * hal_rx_flow_delete_entry_be() - Setup a flow search entry in HW FST
* @fst: Pointer to the Rx Flow Search Table * @rx_fst: Pointer to the Rx Flow Search Table
* @hal_rx_fse: Pointer to the Rx Flow that is to be deleted from the FST * @hal_rx_fse: Pointer to the Rx Flow that is to be deleted from the FST
* *
* Return: Success/Failure * Return: Success/Failure
@@ -327,7 +329,7 @@ hal_rx_fst_get_fse_size_be(void)
#ifdef QCA_MONITOR_2_0_SUPPORT #ifdef QCA_MONITOR_2_0_SUPPORT
/** /**
* hal_txmon_is_mon_buf_addr_tlv_generic_be() - api to find mon buffer tlv * hal_txmon_is_mon_buf_addr_tlv_generic_be() - api to find mon buffer tlv
* @tx_tlv: pointer to TLV header * @tx_tlv_hdr: pointer to TLV header
* *
* Return: bool based on tlv tag matches monitor buffer address tlv * Return: bool based on tlv tag matches monitor buffer address tlv
*/ */
@@ -385,7 +387,7 @@ hal_txmon_get_num_users(void *tx_tlv)
* hal_txmon_parse_tx_fes_setup() - parse tx_fes_setup tlv * hal_txmon_parse_tx_fes_setup() - parse tx_fes_setup tlv
* *
* @tx_tlv: pointer to tx_fes_setup tlv header * @tx_tlv: pointer to tx_fes_setup tlv header
* @ppdu_info: pointer to hal_tx_ppdu_info * @tx_ppdu_info: pointer to hal_tx_ppdu_info
* *
* Return: void * Return: void
*/ */
@@ -487,7 +489,7 @@ hal_txmon_get_num_users(void *tx_tlv)
* hal_txmon_parse_tx_fes_setup() - parse tx_fes_setup tlv * hal_txmon_parse_tx_fes_setup() - parse tx_fes_setup tlv
* *
* @tx_tlv: pointer to tx_fes_setup tlv header * @tx_tlv: pointer to tx_fes_setup tlv header
* @ppdu_info: pointer to hal_tx_ppdu_info * @tx_ppdu_info: pointer to hal_tx_ppdu_info
* *
* Return: void * Return: void
*/ */
@@ -685,7 +687,7 @@ uint8_t get_ru_offset_from_start_index(uint8_t ru_size, uint8_t start_idx)
* *
* @tx_tlv: pointer to firmware to software tlvmpdu start tlv header * @tx_tlv: pointer to firmware to software tlvmpdu start tlv header
* @type: place where this tlv is generated * @type: place where this tlv is generated
* @tx_status_info: pointer to hal_tx_status_info * @status_info: pointer to hal_tx_status_info
* *
* Return: void * Return: void
*/ */
@@ -782,9 +784,8 @@ hal_txmon_status_get_num_users_generic_be(void *tx_tlv_hdr, uint8_t *num_users)
/** /**
* hal_tx_get_ppdu_info() - api to get tx ppdu info * hal_tx_get_ppdu_info() - api to get tx ppdu info
* @pdev_handle: DP_PDEV handle * @data_info: populate dp_ppdu_info data
* @prot_ppdu_info: populate dp_ppdu_info protection * @prot_info: populate dp_ppdu_info protection
* @tx_data_ppdu_info: populate dp_ppdu_info data
* @tlv_tag: Tag * @tlv_tag: Tag
* *
* Return: dp_tx_ppdu_info pointer * Return: dp_tx_ppdu_info pointer
@@ -2966,11 +2967,12 @@ static void hal_reo_shared_qaddr_write_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_reo_shared_qaddr_setup() - Allocate MLO and Non MLO reo queue * hal_reo_shared_qaddr_setup_be() - Allocate MLO and Non MLO reo queue
* reference table shared between SW and HW and initialize in Qdesc Base0 * reference table shared between SW and HW and initialize in Qdesc Base0
* base1 registers provided by HW. * base1 registers provided by HW.
* *
* @hal_soc: HAL Soc handle * @hal_soc_hdl: HAL Soc handle
* @reo_qref: REO queue reference table
* *
* Return: QDF_STATUS_SUCCESS on success else a QDF error. * Return: QDF_STATUS_SUCCESS on success else a QDF error.
*/ */
@@ -3019,10 +3021,10 @@ hal_reo_shared_qaddr_setup_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_reo_shared_qaddr_init() - Zero out REO qref LUT and * hal_reo_shared_qaddr_init_be() - Zero out REO qref LUT and
* write start addr of MLO and Non MLO table in HW * write start addr of MLO and Non MLO table in HW
* *
* @hal_soc: HAL Soc handle * @hal_soc_hdl: HAL Soc handle
* @qref_reset: reset qref LUT * @qref_reset: reset qref LUT
* *
* Return: None * Return: None
@@ -3059,10 +3061,10 @@ static void hal_reo_shared_qaddr_init_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_reo_shared_qaddr_detach() - Free MLO and Non MLO reo queue * hal_reo_shared_qaddr_detach_be() - Free MLO and Non MLO reo queue
* reference table shared between SW and HW * reference table shared between SW and HW
* *
* @hal_soc: HAL Soc handle * @hal_soc_hdl: HAL Soc handle
* *
* Return: None * Return: None
*/ */
@@ -3080,8 +3082,8 @@ static void hal_reo_shared_qaddr_detach_be(hal_soc_handle_t hal_soc_hdl)
#endif #endif
/** /**
* hal_tx_vdev_mismatch_routing_set - set vdev mismatch exception routing * hal_tx_vdev_mismatch_routing_set_generic_be() - set vdev mismatch exception routing
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @config: HAL_TX_VDEV_MISMATCH_TQM_NOTIFY - route via TQM * @config: HAL_TX_VDEV_MISMATCH_TQM_NOTIFY - route via TQM
* HAL_TX_VDEV_MISMATCH_FW_NOTIFY - route via FW * HAL_TX_VDEV_MISMATCH_FW_NOTIFY - route via FW
* *
@@ -3120,8 +3122,8 @@ hal_tx_vdev_mismatch_routing_set_generic_be(hal_soc_handle_t hal_soc_hdl,
#endif #endif
/** /**
* hal_tx_mcast_mlo_reinject_routing_set - set MLO multicast reinject routing * hal_tx_mcast_mlo_reinject_routing_set_generic_be() - set MLO multicast reinject routing
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @config: HAL_TX_MCAST_MLO_REINJECT_FW_NOTIFY - route via FW * @config: HAL_TX_MCAST_MLO_REINJECT_FW_NOTIFY - route via FW
* HAL_TX_MCAST_MLO_REINJECT_TQM_NOTIFY - route via TQM * HAL_TX_MCAST_MLO_REINJECT_TQM_NOTIFY - route via TQM
* *
@@ -3159,9 +3161,9 @@ hal_tx_mcast_mlo_reinject_routing_set_generic_be(
#endif #endif
/** /**
* hal_get_ba_aging_timeout_be - Get BA Aging timeout * hal_get_ba_aging_timeout_be_generic() - Get BA Aging timeout
* *
* @hal_soc: Opaque HAL SOC handle * @hal_soc_hdl: Opaque HAL SOC handle
* @ac: Access category * @ac: Access category
* @value: window size to get * @value: window size to get
*/ */
@@ -3203,7 +3205,7 @@ void hal_get_ba_aging_timeout_be_generic(hal_soc_handle_t hal_soc_hdl,
* hal_setup_link_idle_list_generic_be - Setup scattered idle list using the * hal_setup_link_idle_list_generic_be - Setup scattered idle list using the
* buffer list provided * buffer list provided
* *
* @hal_soc: Opaque HAL SOC handle * @soc: Opaque HAL SOC handle
* @scatter_bufs_base_paddr: Array of physical base addresses * @scatter_bufs_base_paddr: Array of physical base addresses
* @scatter_bufs_base_vaddr: Array of virtual base addresses * @scatter_bufs_base_vaddr: Array of virtual base addresses
* @num_scatter_bufs: Number of scatter buffers in the above lists * @num_scatter_bufs: Number of scatter buffers in the above lists
@@ -3355,7 +3357,7 @@ hal_setup_link_idle_list_generic_be(struct hal_soc *soc,
/** /**
* hal_cookie_conversion_reg_cfg_generic_be() - set cookie conversion relevant register * hal_cookie_conversion_reg_cfg_generic_be() - set cookie conversion relevant register
* for REO/WBM * for REO/WBM
* @soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @cc_cfg: structure pointer for HW cookie conversion configuration * @cc_cfg: structure pointer for HW cookie conversion configuration
* *
* Return: None * Return: None
@@ -3486,9 +3488,8 @@ void hal_cookie_conversion_reg_cfg_generic_be(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_set_ba_aging_timeout_be - Set BA Aging timeout * hal_set_ba_aging_timeout_be_generic() - Set BA Aging timeout
* * @hal_soc_hdl: Opaque HAL SOC handle
* @hal_soc: Opaque HAL SOC handle
* @ac: Access category * @ac: Access category
* ac: 0 - Background, 1 - Best Effort, 2 - Video, 3 - Voice * ac: 0 - Background, 1 - Best Effort, 2 - Video, 3 - Voice
* @value: Input value to set * @value: Input value to set
@@ -3531,9 +3532,9 @@ void hal_set_ba_aging_timeout_be_generic(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_tx_populate_bank_register() - populate the bank register with * hal_tx_populate_bank_register_be() - populate the bank register with
* the software configs. * the software configs.
* @soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @config: bank config * @config: bank config
* @bank_id: bank id to be configured * @bank_id: bank id to be configured
* *
@@ -3626,8 +3627,9 @@ hal_tx_populate_bank_register_be(hal_soc_handle_t hal_soc_hdl,
#define HAL_TCL_VDEV_MCAST_PACKET_CTRL_SHIFT 0x2 #define HAL_TCL_VDEV_MCAST_PACKET_CTRL_SHIFT 0x2
/** /**
* hal_tx_vdev_mcast_ctrl_set - set mcast_ctrl value * hal_tx_vdev_mcast_ctrl_set_be() - set mcast_ctrl value
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @vdev_id: vdev identifier
* @mcast_ctrl_val: mcast ctrl value for this VAP * @mcast_ctrl_val: mcast ctrl value for this VAP
* *
* Return: void * Return: void

13
hal/wifi3.0/be/hal_be_reo.c
View File

@@ -1,6 +1,6 @@
/* /*
* Copyright (c) 2016-2021 The Linux Foundation. All rights reserved. * Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. 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 * Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the * any purpose with or without fee is hereby granted, provided that the
@@ -29,17 +29,6 @@ uint32_t hal_get_reo_reg_base_offset_be(void)
return REO_REG_REG_BASE; return REO_REG_REG_BASE;
} }
/**
* hal_reo_qdesc_setup - Setup HW REO queue descriptor
*
* @hal_soc: Opaque HAL SOC handle
* @ba_window_size: BlockAck window size
* @start_seq: Starting sequence number
* @hw_qdesc_vaddr: Virtual address of REO queue descriptor memory
* @hw_qdesc_paddr: Physical address of REO queue descriptor memory
* @tid: TID
*
*/
void hal_reo_qdesc_setup_be(hal_soc_handle_t hal_soc_hdl, int tid, void hal_reo_qdesc_setup_be(hal_soc_handle_t hal_soc_hdl, int tid,
uint32_t ba_window_size, uint32_t ba_window_size,
uint32_t start_seq, void *hw_qdesc_vaddr, uint32_t start_seq, void *hw_qdesc_vaddr,

6
hal/wifi3.0/be/hal_be_reo.h
View File

@@ -1,6 +1,6 @@
/* /*
* Copyright (c) 2017-2019, 2021 The Linux Foundation. All rights reserved. * Copyright (c) 2017-2019, 2021 The Linux Foundation. All rights reserved.
* Copyright (c) 2021-2022, Qualcomm Innovation Center, Inc. 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 * Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the * any purpose with or without fee is hereby granted, provided that the
@@ -82,8 +82,8 @@ hal_reo_rx_update_queue_status_be(hal_ring_desc_t ring_desc,
/** /**
* hal_reo_init_cmd_ring_be() - Initialize descriptors of REO command SRNG * hal_reo_init_cmd_ring_be() - Initialize descriptors of REO command SRNG
* with command number * with command number
* @hal_soc: Handle to HAL SoC structure * @hal_soc_hdl: Handle to HAL SoC structure
* @hal_ring: Handle to HAL SRNG structure * @hal_ring_hdl: Handle to HAL SRNG structure
* *
* Return: none * Return: none
*/ */

451
hal/wifi3.0/be/hal_be_rx_tlv.h
View File

File diff suppressed because it is too large Load Diff

186
hal/wifi3.0/be/hal_be_tx.h
View File

@@ -60,7 +60,8 @@ enum hal_tx_mcast_ctrl {
HAL_TX_MCAST_CTRL_NO_SPECIAL, HAL_TX_MCAST_CTRL_NO_SPECIAL,
}; };
/* enum hal_tx_notify_frame_type - TX notify frame type /**
* enum hal_tx_notify_frame_type - TX notify frame type
* @NO_TX_NOTIFY: Not a notify frame * @NO_TX_NOTIFY: Not a notify frame
* @TX_HARD_NOTIFY: Hard notify TX frame * @TX_HARD_NOTIFY: Hard notify TX frame
* @TX_SOFT_NOTIFY_E: Soft Notify Tx frame * @TX_SOFT_NOTIFY_E: Soft Notify Tx frame
@@ -78,7 +79,7 @@ enum hal_tx_notify_frame_type {
* --------------------------------------------------------------------------- * ---------------------------------------------------------------------------
*/ */
/** /**
* struct hal_tx_bank_config - SW config bank params * union hal_tx_bank_config - SW config bank params
* @epd: EPD indication flag * @epd: EPD indication flag
* @encap_type: encapsulation type * @encap_type: encapsulation type
* @encrypt_type: encrypt type * @encrypt_type: encrypt type
@@ -91,6 +92,8 @@ enum hal_tx_notify_frame_type {
* @vdev_id_check_en: vdev id check * @vdev_id_check_en: vdev id check
* @pmac_id: mac id * @pmac_id: mac id
* @mcast_pkt_ctrl: mulitcast packet control * @mcast_pkt_ctrl: mulitcast packet control
* @dscp_tid_map_id: DSCP to TID map id
* @reserved: unused bits
* @val: value representing bank config * @val: value representing bank config
*/ */
union hal_tx_bank_config { union hal_tx_bank_config {
@@ -114,14 +117,15 @@ union hal_tx_bank_config {
}; };
/** /**
* struct hal_tx_cmn_config_ppe - SW config exception related parameters * union hal_tx_cmn_config_ppe - SW config exception related parameters
* @drop_prec_err - Exception drop_prec errors. * @drop_prec_err: Exception drop_prec errors.
* @fake_mac_hdr - Exception fake mac header. * @fake_mac_hdr: Exception fake mac header.
* @cpu_code_inv - Exception cpu code invalid. * @cpu_code_inv: Exception cpu code invalid.
* @data_buff_err - Exception buffer length/offset erorors. * @data_buff_err: Exception buffer length/offset erorors.
* @l3_l4_err - Exception m3_l4 checksum errors * @l3_l4_err: Exception m3_l4 checksum errors
* @data_offset_max - Maximum data offset allowed. * @data_offset_max: Maximum data offset allowed.
* @data_len_max - Maximum data length allowed. * @data_len_max: Maximum data length allowed.
* @val: aggregate 32-bit value
*/ */
union hal_tx_cmn_config_ppe { union hal_tx_cmn_config_ppe {
struct { struct {
@@ -137,15 +141,16 @@ union hal_tx_cmn_config_ppe {
}; };
/** /**
* hal_tx_ppe_vp_config - SW config PPE VP table * union hal_tx_ppe_vp_config - SW config PPE VP table
* @vp_num - Virtual port number * @vp_num: Virtual port number
* @pmac_id - Lmac ID * @pmac_id: Lmac ID
* @bank_id: Bank ID corresponding to this I/F. * @bank_id: Bank ID corresponding to this I/F.
* @vdev_id: VDEV ID of the I/F. * @vdev_id: VDEV ID of the I/F.
* @search_idx_reg_num: Register number of this SI. * @search_idx_reg_num: Register number of this SI.
* @use_ppe_int_pri: Use the PPE INT_PRI to TID table * @use_ppe_int_pri: Use the PPE INT_PRI to TID table
* @to_fw: Use FW * @to_fw: Use FW
* @drop_prec_enable: Enable precedence drop. * @drop_prec_enable: Enable precedence drop.
* @val: aggregate 32-bit value
*/ */
union hal_tx_ppe_vp_config { union hal_tx_ppe_vp_config {
struct { struct {
@@ -162,9 +167,10 @@ union hal_tx_ppe_vp_config {
}; };
/** /**
* hal_tx_cmn_ppe_idx_map_config: Use ppe index mapping table * union hal_tx_ppe_idx_map_config - Use ppe index mapping table
* @search_idx: Search index * @search_idx: Search index
* @cache_set: Cache set number * @cache_set: Cache set number
* @val: aggregate 32-bit value
*/ */
union hal_tx_ppe_idx_map_config { union hal_tx_ppe_idx_map_config {
struct { struct {
@@ -175,7 +181,7 @@ union hal_tx_ppe_idx_map_config {
}; };
/** /**
* hal_tx_ppe_pri2tid_map0_config : Configure ppe INT_PRI to tid map * union hal_tx_ppe_pri2tid_map0_config - Configure ppe INT_PRI to tid map
* @int_pri0: INT_PRI_0 * @int_pri0: INT_PRI_0
* @int_pri1: INT_PRI_1 * @int_pri1: INT_PRI_1
* @int_pri2: INT_PRI_2 * @int_pri2: INT_PRI_2
@@ -186,6 +192,7 @@ union hal_tx_ppe_idx_map_config {
* @int_pri7: INT_PRI_7 * @int_pri7: INT_PRI_7
* @int_pri8: INT_PRI_8 * @int_pri8: INT_PRI_8
* @int_pri9: INT_PRI_9 * @int_pri9: INT_PRI_9
* @val: aggregate 32-bit value
*/ */
union hal_tx_ppe_pri2tid_map0_config { union hal_tx_ppe_pri2tid_map0_config {
struct { struct {
@@ -204,13 +211,14 @@ union hal_tx_ppe_pri2tid_map0_config {
}; };
/** /**
* hal_tx_ppe_pri2tid_map1_config : Configure ppe INT_PRI to tid map * union hal_tx_ppe_pri2tid_map1_config - Configure ppe INT_PRI to tid map
* @int_pri0: INT_PRI_10 * @int_pri10: INT_PRI_10
* @int_pri1: INT_PRI_11 * @int_pri11: INT_PRI_11
* @int_pri2: INT_PRI_12 * @int_pri12: INT_PRI_12
* @int_pri3: INT_PRI_13 * @int_pri13: INT_PRI_13
* @int_pri4: INT_PRI_14 * @int_pri14: INT_PRI_14
* @int_pri5: INT_PRI_15 * @int_pri15: INT_PRI_15
* @val: aggregate 32-bit value
*/ */
union hal_tx_ppe_pri2tid_map1_config { union hal_tx_ppe_pri2tid_map1_config {
struct { struct {
@@ -235,7 +243,7 @@ union hal_tx_ppe_pri2tid_map1_config {
*/ */
/** /**
* hal_tx_desc_set_tx_notify_frame - Set TX notify_frame field in Tx desc * hal_tx_desc_set_tx_notify_frame() - Set TX notify_frame field in Tx desc
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @val: Value to be set * @val: Value to be set
* *
@@ -249,7 +257,7 @@ static inline void hal_tx_desc_set_tx_notify_frame(void *desc,
} }
/** /**
* hal_tx_desc_set_flow_override_enable - Set flow_override_enable field * hal_tx_desc_set_flow_override_enable() - Set flow_override_enable field
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @val: Value to be set * @val: Value to be set
* *
@@ -263,7 +271,7 @@ static inline void hal_tx_desc_set_flow_override_enable(void *desc,
} }
/** /**
* hal_tx_desc_set_flow_override - Set flow_override field in TX desc * hal_tx_desc_set_flow_override() - Set flow_override field in TX desc
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @val: Value to be set * @val: Value to be set
* *
@@ -277,7 +285,7 @@ static inline void hal_tx_desc_set_flow_override(void *desc,
} }
/** /**
* hal_tx_desc_set_who_classify_info_sel - Set who_classify_info_sel field * hal_tx_desc_set_who_classify_info_sel() - Set who_classify_info_sel field
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @val: Value to be set * @val: Value to be set
* *
@@ -291,7 +299,7 @@ static inline void hal_tx_desc_set_who_classify_info_sel(void *desc,
} }
/** /**
* hal_tx_desc_set_buf_length - Set Data length in bytes in Tx Descriptor * hal_tx_desc_set_buf_length() - Set Data length in bytes in Tx Descriptor
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @data_length: MSDU length in case of direct descriptor. * @data_length: MSDU length in case of direct descriptor.
* Length of link extension descriptor in case of Link extension * Length of link extension descriptor in case of Link extension
@@ -306,7 +314,7 @@ static inline void hal_tx_desc_set_buf_length(void *desc,
} }
/** /**
* hal_tx_desc_set_buf_offset - Sets Packet Offset field in Tx descriptor * hal_tx_desc_set_buf_offset() - Sets Packet Offset field in Tx descriptor
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @offset: Packet offset from Metadata in case of direct buffer descriptor. * @offset: Packet offset from Metadata in case of direct buffer descriptor.
* *
@@ -320,8 +328,8 @@ static inline void hal_tx_desc_set_buf_offset(void *desc,
} }
/** /**
* hal_tx_desc_set_l4_checksum_en - Set TCP/IP checksum enable flags * hal_tx_desc_set_l4_checksum_en() - Set TCP/IP checksum enable flags
* Tx Descriptor for MSDU_buffer type * Tx Descriptor for MSDU_buffer type
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @en: UDP/TCP over ipv4/ipv6 checksum enable flags (5 bits) * @en: UDP/TCP over ipv4/ipv6 checksum enable flags (5 bits)
* *
@@ -338,10 +346,10 @@ static inline void hal_tx_desc_set_l4_checksum_en(void *desc,
} }
/** /**
* hal_tx_desc_set_l3_checksum_en - Set IPv4 checksum enable flag in * hal_tx_desc_set_l3_checksum_en() - Set IPv4 checksum enable flag in
* Tx Descriptor for MSDU_buffer type * Tx Descriptor for MSDU_buffer type
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @checksum_en_flags: ipv4 checksum enable flags * @en: ipv4 checksum enable flags
* *
* Return: void * Return: void
*/ */
@@ -353,8 +361,8 @@ static inline void hal_tx_desc_set_l3_checksum_en(void *desc,
} }
/** /**
* hal_tx_desc_set_fw_metadata- Sets the metadata that is part of TCL descriptor * hal_tx_desc_set_fw_metadata() - Sets the metadata that is part of TCL descriptor
* @desc:Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @metadata: Metadata to be sent to Firmware * @metadata: Metadata to be sent to Firmware
* *
* Return: void * Return: void
@@ -367,8 +375,8 @@ static inline void hal_tx_desc_set_fw_metadata(void *desc,
} }
/** /**
* hal_tx_desc_set_to_fw - Set To_FW bit in Tx Descriptor. * hal_tx_desc_set_to_fw() - Set To_FW bit in Tx Descriptor.
* @desc:Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @to_fw: if set, Forward packet to FW along with classification result * @to_fw: if set, Forward packet to FW along with classification result
* *
* Return: void * Return: void
@@ -380,8 +388,8 @@ static inline void hal_tx_desc_set_to_fw(void *desc, uint8_t to_fw)
} }
/** /**
* hal_tx_desc_set_hlos_tid - Set the TID value (override DSCP/PCP fields in * hal_tx_desc_set_hlos_tid() - Set the TID value (override DSCP/PCP fields in
* frame) to be used for Tx Frame * frame) to be used for Tx Frame
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @hlos_tid: HLOS TID * @hlos_tid: HLOS TID
* *
@@ -398,9 +406,10 @@ static inline void hal_tx_desc_set_hlos_tid(void *desc,
} }
/** /**
* hal_tx_desc_sync - Commit the descriptor to Hardware * hal_tx_desc_sync() - Commit the descriptor to Hardware
* @hal_tx_des_cached: Cached descriptor that software maintains * @hal_tx_desc_cached: Cached descriptor that software maintains
* @hw_desc: Hardware descriptor to be updated * @hw_desc: Hardware descriptor to be updated
* @num_bytes: descriptor size
*/ */
static inline void hal_tx_desc_sync(void *hal_tx_desc_cached, static inline void hal_tx_desc_sync(void *hal_tx_desc_cached,
void *hw_desc, uint8_t num_bytes) void *hw_desc, uint8_t num_bytes)
@@ -409,8 +418,8 @@ static inline void hal_tx_desc_sync(void *hal_tx_desc_cached,
} }
/** /**
* hal_tx_desc_set_vdev_id - set vdev id to the descriptor to Hardware * hal_tx_desc_set_vdev_id() - set vdev id to the descriptor to Hardware
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @vdev_id: vdev id * @vdev_id: vdev id
*/ */
static inline void hal_tx_desc_set_vdev_id(void *desc, uint8_t vdev_id) static inline void hal_tx_desc_set_vdev_id(void *desc, uint8_t vdev_id)
@@ -420,8 +429,8 @@ static inline void hal_tx_desc_set_vdev_id(void *desc, uint8_t vdev_id)
} }
/** /**
* hal_tx_desc_set_bank_id - set bank id to the descriptor to Hardware * hal_tx_desc_set_bank_id() - set bank id to the descriptor to Hardware
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @bank_id: bank id * @bank_id: bank id
*/ */
static inline void hal_tx_desc_set_bank_id(void *desc, uint8_t bank_id) static inline void hal_tx_desc_set_bank_id(void *desc, uint8_t bank_id)
@@ -431,9 +440,9 @@ static inline void hal_tx_desc_set_bank_id(void *desc, uint8_t bank_id)
} }
/** /**
* hal_tx_desc_set_tcl_cmd_type - set tcl command type to the descriptor * hal_tx_desc_set_tcl_cmd_type() - set tcl command type to the descriptor
* to Hardware * to Hardware
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @tcl_cmd_type: tcl command type * @tcl_cmd_type: tcl command type
*/ */
static inline void static inline void
@@ -444,9 +453,9 @@ hal_tx_desc_set_tcl_cmd_type(void *desc, uint8_t tcl_cmd_type)
} }
/** /**
* hal_tx_desc_set_lmac_id_be - set lmac id to the descriptor to Hardware * hal_tx_desc_set_lmac_id_be() - set lmac id to the descriptor to Hardware
* @hal_soc_hdl: hal soc handle * @hal_soc_hdl: hal soc handle
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @lmac_id: lmac id * @lmac_id: lmac id
*/ */
static inline void static inline void
@@ -458,10 +467,10 @@ hal_tx_desc_set_lmac_id_be(hal_soc_handle_t hal_soc_hdl, void *desc,
} }
/** /**
* hal_tx_desc_set_search_index_be - set search index to the * hal_tx_desc_set_search_index_be() - set search index to the
* descriptor to Hardware * descriptor to Hardware
* @hal_soc_hdl: hal soc handle * @hal_soc_hdl: hal soc handle
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @search_index: search index * @search_index: search index
*/ */
static inline void static inline void
@@ -473,10 +482,10 @@ hal_tx_desc_set_search_index_be(hal_soc_handle_t hal_soc_hdl, void *desc,
} }
/** /**
* hal_tx_desc_set_cache_set_num - set cache set num to the * hal_tx_desc_set_cache_set_num() - set cache set num to the
* descriptor to Hardware * descriptor to Hardware
* @hal_soc_hdl: hal soc handle * @hal_soc_hdl: hal soc handle
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @cache_num: cache number * @cache_num: cache number
*/ */
static inline void static inline void
@@ -488,11 +497,11 @@ hal_tx_desc_set_cache_set_num(hal_soc_handle_t hal_soc_hdl, void *desc,
} }
/** /**
* hal_tx_desc_set_lookup_override_num - set lookup override num * hal_tx_desc_set_index_lookup_override() - set lookup override num to the
* to the descriptor to Hardware * descriptor to Hardware
* @hal_soc_hdl: hal soc handle * @hal_soc_hdl: hal soc handle
* @hal_tx_des_cached: Cached descriptor that software maintains * @desc: Cached descriptor that software maintains
* @cache_num: set numbernumber * @num: set number
*/ */
static inline void static inline void
hal_tx_desc_set_index_lookup_override(hal_soc_handle_t hal_soc_hdl, hal_tx_desc_set_index_lookup_override(hal_soc_handle_t hal_soc_hdl,
@@ -629,6 +638,7 @@ static inline uint64_t hal_tx_comp_get_desc_va(void *hal_desc)
/** /**
* hal_tx_get_num_tcl_banks() - Get number of banks for target * hal_tx_get_num_tcl_banks() - Get number of banks for target
* @hal_soc_hdl: HAL soc handle
* *
* Return: None * Return: None
*/ */
@@ -649,8 +659,8 @@ hal_tx_get_num_tcl_banks(hal_soc_handle_t hal_soc_hdl)
/** /**
* hal_tx_populate_bank_register() - populate the bank register with * hal_tx_populate_bank_register() - populate the bank register with
* the software configs. * the software configs.
* @soc: HAL soc handle * @hal_soc_hdl: HAL soc handle
* @config: bank config * @config: bank config
* @bank_id: bank id to be configured * @bank_id: bank id to be configured
* *
@@ -679,7 +689,7 @@ hal_tx_populate_bank_register(hal_soc_handle_t hal_soc_hdl,
/** /**
* hal_tx_config_rbm_mapping_be() - Update return buffer manager ring id * hal_tx_config_rbm_mapping_be() - Update return buffer manager ring id
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @hal_ring_hdl: Source ring pointer * @hal_ring_hdl: Source ring pointer
* @rbm_id: return buffer manager ring id * @rbm_id: return buffer manager ring id
* *
@@ -705,13 +715,14 @@ hal_tx_config_rbm_mapping_be(hal_soc_handle_t hal_soc_hdl,
#endif #endif
/** /**
* hal_tx_desc_set_buf_addr_be - Fill Buffer Address information in Tx Desc * hal_tx_desc_set_buf_addr_be() - Fill Buffer Address information in Tx Desc
* @hal_soc_hdl: HAL SoC context
* @desc: Handle to Tx Descriptor * @desc: Handle to Tx Descriptor
* @paddr: Physical Address * @paddr: Physical Address
* @pool_id: Return Buffer Manager ID * @rbm_id: Return Buffer Manager ID
* @desc_id: Descriptor ID * @desc_id: Descriptor ID
* @type: 0 - Address points to a MSDU buffer * @type: 0 - Address points to a MSDU buffer
* 1 - Address points to MSDU extension descriptor * 1 - Address points to MSDU extension descriptor
* *
* Return: void * Return: void
*/ */
@@ -780,8 +791,8 @@ hal_tx_desc_set_buf_addr_be(hal_soc_handle_t hal_soc_hdl, void *desc,
#endif #endif
/** /**
* hal_tx_vdev_mismatch_routing_set - set vdev mismatch exception routing * hal_tx_vdev_mismatch_routing_set() - set vdev mismatch exception routing
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @config: HAL_TX_VDEV_MISMATCH_TQM_NOTIFY - route via TQM * @config: HAL_TX_VDEV_MISMATCH_TQM_NOTIFY - route via TQM
* HAL_TX_VDEV_MISMATCH_FW_NOTIFY - route via FW * HAL_TX_VDEV_MISMATCH_FW_NOTIFY - route via FW
* *
@@ -805,8 +816,8 @@ hal_tx_vdev_mismatch_routing_set(hal_soc_handle_t hal_soc_hdl,
#endif #endif
/** /**
* hal_tx_mcast_mlo_reinject_routing_set - set MLO multicast reinject routing * hal_tx_mcast_mlo_reinject_routing_set() - set MLO multicast reinject routing
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @config: HAL_TX_MCAST_MLO_REINJECT_FW_NOTIFY - route via FW * @config: HAL_TX_MCAST_MLO_REINJECT_FW_NOTIFY - route via FW
* HAL_TX_MCAST_MLO_REINJECT_TQM_NOTIFY - route via TQM * HAL_TX_MCAST_MLO_REINJECT_TQM_NOTIFY - route via TQM
* *
@@ -848,8 +859,8 @@ void hal_reo_config_reo2ppe_dest_info(hal_soc_handle_t hal_soc_hdl)
} }
/** /**
* hal_tx_get_num_ppe_vp_tbl_entries() - Get the total number of VP table * hal_tx_get_num_ppe_vp_tbl_entries() - Get the total number of VP table entries
* @hal_soc: HAL SoC Context * @hal_soc_hdl: HAL SoC Context
* *
* Return: Total number of entries. * Return: Total number of entries.
*/ */
@@ -862,8 +873,9 @@ uint32_t hal_tx_get_num_ppe_vp_tbl_entries(hal_soc_handle_t hal_soc_hdl)
} }
/** /**
* hal_tx_get_num_ppe_vp_search_idx_tbl_entries() - Get the total number of search idx registers * hal_tx_get_num_ppe_vp_search_idx_tbl_entries() - Get the total number of
* @hal_soc: HAL SoC Context * search idx registers
* @hal_soc_hdl: HAL SoC Context
* *
* Return: Total number of entries. * Return: Total number of entries.
*/ */
@@ -877,7 +889,7 @@ uint32_t hal_tx_get_num_ppe_vp_search_idx_tbl_entries(hal_soc_handle_t hal_soc_h
/** /**
* hal_tx_set_ppe_cmn_cfg()- Set the PPE common config * hal_tx_set_ppe_cmn_cfg()- Set the PPE common config
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @cmn_cfg: HAL PPE VP common config * @cmn_cfg: HAL PPE VP common config
* *
* Return: void * Return: void
@@ -892,8 +904,8 @@ hal_tx_set_ppe_cmn_cfg(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_tx_populate_ppe_vp_entry - Populate ppe VP entry * hal_tx_populate_ppe_vp_entry() - Populate ppe VP entry
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @vp_cfg: HAL PPE VP config * @vp_cfg: HAL PPE VP config
* @ppe_vp_idx: PPE VP index * @ppe_vp_idx: PPE VP index
* *
@@ -910,8 +922,8 @@ hal_tx_populate_ppe_vp_entry(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_ppeds_cfg_ast_override_map_reg - Set ppe index mapping table value * hal_ppeds_cfg_ast_override_map_reg() - Set ppe index mapping table value
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @reg_idx: index into the table * @reg_idx: index into the table
* @overide_map: HAL PPE INDEX MAPPING config * @overide_map: HAL PPE INDEX MAPPING config
* *
@@ -930,9 +942,10 @@ hal_ppeds_cfg_ast_override_map_reg(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_tx_set_int_pri2id - Set the prit2tid table. * hal_tx_set_int_pri2tid() - Set the pri2tid table.
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @pri2tid: Reference to SW INT_PRI to TID table * @val: value to set
* @map_no: index in SW INT_PRI to TID table
* *
* Return: void * Return: void
*/ */
@@ -946,8 +959,8 @@ hal_tx_set_int_pri2tid(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_tx_update_int_pri2id - Populate the prit2tid table. * hal_tx_update_int_pri2tid() - Populate the pri2tid table.
* @hal_soc: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @pri: INT_PRI value * @pri: INT_PRI value
* @tid: Wi-Fi TID * @tid: Wi-Fi TID
* *
@@ -963,7 +976,7 @@ hal_tx_update_int_pri2tid(hal_soc_handle_t hal_soc_hdl,
} }
/** /**
* hal_tx_dump_ppe_vp_entry - Dump the PPE VP entry * hal_tx_dump_ppe_vp_entry() - Dump the PPE VP entry
* @hal_soc_hdl: HAL SoC context * @hal_soc_hdl: HAL SoC context
* *
* Return: void * Return: void
@@ -977,9 +990,10 @@ hal_tx_dump_ppe_vp_entry(hal_soc_handle_t hal_soc_hdl)
} }
/** /**
* hal_tx_enable_pri2tid_map- Enable the priority to tid mapping * hal_tx_enable_pri2tid_map() - Enable the priority to tid mapping
* @hal_soc_hdl: HAL SoC context * @hal_soc_hdl: HAL SoC context
* @val: True/False value * @val: True/False value
* @ppe_vp_idx: map index
* *
* Return: void * Return: void
*/ */