android_kernel_samsung_sm8650-modules/components/mlme/dispatcher/inc/cfg_mlme_acs.h

/*
 * Copyright (c) 2012-2021 The Linux Foundation. All rights reserved.
 * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
 *
 * Permission to use, copy, modify, and/or distribute this software for
 * any purpose with or without fee is hereby granted, provided that the
 * above copyright notice and this permission notice appear in all
 * copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
 * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
 * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 * PERFORMANCE OF THIS SOFTWARE.
 */

/**
 * DOC: This file contains centralized definitions of converged configuration.
 */

#ifndef __CFG_MLME_ACS_H
#define __CFG_MLME_ACS_H

/*
 * <ini>
 * acs_with_more_param- Enable acs calculation with more param.
 * @Min: 0
 * @Max: 1
 * @Default: 1
 *
 * This ini is used to enable acs calculation with more param.
 *
 * Related: NA
 *
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * </ini>
 */

#define CFG_ACS_WITH_MORE_PARAM CFG_INI_BOOL( \
		"acs_with_more_param", \
		1, \
		"Enable ACS with more param")

/*
 * <ini>
 * AutoChannelSelectWeight - ACS channel weight
 * @Min: 0
 * @Max: 0xFFFFFFFF
 * @Default: 0x00fafafa
 *
 * This ini is used to adjust weight of factors in
 * acs algorithm.
 *
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * bits 0-3:   rssi weight
 * bits 4-7:   bss count weight
 * bits 8-11:  noise floor weight
 * bits 12-15: channel free weight
 * bits 16-19: tx power range weight
 * bits 20-23: tx power throughput weight
 * bits 24-31: reserved
 *
 * </ini>
 */

#define CFG_AUTO_CHANNEL_SELECT_WEIGHT CFG_INI_UINT( \
		"AutoChannelSelectWeight", \
		0, \
		0xFFFFFFFF, \
		0x00fafafa, \
		CFG_VALUE_OR_DEFAULT, \
		"Adjust weight factor in ACS")

/*
 * <ini>
 * gvendor_acs_support - vendor based channel selection manager
 * @Min: 0
 * @Max: 1
 * @Default: 0
 *
 * Enabling this parameter will force driver to use user application based
 * channel selection algo instead of driver based auto channel selection
 * logic.
 *
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * </ini>
 */

#define CFG_USER_AUTO_CHANNEL_SELECTION CFG_INI_BOOL( \
		"gvendor_acs_support", \
		0, \
		"Vendor channel selection manager")

/*
 * <ini>
 * gacs_support_for_dfs_lte_coex - acs support for lte coex and dfs event
 * @Min: 0
 * @Max: 1
 * @Default: 0
 *
 * Enabling this parameter will force driver to use user application based
 * channel selection algo for channel selection in case of dfs and lte
 * coex event.
 *
 * Supported Feature: ACS
 *
 * Usage: Internal
 *
 * </ini>
 */

#define CFG_USER_ACS_DFS_LTE CFG_INI_BOOL( \
		"gacs_support_for_dfs_lte_coex", \
		0, \
		"Acs support for lte coex and dfs")

/*
 * <ini>
 * acs_policy - External ACS policy control
 * @Min: 0
 * @Max: 1
 * @Default: 1
 *
 * Values are per enum hdd_external_acs_policy.
 *
 * This ini is used to control the external ACS policy.
 *
 * 0 -Preferable for ACS to select a
 *    channel with non-zero pcl weight.
 * 1 -Mandatory for ACS to select a
 *    channel with non-zero pcl weight.
 *
 * Related: None
 *
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * </ini>
 */

#define CFG_EXTERNAL_ACS_POLICY CFG_INI_BOOL( \
		"acs_policy", \
		1, \
		"External ACS Policy Control")

#define ACS_WEIGHT_MAX_STR_LEN            500

/*
 * <ini>
 * normalize_acs_weight - Used to control the ACS channel weightage.
 *
 * This ini is used to specify the weight percentage of the channel. Channel
 * weights can be controlled by user to prioritize or de-prioritize channels.
 *
 * Related: ACS
 *
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * </ini>
 */
#define CFG_NORMALIZE_ACS_WEIGHT CFG_INI_STRING( \
		"normalize_acs_weight", \
		0, \
		ACS_WEIGHT_MAX_STR_LEN, \
		"2407-5875=40, 5945-7125=90, 5975=100, 6055=100, 6135=100, 6215=100, 6295=100, 6375=100, 6615=100, 6695=100, 6775=100, 6855=100", \
		"Used to specify the channel weights")

/*
 * <ini>
 * force_start_sap- Enable the SAP even if no channel is suitable for SAP
 * @Min: 0
 * @Max: 1
 * @Default: 0
 *
 * This ini is used to enable the SAP even if no channel is found suitable
 * for SAP by ACS.
 *
 * Related: NA
 *
 * Supported Feature: ACS
 *
 * Usage: Internal
 *
 * </ini>
 */
#define CFG_ACS_FORCE_START_SAP CFG_INI_BOOL( \
		"force_start_sap", \
		0, \
		"Force start SAP")

/*
 * <ini>
 * acs_prefer_6ghz_psc - Select 6 GHz PSC channel as priority
 * @Min: 0
 * @Max: 1
 * @Default: 1
 *
 * This config is used to configure ACS logic to select PSC channel as
 * perefered result. "normalize_acs_weight" INI can make the PSC
 * channel priority higher than NON PSC, but it is for a single channel's
 * weight, for bw 160 or bw 80 combined channel weight, it has less
 * help.
 *
 * Related: None
 *
 * Supported Feature: ACS
 *
 * Usage: Internal
 *
 * </ini>
 */
#define CFG_ACS_PREFER_6GHZ_PSC CFG_BOOL( \
				"acs_prefer_6ghz_psc", \
				1, \
				"Select 6 GHz PSC channel as priority")

/*
 * <ini>
 * np_chan_weight - chan weightage for non preferred channels
 * @Min: 0x00000000
 * @Max: 0x64646464
 * @Default: 0x00000000
 *
 * This INI give percentage value of weights to be considered in the ACS algo
 * for the non preferred channels. the distribution of the channel type is:-
 * Example:- If the percentage of lets say DFS channels is set to 50%, and
 * the weight comes out to be x, then we would increase the weight of DFS
 * channels by 50% ( 100 - y% set in INI), so that it gets de-prioritized in
 * the ACS sorted channel list, the lesser the weight, the better the channel.
 * So the channel with more weight is less likely to be selected. So by default
 * the np chan weightage for DFS is set to 0, that is it will be assigned max
 * weightage, so no probality of getting selected, as for standlaone, DFS is not
 * recommended (it takes 60 sec/10min to start depending upon channel type).
 *
 * Indexes are defined in this way.
 *     0 Index (BITS 0-7): DFS - Def 1%
 *     1 Index (BITS 8-15): Reserved
 *     2 Index (BITS 16-23): Reserved
 *     3 Index (BITS 24-31): Reserved
 * These percentage values are stored in HEX. Max can be 0x64
 * Supported Feature: ACS
 *
 * Usage: External
 *
 * </ini>
 */
#define CFG_ACS_NP_CHAN_WEIGHT CFG_INI_UINT( \
		"np_chan_weight", \
		0x00000000, \
		0x64646464, \
		0x00000001, \
		CFG_VALUE_OR_DEFAULT, \
		"np chan weight")

#define CFG_ACS_ALL \
	CFG(CFG_ACS_WITH_MORE_PARAM) \
	CFG(CFG_AUTO_CHANNEL_SELECT_WEIGHT) \
	CFG(CFG_USER_AUTO_CHANNEL_SELECTION) \
	CFG(CFG_USER_ACS_DFS_LTE) \
	CFG(CFG_EXTERNAL_ACS_POLICY) \
	CFG(CFG_NORMALIZE_ACS_WEIGHT) \
	CFG(CFG_ACS_PREFER_6GHZ_PSC) \
	CFG(CFG_ACS_FORCE_START_SAP) \
	CFG(CFG_ACS_NP_CHAN_WEIGHT)

#endif /* __CFG_MLME_ACS_H */