qcacmn: Fix umac/dfs documentation

The kernel-doc script identified some documentation errors in the
umac/dfs folder, so fix them.

Change-Id: Ia86989a39fe502480e2d2358a6f23759f78707e0
CRs-Fixed: 3382430
This commit is contained in:
Jeff Johnson
2023-01-17 11:47:12 -08:00
committad av Madan Koyyalamudi
förälder 7ae4979be0
incheckning f57c0cf483
25 ändrade filer med 419 tillägg och 356 borttagningar

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2016-2017 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
@@ -29,8 +29,8 @@
/**
* wlan_pdev_get_dfs_obj() - Get DFS object from PDEV.
* @pdev: Pointer to PDEV structure.
* @id: DFS component ID.
* @obj: Pointer to DFS object.
*
* Return: DFS object
*/
struct wlan_dfs *wlan_pdev_get_dfs_obj(struct wlan_objmgr_pdev *pdev);
@@ -52,6 +52,7 @@ QDF_STATUS dfs_deinit(void);
/**
* wlan_dfs_pdev_obj_create_notification() - DFS pdev object create handler.
* @pdev: Pointer to DFS pdev object.
* @arg: component argument
*/
QDF_STATUS wlan_dfs_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
void *arg);
@@ -59,6 +60,7 @@ QDF_STATUS wlan_dfs_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
/**
* wlan_dfs_pdev_obj_destroy_notification() - DFS pdev object delete handler.
* @pdev: Pointer to DFS pdev object.
* @arg: component argument
*/
QDF_STATUS wlan_dfs_pdev_obj_destroy_notification(struct wlan_objmgr_pdev *pdev,
void *arg);

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2011, 2016-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.
* Copyright (c) 2010, Atheros Communications Inc.
* All Rights Reserved.
*
@@ -307,7 +307,7 @@ enum WLAN_DFS_EVENTS {
};
#if defined(WLAN_DFS_PARTIAL_OFFLOAD) && defined(WLAN_DFS_SYNTHETIC_RADAR)
/**
/*
* Structure of Pulse to be injected into the DFS Module
* ******************************************************
* Header
@@ -375,7 +375,7 @@ struct seq_store {
/**
* enum dfs_agile_sm_evt - DFS Agile SM events.
* @DFS_AGILE_SM_EV_AGILE_START: Event to start AGILE PreCAC/RCAC.
* @DFS_AGILE_SM_EV_AGILE_DOWN: Event to stop AGILE PreCAC/RCAC..
* @DFS_AGILE_SM_EV_AGILE_STOP: Event to stop AGILE PreCAC/RCAC..
* @DFS_AGILE_SM_EV_AGILE_DONE: Event to complete AGILE PreCAC/RCAC..
* @DFS_AGILE_SM_EV_ADFS_RADAR: Event to restart AGILE PreCAC/RCAC after radar.
*/

Visa fil

@@ -1,5 +1,6 @@
/*
* Copyright (c) 2016-2020 The Linux Foundation. All rights reserved.
* Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved.
*
*
* Permission to use, copy, modify, and/or distribute this software for
@@ -99,6 +100,7 @@ uint32_t lmac_get_target_type(struct wlan_objmgr_pdev *pdev);
/**
* lmac_get_phymode_info() - Get phymode info.
* @pdev: Pointer to PDEV structure.
* @chan_mode: Channel mode
*/
uint32_t lmac_get_phymode_info(struct wlan_objmgr_pdev *pdev,
uint32_t chan_mode);

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2016-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
@@ -73,7 +73,7 @@ dfs_mlme_proc_spoof_success(struct wlan_objmgr_pdev *pdev)
* @pdev: Pointer to DFS pdev object.
* @ieee_chan: Channel number.
* @freq: Channel frequency.
* @cfreq2: HT80 cfreq2 in Mhz.
* @cfreq2_mhz: HT80 cfreq2 in MHz.
* @flags: channel flags.
*/
#ifdef CONFIG_CHAN_FREQ_API
@@ -98,7 +98,7 @@ void dfs_mlme_proc_cac(struct wlan_objmgr_pdev *pdev, uint32_t vdev_id);
void dfs_mlme_deliver_event_up_after_cac(struct wlan_objmgr_pdev *pdev);
/**
* dfs_mlme_get_extchan() - Get extension channel.
* dfs_mlme_get_extchan_for_freq() - Get extension channel.
* @pdev: Pointer to DFS pdev object.
* @dfs_chan_freq: Frequency in Mhz.
* @dfs_chan_flags: Channel flags.
@@ -146,19 +146,19 @@ int dfs_mlme_ieee2mhz(struct wlan_objmgr_pdev *pdev,
* dfs_mlme_find_dot11_chan_for_freq() - Find a channel pointer given the mode,
* frequency and channel flags.
* @pdev: Pointer to DFS pdev object.
* @ch_freq: Channel frequency.
* @des_cfreq2_mhz: cfreq2 in MHZ.
* @chan_freq: Channel frequency.
* @des_cfreq2_mhz: cfreq2 in MHz.
* @mode: Phymode
* @dfs_chan_freq: Frequency in Mhz.
* @dfs_chan_freq: Frequency in MHz.
* @dfs_chan_flags: Channel flags.
* @dfs_chan_flagext: Extended channel flags.
* @dfs_chan_ieee: IEEE channel number.
* @dfs_chan_vhtop_ch_freq_seg1: Channel Center IEEE for primary 80 segment.
* @dfs_chan_vhtop_ch_freq_seg2: Channel Center frequency applicable for
* 80+80MHz mode of operation.
* 80+80 MHz mode of operation.
* @dfs_chan_mhz_freq_seg1: Channel center frequency of primary 80 segment.
* @dfs_chan_mhz_freq_seg2: Channel center frequency for secondary 80
* segment applicable only for 80+80MHZ mode of
* segment applicable only for 80+80 MHz mode of
* operation.
*
* Return:
@@ -241,9 +241,9 @@ void dfs_mlme_clist_update(struct wlan_objmgr_pdev *pdev,
/**
* dfs_mlme_get_cac_timeout_for_freq() - Get cac_timeout.
* @pdev: Pointer to DFS pdev object.
* @dfs_chan_freq: Frequency in Mhz.
* @dfs_chan_vhtop_freq_seg2: Channel Center frequency applicable for 80+80MHz
* mode of operation.
* @dfs_chan_freq: Frequency in MHz.
* @dfs_chan_vhtop_freq_seg2_mhz: Channel Center frequency applicable for
* 80+80 MHz mode of operation.
* @dfs_chan_flags: Channel flags.
*/
#ifdef CONFIG_CHAN_FREQ_API
@@ -291,7 +291,7 @@ void dfs_mlme_restart_vaps_with_non_dfs_chan(struct wlan_objmgr_pdev *pdev,
* dfs_mlme_check_allowed_prim_chanlist() - Check whether the given channel is
* present in the primary allowed channel list or not
* @pdev: Pointer to DFS pdev object.
* @chan_num: Channel number
* @chan_freq: Channel frequency
*/
#if defined(WLAN_SUPPORT_PRIMARY_ALLOWED_CHAN)
bool dfs_mlme_check_allowed_prim_chanlist(struct wlan_objmgr_pdev *pdev,

Visa fil

@@ -1,5 +1,6 @@
/*
* Copyright (c) 2017-2020 The Linux Foundation. All rights reserved.
* Copyright (c) 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
@@ -129,7 +130,7 @@ struct dfs_radar_found_params {
* enum adfs_ocac_mode - Various Off-Channel CAC modes.
* @QUICK_OCAC_MODE: Used for OCAC where the CAC timeout value is finite.
* This is also known as PreCAC.
* @EXTENSIVE_OCAC: Extensive OCAC.
* @EXTENSIVE_OCAC_MODE: Extensive OCAC.
* @QUICK_RCAC_MODE: Used for RollingCAC where the timeout value is assumed to
* be infinite by the Firmware code, that is, the FW has to
* be on the agile channel until host stop/aborts the agile

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2016-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
@@ -160,6 +160,7 @@ tgt_dfs_set_current_channel_for_freq(struct wlan_objmgr_pdev *pdev,
* tgt_dfs_radar_enable() - Enables the radar.
* @pdev: Pointer to DFS pdev object.
* @no_cac: If no_cac is 0, it cancels the CAC.
* @opmode: operating mode
* @enable: disable/enable radar
*
* This is called each time a channel change occurs, to (potentially) enable
@@ -177,6 +178,7 @@ QDF_STATUS tgt_dfs_radar_enable(
* @insize: size of the input buffer.
* @outdata: A buffer for the results.
* @outsize: Size of the output buffer.
* @error: returned error
*/
QDF_STATUS tgt_dfs_control(struct wlan_objmgr_pdev *pdev,
u_int id,
@@ -356,7 +358,7 @@ QDF_STATUS tgt_dfs_agile_precac_start(struct wlan_objmgr_pdev *pdev);
/**
* tgt_dfs_ocac_complete() - Process off channel cac complete indication.
* @pdev: Pointer to DFS pdev object.
* @vdev_adfs_complete_status: Off channel CAC complete status.
* @ocac_status: Off channel CAC complete status.
*
* wrapper function for dfs_set_agile_precac_state.
* This function called from outside of dfs component.
@@ -388,7 +390,7 @@ QDF_STATUS tgt_dfs_reg_ev_handler(struct wlan_objmgr_psoc *psoc);
/**
* tgt_dfs_stop() - Clear dfs timers.
* @dfs: Pointer to wlan_dfs structure.
* @pdev: Pointer to pdev object
*/
QDF_STATUS tgt_dfs_stop(struct wlan_objmgr_pdev *pdev);
@@ -396,6 +398,7 @@ QDF_STATUS tgt_dfs_stop(struct wlan_objmgr_pdev *pdev);
* tgt_dfs_process_emulate_bang_radar_cmd() - Process to emulate dfs bangradar
* command.
* @pdev: Pointer to DFS pdev object.
* @dfs_unit_test: bang radar emulation command
*
* Process to emulate dfs bangradar command.
*

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2016-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
@@ -35,19 +35,30 @@
* struct dfs_to_mlme - These are MLME function pointer used by DFS component.
* @pdev_component_obj_attach: Attach DFS object to PDEV.
* @pdev_component_obj_detach: Detach DFS object from PDEV.
* @pdev_get_comp_private_obj: Get DFS object from PDEV.
* @dfs_start_rcsa: Send RCSA to RootAP.
* @mlme_mark_dfs: Mark DFS channel frequency as radar.
* @mlme_start_csa_for_freq:
* @mlme_proc_cac: Process the CAC completion event.
* @mlme_deliver_event_up_after_cac: Send a CAC timeout, VAP up event to user
* space
* @mlme_get_extchan_for_freq: Get the extension channel.
* @mlme_set_no_chans_available: Sets no_chans_available flag.
* @mlme_ieee2mhz: Gets Channel freq from ieee number.
* @mlme_find_dot11_chan_for_freq: Find a channel pointer.
* @mlme_get_dfs_channels_for_freq: Get DFS channels from current channel
* list.
* @mlme_dfs_ch_flags_ext: Gets channel extension flag.
* @mlme_channel_change_by_precac: Channel change triggered by PreCAC.
* @mlme_precac_chan_change_csa_for_freq:Channel change triggered by PrCAC using
* Channel Switch Announcement.
* @mlme_postnol_chan_switch: Channel change post NOL using Channel
* Switch Announcement.
* @mlme_nol_timeout_notification: NOL timeout notification.
* @mlme_clist_update: Updates the channel list.
* @mlme_is_opmode_sta: Check if pdev opmode is STA.
* @mlme_rebuild_chan_list_with_non_dfs_channel: Rebuild channels with non-dfs
* @mlme_get_cac_timeout_for_freq: Get CAC timeout for a given channel
* frequency.
* @mlme_rebuild_chan_list_with_non_dfs_channels: Rebuild channels with non-dfs
* channels.
* @mlme_restart_vaps_with_non_dfs_chan: Restart vaps with non-dfs channel.
* @mlme_check_allowed_prim_chanlist: Check whether the given channel is
@@ -56,21 +67,13 @@
* @mlme_update_scan_channel_list: Update the scan channel list sent to FW.
* @mlme_bringdown_vaps: Bringdown vaps if no chans is present.
* @mlme_dfs_deliver_event: Deliver DFS events to user space
* @mlme_precac_chan_change_csa_for_freq:Channel change triggered by PrCAC using
* Channel Switch Announcement.
* @mlme_postnol_chan_switch: Channel change post NOL using Channel
* Switch Announcement.
* @mlme_mark_dfs: Mark DFS channel frequency as radar.
* @mlme_get_extchan_for_freq: Get the extension channel.
* @mlme_find_dot11_chan_for_freq: Find a channel pointer.
* @mlme_get_dfs_channels_for_freq: Get DFS channels from current channel
* list.
* @mlme_get_cac_timeout_for_freq: Get CAC timeout for a given channel
* frequency.
* @mlme_is_inter_band_chan_switch_allowed: Check if switch between 5 GHz and
* 6 GHz is allowed.
* @mlme_acquire_radar_mode_switch_lock: Acquire lock for radar processing over
* mode switch.
* @mlme_release_radar_mode_switch_lock: Release lock taken for radar processing
* over mode switch.
* @mlme_proc_spoof_success: Called when FW send spoof success event.
*/
struct dfs_to_mlme {
QDF_STATUS (*pdev_component_obj_attach)(struct wlan_objmgr_pdev *pdev,
@@ -208,6 +211,7 @@ extern struct dfs_to_mlme global_dfs_to_mlme;
/**
* wlan_dfs_pdev_obj_create_notification() - DFS pdev object create handler.
* @pdev: Pointer to DFS pdev object.
* @arg: component argument
*/
QDF_STATUS wlan_dfs_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
void *arg);
@@ -215,6 +219,7 @@ QDF_STATUS wlan_dfs_pdev_obj_create_notification(struct wlan_objmgr_pdev *pdev,
/**
* wlan_dfs_pdev_obj_destroy_notification() - DFS pdev object delete handler.
* @pdev: Pointer to DFS pdev object.
* @arg: component argument
*/
QDF_STATUS wlan_dfs_pdev_obj_destroy_notification(struct wlan_objmgr_pdev *pdev,
void *arg);
@@ -244,6 +249,7 @@ QDF_STATUS ucfg_dfs_getnol(struct wlan_objmgr_pdev *pdev, void *dfs_nolinfo);
* ucfg_dfs_override_cac_timeout() - Override the default CAC timeout.
* @pdev: Pointer to DFS pdev object.
* @cac_timeout: CAC timeout value.
* @status: pointer to save status
*
* Wrapper function for dfs_override_cac_timeout().
* This function called from outside of dfs component.
@@ -255,6 +261,7 @@ QDF_STATUS ucfg_dfs_override_cac_timeout(struct wlan_objmgr_pdev *pdev,
* ucfg_dfs_get_override_cac_timeout() - Get override CAC timeout value.
* @pdev: Pointer to DFS pdev object.
* @cac_timeout: Pointer to save the CAC timeout value.
* @status: pointer to save status
*
* Wrapper function for dfs_get_override_cac_timeout().
* This function called from outside of dfs component.
@@ -345,7 +352,7 @@ QDF_STATUS ucfg_dfs_get_precac_intermediate_chan(struct wlan_objmgr_pdev *pdev,
* ucfg_dfs_get_precac_chan_state_for_freq() - Get precac status for the
* given channel.
* @pdev: Pointer to DFS pdev object.
* @precac_chan: Channel frequency for which precac state needs to be
* @precac_freq: Channel frequency for which precac state needs to be
* determined.
*
* Wrapper function for dfs_get_precac_chan_state_for_freq().
@@ -503,7 +510,7 @@ QDF_STATUS ucfg_dfs_reinit_timers(struct wlan_objmgr_pdev *pdev);
/**
* ucfg_dfs_reset_agile_config() - Reset ADFS config.
* @pdev: Pointer to wlan_objmgr_pdev structure.
* @psoc: Pointer to wlan_objmgr_psoc structure.
*
* Wrapper function to reset Agile DFS config such as the variables which hold
* information about the state of the preCAC timer, active precac

Visa fil

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2016-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
@@ -226,12 +226,11 @@ QDF_STATUS utils_dfs_stacac_stop(struct wlan_objmgr_pdev *pdev);
*/
QDF_STATUS utils_dfs_get_usenol(struct wlan_objmgr_pdev *pdev,
uint16_t *usenol);
/*
* utils_dfs_radar_disable() - Disables the radar.
/**
* utils_dfs_is_spruce_spur_war_applicable() - Is Spruce spur WAR applicable
* @pdev: Pointer to DFS pdev object.
*
* Return: true if Spruce spur WAR is applicable else false.
*
* Spur or leakage transmissions is observed in Spruce HW in
* frequencies from 5260MHz to 5320MHz when one of the following
* conditions is true,
@@ -252,6 +251,8 @@ QDF_STATUS utils_dfs_get_usenol(struct wlan_objmgr_pdev *pdev,
* should make sure to prevent moving to the adjacent channels 36/44/48 in
* 80MHz mode. Failing to do so will cause spur transmissions in channel 52
* through 64.
*
* Return: true if Spruce spur WAR is applicable else false.
*/
bool utils_dfs_is_spruce_spur_war_applicable(struct wlan_objmgr_pdev *pdev);
@@ -311,7 +312,7 @@ QDF_STATUS utils_dfs_get_nol_timeout(struct wlan_objmgr_pdev *pdev,
/**
* utils_dfs_nol_addchan() - Add channel to NOL.
* @pdev: Pointer to DFS pdev object.
* @chan: channel t o add NOL.
* @freq: channel frequency to add to NOL.
* @dfs_nol_timeout: NOL timeout.
*
* wrapper function for dfs_nol_addchan(). this
@@ -343,11 +344,11 @@ QDF_STATUS utils_dfs_second_segment_radar_disable(
/**
* utils_dfs_fetch_nol_ie_info() - Fills the arguments with NOL information
* needed for sending RCSA.
* pdev: Pointer to DFS pdev object.
* nol_ie_bandwidth: Minimum DFS subchannel Bandwidth.
* nol_ie_startfreq: Radar affected channel list start subchannel's centre
* @pdev: Pointer to DFS pdev object.
* @nol_ie_bandwidth: Minimum DFS subchannel Bandwidth.
* @nol_ie_startfreq: Radar affected channel list start subchannel's centre
* frequency.
* nol_ie_bitmap: Bitmap of radar affected subchannels.
* @nol_ie_bitmap: Bitmap of radar affected subchannels.
*/
QDF_STATUS utils_dfs_fetch_nol_ie_info(struct wlan_objmgr_pdev *pdev,
uint8_t *nol_ie_bandwidth,
@@ -357,9 +358,9 @@ QDF_STATUS utils_dfs_fetch_nol_ie_info(struct wlan_objmgr_pdev *pdev,
/**
* utils_dfs_set_rcsa_flags() - Set flags that are required for sending
* RCSA and NOL IE.
* pdev: Pointer to DFS pdev object.
* is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
* is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
* @pdev: Pointer to DFS pdev object.
* @is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
* @is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
*/
QDF_STATUS utils_dfs_set_rcsa_flags(struct wlan_objmgr_pdev *pdev,
@@ -369,9 +370,9 @@ QDF_STATUS utils_dfs_set_rcsa_flags(struct wlan_objmgr_pdev *pdev,
/**
* utils_dfs_get_rcsa_flags() - Get flags that are required for sending
* RCSA and NOL IE.
* pdev: Pointer to DFS pdev object.
* is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
* is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
* @pdev: Pointer to DFS pdev object.
* @is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
* @is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
*/
QDF_STATUS utils_dfs_get_rcsa_flags(struct wlan_objmgr_pdev *pdev,
@@ -381,11 +382,11 @@ QDF_STATUS utils_dfs_get_rcsa_flags(struct wlan_objmgr_pdev *pdev,
/**
* utils_dfs_process_nol_ie_bitmap() - Update NOL with external radar
* information.
* pdev: Pointer to DFS pdev object.
* nol_ie_bandwidth: Minimum DFS subchannel Bandwidth.
* nol_ie_startfreq: Radar affected channel list start channel's
* @pdev: Pointer to DFS pdev object.
* @nol_ie_bandwidth: Minimum DFS subchannel Bandwidth.
* @nol_ie_startfreq: Radar affected channel list start channel's
* centre frequency.
* nol_ie_bitmap: Bitmap of radar affected subchannels.
* @nol_ie_bitmap: Bitmap of radar affected subchannels.
*
* Return: True if NOL IE should be propagated, else false.
*/
@@ -465,7 +466,7 @@ utils_dfs_get_random_channel_for_freq(struct wlan_objmgr_pdev *pdev,
* @flags: random channel selection flags.
* @ch_params: current channel params.
* @hw_mode: current operating mode.
* @target_chan: Pointer to target_chan_freq.
* @target_chan_freq: Pointer to target_chan_freq.
* @acs_info: acs range info.
*
* Get random channel based on vdev interface type. If the vdev is null,
@@ -485,7 +486,7 @@ QDF_STATUS utils_dfs_get_vdev_random_channel_for_freq(
* @pdev: Pointer to DFS pdev object.
* @ch_params: current channel params.
* @hw_mode: current operating mode.
* @target_chan: Pointer to target_chan freq.
* @target_chan_freq: Pointer to target_chan freq.
*
* wrapper function for get bw_reduced_channel. this
* function called from outside of dfs component.
@@ -594,7 +595,7 @@ void utils_dfs_reg_update_nol_chan_for_freq(struct wlan_objmgr_pdev *pdev,
bool nol_ch);
#endif
/**
* utils_dfs_freq_to_chan () - convert channel freq to channel number
* utils_dfs_freq_to_chan() - convert channel freq to channel number
* @freq: frequency
*
* Return: channel number
@@ -602,7 +603,7 @@ void utils_dfs_reg_update_nol_chan_for_freq(struct wlan_objmgr_pdev *pdev,
uint8_t utils_dfs_freq_to_chan(uint32_t freq);
/**
* utils_dfs_chan_to_freq () - convert channel number to frequency
* utils_dfs_chan_to_freq() - convert channel number to frequency
* @chan: channel number
*
* Return: frequency
@@ -684,22 +685,23 @@ utils_dfs_can_ignore_radar_event(struct wlan_objmgr_pdev *pdev)
*/
int utils_get_dfsdomain(struct wlan_objmgr_pdev *pdev);
#if defined(WLAN_DFS_PARTIAL_OFFLOAD) && defined(HOST_DFS_SPOOF_TEST)
/**
* utils_dfs_is_spoof_check_failed() - get spoof check status.
* @pdev: pdev ptr
* @is_spoof_check_failed: pointer containing the status.
*
* Return: QDF_STATUS.
*/
QDF_STATUS utils_dfs_is_spoof_check_failed(struct wlan_objmgr_pdev *pdev,
bool *is_spoof_check_failed);
/**
* utils_dfs_is_spoof_done() - get spoof check status.
* @pdev: pdev ptr
*
* Return: True if dfs_spoof_test_done is set.
*/
#if defined(WLAN_DFS_PARTIAL_OFFLOAD) && defined(HOST_DFS_SPOOF_TEST)
QDF_STATUS utils_dfs_is_spoof_check_failed(struct wlan_objmgr_pdev *pdev,
bool *is_spoof_check_failed);
bool utils_dfs_is_spoof_done(struct wlan_objmgr_pdev *pdev);
#else
static inline
@@ -747,17 +749,18 @@ void utils_dfs_get_nol_history_chan_list(struct wlan_objmgr_pdev *pdev,
* utils_dfs_reg_update_nol_history_chan_for_freq() - set nol history channel
*
* @pdev: pdev ptr
* @ch_list: freq channel list to be returned
* @num_ch: number of channels
* @nol_history_ch: nol history flag
* @freq_list: freq channel list to be returned
* @num_chan: number of channels
* @nol_history_chan: nol history flag
*
* Return: void
*/
#ifdef CONFIG_CHAN_FREQ_API
void utils_dfs_reg_update_nol_history_chan_for_freq(struct wlan_objmgr_pdev *,
uint16_t *freq_list,
uint8_t num_ch,
bool nol_history_ch);
void
utils_dfs_reg_update_nol_history_chan_for_freq(struct wlan_objmgr_pdev *pdev,
uint16_t *freq_list,
uint8_t num_chan,
bool nol_history_chan);
#endif
/**
@@ -797,7 +800,8 @@ utils_dfs_is_cac_required_on_dfs_curchan(struct wlan_objmgr_pdev *pdev,
bool *continue_current_cac,
bool is_vap_restart);
/** utils_dfs_is_precac_done() - Check if precac has been done in chosen channel
/**
* utils_dfs_is_precac_done() - Check if precac has been done in chosen channel
* @pdev: Pointer to DFS pdev object.
* @wlan_chan: Pointer to wlan channel object that can be accessed by other
* components.
@@ -814,7 +818,8 @@ bool utils_dfs_is_precac_done(struct wlan_objmgr_pdev *pdev,
* utils_dfs_get_disable_radar_marking() - Retrieve the value of disable radar.
* marking.
* @pdev: Pointer to DFS pdev object.
* @dis_radar_marking: pointer to retrieve the value of disable_radar_marking.
* @disable_radar_marking: pointer to retrieve the value of
* disable_radar_marking.
*/
#if defined(WLAN_DFS_FULL_OFFLOAD) && defined(QCA_DFS_NOL_OFFLOAD)
QDF_STATUS utils_dfs_get_disable_radar_marking(struct wlan_objmgr_pdev *pdev,
@@ -831,7 +836,7 @@ QDF_STATUS utils_dfs_get_disable_radar_marking(struct wlan_objmgr_pdev *pdev,
/**
* utils_dfs_deliver_event() - Deliver DFS event to userspace.
* @pdev: Pointer to DFS pdev object
* @chan: channel radar hit on
* @freq: frequency radar hit on
* @event: event being sent
*/
void utils_dfs_deliver_event(struct wlan_objmgr_pdev *pdev, uint16_t freq,
@@ -868,8 +873,8 @@ void utils_dfs_agile_sm_deliver_evt(struct wlan_objmgr_pdev *pdev,
* utils_dfs_get_rcac_channel() - Get the completed Rolling CAC channel if
* available.
* @pdev: Pointer to DFS pdev object.
* @ch_params: current channel params.
* @target_chan: Pointer to target_chan freq.
* @chan_params: current channel params.
* @target_chan_freq: Pointer to target_chan freq.
*
* Return: QDF_STATUS.
*/

Visa fil

@@ -1,6 +1,6 @@
/*
* 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
@@ -705,7 +705,7 @@ void utils_dfs_get_chan_list(struct wlan_objmgr_pdev *pdev,
* on current channel list.
* @pdev: Pointer to pdev structure.
* @vdev: vdev of request
* @chan: Pointer to channel list.
* @chan_list: Pointer to channel list.
* @num_chan: number of channels.
*
* Get regdb channel list based on dfs current channel.
@@ -1461,7 +1461,7 @@ static void utils_dfs_convert_freq_to_index(qdf_freq_t freq, int8_t *index)
/**
* utils_dfs_update_chan_state_array_element() - Update the per dfs channel
* state array element indexed by the frequency with the new state.
*
* @dfs: DFS context
* @freq: Input DFS Channel frequency which will converted to channel state
* array index.
* @state: Input DFS state with which the value indexed by frequency will be