Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit df7d3c6c authored by Srinivas Dasari's avatar Srinivas Dasari
Browse files

nl80211: Introduce scan flags to emphasize requested scan behavior 



This commit defines new scan flags (LOW_SPAN, LOW_POWER, HIGH_LATENCY)
to emphasize the requested scan behavior for the driver. These flags
are optional and are mutually exclusive. The implementation of the
respective functionality can be driver/hardware specific.

These flags can be used to control the compromise between how long
a scan takes, how much power it uses, and high accurate/complete
the scan is in finding the BSSs.

Change-Id: I8f69b89a846da0b5ab89d90e215731bb4f01856c
CRs-Fixed: 2173869
Signed-off-by: default avatarSrinivas Dasari <dasaris@codeaurora.org>
parent 0c86848b

include/net/cfg80211.h

+6 −0
Original line number Diff line number Diff line
@@ -55,6 +55,12 @@ 
 */

#define CFG80211_ROAMED_API_UNIFIED 1



/* Indicate backport support for DBS scan control */

#define CFG80211_SCAN_DBS_CONTROL_SUPPORT 1



/* Indicate backport support for per chain rssi scan */

#define CFG80211_SCAN_PER_CHAIN_RSSI_SUPPORT 1



/**

 * DOC: Introduction

 *

include/uapi/linux/nl80211.h

+52 −0
Original line number Diff line number Diff line
@@ -4839,6 +4839,27 @@ enum nl80211_feature_flags { 
 *	RSSI threshold values to monitor rather than exactly one threshold.

 * @NL80211_EXT_FEATURE_FILS_SK_OFFLOAD: Driver SME supports FILS shared key

 *	authentication with %NL80211_CMD_CONNECT.

 * @NL80211_EXT_FEATURE_4WAY_HANDSHAKE_STA_PSK: Device wants to do 4-way

 *	handshake with PSK in station mode (PSK is passed as part of the connect

 *	and associate commands), doing it in the host might not be supported.

 * @NL80211_EXT_FEATURE_4WAY_HANDSHAKE_STA_1X: Device wants to do doing 4-way

 *	handshake with 802.1X in station mode (will pass EAP frames to the host

 *	and accept the set_pmk/del_pmk commands), doing it in the host might not

 *	be supported.

 * @NL80211_EXT_FEATURE_FILS_MAX_CHANNEL_TIME: Driver is capable of overriding

 *	the max channel attribute in the FILS request params IE with the

 *	actual dwell time.

 * @NL80211_EXT_FEATURE_ACCEPT_BCAST_PROBE_RESP: Driver accepts broadcast probe

 *	response

 * @NL80211_EXT_FEATURE_OCE_PROBE_REQ_HIGH_TX_RATE: Driver supports sending

 *	the first probe request in each channel at rate of at least 5.5Mbps.

 * @NL80211_EXT_FEATURE_OCE_PROBE_REQ_DEFERRAL_SUPPRESSION: Driver supports

 *	probe request tx deferral and suppression

 * @NL80211_EXT_FEATURE_MFP_OPTIONAL: Driver supports the %NL80211_MFP_OPTIONAL

 *	value in %NL80211_ATTR_USE_MFP.

 * @NL80211_EXT_FEATURE_LOW_SPAN_SCAN: Driver supports low span scan.

 * @NL80211_EXT_FEATURE_LOW_POWER_SCAN: Driver supports low power scan.

 * @NL80211_EXT_FEATURE_HIGH_ACCURACY_SCAN: Driver supports high accuracy scan.

 *

 * @NUM_NL80211_EXT_FEATURES: number of extended features.

 * @MAX_NL80211_EXT_FEATURES: highest extended feature index.
@@ -4859,6 +4880,16 @@ enum nl80211_ext_feature_index { 
	NL80211_EXT_FEATURE_SCHED_SCAN_RELATIVE_RSSI,

	NL80211_EXT_FEATURE_CQM_RSSI_LIST,

	NL80211_EXT_FEATURE_FILS_SK_OFFLOAD,

	NL80211_EXT_FEATURE_4WAY_HANDSHAKE_STA_PSK,

	NL80211_EXT_FEATURE_4WAY_HANDSHAKE_STA_1X,

	NL80211_EXT_FEATURE_FILS_MAX_CHANNEL_TIME,

	NL80211_EXT_FEATURE_ACCEPT_BCAST_PROBE_RESP,

	NL80211_EXT_FEATURE_OCE_PROBE_REQ_HIGH_TX_RATE,

	NL80211_EXT_FEATURE_OCE_PROBE_REQ_DEFERRAL_SUPPRESSION,

	NL80211_EXT_FEATURE_MFP_OPTIONAL,

	NL80211_EXT_FEATURE_LOW_SPAN_SCAN,

	NL80211_EXT_FEATURE_LOW_POWER_SCAN,

	NL80211_EXT_FEATURE_HIGH_ACCURACY_SCAN,



	/* add new features before the definition below */

	NUM_NL80211_EXT_FEATURES,
@@ -4919,6 +4950,10 @@ enum nl80211_timeout_reason { 
 * of NL80211_CMD_TRIGGER_SCAN and NL80211_CMD_START_SCHED_SCAN

 * requests.

 *

 * NL80211_SCAN_FLAG_LOW_SPAN, NL80211_SCAN_FLAG_LOW_POWER, and

 * NL80211_SCAN_FLAG_HIGH_ACCURACY flags are exclusive of each other, i.e., only

 * one of them can be used in the request.

 *

 * @NL80211_SCAN_FLAG_LOW_PRIORITY: scan request has low priority

 * @NL80211_SCAN_FLAG_FLUSH: flush cache before scanning

 * @NL80211_SCAN_FLAG_AP: force a scan even if the interface is configured
@@ -4935,12 +4970,29 @@ enum nl80211_timeout_reason { 
 *	locally administered 1, multicast 0) is assumed.

 *	This flag must not be requested when the feature isn't supported, check

 *	the nl80211 feature flags for the device.

 *	SSID and/or RSSI.

 * @NL80211_SCAN_FLAG_LOW_SPAN: Span corresponds to the total time taken to

 *	accomplish the scan. Thus, this flag intends the driver to perform the

 *	scan request with lesser span/duration. It is specific to the driver

 *	implementations on how this is accomplished. Scan accuracy may get

 *	impacted with this flag.

 * @NL80211_SCAN_FLAG_LOW_POWER: This flag intends the scan attempts to consume

 *	optimal possible power. Drivers can resort to their specific means to

 *	optimize the power. Scan accuracy may get impacted with this flag.

 * @NL80211_SCAN_FLAG_HIGH_ACCURACY: Accuracy here intends to the extent of scan

 *	results obtained. Thus HIGH_ACCURACY scan flag aims to get maximum

 *	possible scan results. This flag hints the driver to use the best

 *	possible scan configuration to improve the accuracy in scanning.

 *	Latency and power use may get impacted with this flag.

 */

enum nl80211_scan_flags {

	NL80211_SCAN_FLAG_LOW_PRIORITY			= 1<<0,

	NL80211_SCAN_FLAG_FLUSH				= 1<<1,

	NL80211_SCAN_FLAG_AP				= 1<<2,

	NL80211_SCAN_FLAG_RANDOM_ADDR			= 1<<3,

	NL80211_SCAN_FLAG_LOW_SPAN			= 1<<8,

	NL80211_SCAN_FLAG_LOW_POWER			= 1<<9,

	NL80211_SCAN_FLAG_HIGH_ACCURACY			= 1<<10,

};



/**

net/wireless/nl80211.c

+11 −2
Original line number Diff line number Diff line
@@ -6701,8 +6701,17 @@ static int nl80211_trigger_scan(struct sk_buff *skb, struct genl_info *info) 
	if (info->attrs[NL80211_ATTR_SCAN_FLAGS]) {

		request->flags = nla_get_u32(

			info->attrs[NL80211_ATTR_SCAN_FLAGS]);

		if ((request->flags & NL80211_SCAN_FLAG_LOW_PRIORITY) &&

		    !(wiphy->features & NL80211_FEATURE_LOW_PRIORITY_SCAN)) {

		if (((request->flags & NL80211_SCAN_FLAG_LOW_PRIORITY) &&

		     !(wiphy->features & NL80211_FEATURE_LOW_PRIORITY_SCAN)) ||

		    ((request->flags & NL80211_SCAN_FLAG_LOW_SPAN) &&

		     !wiphy_ext_feature_isset(wiphy,

				      NL80211_EXT_FEATURE_LOW_SPAN_SCAN)) ||

		    ((request->flags & NL80211_SCAN_FLAG_LOW_POWER) &&

		     !wiphy_ext_feature_isset(wiphy,

				      NL80211_EXT_FEATURE_LOW_POWER_SCAN)) ||

		    ((request->flags & NL80211_SCAN_FLAG_HIGH_ACCURACY) &&

		     !wiphy_ext_feature_isset(wiphy,

		      NL80211_EXT_FEATURE_HIGH_ACCURACY_SCAN))) {

			err = -EOPNOTSUPP;

			goto out_free;

		}