nl80211: Add API to support VHT MU-MIMO air sniffer

add API to support VHT MU-MIMO air sniffer.
in MU-MIMO there are parallel frames on the air while the HW
has only one RX.
add the capability to sniff one of the MU-MIMO parallel frames by
giving the sniffer additional information so it'll know which
of the parallel frames it shall follow.

Add attribute - NL80211_ATTR_MU_MIMO_GROUP_DATA - for getting
a MU-MIMO groupID in order to monitor packets from that group
using VHT MU-MIMO.
And add attribute -NL80211_ATTR_MU_MIMO_FOLLOW_ADDR - for passing
MAC address to monitor mode.
that option will be used by VHT MU-MIMO air sniffer to follow a
station according to it's MAC address using VHT MU-MIMO.

Signed-off-by: Aviya Erenfeld <aviya.erenfeld@intel.com>
Signed-off-by: Luca Coelho <luciano.coelho@intel.com>
Signed-off-by: Johannes Berg <johannes.berg@intel.com>

1 files changed, 29 insertions, 0 deletions

diff --git a/include/uapi/linux/nl80211.h b/include/uapi/linux/nl80211.h
index 53c8278827a0..1d7da7888dcf 100644
--- a/include/uapi/linux/nl80211.h
+++ b/include/uapi/linux/nl80211.h
@@ -1829,6 +1829,25 @@ enum nl80211_commands {
  *      %NL80211_ATTR_EXT_CAPA_MASK, to specify the extended capabilities per
  *      interface type.
  *
+ * @NL80211_ATTR_MU_MIMO_GROUP_DATA: array of 24 bytes that defines a MU-MIMO
+ *      groupID for monitor mode.
+ *      The first 8 bytes are a mask that defines the membership in each
+ *      group (there are 64 groups, group 0 and 63 are reserved),
+ *      each bit represents a group and set to 1 for being a member in
+ *      that group and 0 for not being a member.
+ *      The remaining 16 bytes define the position in each group: 2 bits for
+ *      each group.
+ *      (smaller group numbers represented on most significant bits and bigger
+ *      group numbers on least significant bits.)
+ *      This attribute is used only if all interfaces are in monitor mode.
+ *      Set this attribute in order to monitor packets using the given MU-MIMO
+ *      groupID data.
+ *      to turn off that feature set all the bits of the groupID to zero.
+ * @NL80211_ATTR_MU_MIMO_FOLLOW_MAC_ADDR: mac address for the sniffer to follow
+ *      when using MU-MIMO air sniffer.
+ *      to turn that feature off set an invalid mac address
+ *      (e.g. FF:FF:FF:FF:FF:FF)
+ *
  * @NUM_NL80211_ATTR: total number of nl80211_attrs available
  * @NL80211_ATTR_MAX: highest attribute number currently defined
  * @__NL80211_ATTR_AFTER_LAST: internal use
@@ -2213,6 +2232,9 @@ enum nl80211_attrs {
 
         NL80211_ATTR_IFTYPE_EXT_CAPA,
 
+        NL80211_ATTR_MU_MIMO_GROUP_DATA,
+        NL80211_ATTR_MU_MIMO_FOLLOW_MAC_ADDR,
+
         /* add attributes here, update the policy in nl80211.c */
 
         __NL80211_ATTR_AFTER_LAST,
@@ -4479,6 +4501,12 @@ enum nl80211_feature_flags {
  *      %NL80211_CMD_ASSOCIATE and %NL80211_CMD_CONNECT requests, which will set
  *      the ASSOC_REQ_USE_RRM flag in the association request even if
  *      NL80211_FEATURE_QUIET is not advertized.
+ * @NL80211_EXT_FEATURE_MU_MIMO_AIR_SNIFFER: This device supports MU-MIMO air
+ *      sniffer which means that it can be configured to hear packets from
+ *      certain groups which can be configured by the
+ *      %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.
  *
  * @NUM_NL80211_EXT_FEATURES: number of extended features.
  * @MAX_NL80211_EXT_FEATURES: highest extended feature index.
@@ -4486,6 +4514,7 @@ enum nl80211_feature_flags {
 enum nl80211_ext_feature_index {
         NL80211_EXT_FEATURE_VHT_IBSS,
         NL80211_EXT_FEATURE_RRM,
+        NL80211_EXT_FEATURE_MU_MIMO_AIR_SNIFFER,
 
         /* add new features before the definition below */
         NUM_NL80211_EXT_FEATURES,