qcacmn: Fix hal/wifi3.0/qcn6122 documentation

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

Change-Id: I68212a1a3356b20032336b663c202b840f4c6035
CRs-Fixed: 3411730
This commit is contained in:
Jeff Johnson
2023-02-20 09:08:28 -08:00
کامیت شده توسط Madan Koyyalamudi
والد bbede4e20d
کامیت 4f8ff9d20f
2فایلهای تغییر یافته به همراه165 افزوده شده و 173 حذف شده

مشاهده پرونده

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2020-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 any
* purpose with or without fee is hereby granted, provided that the above
@@ -130,12 +130,11 @@
#include "hal_li_generic_api.h"
/**
* hal_rx_sw_mon_desc_info_get_6122(): API to read the
* sw monitor ring descriptor
*
* hal_rx_sw_mon_desc_info_get_6122() - API to read the sw monitor ring
* descriptor
* @rxdma_dst_ring_desc: sw monitor ring descriptor
* @desc_info_buf: Descriptor info buffer to which
* sw monitor ring descriptor is populated to
* @desc_info_buf: Descriptor info buffer to which sw monitor ring descriptor is
* populated to
*
* Return: void
*/
@@ -184,10 +183,10 @@ hal_rx_sw_mon_desc_info_get_6122(hal_ring_desc_t rxdma_dst_ring_desc,
}
/**
* hal_rx_msdu_start_nss_get_6122(): API to get the NSS
* Interval from rx_msdu_start
*
* hal_rx_msdu_start_nss_get_6122() - API to get the NSS Interval from
* rx_msdu_start
* @buf: pointer to the start of RX PKT TLV header
*
* Return: uint32_t(nss)
*/
static uint32_t hal_rx_msdu_start_nss_get_6122(uint8_t *buf)
@@ -203,10 +202,10 @@ static uint32_t hal_rx_msdu_start_nss_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_start_get_len_6122(): API to get the MSDU length
* from rx_msdu_start TLV
* hal_rx_msdu_start_get_len_6122() - API to get the MSDU length from
* rx_msdu_start TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: (uint32_t)msdu length
*/
static uint32_t hal_rx_msdu_start_get_len_6122(uint8_t *buf)
@@ -222,10 +221,9 @@ static uint32_t hal_rx_msdu_start_get_len_6122(uint8_t *buf)
}
/**
* hal_rx_mon_hw_desc_get_mpdu_status_6122(): Retrieve MPDU status
*
* @ hw_desc_addr: Start address of Rx HW TLVs
* @ rs: Status for monitor mode
* hal_rx_mon_hw_desc_get_mpdu_status_6122() - Retrieve MPDU status
* @hw_desc_addr: Start address of Rx HW TLVs
* @rs: Status for monitor mode
*
* Return: void
*/
@@ -259,7 +257,7 @@ static void hal_rx_mon_hw_desc_get_mpdu_status_6122(void *hw_desc_addr,
#define LINK_DESC_SIZE (NUM_OF_DWORDS_RX_MSDU_LINK << 2)
/**
* hal_get_link_desc_size_6122(): API to get the link desc size
* hal_get_link_desc_size_6122() - API to get the link desc size
*
* Return: uint32_t
*/
@@ -269,9 +267,9 @@ static uint32_t hal_get_link_desc_size_6122(void)
}
/**
* hal_rx_get_tlv_6122(): API to get the tlv
*
* hal_rx_get_tlv_6122() - API to get the tlv
* @rx_tlv: TLV data extracted from the rx packet
*
* Return: uint8_t
*/
static uint8_t hal_rx_get_tlv_6122(void *rx_tlv)
@@ -280,10 +278,9 @@ static uint8_t hal_rx_get_tlv_6122(void *rx_tlv)
}
/**
* hal_rx_mpdu_start_tlv_tag_valid_6122 () - API to check if RX_MPDU_START
* tlv tag is valid
*
*@rx_tlv_hdr: start address of rx_pkt_tlvs
* hal_rx_mpdu_start_tlv_tag_valid_6122() - API to check if RX_MPDU_START
* tlv tag is valid
* @rx_tlv_hdr: start address of rx_pkt_tlvs
*
* Return: true if RX_MPDU_START is valid, else false.
*/
@@ -298,10 +295,9 @@ uint8_t hal_rx_mpdu_start_tlv_tag_valid_6122(void *rx_tlv_hdr)
}
/**
* hal_rx_wbm_err_msdu_continuation_get_6122 () - API to check if WBM
* msdu continuation bit is set
*
*@wbm_desc: wbm release ring descriptor
* hal_rx_wbm_err_msdu_continuation_get_6122() - API to check if WBM msdu
* continuation bit is set
* @wbm_desc: wbm release ring descriptor
*
* Return: true if msdu continuation bit is set.
*/
@@ -316,9 +312,11 @@ uint8_t hal_rx_wbm_err_msdu_continuation_get_6122(void *wbm_desc)
}
/**
* hal_rx_proc_phyrx_other_receive_info_tlv_6122(): API to get tlv info
* hal_rx_proc_phyrx_other_receive_info_tlv_6122() - API to get tlv info
* @rx_tlv_hdr: RX TLV header
* @ppdu_info_hdl: handle to PPDU info to update
*
* Return: uint32_t
* Return: None
*/
static inline
void hal_rx_proc_phyrx_other_receive_info_tlv_6122(void *rx_tlv_hdr,
@@ -371,10 +369,10 @@ void hal_rx_get_rtt_info_6122(void *rx_tlv,
#endif
/**
* hal_rx_dump_msdu_start_tlv_6122() : dump RX msdu_start TLV in structured
* human readable format.
* @ msdu_start: pointer the msdu_start TLV in pkt.
* @ dbg_level: log level.
* hal_rx_dump_msdu_start_tlv_6122() - dump RX msdu_start TLV in structured
* human readable format.
* @msdustart: pointer the msdu_start TLV in pkt.
* @dbg_level: log level.
*
* Return: void
*/
@@ -446,10 +444,10 @@ static void hal_rx_dump_msdu_start_tlv_6122(void *msdustart,
}
/**
* hal_rx_dump_msdu_end_tlv_6122: dump RX msdu_end TLV in structured
* human readable format.
* @ msdu_end: pointer the msdu_end TLV in pkt.
* @ dbg_level: log level.
* hal_rx_dump_msdu_end_tlv_6122() - dump RX msdu_end TLV in structured
* human readable format.
* @msduend: pointer the msdu_end TLV in pkt.
* @dbg_level: log level.
*
* Return: void
*/
@@ -547,10 +545,9 @@ static void hal_rx_dump_msdu_end_tlv_6122(void *msduend,
}
/**
* hal_rx_mpdu_start_tid_get_6122(): API to get tid
* from rx_msdu_start
*
* hal_rx_mpdu_start_tid_get_6122() - API to get tid from rx_msdu_start
* @buf: pointer to the start of RX PKT TLV header
*
* Return: uint32_t(tid value)
*/
static uint32_t hal_rx_mpdu_start_tid_get_6122(uint8_t *buf)
@@ -566,10 +563,10 @@ static uint32_t hal_rx_mpdu_start_tid_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_start_reception_type_get(): API to get the reception type
* Interval from rx_msdu_start
*
* hal_rx_msdu_start_reception_type_get_6122() - API to get the reception type
* Interval from rx_msdu_start
* @buf: pointer to the start of RX PKT TLV header
*
* Return: uint32_t(reception_type)
*/
static uint32_t hal_rx_msdu_start_reception_type_get_6122(uint8_t *buf)
@@ -585,10 +582,9 @@ static uint32_t hal_rx_msdu_start_reception_type_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_da_idx_get_6122: API to get da_idx
* from rx_msdu_end TLV
* hal_rx_msdu_end_da_idx_get_6122() - API to get da_idx from rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: da index
*/
static uint16_t hal_rx_msdu_end_da_idx_get_6122(uint8_t *buf)
@@ -603,10 +599,11 @@ static uint16_t hal_rx_msdu_end_da_idx_get_6122(uint8_t *buf)
}
/**
* hal_rx_get_rx_fragment_number_6122(): Function to retrieve rx fragment number
* hal_rx_get_rx_fragment_number_6122() - Function to retrieve rx fragment
* number
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: rx fragment number
* Return: rx fragment number
*/
static
uint8_t hal_rx_get_rx_fragment_number_6122(uint8_t *buf)
@@ -620,10 +617,10 @@ uint8_t hal_rx_get_rx_fragment_number_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_da_is_mcbc_get_6122(): API to check if pkt is MCBC
* from rx_msdu_end TLV
* hal_rx_msdu_end_da_is_mcbc_get_6122() - API to check if pkt is MCBC from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: da_is_mcbc
*/
static uint8_t
@@ -636,10 +633,10 @@ hal_rx_msdu_end_da_is_mcbc_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_sa_is_valid_get_6122(): API to get_6122 the
* sa_is_valid bit from rx_msdu_end TLV
* hal_rx_msdu_end_sa_is_valid_get_6122() - API to get_6122 the sa_is_valid bit
* from rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: sa_is_valid bit
*/
static uint8_t
@@ -655,10 +652,10 @@ hal_rx_msdu_end_sa_is_valid_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_sa_idx_get_6122(): API to get_6122 the
* sa_idx from rx_msdu_end TLV
* hal_rx_msdu_end_sa_idx_get_6122() - API to get_6122 the sa_idx from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: sa_idx (SA AST index)
*/
static uint16_t hal_rx_msdu_end_sa_idx_get_6122(uint8_t *buf)
@@ -674,8 +671,6 @@ static uint16_t hal_rx_msdu_end_sa_idx_get_6122(uint8_t *buf)
/**
* hal_rx_desc_is_first_msdu_6122() - Check if first msdu
*
* @hal_soc_hdl: hal_soc handle
* @hw_desc_addr: hardware descriptor address
*
* Return: 0 - success/ non-zero failure
@@ -689,10 +684,10 @@ static uint32_t hal_rx_desc_is_first_msdu_6122(void *hw_desc_addr)
}
/**
* hal_rx_msdu_end_l3_hdr_padding_get_6122(): API to get_6122 the
* l3_header padding from rx_msdu_end TLV
* hal_rx_msdu_end_l3_hdr_padding_get_6122() - API to get_6122 the l3_header
* padding from rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: number of l3 header padding bytes
*/
static uint32_t hal_rx_msdu_end_l3_hdr_padding_get_6122(uint8_t *buf)
@@ -707,10 +702,10 @@ static uint32_t hal_rx_msdu_end_l3_hdr_padding_get_6122(uint8_t *buf)
}
/**
* @ hal_rx_encryption_info_valid_6122: Returns encryption type.
* hal_rx_encryption_info_valid_6122() - Returns encryption type.
* @buf: rx_tlv_hdr of the received packet
*
* @ buf: rx_tlv_hdr of the received packet
* @ Return: encryption type
* Return: encryption type
*/
inline uint32_t hal_rx_encryption_info_valid_6122(uint8_t *buf)
{
@@ -723,11 +718,11 @@ inline uint32_t hal_rx_encryption_info_valid_6122(uint8_t *buf)
return encryption_info;
}
/*
* @ hal_rx_print_pn_6122: Prints the PN of rx packet.
/**
* hal_rx_print_pn_6122() - Prints the PN of rx packet.
* @buf: rx_tlv_hdr of the received packet
*
* @ buf: rx_tlv_hdr of the received packet
* @ Return: void
* Return: void
*/
static void hal_rx_print_pn_6122(uint8_t *buf)
{
@@ -746,10 +741,10 @@ static void hal_rx_print_pn_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_first_msdu_get_6122: API to get first msdu status
* from rx_msdu_end TLV
* hal_rx_msdu_end_first_msdu_get_6122() - API to get first msdu status from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: first_msdu
*/
static uint8_t hal_rx_msdu_end_first_msdu_get_6122(uint8_t *buf)
@@ -764,10 +759,10 @@ static uint8_t hal_rx_msdu_end_first_msdu_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_da_is_valid_get_6122: API to check if da is valid
* from rx_msdu_end TLV
* hal_rx_msdu_end_da_is_valid_get_6122() - API to check if da is valid from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: da_is_valid
*/
static uint8_t hal_rx_msdu_end_da_is_valid_get_6122(uint8_t *buf)
@@ -782,10 +777,10 @@ static uint8_t hal_rx_msdu_end_da_is_valid_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_last_msdu_get_6122: API to get last msdu status
* from rx_msdu_end TLV
* hal_rx_msdu_end_last_msdu_get_6122() - API to get last msdu status from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* @ buf: pointer to the start of RX PKT TLV headers
* Return: last_msdu
*/
static uint8_t hal_rx_msdu_end_last_msdu_get_6122(uint8_t *buf)
@@ -799,11 +794,11 @@ static uint8_t hal_rx_msdu_end_last_msdu_get_6122(uint8_t *buf)
return last_msdu;
}
/*
* hal_rx_get_mpdu_mac_ad4_valid(): Retrieves if mpdu 4th addr is valid
/**
* hal_rx_get_mpdu_mac_ad4_valid_6122() - Retrieves if mpdu 4th addr is valid
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: value of mpdu 4th address valid field
* Return: value of mpdu 4th address valid field
*/
inline bool hal_rx_get_mpdu_mac_ad4_valid_6122(uint8_t *buf)
{
@@ -817,7 +812,7 @@ inline bool hal_rx_get_mpdu_mac_ad4_valid_6122(uint8_t *buf)
}
/**
* hal_rx_mpdu_start_sw_peer_id_get_6122: Retrieve sw peer_id
* hal_rx_mpdu_start_sw_peer_id_get_6122() - Retrieve sw peer_id
* @buf: network buffer
*
* Return: sw peer_id
@@ -832,11 +827,10 @@ static uint32_t hal_rx_mpdu_start_sw_peer_id_get_6122(uint8_t *buf)
&mpdu_start->rx_mpdu_info_details);
}
/*
* hal_rx_mpdu_get_to_ds_6122(): API to get the tods info
* from rx_mpdu_start
*
/**
* hal_rx_mpdu_get_to_ds_6122() - API to get the tods info from rx_mpdu_start
* @buf: pointer to the start of RX PKT TLV header
*
* Return: uint32_t(to_ds)
*/
static uint32_t hal_rx_mpdu_get_to_ds_6122(uint8_t *buf)
@@ -850,11 +844,10 @@ static uint32_t hal_rx_mpdu_get_to_ds_6122(uint8_t *buf)
return HAL_RX_MPDU_GET_TODS(mpdu_info);
}
/*
* hal_rx_mpdu_get_fr_ds_6122(): API to get the from ds info
* from rx_mpdu_start
*
/**
* hal_rx_mpdu_get_fr_ds_6122() - API to get the from ds info from rx_mpdu_start
* @buf: pointer to the start of RX PKT TLV header
*
* Return: uint32_t(fr_ds)
*/
static uint32_t hal_rx_mpdu_get_fr_ds_6122(uint8_t *buf)
@@ -868,12 +861,12 @@ static uint32_t hal_rx_mpdu_get_fr_ds_6122(uint8_t *buf)
return HAL_RX_MPDU_GET_FROMDS(mpdu_info);
}
/*
* hal_rx_get_mpdu_frame_control_valid_6122(): Retrieves mpdu
* frame control valid
/**
* hal_rx_get_mpdu_frame_control_valid_6122() - Retrieves mpdu frame control
* valid
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: value of frame control valid field
* Return: value of frame control valid field
*/
static uint8_t hal_rx_get_mpdu_frame_control_valid_6122(uint8_t *buf)
{
@@ -884,11 +877,11 @@ static uint8_t hal_rx_get_mpdu_frame_control_valid_6122(uint8_t *buf)
}
/**
* hal_rx_get_mpdu_frame_control_field_6122(): Function to
* retrieve frame control field
* hal_rx_get_mpdu_frame_control_field_6122() - Function to retrieve frame
* control field
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: value of frame control field
* Return: value of frame control field
*
*/
static uint16_t hal_rx_get_mpdu_frame_control_field_6122(uint8_t *buf)
@@ -902,11 +895,11 @@ static uint16_t hal_rx_get_mpdu_frame_control_field_6122(uint8_t *buf)
return frame_ctrl;
}
/*
* hal_rx_mpdu_get_addr1_6122(): API to check get address1 of the mpdu
*
/**
* hal_rx_mpdu_get_addr1_6122() - API to check get address1 of the mpdu
* @buf: pointer to the start of RX PKT TLV headera
* @mac_addr: pointer to mac address
*
* Return: success/failure
*/
static QDF_STATUS hal_rx_mpdu_get_addr1_6122(uint8_t *buf,
@@ -936,12 +929,12 @@ static QDF_STATUS hal_rx_mpdu_get_addr1_6122(uint8_t *buf,
return QDF_STATUS_E_FAILURE;
}
/*
* hal_rx_mpdu_get_addr2_6122(): API to check get address2 of the mpdu
* in the packet
*
/**
* hal_rx_mpdu_get_addr2_6122() - API to check get address2 of the mpdu in the
* packet
* @buf: pointer to the start of RX PKT TLV header
* @mac_addr: pointer to mac address
*
* Return: success/failure
*/
static QDF_STATUS hal_rx_mpdu_get_addr2_6122(uint8_t *buf, uint8_t *mac_addr)
@@ -970,12 +963,11 @@ static QDF_STATUS hal_rx_mpdu_get_addr2_6122(uint8_t *buf, uint8_t *mac_addr)
return QDF_STATUS_E_FAILURE;
}
/*
* hal_rx_mpdu_get_addr3_6122(): API to get address3 of the mpdu
* in the packet
*
/**
* hal_rx_mpdu_get_addr3_6122() - API to get address3 of the mpdu in the packet
* @buf: pointer to the start of RX PKT TLV header
* @mac_addr: pointer to mac address
*
* Return: success/failure
*/
static QDF_STATUS hal_rx_mpdu_get_addr3_6122(uint8_t *buf, uint8_t *mac_addr)
@@ -1004,12 +996,11 @@ static QDF_STATUS hal_rx_mpdu_get_addr3_6122(uint8_t *buf, uint8_t *mac_addr)
return QDF_STATUS_E_FAILURE;
}
/*
* hal_rx_mpdu_get_addr4_6122(): API to get address4 of the mpdu
* in the packet
*
/**
* hal_rx_mpdu_get_addr4_6122() - API to get address4 of the mpdu in the packet
* @buf: pointer to the start of RX PKT TLV header
* @mac_addr: pointer to mac address
*
* Return: success/failure
*/
static QDF_STATUS hal_rx_mpdu_get_addr4_6122(uint8_t *buf, uint8_t *mac_addr)
@@ -1038,12 +1029,12 @@ static QDF_STATUS hal_rx_mpdu_get_addr4_6122(uint8_t *buf, uint8_t *mac_addr)
return QDF_STATUS_E_FAILURE;
}
/*
* hal_rx_get_mpdu_sequence_control_valid_6122(): Get mpdu
* sequence control valid
/**
* hal_rx_get_mpdu_sequence_control_valid_6122() - Get mpdu sequence control
* valid
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: value of sequence control valid field
* Return: value of sequence control valid field
*/
static uint8_t hal_rx_get_mpdu_sequence_control_valid_6122(uint8_t *buf)
{
@@ -1054,9 +1045,8 @@ static uint8_t hal_rx_get_mpdu_sequence_control_valid_6122(uint8_t *buf)
}
/**
* hal_rx_is_unicast_6122: check packet is unicast frame or not.
*
* @ buf: pointer to rx pkt TLV.
* hal_rx_is_unicast_6122() - check packet is unicast frame or not.
* @buf: pointer to rx pkt TLV.
*
* Return: true on unicast.
*/
@@ -1077,7 +1067,7 @@ static bool hal_rx_is_unicast_6122(uint8_t *buf)
}
/**
* hal_rx_tid_get_6122: get tid based on qos control valid.
* hal_rx_tid_get_6122() - get tid based on qos control valid.
* @hal_soc_hdl: hal soc handle
* @buf: pointer to rx pkt TLV.
*
@@ -1102,7 +1092,7 @@ static uint32_t hal_rx_tid_get_6122(hal_soc_handle_t hal_soc_hdl, uint8_t *buf)
}
/**
* hal_rx_hw_desc_get_ppduid_get_6122(): retrieve ppdu id
* hal_rx_hw_desc_get_ppduid_get_6122() - retrieve ppdu id
* @rx_tlv_hdr: rx tlv header
* @rxdma_dst_ring_desc: rxdma HW descriptor
*
@@ -1117,12 +1107,12 @@ static uint32_t hal_rx_hw_desc_get_ppduid_get_6122(void *rx_tlv_hdr,
}
/**
* hal_reo_status_get_header_6122 - Process reo desc info
* hal_reo_status_get_header_6122() - Process reo desc info
* @ring_desc: REO status ring descriptor
* @b - tlv type info
* @h1 - Pointer to hal_reo_status_header where info to be stored
* @b: tlv type info
* @h1: Pointer to hal_reo_status_header where info to be stored
*
* Return - none.
* Return: none.
*
*/
static void hal_reo_status_get_header_6122(hal_ring_desc_t ring_desc, int b,
@@ -1221,8 +1211,8 @@ static void hal_reo_status_get_header_6122(hal_ring_desc_t ring_desc, int b,
}
/**
* hal_rx_mpdu_start_mpdu_qos_control_valid_get_6122():
* Retrieve qos control valid bit from the tlv.
* hal_rx_mpdu_start_mpdu_qos_control_valid_get_6122() - Retrieve qos control
* valid bit from the tlv.
* @buf: pointer to rx pkt TLV.
*
* Return: qos control value.
@@ -1239,8 +1229,8 @@ hal_rx_mpdu_start_mpdu_qos_control_valid_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_end_sa_sw_peer_id_get_6122(): API to get the
* sa_sw_peer_id from rx_msdu_end TLV
* hal_rx_msdu_end_sa_sw_peer_id_get_6122() - API to get the sa_sw_peer_id from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: sa_sw_peer_id index
@@ -1255,7 +1245,7 @@ hal_rx_msdu_end_sa_sw_peer_id_get_6122(uint8_t *buf)
}
/**
* hal_tx_desc_set_mesh_en_6122 - Set mesh_enable flag in Tx descriptor
* hal_tx_desc_set_mesh_en_6122() - Set mesh_enable flag in Tx descriptor
* @desc: Handle to Tx Descriptor
* @en: For raw WiFi frames, this indicates transmission to a mesh STA,
* enabling the interpretation of the 'Mesh Control Present' bit
@@ -1330,7 +1320,7 @@ hal_rx_get_ppdu_id_6122(uint8_t *buf)
}
/**
* hal_reo_config_6122(): Set reo config parameters
* hal_reo_config_6122() - Set reo config parameters
* @soc: hal soc handle
* @reg_val: value to be set
* @reo_params: reo parameters
@@ -1347,9 +1337,9 @@ hal_reo_config_6122(struct hal_soc *soc,
/**
* hal_rx_msdu_desc_info_get_ptr_6122() - Get msdu desc info ptr
* @msdu_details_ptr - Pointer to msdu_details_ptr
* @msdu_details_ptr: Pointer to msdu_details_ptr
*
* Return - Pointer to rx_msdu_desc_info structure.
* Return: Pointer to rx_msdu_desc_info structure.
*
*/
static void *hal_rx_msdu_desc_info_get_ptr_6122(void *msdu_details_ptr)
@@ -1359,9 +1349,9 @@ static void *hal_rx_msdu_desc_info_get_ptr_6122(void *msdu_details_ptr)
/**
* hal_rx_link_desc_msdu0_ptr_6122 - Get pointer to rx_msdu details
* @link_desc - Pointer to link desc
* @link_desc: Pointer to link desc
*
* Return - Pointer to rx_msdu_details structure
* Return: Pointer to rx_msdu_details structure
*
*/
static void *hal_rx_link_desc_msdu0_ptr_6122(void *link_desc)
@@ -1370,8 +1360,7 @@ static void *hal_rx_link_desc_msdu0_ptr_6122(void *link_desc)
}
/**
* hal_rx_msdu_flow_idx_get_6122: API to get flow index
* from rx_msdu_end TLV
* hal_rx_msdu_flow_idx_get_6122() - API to get flow index from rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: flow index value from MSDU END TLV
@@ -1385,8 +1374,8 @@ static inline uint32_t hal_rx_msdu_flow_idx_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_flow_idx_invalid_6122: API to get flow index invalid
* from rx_msdu_end TLV
* hal_rx_msdu_flow_idx_invalid_6122() - API to get flow index invalid from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: flow index invalid value from MSDU END TLV
@@ -1400,8 +1389,8 @@ static bool hal_rx_msdu_flow_idx_invalid_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_flow_idx_timeout_6122: API to get flow index timeout
* from rx_msdu_end TLV
* hal_rx_msdu_flow_idx_timeout_6122() - API to get flow index timeout from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: flow index timeout value from MSDU END TLV
@@ -1415,8 +1404,8 @@ static bool hal_rx_msdu_flow_idx_timeout_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_fse_metadata_get_6122: API to get FSE metadata
* from rx_msdu_end TLV
* hal_rx_msdu_fse_metadata_get_6122() - API to get FSE metadata from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: fse metadata value from MSDU END TLV
@@ -1430,8 +1419,8 @@ static uint32_t hal_rx_msdu_fse_metadata_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_cce_metadata_get_6122: API to get CCE metadata
* from rx_msdu_end TLV
* hal_rx_msdu_cce_metadata_get_6122() - API to get CCE metadata from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
*
* Return: cce_metadata
@@ -1446,8 +1435,9 @@ hal_rx_msdu_cce_metadata_get_6122(uint8_t *buf)
}
/**
* hal_rx_msdu_get_flow_params_6122: API to get flow index, flow index invalid
* and flow index timeout from rx_msdu_end TLV
* hal_rx_msdu_get_flow_params_6122() - API to get flow index, flow index
* invalid and flow index timeout from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
* @flow_invalid: pointer to return value of flow_idx_valid
* @flow_timeout: pointer to return value of flow_idx_timeout
@@ -1482,10 +1472,10 @@ hal_rx_tlv_get_tcp_chksum_6122(uint8_t *buf)
}
/**
* hal_rx_get_rx_sequence_6122(): Function to retrieve rx sequence number
* hal_rx_get_rx_sequence_6122() - Function to retrieve rx sequence number
* @buf: Network buffer
*
* @nbuf: Network buffer
* Returns: rx sequence number
* Return: rx sequence number
*/
static
uint16_t hal_rx_get_rx_sequence_6122(uint8_t *buf)
@@ -1496,15 +1486,16 @@ uint16_t hal_rx_get_rx_sequence_6122(uint8_t *buf)
return HAL_RX_MPDU_GET_SEQUENCE_NUMBER(rx_mpdu_info);
}
#define SPRUCE_SEQ_WCSS_UMAC_OFFSET 0x00a00000
#define SPRUCE_CE_WFSS_CE_REG_BASE 0x3B80000
/**
* hal_get_window_address_6122(): Function to get hp/tp address
* hal_get_window_address_6122() - Function to get hp/tp address
* @hal_soc: Pointer to hal_soc
* @addr: address offset of register
*
* Return: modified address offset of register
*/
#define SPRUCE_SEQ_WCSS_UMAC_OFFSET 0x00a00000
#define SPRUCE_CE_WFSS_CE_REG_BASE 0x3B80000
static inline qdf_iomem_t hal_get_window_address_6122(struct hal_soc *hal_soc,
qdf_iomem_t addr)
{
@@ -1542,11 +1533,10 @@ static inline void hal_write_window_register(struct hal_soc *hal_soc)
}
/**
* hal_rx_msdu_packet_metadata_get_6122(): API to get the
* msdu information from rx_msdu_end TLV
*
* @ buf: pointer to the start of RX PKT TLV headers
* @ hal_rx_msdu_metadata: pointer to the msdu info structure
* hal_rx_msdu_packet_metadata_get_6122() - API to get the msdu information from
* rx_msdu_end TLV
* @buf: pointer to the start of RX PKT TLV headers
* @msdu_pkt_metadata: pointer to the msdu info structure
*/
static void
hal_rx_msdu_packet_metadata_get_6122(uint8_t *buf,
@@ -1567,9 +1557,9 @@ hal_rx_msdu_packet_metadata_get_6122(uint8_t *buf,
/**
* hal_rx_flow_setup_fse_6122() - 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
* @table_offset: offset into the table where the flow is to be setup
* @flow: Flow Parameters
* @rx_flow: Flow Parameters
*
* Return: Success/Failure
*/
@@ -2372,8 +2362,10 @@ struct hal_hw_srng_config hw_srng_table_6122[] = {
};
/**
* hal_qcn6122_attach()- Attach 6122 target specific hal_soc ops,
* offset and srng table
* hal_qcn6122_attach() - Attach 6122 target specific hal_soc ops,
* offset and srng table
* @hal_soc: HAL SoC Context
*
* Return: void
*/
void hal_qcn6122_attach(struct hal_soc *hal_soc)

مشاهده پرونده

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2020-2021, The Linux Foundation. All rights reserved.
* Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
* Copyright (c) 2022-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
@@ -113,11 +113,11 @@ static void hal_tx_set_dscp_tid_map_6122(struct hal_soc *soc,
/**
* hal_tx_update_dscp_tid_6122() - Update the dscp tid map table as
updated by user
* updated by user
* @soc: HAL SoC context
* @map: DSCP-TID mapping table
* @id : MAP ID
* @dscp: DSCP_TID map index
* @tid: TID
* @id: MAP ID
* @dscp: DSCP
*
* Return: void
*/
@@ -211,7 +211,7 @@ static void hal_tx_desc_set_lmac_id_6122(void *desc, uint8_t lmac_id)
/**
* hal_tx_init_cmd_credit_ring_6122() - Initialize TCL command/credit SRNG
* @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
*/