qcacld-3.0: Fix Common Services Documentation

The kernel-doc script identified multiple documentation issues in
components/cmn_services, so fix them.

Change-Id: Ifdc8cefcbf7b31dc3e91cc3c5dab7cccd331e473
CRs-Fixed: 3363114
Šī revīzija ir iekļauta:
Jeff Johnson
2023-01-04 12:10:49 -08:00
revīziju iesūtīja Madan Koyyalamudi
vecāks bf0930cb1a
revīzija 4086862b28
18 mainīti faili ar 396 papildinājumiem un 323 dzēšanām

Parādīt failu

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2012-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
@@ -604,7 +604,7 @@ CFG_INI_UINT("g_mark_sap_indoor_as_disable", 0, 1, 0, CFG_VALUE_OR_DEFAULT, \
CFG_INI_UINT("g_enable_go_force_scc", 0, 2, 0, CFG_VALUE_OR_DEFAULT, \
"Enable/Disable P2P GO force SCC")
/**
/*
* <ini>
* g_pcl_band_priority - Set 5G/6G Channel order
* Options.

Parādīt failu

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2012-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
@@ -70,10 +70,10 @@ typedef const enum policy_mgr_conc_next_action
/**
* enum PM_AP_DFS_MASTER_MODE - AP dfs master mode
* @PM_STA_SAP_ON_DFS_DEFAULT - Disallow STA+SAP SCC on DFS channel
* @PM_STA_SAP_ON_DFS_MASTER_MODE_DISABLED - Allow STA+SAP SCC
* @PM_STA_SAP_ON_DFS_DEFAULT: Disallow STA+SAP SCC on DFS channel
* @PM_STA_SAP_ON_DFS_MASTER_MODE_DISABLED: Allow STA+SAP SCC
* on DFS channel with master mode disabled
* @PM_STA_SAP_ON_DFS_MASTER_MODE_FLEX - enhance
* @PM_STA_SAP_ON_DFS_MASTER_MODE_FLEX: enhance
* "PM_STA_SAP_ON_DFS_MASTER_MODE_DISABLED" with below requirement:
* a. Allow single SAP (GO) start on DFS channel.
* b. Allow CAC process on DFS channel in single SAP (GO) mode
@@ -149,7 +149,7 @@ static inline const char *device_mode_to_string(uint32_t idx)
};
/**
* trim_chan_info - trim channel info
* struct trim_chan_info - trim channel info
* @band_capability: band capability
* @sap_count: sap count
* @trim: enum trim channel list
@@ -663,6 +663,7 @@ bool policy_mgr_check_for_session_conc(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_handle_conc_multiport() - to handle multiport concurrency
* @psoc: PSOC object information
* @session_id: Session ID
* @ch_freq: Channel frequency
* @reason: reason for connection update
@@ -685,8 +686,6 @@ policy_mgr_handle_conc_multiport(struct wlan_objmgr_psoc *psoc,
* policy_mgr_check_concurrent_intf_and_restart_sap() - Check
* concurrent change intf
* @psoc: PSOC object information
* @operation_channel: operation channel
* @vdev_id: vdev id of SAP
*
* Checks the concurrent change interface and restarts SAP
*
@@ -830,8 +829,8 @@ policy_mgr_is_p2p_p2p_conc_supported(struct wlan_objmgr_psoc *psoc)
* is present and find mode, freq , vdev id and chan width
*
* @psoc: psoc object
* @vdev: vdev id
* @freq: frequency
* @vdev_id: vdev id
* @curr_go_freq: frequency
* @mode: existing vdev mode
* @con_freq: existing connection freq
* @ch_width: ch_width of existing connection
@@ -853,7 +852,7 @@ policy_mgr_fetch_existing_con_info(struct wlan_objmgr_psoc *psoc,
#define GO_FORCE_SCC_DISABLE 0
#define GO_FORCE_SCC_STRICT 1
#define GO_FORCE_SCC_LIBERAL 2
/**
/*
* Stay in MCC for 1 second, in case of first p2p go channel
* needs to be moved to curr go channel
*/
@@ -1047,7 +1046,7 @@ void policy_mgr_decr_session_set_pcl(struct wlan_objmgr_psoc *psoc,
#ifdef WLAN_FEATURE_11BE_MLO
/**
* policy_mgr_is_mlo_vdev_id() - check if vdev id is part of ML
* policy_mgr_is_ml_vdev_id() - check if vdev id is part of ML
* @psoc: PSOC object information
* @vdev_id: vdev id to check
*
@@ -1302,9 +1301,8 @@ bool policy_mgr_allow_concurrency(struct wlan_objmgr_psoc *psoc,
* policy_mgr_check_scc_sbs_channel() - Check for allowed
* concurrency combination
* @psoc: PSOC object information
* @mode: new connection mode
* @ch_freq: channel frequency on which new connection is coming up
* @bw: Bandwidth requested by the connection (optional)
* @intf_ch_freq: channel frequency on which new connection is coming up
* @sap_ch_freq: SoftAp channel frequency
* @vdev_id: Vdev Id
* @cc_mode: concurrent switch mode
*
@@ -1506,7 +1504,7 @@ QDF_STATUS policy_mgr_decr_connection_count(struct wlan_objmgr_psoc *psoc,
QDF_STATUS
policy_mgr_current_connections_update(struct wlan_objmgr_psoc *psoc,
uint32_t session_id, uint32_t ch_freq,
enum policy_mgr_conn_update_reason,
enum policy_mgr_conn_update_reason reason,
uint32_t request_id);
/**
@@ -1529,6 +1527,7 @@ policy_mgr_change_hw_mode_sta_connect(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_is_dbs_allowed_for_concurrency() - If dbs is allowed for current
* concurreny
* @psoc: PSOC object information
* @new_conn_mode: new connection mode
*
* When a new connection is about to come up, check if dbs is allowed for
@@ -1580,7 +1579,7 @@ policy_mgr_get_pcl_ch_for_sap_go_with_ll_sap_present(
* policy_mgr_get_pcl_channel_for_ll_sap_concurrency() - Get pcl channel list
* for LL SAP concurrency
* @psoc: PSOC object information
* @mode: Device mode
* @curr_mode: Device mode
* @vdev_id: Vdev id
* @pcl_channels: Preferred channel freq list
* @pcl_weight: Weights of the PCL
@@ -1759,7 +1758,7 @@ QDF_STATUS policy_mgr_pdev_set_hw_mode(struct wlan_objmgr_psoc *psoc,
uint32_t request_id);
/**
* policy_mgr_pdev_set_hw_mode_cback() - callback invoked by
* typedef policy_mgr_pdev_set_hw_mode_cback() - callback invoked by
* other component to provide set HW mode request status
* @status: status of the request
* @cfgd_hw_mode_index: new HW mode index
@@ -1788,7 +1787,7 @@ typedef void (*policy_mgr_pdev_set_hw_mode_cback)(uint32_t status,
uint32_t request_id);
/**
* policy_mgr_nss_update_cback() - callback invoked by other
* typedef policy_mgr_nss_update_cback() - callback invoked by other
* component to provide nss update request status
* @psoc: PSOC object information
* @tx_status: tx completion status for updated beacon with new
@@ -1854,8 +1853,9 @@ struct policy_mgr_sme_cbacks {
* @get_mode_for_non_connected_vdev: Get the mode for a non
* connected vdev
* @hdd_get_device_mode: Get QDF_OPMODE type for session id (vdev id)
* @hdd_is_chan_switch_in_progress: Check if in any adater channel switch is in
* @hdd_is_chan_switch_in_progress: Check if in any adapter channel switch is in
* progress
* @hdd_is_cac_in_progress: Check if in any adapter CAC is in progress
* @wlan_hdd_set_sap_csa_reason: Set the sap csa reason in cases like NAN.
* @hdd_get_ap_6ghz_capable: get ap vdev 6ghz capable info from hdd ap adapter.
* @wlan_hdd_indicate_active_ndp_cnt: indicate active ndp cnt to hdd
@@ -1912,8 +1912,8 @@ struct policy_mgr_conc_cbacks {
/**
* struct policy_mgr_tdls_cbacks - TDLS Callbacks to be invoked
* from policy manager
* @set_tdls_ct_mode: Set the tdls connection tracker mode
* @check_is_tdls_allowed: check if tdls allowed or not
* @tdls_notify_increment_session:
* @tdls_notify_decrement_session:
*/
struct policy_mgr_tdls_cbacks {
void (*tdls_notify_increment_session)(struct wlan_objmgr_psoc *psoc);
@@ -2340,7 +2340,7 @@ bool policy_mgr_is_sap_mandatory_channel_set(struct wlan_objmgr_psoc *psoc);
/**
* policy_mgr_list_has_24GHz_channel() - Check if list contains 2.4GHz channels
* @channel_list: Channel frequency list
* @ch_freq_list: Channel frequency list
* @list_len: Length of the channel list
*
* Checks if the channel list contains atleast one 2.4GHz channel
@@ -2353,7 +2353,7 @@ bool policy_mgr_list_has_24GHz_channel(uint32_t *ch_freq_list,
/**
* policy_mgr_get_valid_chans_from_range() - get valid channel from given range
* @psoc: PSOC object information
* @ch_freq_list: Pointer to the channel frequency list
* @ch_list: Pointer to the channel frequency list
* @ch_cnt: Pointer to the length of the channel list
* @mode: Device mode
*
@@ -2381,9 +2381,9 @@ QDF_STATUS policy_mgr_get_valid_chans(struct wlan_objmgr_psoc *psoc,
* policy_mgr_get_nss_for_vdev() - Get the allowed nss value for the
* vdev
* @psoc: PSOC object information
* @dev_mode: connection type.
* @nss2g: Pointer to the 2G Nss parameter.
* @nss5g: Pointer to the 5G Nss parameter.
* @mode: connection type.
* @nss_2g: Pointer to the 2G Nss parameter.
* @nss_5g: Pointer to the 5G Nss parameter.
*
* Fills the 2G and 5G Nss values based on connection type.
*
@@ -2631,6 +2631,7 @@ QDF_STATUS policy_mgr_get_valid_chan_weights(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_set_hw_mode_on_channel_switch() - Set hw mode
* after channel switch
* @psoc: PSOC object information
* @session_id: Session ID
*
* Sets hw mode after doing a channel switch
@@ -2733,9 +2734,10 @@ QDF_STATUS policy_mgr_check_conn_with_mode_and_vdev_id(
* @new_hw_mode_index: New HW mode index
* @num_vdev_mac_entries: Number of vdev-mac id mapping that follows
* @vdev_mac_map: vdev-mac id map. This memory will be freed by the caller.
* So, make local copy if needed.
* @num_mac_freq: Number of pdev freq mapping that follows
* @mac_freq_range: mac_freq_range mapping
* So, make local copy if needed.
* @context:
*
* Provides the old and new HW mode index set by the FW
*
@@ -2833,7 +2835,7 @@ QDF_STATUS policy_mgr_register_hdd_cb(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_register_conc_cb() - register Lim callbacks
* @psoc: PSOC object information
* @hdd_cbacks: function pointers from lim
* @conc_cbacks: function pointers from lim
*
* API, allows Lim to register callbacks to be invoked by policy
* mgr
@@ -2885,11 +2887,11 @@ QDF_STATUS policy_mgr_register_cdp_cb(struct wlan_objmgr_psoc *psoc,
struct policy_mgr_cdp_cbacks *cdp_cbacks);
/**
* policy_mgr_register_dp_cb() - register CDP callbacks
* policy_mgr_register_dp_cb() - register DP callbacks
* @psoc: PSOC object information
* @cdp_cbacks: function pointers from CDP
* @dp_cbacks: function pointers from DP
*
* API, allows CDP to register callbacks to be invoked by
* API, allows DP to register callbacks to be invoked by
* policy mgr
*
* Return: SUCCESS,
@@ -3471,7 +3473,7 @@ void policy_mgr_update_dbs_fw_config(struct wlan_objmgr_psoc *psoc);
* request config in policy manager component
* @psoc: PSOC object information
* @scan_config: DBS scan config
* @fw_config: DBS FW config
* @fw_mode_config: DBS FW config
*
* This function updates DBS request configurations required by
* policy manager
@@ -3558,7 +3560,7 @@ void policy_mgr_update_hw_mode_index(struct wlan_objmgr_psoc *psoc,
* policy_mgr_update_old_hw_mode_index() - Function to update
* old HW mode in policy manager component
* @psoc: PSOC object information
* @new_hw_mode_index: index to old HW mode
* @old_hw_mode_index: index to old HW mode
*
* This function to update the old HW mode in policy manager
*
@@ -3624,8 +3626,11 @@ bool policy_mgr_is_dnsc_set(struct wlan_objmgr_vdev *vdev);
* @scan_config: DBS related scan config
* @fw_mode_config: DBS related FW config
* @dual_mac_disable_ini: DBS related ini config
* @channel_select_logic_conc:
*
* This function returns the latest DBS configuration for
* connection & scan, sent to FW
*
* Return: SUCCESS or FAILURE
*/
QDF_STATUS policy_mgr_get_updated_scan_and_fw_mode_config(
@@ -3772,7 +3777,7 @@ bool policy_mgr_disallow_mcc(struct wlan_objmgr_psoc *psoc,
* policy_mgr_mode_specific_get_channel() - Get channel for a
* connection type
* @psoc: PSOC object information
* @chan_list: Connection type
* @mode: Connection type
*
* Get channel frequency for a connection type
*
@@ -3992,6 +3997,7 @@ bool policy_mgr_is_hwmode_set_for_given_chnl(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_get_connection_info() - Get info of all active connections
* @psoc: pointer to soc
* @info: Pointer to connection info
*
* Return: Connection count
@@ -4001,7 +4007,8 @@ uint32_t policy_mgr_get_connection_info(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_register_mode_change_cb() - Register mode change callback with
* policy manager
* @callback: HDD callback to be registered
* @psoc: pointer to soc
* @mode_change_cb: HDD callback to be registered
*
* Return: QDF_STATUS
*/
@@ -4010,7 +4017,7 @@ QDF_STATUS policy_mgr_register_mode_change_cb(struct wlan_objmgr_psoc *psoc,
/**
* policy_mgr_deregister_mode_change_cb() - Deregister mode change callback with
* policy manager
* @callback: HDD callback to be registered
* @psoc: pointer to soc
*
* Return: QDF_STATUS
*/
@@ -4020,7 +4027,7 @@ QDF_STATUS policy_mgr_deregister_mode_change_cb(struct wlan_objmgr_psoc *psoc);
* policy_mgr_allow_sap_go_concurrency() - check whether SAP/GO concurrency is
* allowed.
* @psoc: pointer to soc
* @policy_mgr_con_mode: operating mode of interface to be checked
* @mode: operating mode of interface to be checked
* @ch_freq: new operating channel of the interface to be checked
* @vdev_id: vdev id of the connection to be checked, 0xff for new connection
*
@@ -4080,7 +4087,7 @@ bool policy_mgr_sta_sap_scc_on_lte_coex_chan(
struct wlan_objmgr_psoc *psoc);
/**
* policy_mgr_valid_channel_for_channel_switch() - check for valid channel for
* policy_mgr_is_valid_for_channel_switch() - check for valid channel for
* channel switch.
* @psoc: pointer to psoc
* @ch_freq: channel frequency to be validated.
@@ -4233,7 +4240,7 @@ void policy_mgr_set_ap_6ghz_capable(struct wlan_objmgr_psoc *psoc,
* AP is allowed on 6G band only when all of below statements are true:
* a. SAP config includes WPA3 security - SAE,OWE,SuiteB.
* b. SAP is configured by ACS range which includes any 6G channel or
configured by 6G Fixed channel.
* configured by 6G Fixed channel.
* c. SAP has no legacy clients (client doesn't support 6G band).
* legacy client (non 6ghz capable): association request frame has no
* 6G band global operating Class.
@@ -4408,9 +4415,9 @@ bool policy_mgr_is_sta_mon_concurrency(struct wlan_objmgr_psoc *psoc);
QDF_STATUS policy_mgr_check_mon_concurrency(struct wlan_objmgr_psoc *psoc);
/**
* policy_mgr_get_hw_max_dbs_bw() - Computes DBS BW
* policy_mgr_get_hw_dbs_max_bw() - Computes DBS BW
* @psoc: PSOC object information
* @dbs_bw: BW info of both MAC0 and MAC1
* @bw_dbs: BW info of both MAC0 and MAC1
* This function computes BW info of both MAC0 and MAC1
*
* Return: void

Parādīt failu

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2012-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
@@ -29,16 +29,16 @@
/* Include files */
#include <wmi_unified_api.h>
/**
/*
* Some max value greater than the max length of the channel list
*/
#define MAX_WEIGHT_OF_PCL_CHANNELS 255
/**
/*
* Some fixed weight difference between the groups
*/
#define PCL_GROUPS_WEIGHT_DIFFERENCE 20
/**
/*
* Currently max, only 3 groups are possible as per 'enum policy_mgr_pcl_type'.
* i.e., in a PCL only 3 groups of channels can be present
* e.g., SCC channel on 2.4 Ghz, SCC channel on 5 Ghz & 5 Ghz channels.
@@ -93,7 +93,7 @@ typedef int (*send_mode_change_event_cb)(void);
* @CSA_REASON_DCS: DCS
* @CSA_REASON_CHAN_DISABLED: channel is disabled
* @CSA_REASON_CHAN_PASSIVE: channel is passive
* @CSA_REASON_GO_BSS_STARED: P2P go started
* @CSA_REASON_GO_BSS_STARTED: P2P go started
* @CSA_REASON_SAP_ACS: 2.4 GHz preferred SAP ACS starting
* @CSA_REASON_SAP_FIX_CH_CONC_WITH_GO: SAP fix channel start
* and move GO to other band
@@ -226,7 +226,7 @@ enum policy_mgr_pcl_group_id {
};
/**
* policy_mgr_pcl_channel_order - Order in which the PCL is requested
* enum policy_mgr_pcl_channel_order - Order in which the PCL is requested
* @POLICY_MGR_PCL_ORDER_NONE: no order
* @POLICY_MGR_PCL_ORDER_24G_THEN_5G: 2.4 Ghz channel followed by 5 Ghz channel
* @POLICY_MGR_PCL_ORDER_5G_THEN_2G: 5 Ghz channel followed by 2.4 Ghz channel
@@ -250,7 +250,7 @@ enum policy_mgr_pcl_channel_order {
};
/**
* policy_mgr_pcl_band_priority - Band priority between 5G and 6G channel
* enum policy_mgr_pcl_band_priority - Band priority between 5G and 6G channel
* @POLICY_MGR_PCL_BAND_5G_THEN_6G: 5 Ghz channel followed by 6 Ghz channel
* @POLICY_MGR_PCL_BAND_6G_THEN_5G: 6 Ghz channel followed by 5 Ghz channel
*
@@ -271,6 +271,7 @@ enum policy_mgr_pcl_band_priority {
* @POLICY_MGR_RX_NSS_6: Receive Nss = 6
* @POLICY_MGR_RX_NSS_7: Receive Nss = 7
* @POLICY_MGR_RX_NSS_8: Receive Nss = 8
* @POLICY_MGR_RX_NSS_MAX: maximum enumeration
*
* Indicates the maximum number of spatial streams that the STA can receive
*/
@@ -392,6 +393,11 @@ enum policy_mgr_mac_use {
* @PM_24G_SCC_CH_SBS_CH_5G: 2.4 Ghz channels, SCC channel,
* SBS channels & rest of the 5G channels
* @PM_24G_SBS_CH_MCC_CH: 2.4 Ghz channels, SBS channels & MCC channels
* @PM_SBS_CH_24G_SCC_CH:
* @PM_SBS_CH_SCC_CH_24G:
* @PM_SCC_CH_SBS_CH_24G:
* @PM_SBS_CH_SCC_CH_5G_24G:
* @PM_SCC_CH_MCC_CH_SBS_CH_24G:
* @PM_SBS_CH_2G: SBS channels & 2.4 Ghz channels
* @PM_SCC_ON_5G_LOW_5G_LOW_PLUS_SHARED_2G: 5 GHz low SCC channel followed by
* 5 GHz low frequencies, add 2.4 GHz if its shared with 5 GHz low
@@ -464,7 +470,7 @@ enum policy_mgr_pcl_type {
* @PM_SAP_24_1x1: SAP connection using 1x1@2.4 Ghz
* @PM_SAP_24_2x2: SAP connection using 2x2@2.4 Ghz
* @PM_SAP_5_1x1: SAP connection using 1x1@5 Ghz
* @PM_SAP_5_1x1: SAP connection using 2x2@5 Ghz
* @PM_SAP_5_2x2: SAP connection using 2x2@5 Ghz
* @PM_NAN_DISC_24_1x1: NAN Discovery using 1x1@2.4 Ghz
* @PM_NAN_DISC_24_2x2: NAN Discovery using 2x2@2.4 Ghz
* @PM_NDI_24_1x1: NAN Datapath using 1x1@2.4 Ghz
@@ -524,9 +530,12 @@ enum policy_mgr_one_connection_mode {
* 1x1@5 Ghz
* @PM_STA_SAP_MCC_5_2x2: STA & SAP connection on MCC using
* 2x2@5 Ghz
* @PM_STA_SAP_MCC_24_5_1x1:
* @PM_STA_SAP_MCC_24_5_2x2:
* @PM_STA_SAP_DBS_1x1: STA & SAP connection on DBS using 1x1
* @PM_STA_SAP_DBS_2x2: STA & SAP connection on DBS using 2x2
* @PM_STA_SAP_SBS_5_1x1: STA & SAP connection on 5G SBS using 1x1
* @PM_STA_SAP_SBS_5_2x2: STA & SAP connection on 5G SBS using 2x2
* @PM_STA_P2P_GO_SCC_24_1x1: STA & P2P GO connection on SCC
* using 1x1@2.4 Ghz
* @PM_STA_P2P_GO_SCC_24_2x2: STA & P2P GO connection on SCC
@@ -543,12 +552,16 @@ enum policy_mgr_one_connection_mode {
* using 1x1@5 Ghz
* @PM_STA_P2P_GO_MCC_5_2x2: STA & P2P GO connection on MCC
* using 2x2@5 Ghz
* @PM_STA_P2P_GO_MCC_24_5_1x1:
* @PM_STA_P2P_GO_MCC_24_5_2x2:
* @PM_STA_P2P_GO_DBS_1x1: STA & P2P GO connection on DBS using
* 1x1
* @PM_STA_P2P_GO_DBS_2x2: STA & P2P GO connection on DBS using
* 2x2
* @PM_STA_P2P_GO_SBS_5_1x1: STA & P2P GO connection on 5G SBS
* using 1x1
* @PM_STA_P2P_GO_SBS_5_2x2: STA & P2P GO connection on 5G SBS
* using 2x2
* @PM_STA_P2P_CLI_SCC_24_1x1: STA & P2P CLI connection on SCC
* using 1x1@2.4 Ghz
* @PM_STA_P2P_CLI_SCC_24_2x2: STA & P2P CLI connection on SCC
@@ -565,12 +578,16 @@ enum policy_mgr_one_connection_mode {
* using 1x1@5 Ghz
* @PM_STA_P2P_CLI_MCC_5_2x2: STA & P2P CLI connection on MCC
* using 2x2@5 Ghz
* @PM_STA_P2P_CLI_MCC_24_5_1x1:
* @PM_STA_P2P_CLI_MCC_24_5_2x2:
* @PM_STA_P2P_CLI_DBS_1x1: STA & P2P CLI connection on DBS
* using 1x1
* @PM_STA_P2P_CLI_DBS_2x2: STA & P2P CLI connection on DBS
* using 2x2
* @PM_STA_P2P_CLI_SBS_5_1x1: STA & P2P CLI connection on 5G
* SBS using 1x1
* @PM_STA_P2P_CLI_SBS_5_2x2: STA & P2P CLI connection on 5G
* SBS using 2x2
* @PM_P2P_GO_P2P_CLI_SCC_24_1x1: P2P GO & CLI connection on
* SCC using 1x1@2.4 Ghz
* @PM_P2P_GO_P2P_CLI_SCC_24_2x2: P2P GO & CLI connection on
@@ -587,12 +604,16 @@ enum policy_mgr_one_connection_mode {
* MCC using 1x1@5 Ghz
* @PM_P2P_GO_P2P_CLI_MCC_5_2x2: P2P GO & CLI connection on
* MCC using 2x2@5 Ghz
* @PM_P2P_GO_P2P_CLI_MCC_24_5_1x1:
* @PM_P2P_GO_P2P_CLI_MCC_24_5_2x2:
* @PM_P2P_GO_P2P_CLI_DBS_1x1: P2P GO & CLI connection on DBS
* using 1x1
* @PM_P2P_GO_P2P_CLI_DBS_2x2: P2P GO & P2P CLI connection
* on DBS using 2x2
* @PM_P2P_GO_P2P_CLI_SBS_5_1x1: P2P GO & P2P CLI connection
* on 5G SBS using 1x1
* @PM_P2P_GO_P2P_CLI_SBS_5_2x2: P2P GO & P2P CLI connection
* on 5G SBS using 2x2
* @PM_P2P_GO_SAP_SCC_24_1x1: P2P GO & SAP connection on
* SCC using 1x1@2.4 Ghz
* @PM_P2P_GO_SAP_SCC_24_2x2: P2P GO & SAP connection on
@@ -609,12 +630,16 @@ enum policy_mgr_one_connection_mode {
* MCC using 1x1@5 Ghz
* @PM_P2P_GO_SAP_MCC_5_2x2: P2P GO & SAP connection on
* MCC using 2x2@5 Ghz
* @PM_P2P_GO_SAP_MCC_24_5_1x1:
* @PM_P2P_GO_SAP_MCC_24_5_2x2:
* @PM_P2P_GO_SAP_DBS_1x1: P2P GO & SAP connection on DBS using
* 1x1
* @PM_P2P_GO_SAP_DBS_2x2: P2P GO & SAP connection on DBS using
* 2x2
* @PM_P2P_GO_SAP_SBS_5_1x1: P2P GO & SAP connection on 5G SBS
* using 1x1
* @PM_P2P_GO_SAP_SBS_5_2x2: P2P GO & SAP connection on 5G SBS
* using 2x2
* @PM_P2P_GO_P2P_GO_SCC_24_1x1: P2P GO & P2P GO SCC on 2.4G using 1x1
* @PM_P2P_GO_P2P_GO_SCC_24_2x2: P2P GO & P2P GO SCC on 2.4G using 2x2
* @PM_P2P_GO_P2P_GO_MCC_24_1x1: P2P GO & P2P GO MCC on 2.4G using 1x1
@@ -630,6 +655,7 @@ enum policy_mgr_one_connection_mode {
* @PM_P2P_GO_P2P_GO_DBS_1x1: P2P GO & P2P GO on DBS using 1x1
* @PM_P2P_GO_P2P_GO_DBS_2x2: P2P GO & P2P GO on DBS using 2x2
* @PM_P2P_GO_P2P_GO_SBS_5_1x1: P2P GO & P2P GO on SBS using 1x1
* @PM_P2P_GO_P2P_GO_SBS_5_2x2: P2P GO & P2P GO on SBS using 2x2
* @PM_P2P_CLI_SAP_SCC_24_1x1: CLI & SAP connection on SCC using
* 1x1@2.4 Ghz
* @PM_P2P_CLI_SAP_SCC_24_2x2: CLI & SAP connection on SCC using
@@ -646,15 +672,17 @@ enum policy_mgr_one_connection_mode {
* 1x1@5 Ghz
* @PM_P2P_CLI_SAP_MCC_5_2x2: CLI & SAP connection on MCC using
* 2x2@5 Ghz
* @POLICY_MGR_P2P_STA_SAP_MCC_24_5_1x1: CLI and SAP connecting on MCC
* @PM_P2P_CLI_SAP_MCC_24_5_1x1: CLI and SAP connecting on MCC
* in 2.4 and 5GHz 1x1
* @POLICY_MGR_P2P_STA_SAP_MCC_24_5_2x2: CLI and SAP connecting on MCC
* @PM_P2P_CLI_SAP_MCC_24_5_2x2: CLI and SAP connecting on MCC
* in 2.4 and 5GHz 2x2
* @PM_P2P_CLI_SAP_DBS_1x1,: CLI & SAP connection on DBS using 1x1
* @PM_P2P_CLI_SAP_DBS_1x1: CLI & SAP connection on DBS using 1x1
* @PM_P2P_CLI_SAP_DBS_2x2: P2P CLI & SAP connection on DBS using
* 2x2
* @PM_P2P_CLI_SAP_SBS_5_1x1: P2P CLI & SAP connection on 5G SBS
* using 1x1
* @PM_P2P_CLI_SAP_SBS_5_2x2: P2P CLI & SAP connection on 5G SBS
* using 2x2
* @PM_P2P_CLI_P2P_CLI_SCC_24_1x1: P2P CLI & P2P CLI SCC on 2.4G using 1x1
* @PM_P2P_CLI_P2P_CLI_SCC_24_2x2: P2P CLI & P2P CLI SCC on 2.4G using 2x2
* @PM_P2P_CLI_P2P_CLI_MCC_24_1x1: P2P CLI & P2P CLI MCC on 2.4G using 1x1
@@ -670,6 +698,7 @@ enum policy_mgr_one_connection_mode {
* @PM_P2P_CLI_P2P_CLI_DBS_1x1: P2P CLI & P2P CLI on DBS using 1x1
* @PM_P2P_CLI_P2P_CLI_DBS_2x2: P2P CLI & P2P CLI on DBS using 2x2
* @PM_P2P_CLI_P2P_CLI_SBS_5_1x1: P2P CLI & P2P CLI on SBS using 1x1
* @PM_P2P_CLI_P2P_CLI_SBS_5_2x2: P2P CLI & P2P CLI on SBS using 2x2
* @PM_SAP_SAP_SCC_24_1x1: SAP & SAP connection on
* SCC using 1x1@2.4 Ghz
* @PM_SAP_SAP_SCC_24_2x2: SAP & SAP connection on
@@ -694,6 +723,7 @@ enum policy_mgr_one_connection_mode {
* 1x1
* @PM_SAP_SAP_DBS_2x2: SAP & SAP connection on DBS using 2x2
* @PM_SAP_SAP_SBS_5_1x1: SAP & SAP connection on 5G SBS using 1x1
* @PM_SAP_SAP_SBS_5_2x2: SAP & SAP connection on 5G SBS using 2x2
* @PM_SAP_NAN_DISC_SCC_24_1x1: SAP & NAN connection on
* SCC using 1x1@2.4 Ghz
* @PM_SAP_NAN_DISC_SCC_24_2x2: SAP & NAN connection on
@@ -728,6 +758,7 @@ enum policy_mgr_one_connection_mode {
* 1x1
* @PM_STA_STA_DBS_2x2: STA & STA connection on DBS using 2x2
* @PM_STA_STA_SBS_5_1x1: STA & STA connection on 5G SBS using 1x1
* @PM_STA_STA_SBS_5_2x2: STA & STA connection on 5G SBS using 2x2
* @PM_STA_NAN_DISC_SCC_24_1x1: NAN & STA connection on SCC using 1x1 on 2.4 GHz
* @PM_STA_NAN_DISC_SCC_24_2x2: NAN & STA connection on SCC using 2x2 on 2.4 GHz
* @PM_STA_NAN_DISC_MCC_24_1x1: NAN & STA connection on MCC using 1x1 on 2.4 GHz
@@ -740,6 +771,7 @@ enum policy_mgr_one_connection_mode {
* @PM_NAN_DISC_NDI_MCC_24_2x2: NAN & NDI connection on MCC using 2x2 on 2.4 GHz
* @PM_NAN_DISC_NDI_DBS_1x1: NAN & NDI connection on DBS using 1x1
* @PM_NAN_DISC_NDI_DBS_2x2: NAN & NDI connection on DBS using 2x2
* @PM_MAX_TWO_CONNECTION_MODE: Max enumeration
*
* These are generic IDs that identify the various roles in the
* software system
@@ -987,20 +1019,19 @@ enum policy_mgr_two_connection_mode {
* 2.4 GHZ MCC on mac0 and second STA on high 5 GHZ on mac1 doing SBS
* @PM_STA_STA_5_LOW_MCC_SAP_5_HIGH_SBS : First STA on high 5 GHZ & Second STA
* on high 5 GHZ MCC on mac0 and SAP on low 5 GHZ on mac1 doing SBS
* @PM_24_5_MCC_SCC_PLUS_5_SBS: The 2.4 GHZ vdev creating MCC/SCC with low 5 GHZ
* or high 5 GHZ (dynamic SBS) on mac 0 and one vdev on high 5 GHZ or low 5 GHZ
* freq respectively on mac 1 doing SBS
* @PM_STA_24_STA_5_MCC_SAP_5_LOW_SBS: MLO STA 2+5/6 GHz, SAP on 5/6 GHz
* low band, the current hw mode is SBS.
* @PM_24_5_PLUS_5_LOW_N_HIGH_SHARE_SBS:
* @PM_SAP_24_STA_5_STA_5_LOW_N_HIGH_SHARE_SBS: The 2.4 GHZ SAP creating MCC/SCC
* with STA of low 5 GHZ or high 5 GHZ (dynamic SBS) on mac 0 and one STA on
* high 5 GHZ or low 5 GHZ freq respectively on mac 1 doing SBS
* @PM_STA_24_SAP_5_STA_5_LOW_N_HIGH_SHARE_SBS: The 2.4 GHZ STA creating MCC/SCC
* with SAP of low 5 GHZ or high 5 GHZ (dynamic SBS) on mac 0 and one STA on
* high 5 GHZ or low 5 GHZ freq respectively on mac 1 doing SBS
* @PM_24_5_PLUS_5_LOW_OR_HIGH_SHARE_SBS (not dynamic SBS): MLO STA 2+5/6 GHz,
* @PM_24_5_PLUS_5_LOW_OR_HIGH_SHARE_SBS: (not dynamic SBS) MLO STA 2+5/6 GHz,
* SAP on 5/6 GHz, and target only support 2.4 GHz shared with 5 GHz low band
* or 5 GHz high band but not both.
* @PM_MAX_THREE_CONNECTION_MODE: Maximum enumeration
*/
enum policy_mgr_three_connection_mode {
PM_STA_SAP_SCC_24_SAP_5_DBS,
@@ -1091,7 +1122,7 @@ enum policy_mgr_three_connection_mode {
* @PM_DBS2_DOWNGRADE: downgrade 5G beaconing entity to 1x1 and switch to DBS2.
* @PM_UPGRADE_5G: upgrade 5g beaconing entity to 2x2.
* @PM_UPGRADE_2G: upgrade 2g beaconing entity to 2x2.
* @PM_MAX_CONC_PRIORITY_MODE: Max place holder
* @PM_MAX_CONC_NEXT_ACTION: Max place holder
*
* These are generic IDs that identify the various roles
* in the software system
@@ -1145,12 +1176,14 @@ enum policy_mgr_band {
* @POLICY_MGR_UPDATE_REASON_AFTER_CHANNEL_SWITCH: After Channel switch
* @POLICY_MGR_UPDATE_REASON_CHANNEL_SWITCH_STA: Before Channel switch for STA
* @POLICY_MGR_UPDATE_REASON_CHANNEL_SWITCH_SAP: Before Channel switch for SAP
* @POLICY_MGR_UPDATE_REASON_PRE_CAC: Pre-CAC
* @POLICY_MGR_UPDATE_REASON_PRI_VDEV_CHANGE: In Dual DBS HW, if the vdev based
* 2x2 preference enabled, the vdev down may cause prioritized active
* vdev change, then DBS hw mode may needs to change from one DBS mode
* to the other DBS mode. This reason code indicates such condition.
* @POLICY_MGR_UPDATE_REASON_NAN_DISCOVERY: NAN Discovery related
* @POLICY_MGR_UPDATE_REASON_NDP_UPDATE: NAN Datapath related update
* @POLICY_MGR_UPDATE_REASON_LFR2_ROAM: Roaming
* @POLICY_MGR_UPDATE_REASON_STA_CONNECT: STA/CLI connection to peer
*/
enum policy_mgr_conn_update_reason {
@@ -1172,7 +1205,7 @@ enum policy_mgr_conn_update_reason {
/**
* enum hw_mode_bandwidth - bandwidth of wifi channel.
*
* @HW_MODE_BW_NONE: no bandwidth configured
* @HW_MODE_5_MHZ: 5 Mhz bandwidth
* @HW_MODE_10_MHZ: 10 Mhz bandwidth
* @HW_MODE_20_MHZ: 20 Mhz bandwidth
@@ -1357,6 +1390,7 @@ struct policy_mgr_disabled_ml_link_info {
* @mac0_band_cap: mac0 band (5g/2g) capability
* @dbs_cap: DBS capabality
* @agile_dfs_cap: Agile DFS capabality
* @sbs_cap: SBS capability
* @emlsr_cap: eMLSR capability
* @action_type: for dbs mode, the field indicates the "Action type" to be
* used to switch to the mode. To help the hw mode validation.
@@ -1464,11 +1498,11 @@ struct policy_mgr_vdev_entry_info {
};
/**
* struct policy_mgr_freq_range hw mode freq range for the pdev
* @low_2ghz_ freq: lower 2.4GHz channels
* @high_2ghz_ freq: higher 2.4 GHz channels
* @low_5ghz_ freq: lower 5 GHz channels
* @high_5ghz_ freq: higher 5 GHz channels
* struct policy_mgr_freq_range - hw mode freq range for the pdev
* @low_2ghz_freq: lower 2.4GHz channels
* @high_2ghz_freq: higher 2.4 GHz channels
* @low_5ghz_freq: lower 5 GHz channels
* @high_5ghz_freq: higher 5 GHz channels
*/
struct policy_mgr_freq_range {
qdf_freq_t low_2ghz_freq;
@@ -1478,13 +1512,13 @@ struct policy_mgr_freq_range {
};
/**
* enum policy_mgr_mode enum for host mode
* enum policy_mgr_mode - enum for host mode
* @MODE_SMM: Single mac mode
* @MODE_DBS: DBS mode
* @MODE_SBS: SBS mode with either high share or low share
* @MODE_SBS_UPPER_SHARE: Higher 5Ghz shared with 2.4Ghz
* @MODE_SBS_LOWER_SHARE: LOWER 5Ghz shared with 2.4Ghz
* #MODE_EMLSR: eMLSR mode
* @MODE_EMLSR: eMLSR mode
* @MODE_HW_MAX: MAX
*/
enum policy_mgr_mode {
@@ -1583,7 +1617,7 @@ struct dbs_nss {
uint32_t single_mac0_band_cap;
};
/**
/*
* Max radio combination numbers
*/
#define MAX_RADIO_COMBINATION 16
@@ -1660,14 +1694,14 @@ struct sta_ap_intf_check_work_ctx {
/**
* enum indoor_conc_update_type - Indoor concurrency update type
* @CONNECT - On a new STA connection
* @DISCONNECT_WITHOUT_CONCURRENCY - On a STA disconnection with no active
* @CONNECT: On a new STA connection
* @DISCONNECT_WITHOUT_CONCURRENCY: On a STA disconnection with no active
* sessions on the same frequency
* @DISCONNECT_WITH_CONCURRENCY - On a STA disconnection with an active
* @DISCONNECT_WITH_CONCURRENCY: On a STA disconnection with an active
* session on the same frequency
* @SWITCH_WITH_CONCURRENCY - On a STA roam or CSA to a different channel
* @SWITCH_WITH_CONCURRENCY: On a STA roam or CSA to a different channel
* with a concurrent SAP on previous frequency
* @SWITCH_WITHOUT_CONCURRENCY - On a STA roam or CSA to a different channel
* @SWITCH_WITHOUT_CONCURRENCY: On a STA roam or CSA to a different channel
* without any concurrent SAP on previous frequency
*/
enum indoor_conc_update_type {

Parādīt failu

@@ -1,6 +1,6 @@
/*
* Copyright (c) 2018-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
@@ -25,6 +25,7 @@
/**
* ucfg_policy_mgr_psoc_open() - This API sets CFGs to policy manager context
* @psoc: pointer to psoc
*
* This API pulls policy manager's context from PSOC and initialize the CFG
* structure of policy manager.
@@ -32,8 +33,10 @@
* Return: QDF_STATUS_SUCCESS up on success and any other status for failure.
*/
QDF_STATUS ucfg_policy_mgr_psoc_open(struct wlan_objmgr_psoc *psoc);
/**
* ucfg_policy_mgr_psoc_close() - This API resets CFGs for policy manager ctx
* @psoc: pointer to psoc
*
* This API pulls policy manager's context from PSOC and resets the CFG
* structure of policy manager.
@@ -130,7 +133,7 @@ QDF_STATUS ucfg_policy_mgr_get_conc_rule2(struct wlan_objmgr_psoc *psoc,
uint8_t *conc_rule2);
/**
* policy_mgr_get_chnl_select_plcy() - to get channel selection policy
* ucfg_policy_mgr_get_chnl_select_plcy() - to get channel selection policy
* @psoc: pointer to psoc
* @chnl_select_plcy: value to be filled
*
@@ -142,7 +145,7 @@ QDF_STATUS ucfg_policy_mgr_get_conc_rule2(struct wlan_objmgr_psoc *psoc,
QDF_STATUS ucfg_policy_mgr_get_chnl_select_plcy(struct wlan_objmgr_psoc *psoc,
uint32_t *chnl_select_plcy);
/**
* policy_mgr_get_mcc_adaptive_sch() - to get mcc adaptive scheduler
* ucfg_policy_mgr_get_mcc_adaptive_sch() - to get mcc adaptive scheduler
* @psoc: pointer to psoc
* @enable_mcc_adaptive_sch: value to be filled
*
@@ -376,7 +379,6 @@ ucfg_policy_mgr_get_indoor_chnl_marking(struct wlan_objmgr_psoc *psoc,
* ucfg_policy_mgr_get_sta_sap_scc_on_indoor_chnl() - to get if
* sta sap scc on indoor channel is allowed
* @psoc: pointer to psoc
* @sap_scc_on_indoor: value to be filled
*
* This API is used to get the value of sta+sap scc on indoor channel
*