nl80211: support beacon report scanning

Beacon report radio measurement requires reporting observed BSSs
on the channels specified in the beacon request. If the measurement
mode is set to passive or active, it requires actually performing a
scan (passive or active, accordingly), and reporting the time that
the scan was started and the time each beacon/probe was received
(both in terms of TSF of the BSS of the requesting AP). If the
request mode is table, this information is optional.
In addition, the radio measurement request specifies the channel
dwell time for the measurement.

In order to use scan for beacon report when the mode is active or
passive, add a parameter to scan request that specifies the
channel dwell time, and add scan start time and beacon received time
to scan results information.

Supporting beacon report is required for Multi Band Operation (MBO).

Signed-off-by: Assaf Krauss <assaf.krauss@intel.com>
Signed-off-by: David Spinadel <david.spinadel@intel.com>
Signed-off-by: Avraham Stern <avraham.stern@intel.com>
Signed-off-by: Luca Coelho <luciano.coelho@intel.com>
Signed-off-by: Johannes Berg <johannes.berg@intel.com>

1 files changed, 42 insertions, 0 deletions

diff --git a/include/uapi/linux/nl80211.h b/include/uapi/linux/nl80211.h
index 1d7da7888dcf..b39ccab45333 100644
--- a/include/uapi/linux/nl80211.h
+++ b/include/uapi/linux/nl80211.h
@@ -1848,6 +1848,22 @@ enum nl80211_commands {
  *      to turn that feature off set an invalid mac address
  *      (e.g. FF:FF:FF:FF:FF:FF)
  *
+ * @NL80211_ATTR_SCAN_START_TIME_TSF: The time at which the scan was actually
+ *      started (u64). The time is the TSF of the BSS the interface that
+ *      requested the scan is connected to (if available, otherwise this
+ *      attribute must not be included).
+ * @NL80211_ATTR_SCAN_START_TIME_TSF_BSSID: The BSS according to which
+ *      %NL80211_ATTR_SCAN_START_TIME_TSF is set.
+ * @NL80211_ATTR_MEASUREMENT_DURATION: measurement duration in TUs (u16). If
+ *      %NL80211_ATTR_MEASUREMENT_DURATION_MANDATORY is not set, this is the
+ *      maximum measurement duration allowed. This attribute is used with
+ *      measurement requests. It can also be used with %NL80211_CMD_TRIGGER_SCAN
+ *      if the scan is used for beacon report radio measurement.
+ * @NL80211_ATTR_MEASUREMENT_DURATION_MANDATORY: flag attribute that indicates
+ *      that the duration specified with %NL80211_ATTR_MEASUREMENT_DURATION is
+ *      mandatory. If this flag is not set, the duration is the maximum duration
+ *      and the actual measurement duration may be shorter.
+ *
  * @NUM_NL80211_ATTR: total number of nl80211_attrs available
  * @NL80211_ATTR_MAX: highest attribute number currently defined
  * @__NL80211_ATTR_AFTER_LAST: internal use
@@ -2235,6 +2251,11 @@ enum nl80211_attrs {
         NL80211_ATTR_MU_MIMO_GROUP_DATA,
         NL80211_ATTR_MU_MIMO_FOLLOW_MAC_ADDR,
 
+        NL80211_ATTR_SCAN_START_TIME_TSF,
+        NL80211_ATTR_SCAN_START_TIME_TSF_BSSID,
+        NL80211_ATTR_MEASUREMENT_DURATION,
+        NL80211_ATTR_MEASUREMENT_DURATION_MANDATORY,
+
         /* add attributes here, update the policy in nl80211.c */
 
         __NL80211_ATTR_AFTER_LAST,
@@ -3496,6 +3517,12 @@ enum nl80211_bss_scan_width {
  *      was last updated by a received frame. The value is expected to be
  *      accurate to about 10ms. (u64, nanoseconds)
  * @NL80211_BSS_PAD: attribute used for padding for 64-bit alignment
+ * @NL80211_BSS_PARENT_TSF: the time at the start of reception of the first
+ *      octet of the timestamp field of the last beacon/probe received for
+ *      this BSS. The time is the TSF of the BSS specified by
+ *      @NL80211_BSS_PARENT_BSSID. (u64).
+ * @NL80211_BSS_PARENT_BSSID: the BSS according to which @NL80211_BSS_PARENT_TSF
+ *      is set.
  * @__NL80211_BSS_AFTER_LAST: internal
  * @NL80211_BSS_MAX: highest BSS attribute
  */
@@ -3517,6 +3544,8 @@ enum nl80211_bss {
         NL80211_BSS_PRESP_DATA,
         NL80211_BSS_LAST_SEEN_BOOTTIME,
         NL80211_BSS_PAD,
+        NL80211_BSS_PARENT_TSF,
+        NL80211_BSS_PARENT_BSSID,
 
         /* keep last */
         __NL80211_BSS_AFTER_LAST,
@@ -4507,6 +4536,16 @@ enum nl80211_feature_flags {
  *      %NL80211_ATTR_MU_MIMO_GROUP_DATA attribute,
  *      or can be configured to follow a station by configuring the
  *      %NL80211_ATTR_MU_MIMO_FOLLOW_MAC_ADDR attribute.
+ * @NL80211_EXT_FEATURE_SCAN_START_TIME: This driver includes the actual
+ *      time the scan started in scan results event. The time is the TSF of
+ *      the BSS that the interface that requested the scan is connected to
+ *      (if available).
+ * @NL80211_EXT_FEATURE_BSS_PARENT_TSF: Per BSS, this driver reports the
+ *      time the last beacon/probe was received. The time is the TSF of the
+ *      BSS that the interface that requested the scan is connected to
+ *      (if available).
+ * @NL80211_EXT_FEATURE_SET_SCAN_DWELL: This driver supports configuration of
+ *      channel dwell time.
  *
  * @NUM_NL80211_EXT_FEATURES: number of extended features.
  * @MAX_NL80211_EXT_FEATURES: highest extended feature index.
@@ -4515,6 +4554,9 @@ enum nl80211_ext_feature_index {
         NL80211_EXT_FEATURE_VHT_IBSS,
         NL80211_EXT_FEATURE_RRM,
         NL80211_EXT_FEATURE_MU_MIMO_AIR_SNIFFER,
+        NL80211_EXT_FEATURE_SCAN_START_TIME,
+        NL80211_EXT_FEATURE_BSS_PARENT_TSF,
+        NL80211_EXT_FEATURE_SET_SCAN_DWELL,
 
         /* add new features before the definition below */
         NUM_NL80211_EXT_FEATURES,