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

qcacmn: Fix WMI documentation

Browse Source 
The kernel-doc script identified many documentation issues in
the wmi folder, so fix them.

Note that in quite a few cases there is duplicate documentation in .h
and .c files, and in those cases remove the documentation from the .c
files since the interface should be documented, not the
implementation.

Change-Id: I097d5b8e8f0ba09046b7b8abe338d05a00f8cc7e
CRs-Fixed: 3372831
This commit is contained in:
Jeff Johnson
2022-12-22 17:29:33 -08:00
committed by Madan Koyyalamudi
parent f75a30225c
commit 213581ab0b
37 changed files with 582 additions and 773 deletions
Download Patch File Download Diff File Expand all files Collapse all files

375
wmi/inc/wmi_unified_api.h
View File

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2013-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
@@ -142,6 +142,7 @@ struct policy_mgr_dual_mac_config;
* enum wmi_target_type - type of supported wmi command
* @WMI_TLV_TARGET: tlv based target
* @WMI_NON_TLV_TARGET: non-tlv based target
* @WMI_MAX_TARGET_TYPE: max value
*
*/
enum wmi_target_type {
@@ -154,6 +155,7 @@ enum wmi_target_type {
* enum wmi_rx_exec_ctx - wmi rx execution context
* @WMI_RX_WORK_CTX: work queue context execution provided by WMI layer
* @WMI_RX_UMAC_CTX: execution context provided by umac layer
* @WMI_RX_TASKLET_CTX: legacy name for UMAC context
* @WMI_RX_SERIALIZER_CTX: Execution context is serialized thread context
* @WMI_RX_DIAG_WORK_CTX: work queue execution context for FW diag events
*/
@@ -220,10 +222,9 @@ struct wmi_unified_exec_ctx {
};
/**
* attach for unified WMI
*
* @param scn_handle : handle to SCN.
* @param params : attach params for WMI
* wmi_unified_attach() - attach for unified WMI
* @scn_handle: handle to SCN.
* @params: attach params for WMI
*
*/
void *wmi_unified_attach(void *scn_handle,
@@ -246,38 +247,36 @@ void wmi_mgmt_cmd_record(wmi_unified_t wmi_handle, uint32_t cmd,
void *header, uint32_t vdev_id, uint32_t chanfreq);
/**
* detach for unified WMI
* wmi_unified_detach() - detach for unified WMI
* @wmi_handle: handle to WMI.
*
* @param wmi_handle : handle to WMI.
* @return void.
* Return: void.
*/
void wmi_unified_detach(struct wmi_unified *wmi_handle);
/**
* API to sync time between host and firmware
*
* wmi_send_time_stamp_sync_cmd_tlv() - API to sync time between host and
* firmware
* @wmi_handle: handle to WMI.
*
* Return: none
*/
void wmi_send_time_stamp_sync_cmd_tlv(wmi_unified_t wmi_handle);
/**
* wmi_unified_remove_work() - detach for WMI work
* @wmi_handle: handle to WMI
*
* A function that does not fully detach WMI, but just remove work
* queue items associated with it. This is used to make sure that
* before any other processing code that may destroy related contexts
* (HTC, etc), work queue processing on WMI has already been stopped.
*
* Return: None
*/
void
wmi_unified_remove_work(struct wmi_unified *wmi_handle);
/**
* generic function to allocate WMI buffer
*
* @param wmi_handle : handle to WMI.
* @param len : length of the buffer
* @return wmi_buf_t.
*/
#ifdef NBUF_MEMORY_DEBUG
#define wmi_buf_alloc(h, l) wmi_buf_alloc_debug(h, l, __func__, __LINE__)
wmi_buf_t
wmi_buf_alloc_debug(wmi_unified_t wmi_handle, uint32_t len,
const char *func_name, uint32_t line_num);
#else
/**
* wmi_buf_alloc() - generic function to allocate WMI buffer
* @wmi_handle: handle to WMI.
@@ -285,6 +284,14 @@ wmi_buf_alloc_debug(wmi_unified_t wmi_handle, uint32_t len,
*
* Return: return wmi_buf_t or null if memory alloc fails
*/
#ifdef NBUF_MEMORY_DEBUG
#define wmi_buf_alloc(wmi_handle, len) \
wmi_buf_alloc_debug(wmi_handle, len, __func__, __LINE__)
wmi_buf_t
wmi_buf_alloc_debug(wmi_unified_t wmi_handle, uint32_t len,
const char *func_name, uint32_t line_num);
#else
#define wmi_buf_alloc(wmi_handle, len) \
wmi_buf_alloc_fl(wmi_handle, len, __func__, __LINE__)
@@ -293,9 +300,9 @@ wmi_buf_t wmi_buf_alloc_fl(wmi_unified_t wmi_handle, uint32_t len,
#endif
/**
* generic function frees WMI net buffer
* wmi_buf_free() - generic function frees WMI net buffer
*
* @param net_buf : Pointer to net_buf to be freed
* @net_buf : Pointer to net_buf to be freed
*/
void wmi_buf_free(wmi_buf_t net_buf);
@@ -452,8 +459,8 @@ wmi_unified_register_raw_event_handler(wmi_unified_t wmi_handle,
/**
* wmi_unified_unregister_event_handler() - WMI event handler unregister
* function
* wmi_handle: handle to WMI.
* event_id: WMI event ID
* @wmi_handle: handle to WMI.
* @event_id: WMI event ID
*
* Return: QDF_STATUS
*/
@@ -496,8 +503,7 @@ wmi_diag_connect_pdev_htc_service(struct wmi_unified *wmi_handle,
#if defined(WLAN_DIAG_AND_DBR_OVER_SEPARATE_CE)
/**
* wmi_dbr_connect_pdev_htc_service()
* WMI DBR API to get connect to HTC service
* wmi_dbr_connect_pdev_htc_service() - WMI DBR API to connect to HTC service
* @wmi_handle: handle to WMI.
* @htc_handle: handle to HTC.
*
@@ -515,38 +521,41 @@ wmi_dbr_connect_pdev_htc_service(struct wmi_unified *wmi_handle,
}
#endif
/*
* WMI API to verify the host has enough credits to suspend
* @param wmi_handle : handle to WMI.
/**
* wmi_is_suspend_ready() - WMI API to verify the host has enough credits
* to suspend
* @wmi_handle: handle to WMI.
*/
int wmi_is_suspend_ready(wmi_unified_t wmi_handle);
/**
* WMI API to get updated host_credits
* @param wmi_handle : handle to WMI.
* wmi_get_host_credits() - WMI API to get updated host_credits
* @wmi_handle : handle to WMI.
*/
int wmi_get_host_credits(wmi_unified_t wmi_handle);
/**
* WMI API to get WMI Pending Commands in the HTC queue
* @param wmi_handle : handle to WMI.
* wmi_get_pending_cmds() - WMI API to get WMI Pending Commands in the HTC
* queue
* @wmi_handle: handle to WMI.
*/
int wmi_get_pending_cmds(wmi_unified_t wmi_handle);
/**
* WMI API to set target suspend state
* @param wmi_handle : handle to WMI.
* @param val : suspend state boolean
* wmi_set_target_suspend() - WMI API to set target suspend state
* @wmi_handle: handle to WMI.
* @val: suspend state boolean
*/
void wmi_set_target_suspend(wmi_unified_t wmi_handle, bool val);
/**
* WMI API to set target suspend command acked flag
* @param wmi_handle : handle to WMI.
* @param val : suspend command acked flag boolean
* wmi_set_target_suspend_acked() - WMI API to set target suspend command
* acked flag
* @wmi_handle: handle to WMI.
* @val: suspend command acked flag boolean
*/
void wmi_set_target_suspend_acked(wmi_unified_t wmi_handle, bool val);
@@ -573,9 +582,9 @@ bool wmi_is_target_suspend_acked(struct wmi_unified *wmi_handle);
#ifdef WLAN_FEATURE_WMI_SEND_RECV_QMI
/**
* wmi_set_qmi_stats() - WMI API to set qmi stats enabled/disabled
* @wmi_handle: handle to WMI.
* @val: suspend state boolean
* wmi_set_qmi_stats() - WMI API to set qmi stats enabled/disabled
* @wmi_handle: handle to WMI.
* @val: suspend state boolean
*/
void wmi_set_qmi_stats(wmi_unified_t wmi_handle, bool val);
@@ -602,40 +611,42 @@ bool wmi_is_qmi_stats_enabled(struct wmi_unified *wmi_handle)
#endif /* end if of WLAN_FEATURE_WMI_SEND_RECV_QMI */
/**
* WMI API to set bus suspend state
* @param wmi_handle: handle to WMI.
* @param val: suspend state boolean
* wmi_set_is_wow_bus_suspended() - WMI API to set bus suspend state
* @wmi_handle: handle to WMI.
* @val: suspend state boolean
*/
void wmi_set_is_wow_bus_suspended(wmi_unified_t wmi_handle, A_BOOL val);
/**
* WMI API to set crash injection state
* @param wmi_handle: handle to WMI.
* @param val: crash injection state boolean
* wmi_tag_crash_inject() - WMI API to set crash injection state
* @wmi_handle: handle to WMI.
* @flag: crash injection state boolean
*/
void wmi_tag_crash_inject(wmi_unified_t wmi_handle, A_BOOL flag);
/**
* WMI API to set target assert
* @param wmi_handle: handle to WMI.
* @param val: target assert config value.
* wmi_set_tgt_assert() - WMI API to set target assert
* @wmi_handle: handle to WMI.
* @val: target assert config value.
*
* Return: none.
* Return: none.
*/
void wmi_set_tgt_assert(wmi_unified_t wmi_handle, bool val);
/**
* generic function to block unified WMI command
* @param wmi_handle : handle to WMI.
* @return 0 on success and -ve on failure.
* wmi_stop() - generic function to block unified WMI command
* @wmi_handle: handle to WMI.
*
* Return: 0 on success and -ve on failure.
*/
int
wmi_stop(wmi_unified_t wmi_handle);
/**
* generic function to start unified WMI command
* @param wmi_handle : handle to WMI.
* @return 0 on success and -ve on failure.
* wmi_start() - generic function to start unified WMI command
* @wmi_handle: handle to WMI.
*
* Return: 0 on success and -ve on failure.
*/
int
wmi_start(wmi_unified_t wmi_handle);
@@ -644,23 +655,24 @@ wmi_start(wmi_unified_t wmi_handle);
* wmi_is_blocked() - generic function to check if WMI is blocked
* @wmi_handle: handle to WMI.
*
* @Return: true, if blocked, false if not blocked
* Return: true, if blocked, false if not blocked
*/
bool
wmi_is_blocked(wmi_unified_t wmi_handle);
/**
* API to flush all the previous packets associated with the wmi endpoint
* wmi_flush_endpoint() - API to flush all the previous packets associated
* with the wmi endpoint
*
* @param wmi_handle : handle to WMI.
* @wmi_handle: handle to WMI.
*/
void
wmi_flush_endpoint(wmi_unified_t wmi_handle);
/**
* API to stop wmi sequence check
* wmi_interface_sequence_stop() - API to stop wmi sequence check
*
* @param wmi_handle : handle to WMI.
* @wmi_handle: handle to WMI.
*/
void
wmi_interface_sequence_stop(wmi_unified_t wmi_handle);
@@ -670,26 +682,39 @@ wmi_interface_sequence_stop(wmi_unified_t wmi_handle);
* conversion in WMI. By default pdev_id and
* phyid conversion is not done in WMI.
* This API can be used enable conversion in WMI.
* @param wmi_handle : handle to WMI
* @param *pdev_id_map : pdev conversion map
* @param size : size of pdev_id_map
* Return none
* @wmi_handle: handle to WMI
* @pdev_id_map: pdev conversion map
* @size: size of pdev_id_map
*
* Return: none
*/
void wmi_pdev_id_conversion_enable(wmi_unified_t wmi_handle,
uint32_t *pdev_id_map,
uint8_t size);
/**
* API to handle wmi rx event after UMAC has taken care of execution
* context
* __wmi_control_rx() - API to handle wmi rx event after UMAC has taken care
* of execution context
*
* @param wmi_handle : handle to WMI.
* @param evt_buf : wmi event buffer
* @wmi_handle: handle to WMI.
* @evt_buf: wmi event buffer
*/
void __wmi_control_rx(struct wmi_unified *wmi_handle, wmi_buf_t evt_buf);
#ifdef FEATURE_RUNTIME_PM
/**
* wmi_set_runtime_pm_inprogress() - set runtime pm progress flag
* @wmi_handle: wmi context
* @val: runtime pm progress flag
*/
void
wmi_set_runtime_pm_inprogress(wmi_unified_t wmi_handle, bool val);
/**
* wmi_get_runtime_pm_inprogress() - get runtime pm progress flag
* @wmi_handle: wmi context
*
* Return: value of runtime pm progress flag
*/
bool wmi_get_runtime_pm_inprogress(wmi_unified_t wmi_handle);
#else
static inline void
@@ -703,16 +728,42 @@ static inline bool wmi_get_runtime_pm_inprogress(wmi_unified_t wmi_handle)
}
#endif
/**
* wmi_unified_get_soc_handle: Get WMI SoC handle
* @wmi_handle: WMI context got from wmi_attach
*
* Return: Pointer to Soc handle
*/
void *wmi_unified_get_soc_handle(struct wmi_unified *wmi_handle);
/**
* wmi_unified_get_pdev_handle: Get WMI SoC handle
* @soc: Pointer to wmi soc object
* @pdev_idx: pdev index
*
* Return: Pointer to wmi handle or NULL on failure
*/
void *wmi_unified_get_pdev_handle(struct wmi_soc *soc, uint32_t pdev_idx);
/**
* UMAC Callback to process fw event.
* @param wmi_handle : handle to WMI.
* @param evt_buf : wmi event buffer
* wmi_process_fw_event() - UMAC Callback to process fw event.
* @wmi_handle: handle to WMI.
* @evt_buf: wmi event buffer
*
* This function process fw event in caller context
*
* Return: none
*/
void wmi_process_fw_event(struct wmi_unified *wmi_handle, wmi_buf_t evt_buf);
/**
* wmi_get_max_msg_len() - get maximum WMI message length
* @wmi_handle: WMI handle.
*
* This function returns the maximum WMI message length
*
* Return: maximum WMI message length
*/
uint16_t wmi_get_max_msg_len(wmi_unified_t wmi_handle);
/**
@@ -729,8 +780,8 @@ QDF_STATUS wmi_unified_soc_set_hw_mode_cmd(wmi_unified_t wmi_handle,
uint32_t hw_mode_index);
/**
* wmi_extract_hw_mode_resp() - function to extract HW mode change response
* @wmi_hdl: WMI handle
* wmi_unified_extract_hw_mode_resp() - Extract HW mode change response
* @wmi: WMI handle
* @evt_buf: Buffer holding event data
* @cmd_status: command status
*
@@ -874,7 +925,7 @@ QDF_STATUS wmi_unified_vdev_down_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_vdev_start_send() - send vdev start command to fw
* @wmi_handle: wmi handle
* @vdev_id: vdev id
* @req: pointer to hold vdev start parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -895,7 +946,6 @@ wmi_unified_vdev_set_nac_rssi_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_vdev_set_param_send() - WMI vdev set parameter function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold vdev set parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -957,10 +1007,9 @@ wmi_unified_roam_set_param_send(wmi_unified_t wmi_handle,
#endif
/**
* wmi_unified_vdev_set_param_send() - WMI vdev set parameter function
* wmi_unified_vdev_set_mu_snif_send() - Set vdev MU sniffer parameters
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold vdev set parameter
* @param: vdev MU sniffer parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1028,7 +1077,7 @@ QDF_STATUS wmi_unified_peer_delete_all_send(
struct peer_delete_all_params *param);
/**
* wmi_set_peer_param() - set peer parameter in fw
* wmi_set_peer_param_send() - set peer parameter in fw
* @wmi_handle: wmi handle
* @peer_addr: peer mac address
* @param: pointer to hold peer set parameter
@@ -1043,9 +1092,7 @@ wmi_set_peer_param_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_peer_create_send() - send peer create command to fw
* @wmi_handle: wmi handle
* @peer_addr: peer mac address
* @peer_type: peer type
* @vdev_id: vdev id
* @param: peer create parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1148,11 +1195,11 @@ QDF_STATUS wmi_unified_peer_based_pktlog_send(wmi_unified_t wmi_handle,
uint8_t enb_dsb);
/**
* wmi_unified_packet_log_disable__send() - WMI pktlog disable function
* wmi_unified_packet_log_disable_send() - WMI pktlog disable function
* @wmi_handle: handle to WMI.
* @PKTLOG_EVENT: packet log event
* @mac_id: Mac id
*
* @return QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
QDF_STATUS wmi_unified_packet_log_disable_send(wmi_unified_t wmi_handle,
uint8_t mac_id);
@@ -1198,7 +1245,7 @@ wmi_unified_pdev_param_send(wmi_unified_t wmi_handle,
* @wmi_handle: handle to WMI.
* @param: pointer to hold FILS Discovery send cmd parameter
*
* @return QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
QDF_STATUS
wmi_unified_fd_tmpl_send_cmd(wmi_unified_t wmi_handle,
@@ -1207,10 +1254,9 @@ wmi_unified_fd_tmpl_send_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_beacon_tmpl_send_cmd() - WMI beacon send function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold beacon send cmd parameter
*
* @return QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
QDF_STATUS
wmi_unified_beacon_tmpl_send_cmd(wmi_unified_t wmi_handle,
@@ -1219,7 +1265,6 @@ wmi_unified_beacon_tmpl_send_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_peer_assoc_send() - WMI peer assoc function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to peer assoc parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1230,7 +1275,6 @@ QDF_STATUS wmi_unified_peer_assoc_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_sta_ps_cmd_send() - set sta powersave parameters
* @wmi_handle: wmi handle
* @peer_addr: peer mac address
* @param: pointer to sta_ps parameter structure
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1241,7 +1285,7 @@ QDF_STATUS wmi_unified_sta_ps_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_ap_ps_cmd_send() - set ap powersave parameters
* @wmi_handle: wmi handle
* @peer_addr: peer mac address
* @macaddr: peer mac address
* @param: pointer to ap_ps parameter structure
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1253,7 +1297,6 @@ QDF_STATUS wmi_unified_ap_ps_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_scan_start_cmd_send() - WMI scan start function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold scan start cmd parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1265,7 +1308,6 @@ wmi_unified_scan_start_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_scan_stop_cmd_send() - WMI scan start function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold scan start cmd parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1277,7 +1319,6 @@ wmi_unified_scan_stop_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_scan_chan_list_cmd_send() - WMI scan channel list function
* @wmi_handle: handle to WMI.
* @macaddr: MAC address
* @param: pointer to hold scan channel list parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1290,7 +1331,7 @@ wmi_unified_scan_chan_list_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_crash_inject() - inject fw crash
* @wmi_handle: wmi handle
* @param: ponirt to crash inject parameter structure
* @param: pointer to crash inject parameter structure
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1298,7 +1339,7 @@ QDF_STATUS wmi_crash_inject(wmi_unified_t wmi_handle,
struct crash_inject *param);
/**
* wmi_unified_pdev_utf_cmd() - send utf command to fw
* wmi_unified_pdev_utf_cmd_send() - send utf command to fw
* @wmi_handle: wmi handle
* @param: pointer to pdev_utf_params
* @mac_id: mac id to have radio context
@@ -1380,7 +1421,7 @@ wmi_unified_set_sta_uapsd_auto_trig_cmd(wmi_unified_t wmi_handle,
struct sta_uapsd_trig_params *param);
/**
* wmi_get_temperature() - get pdev temperature req
* wmi_unified_get_temperature() - get pdev temperature req
* @wmi_handle: wmi handle
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure.
@@ -1388,7 +1429,7 @@ wmi_unified_set_sta_uapsd_auto_trig_cmd(wmi_unified_t wmi_handle,
QDF_STATUS wmi_unified_get_temperature(wmi_unified_t wmi_handle);
/**
* wmi_set_smps_params() - set smps params
* wmi_unified_set_smps_params() - set smps params
* @wmi_handle: wmi handle
* @vdev_id: vdev id
* @value: value
@@ -1400,7 +1441,7 @@ QDF_STATUS wmi_unified_set_smps_params(wmi_unified_t wmi_handle,
int value);
/**
* wmi_set_mimops() - set MIMO powersave
* wmi_unified_set_mimops() - set MIMO powersave
* @wmi_handle: wmi handle
* @vdev_id: vdev id
* @value: value
@@ -1497,7 +1538,7 @@ wmi_unified_setup_install_key_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_get_pn_send_cmd() - send command to fw get PN for peer
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @pn_params: PN parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1508,7 +1549,7 @@ wmi_unified_get_pn_send_cmd(wmi_unified_t wmi_hdl,
/**
* wmi_unified_get_rxpn_send_cmd() - send command to fw get Rx PN for peer
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @pn_params: PN parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -1519,7 +1560,7 @@ wmi_unified_get_rxpn_send_cmd(wmi_unified_t wmi_hdl,
/**
* wmi_unified_p2p_go_set_beacon_ie_cmd() - set beacon IE for p2p go
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @vdev_id: vdev id
* @p2p_ie: p2p IE
*
@@ -1542,7 +1583,8 @@ QDF_STATUS wmi_unified_scan_probe_setoui_cmd(wmi_unified_t wmi_handle,
struct scan_mac_oui *psetoui);
#ifdef IPA_OFFLOAD
/** wmi_unified_ipa_offload_control_cmd() - ipa offload control parameter
/**
* wmi_unified_ipa_offload_control_cmd() - ipa offload control parameter
* @wmi_handle: wmi handle
* @ipa_offload: ipa offload control parameter
*
@@ -1660,7 +1702,6 @@ QDF_STATUS wmi_unified_congestion_request_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_snr_request_cmd() - send request to fw to get RSSI stats
* @wmi_handle: wmi handle
* @rssi_req: get RSSI request
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1713,8 +1754,7 @@ QDF_STATUS wmi_unified_csa_offload_enable(wmi_unified_t wmi_handle,
/**
* wmi_unified_oem_dma_ring_cfg() - configure OEM DMA rings
* @wmi_handle: wmi handle
* @data_len: len of dma cfg req
* @data: dma cfg req
* @cfg: dma cfg req
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1797,7 +1837,7 @@ QDF_STATUS wmi_unified_stats_ext_req_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_process_dhcpserver_offload_cmd() - enable DHCP server offload
* @wmi_handle: wmi handle
* @pDhcpSrvOffloadInfo: DHCP server offload info
* @params: DHCP server offload info
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -1965,7 +2005,7 @@ QDF_STATUS wmi_unified_send_apf_read_work_memory_cmd(wmi_unified_t wmi,
* wmi_extract_apf_read_memory_resp_event() - extract read mem resp event
* @wmi: wmi handle
* @evt_buf: Pointer to the event buffer
* @resp: pointer to memory to extract event parameters into
* @read_mem_evt: pointer to memory to extract event parameters into
*
* This function exctracts read mem response event into the given structure ptr
*
@@ -2011,7 +2051,7 @@ QDF_STATUS
wmi_send_reset_peer_mumimo_tx_count_cmd(wmi_unified_t wmi_handle,
uint32_t value);
/*
/**
* wmi_unified_send_btcoex_wlan_priority_cmd() - send btcoex priority commands
* @wmi_handle: wmi handle
* @param: wmi btcoex cfg params
@@ -2066,7 +2106,7 @@ wmi_unified_send_coex_config_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_send_dbam_config_cmd() - send dbam config command
* @wmi_handle: wmi handle
* @mode: dbam config mode param
* @param: dbam config mode param
*
* Send WMI_COEX_DBAM_CMD param to fw.
*
@@ -2140,7 +2180,7 @@ wmi_extract_fips_extend_event_data(wmi_unified_t wmi_handle, void *evt_buf,
#ifdef WLAN_FEATURE_DISA
/**
* wmi_unified_encrypt_decrypt_send_cmd() - send encryptdecrypt cmd to fw
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @params: encrypt/decrypt params
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -2307,7 +2347,6 @@ QDF_STATUS wmi_unified_set_bridge_mac_addr_cmd_send(
/**
* wmi_unified_phyerr_enable_cmd_send() - WMI phyerr enable cmd function
* @wmi_handle: handle to WMI.
* @param: pointer to hold phyerr enable param
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -2316,7 +2355,6 @@ QDF_STATUS wmi_unified_phyerr_enable_cmd_send(wmi_unified_t wmi_handle);
/**
* wmi_unified_phyerr_disable_cmd_send() - WMI phyerr disable cmd function
* @wmi_handle: handle to WMI.
* @param: pointer to hold phyerr disable param
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -2404,7 +2442,7 @@ QDF_STATUS wmi_extract_pdev_sscan_fft_bin_index(
* wmi_extract_pdev_spectral_session_chan_info() - Extract channel information
* for a spectral scan session
* @wmi_handle: handle to WMI.
* @evt_buf: Event buffer
* @event: Event buffer
* @chan_info: Spectral session channel information data structure to be filled
* by this API
*
@@ -2418,7 +2456,7 @@ QDF_STATUS wmi_extract_pdev_spectral_session_chan_info(
* wmi_extract_pdev_spectral_session_detector_info() - Extract detector
* information for a spectral scan session
* @wmi_handle: handle to WMI.
* @evt_buf: Event buffer
* @event: Event buffer
* @det_info: Spectral session detector information data structure to be filled
* by this API
* @det_info_idx: index in the array of spectral scan detector info TLVs
@@ -2474,8 +2512,8 @@ QDF_STATUS wmi_extract_spectral_fft_size_caps(
#if defined(WLAN_SUPPORT_FILS) || defined(CONFIG_BAND_6GHZ)
/**
* wmi_unified_vdev_fils_enable_cmd_send() - WMI send fils enable command
* @param wmi_handle: handle to WMI.
* @param config_fils_params: fils enable parameters
* @wmi_handle: handle to WMI.
* @param: fils enable parameters
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -2544,8 +2582,7 @@ QDF_STATUS wmi_unified_vdev_set_qdepth_thresh_cmd_send(
#ifdef WLAN_REG_PARTIAL_OFFLOAD
/**
* wmi_unified_pdev_set_regdomain_params_cmd_send() - WMI set regdomain
* function
* wmi_unified_pdev_set_regdomain_cmd_send() - WMI set regdomain function
* @wmi_handle: handle to WMI.
* @param: pointer to hold regdomain param
*
@@ -2710,6 +2747,7 @@ QDF_STATUS wmi_save_service_bitmap(wmi_unified_t wmi_handle, void *evt_buf,
/**
* wmi_save_ext_service_bitmap() - save extended service bitmap
* @wmi_handle: wmi handle
* @bitmap_buf: pointer to event buffer
* @evt_buf: pointer to event buffer
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS failure code
@@ -2756,7 +2794,6 @@ wmi_extract_hal_reg_cap(wmi_unified_t wmi_handle, void *evt_buf,
* @wmi_handle: wmi handle
* @evt_buf: Pointer to event buffer
* @phy_idx: Phy id
* @wireless_modes: 11AX wireless modes
* @hal_reg_cap: pointer to hold HAL reg capabilities ext2 structure
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -2817,7 +2854,7 @@ QDF_STATUS wmi_ready_extract_mac_addr(wmi_unified_t wmi_handle,
void *ev, uint8_t *macaddr);
/**
* wmi_ready_extract_mac_addr() - extract MAC address list from ready event
* wmi_ready_extract_mac_addr_list() - extract MAC address list from ready event
* @wmi_handle: wmi handle
* @ev: pointer to event buffer
* @num_mac_addr: Pointer to number of entries
@@ -2829,8 +2866,8 @@ wmi_host_mac_addr
uint8_t *num_mac_addr);
/**
* wmi_extract_ready_params() - Extract data from ready event apart from
* status, macaddr and version.
* wmi_extract_ready_event_params() - Extract data from ready event apart from
* status, macaddr and version.
* @wmi_handle: Pointer to WMI handle.
* @evt_buf: Pointer to Ready event buffer.
* @ev_param: Pointer to host defined struct to copy the data from event.
@@ -2948,7 +2985,7 @@ QDF_STATUS wmi_unified_lcr_set_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_extract_pn() - extract pn event data
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @evt_buf: pointer to event buffer
* @param: pointer to get pn event param
*
@@ -2959,7 +2996,7 @@ QDF_STATUS wmi_unified_extract_pn(wmi_unified_t wmi_hdl, void *evt_buf,
/**
* wmi_unified_extract_rxpn() - extract Rx PN event data
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @evt_buf: pointer to event buffer
* @param: pointer to get Rx PN event param
*
@@ -2998,9 +3035,9 @@ wmi_extract_fips_event_data(wmi_unified_t wmi_handle, void *evt_buf,
/**
* wmi_extract_encrypt_decrypt_resp_params() -
* extract encrypt decrypt resp params from event buffer
* @wmi_handle: wmi handle
* @wmi_hdl: wmi handle
* @evt_buf: pointer to event buffer
* @resp: encrypt decrypt resp params
* @param: encrypt decrypt resp params
*
* Return: QDF_STATUS_SUCCESS for success or error code
*/
@@ -3336,7 +3373,7 @@ wmi_extract_chan_stats(wmi_unified_t wmi_handle, void *evt_buf,
* @level: Pointer to hold extracted level in host enum
* @therm_throt_levels: Pointer to hold extracted number of level in thermal
* stats
* @tt_lvl_stats_event: Pointer to hold extracted thermal stats for each level
* @tt_stats: Pointer to hold extracted thermal stats for each level
* @pdev_id: Pointer to hold extracted pdev_id
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
@@ -3447,7 +3484,7 @@ wmi_extract_pmf_bcn_protect_stats(wmi_unified_t wmi_handle, void *evt_buf,
wmi_host_pmf_bcn_protect_stats *bcn_stats);
/**
* extract_unit_test() - extract unit test from event
* wmi_extract_unit_test() - extract unit test from event
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer
* @unit_test: Pointer to hold unit-test header
@@ -3530,7 +3567,7 @@ wmi_extract_bcn_stats(wmi_unified_t wmi_handle, void *evt_buf,
* wmi_extract_vdev_nac_rssi_stats() - extract NAC_RSSI stats from event
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer
* @vdev_extd_stats: Pointer to hold nac rssi stats
* @vdev_nac_rssi_stats: Pointer to hold nac rssi stats
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -3606,8 +3643,8 @@ QDF_STATUS wmi_unified_fw_test_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_wfa_test_cmd() - send wfa test command to fw.
* @handle: wmi handle
* @wmi_fwtest: wfa test param
* @wmi_handle: wmi handle
* @wmi_wfatest: wfa test param
*
* This function send wfa test command to fw.
*
@@ -3640,9 +3677,10 @@ QDF_STATUS wmi_unified_peer_rx_reorder_queue_remove_send(
wmi_unified_t wmi_handle,
struct rx_reorder_queue_remove_params *param);
/*
/**
* wmi_extract_service_ready_ext() - extract extended service ready
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer
* @param: wmi power debug parameter
*
*
@@ -3652,10 +3690,10 @@ QDF_STATUS wmi_extract_service_ready_ext(
wmi_unified_t wmi_handle, uint8_t *evt_buf,
struct wlan_psoc_host_service_ext_param *param);
/*
/**
* wmi_extract_service_ready_ext2() - extract extended2 service ready
* @wmi_handle: wmi handle
* @evt_buff: pointer to event buffer
* @evt_buf: pointer to event buffer
* @param: wmi ext2 base parameters
*
*
@@ -3665,7 +3703,7 @@ QDF_STATUS wmi_extract_service_ready_ext2(
struct wmi_unified *wmi_handle, uint8_t *evt_buf,
struct wlan_psoc_host_service_ext2_param *param);
/*
/**
* wmi_extract_dbs_or_sbs_cap_service_ready_ext2() - extract dbs_or_sbs cap from
* service ready ext 2
*
@@ -3855,7 +3893,7 @@ QDF_STATUS wmi_extract_pdev_qvit_event(wmi_unified_t wmi_handle,
#ifdef WLAN_SUPPORT_RF_CHARACTERIZATION
/**
* wmi_extract_num_rf_characterziation_entries - Extract number of RF
* wmi_extract_num_rf_characterization_entries - Extract number of RF
* characterization metrics received from the RF characterization event.
* @wmi_hdl: WMI handle
* @evt_buf: Event buffer
@@ -3868,8 +3906,8 @@ QDF_STATUS wmi_extract_num_rf_characterization_entries(wmi_unified_t wmi_hdl,
uint32_t *num_rf_characterization_entries);
/**
* wmi_extract_rf_characterziation_entries - Extract RF characterization metrics
* received from the RF characterization event.
* wmi_extract_rf_characterization_entries - Extract RF characterization
* metrics received from the RF characterization event.
* @wmi_hdl: WMI handle
* @evt_buf: Event buffer
* @num_rf_characterization_entries: Number of RF characterization metrics
@@ -3883,8 +3921,8 @@ QDF_STATUS wmi_extract_rf_characterization_entries(wmi_unified_t wmi_hdl,
struct wmi_host_rf_characterization_event_param *rf_characterization_entries);
#endif
/*
* wmi_extract_chainmask_tables_tlv() - extract chain mask tables
/**
* wmi_extract_chainmask_tables() - extract chain mask tables
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer.
* @chainmask_table: pointer to struct wlan_psoc_host_chainmask_table
@@ -3942,8 +3980,8 @@ wmi_unified_send_vdev_adfs_ocac_abort_cmd(wmi_unified_t wmi_handle,
/**
* wmi_unified_set_country_cmd_send() - WMI set country function
* @wmi_handle : handle to WMI.
* @param : pointer to hold set country cmd parameter
* @wmi_handle: handle to WMI.
* @param: pointer to hold set country cmd parameter
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -4012,7 +4050,7 @@ void wmi_print_mgmt_event_log(wmi_unified_t wmi, uint32_t count,
#endif /* WMI_INTERFACE_EVENT_LOGGING */
/**
* wmi_unified_send_wds_entry_list_cmd() - WMI function to get list of
* wmi_unified_send_dump_wds_table_cmd() - WMI function to get list of
* wds entries from FW
* @wmi_handle: wmi handle
*
@@ -4085,7 +4123,7 @@ QDF_STATUS wmi_extract_green_ap_egap_status_info(
* Return: QDF_STATUS
*/
QDF_STATUS wmi_unified_extract_green_ap_ll_ps_param(
wmi_unified_t wmi_hdl, uint8_t *evt_buf,
wmi_unified_t wmi_handle, uint8_t *evt_buf,
struct wlan_green_ap_ll_ps_event_param *green_ap_ll_ps_event_param);
#endif
@@ -4130,7 +4168,8 @@ QDF_STATUS
wmi_extract_offload_bcn_tx_status_evt(wmi_unified_t wmi_handle, void *evt_buf,
uint32_t *vdev_id, uint32_t *tx_status);
/* wmi_get_ch_width_from_phy_mode() - convert phy mode to channel width
/**
* wmi_get_ch_width_from_phy_mode() - convert phy mode to channel width
* @wmi_handle: wmi handle
* @phymode: phy mode
*
@@ -4144,7 +4183,6 @@ wmi_host_channel_width wmi_get_ch_width_from_phy_mode(
* wmi_extract_cca_stats() - api to extract congestion stats from event buffer
* @wmi_handle: wma handle
* @evt_buf: event buffer
* @datalen: length of buffer
* @stats: buffer to populated after stats extraction
*
* Return: status of operation
@@ -4240,7 +4278,7 @@ void wmi_process_fw_event_worker_thread_ctx(struct wmi_unified *wmi_handle,
* status from event
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer
* @ev: Pointer to hold ctl status
* @param: Pointer to hold ctl status
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -4253,7 +4291,7 @@ QDF_STATUS wmi_extract_ctl_failsafe_check_ev_param(
/**
* wmi_unified_send_obss_spatial_reuse_set_cmd() - send obss pd offset
* @wmi_handle: wmi handle
* @oobss_spatial_reuse_param: Pointer to obsspd min max offset
* @obss_spatial_reuse_param: Pointer to obsspd min max offset
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -4472,7 +4510,7 @@ enum cdp_sec_type wlan_crypto_cipher_to_cdp_sec_type(
/**
* wmi_unified_send_mws_coex_req_cmd() - WMI function to send coex req cmd
* @wmi_hdl: wmi handle
* @wmi_handle: wmi handle
* @vdev_id: Vdev Id
* @cmd_id: Coex cmd for which info is required
*
@@ -4512,7 +4550,7 @@ wmi_extract_oem_response_param(wmi_unified_t wmi_hdl, void *resp_buf,
#if defined(WIFI_POS_CONVERGED) && defined(WLAN_FEATURE_RTT_11AZ_SUPPORT)
/**
* wmi_extract_pasn_peer_create_req() - Extract peer create request event
* @wmi_hdl: WMI handle
* @wmi: WMI handle
* @evt_buf: Event buffer
* @dst: Destination buffer
*
@@ -4560,7 +4598,7 @@ wmi_send_rtt_pasn_deauth_cmd(wmi_unified_t wmi, struct qdf_mac_addr *peer_mac);
/**
* wmi_critical_events_in_flight() - get the number of critical events in flight
*
* @wmi_hdl: WMI handle
* @wmi: WMI handle
*
* Return: the number of critical events in flight.
*/
@@ -4570,7 +4608,7 @@ uint32_t wmi_critical_events_in_flight(struct wmi_unified *wmi);
#ifdef FEATURE_ANI_LEVEL_REQUEST
/**
* wmi_unified_ani_level_cmd_send() - WMI function to send get ani level cmd
* @wmi_hdl: WMI handle
* @wmi_handle: WMI handle
* @freqs: pointer to list of freqs for which ANI levels are to be fetched
* @num_freqs: number of freqs in the above parameter
*
@@ -4582,7 +4620,8 @@ QDF_STATUS wmi_unified_ani_level_cmd_send(wmi_unified_t wmi_handle,
/**
* wmi_unified_extract_ani_level() - WMI function to receive ani level cmd
* @wmi_hdl: WMI handle
* @wmi_handle: WMI handle
* @data: event data
* @info: pointer to ANI data received from the FW and stored in HOST
* @num_freqs: number of freqs in the above parameter
*
@@ -4772,7 +4811,7 @@ wmi_unified_extract_halphy_stats_event_count(wmi_unified_t wmi_handle,
/**
* wmi_unified_send_vdev_tsf_tstamp_action_cmd() - send vdev tsf action command
* @wmi: wmi handle
* @wmi_hdl: wmi handle
* @vdev_id: vdev id
*
* TSF_TSTAMP_READ_VALUE is the only operation supported
@@ -4783,9 +4822,9 @@ QDF_STATUS wmi_unified_send_vdev_tsf_tstamp_action_cmd(wmi_unified_t wmi_hdl,
/**
* wmi_extract_vdev_tsf_report_event() - extract vdev tsf report from event
* @wmi_handle: wmi handle
* @param evt_buf: pointer to event buffer
* @wmi_host_tsf_event param: Pointer to hold event info
* @wmi_hdl: wmi handle
* @evt_buf: pointer to event buffer
* @param: Pointer to hold event info
*
* Return: QDF_STATUS_SUCCESS on success and QDF_STATUS_E_FAILURE for failure
*/
@@ -4990,10 +5029,10 @@ QDF_STATUS wmi_unified_pn_mgmt_rxfilter_send_cmd(
struct vdev_pn_mgmt_rxfilter_params *params);
/**
* wmi_extract_pdev_telemetry_stats_tlv - extract pdev telemetry stats
* wmi_extract_pdev_telemetry_stats - extract pdev telemetry stats
* @wmi_handle: wmi handle
* @evt_buf: pointer to event buffer
* @pdev stats: Pointer to hold pdev telemetry stats
* @pdev_stats: Pointer to hold pdev telemetry stats
*
* Return: QDF_STATUS_SUCCESS for success or error code
*/
@@ -5019,7 +5058,7 @@ QDF_STATUS wmi_feature_set_cmd_send(
* wmi_extract_health_mon_event - extract health monitor params
* @wmi_handle: wmi handle
* @ev: pointer to event buffer
* @params: health monitor params
* @param: health monitor params
*
* Return: QDF_STATUS_SUCCESS for success or error code
*/
@@ -5031,7 +5070,7 @@ QDF_STATUS wmi_extract_health_mon_event(
#endif /* HEALTH_MON_SUPPORT */
/**
* wmi_unified__update_edca_pifs_param() - update EDCA/PIFS params
* wmi_unified_update_edca_pifs_param() - update EDCA/PIFS params
* @wmi_handle: wmi handle
* @edca_pifs_param: pointer to edca_pifs_vparam struct
*