Add QCA vendor command and attributes for RROP

Add QCA vendor command and attributes for vendor specific Representative
RF Operating Parameter (RROP) information. This information is intended
for optional use by external ACS. It provides guidance values for some
RF parameters that are used by the system during operation, so that
external ACS can utilize these to compare between channels, bands, etc.

Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com>

diff --git a/src/common/qca-vendor.h b/src/common/qca-vendor.h
index 36db9070f7f4aeb90ef7d271ca639b7d5f24a839..9d12939b2b77bb8e3eb5d598c30318eec4c93862 100644 (file)
--- a/src/common/qca-vendor.h
+++ b/src/common/qca-vendor.h
@@ -360,6 +360,11 @@ enum qca_radiotap_vendor_ids {
  *     QCA_WLAN_VENDOR_ATTR_PEER_ADDR and the access category of the packets
  *     in QCA_WLAN_VENDOR_ATTR_AC. The attributes are listed
  *     in enum qca_wlan_vendor_attr_flush_pending.
+ *
+ * @QCA_NL80211_VENDOR_SUBCMD_GET_RROP_INFO: Get vendor specific Representative
+ *     RF Operating Parameter (RROP) information. The attributes for this
+ *     information are defined in enum qca_wlan_vendor_attr_rrop_info. This is
+ *     intended for use by external Auto Channel Selection applications.
  */
 enum qca_nl80211_vendor_subcmds {
        QCA_NL80211_VENDOR_SUBCMD_UNSPEC = 0,
@@ -498,6 +503,7 @@ enum qca_nl80211_vendor_subcmds {
        QCA_NL80211_VENDOR_SUBCMD_SPECTRAL_SCAN_GET_STATUS = 161,
        /* Flush peer pending data */
        QCA_NL80211_VENDOR_SUBCMD_PEER_FLUSH_PENDING = 162,
+       QCA_NL80211_VENDOR_SUBCMD_GET_RROP_INFO = 163,
 };
 
 
@@ -3633,6 +3639,11 @@ enum qca_wlan_vendor_attr_external_acs_event {
         * qca_wlan_vendor_attr_external_acs_policy.
         */
        QCA_WLAN_VENDOR_ATTR_EXTERNAL_ACS_EVENT_POLICY = 13,
+       /* Reference RF Operating Parameter (RROP) availability information
+        * (u16). It uses values defined in enum
+        * qca_wlan_vendor_attr_rropavail_info.
+        */
+       QCA_WLAN_VENDOR_ATTR_EXTERNAL_ACS_EVENT_RROPAVAIL_INFO = 14,
 
        /* keep last */
        QCA_WLAN_VENDOR_ATTR_EXTERNAL_ACS_EVENT_LAST,
@@ -4138,4 +4149,75 @@ enum qca_wlan_vendor_attr_flush_pending {
        QCA_WLAN_VENDOR_ATTR_FLUSH_PENDING_AFTER_LAST - 1,
 };
 
+/**
+ * enum qca_wlan_vendor_attr_rropavail_info - Specifies whether Representative
+ * RF Operating Parameter (RROP) information is available, and if so, at which
+ * point in the application-driver interaction sequence it can be retrieved by
+ * the application from the driver. This point may vary by architecture and
+ * other factors. This is a u16 value.
+ */
+enum qca_wlan_vendor_attr_rropavail_info {
+       /* RROP information is unavailable. */
+       QCA_WLAN_VENDOR_ATTR_RROPAVAIL_INFO_UNAVAILABLE,
+       /* RROP information is available and the application can retrieve the
+        * information after receiving an QCA_NL80211_VENDOR_SUBCMD_EXTERNAL_ACS
+        * event from the driver.
+        */
+       QCA_WLAN_VENDOR_ATTR_RROPAVAIL_INFO_EXTERNAL_ACS_START,
+       /* RROP information is available only after a vendor specific scan
+        * (requested using QCA_NL80211_VENDOR_SUBCMD_TRIGGER_SCAN) has
+        * successfully completed. The application can retrieve the information
+        * after receiving the QCA_NL80211_VENDOR_SUBCMD_SCAN_DONE event from
+        * the driver.
+        */
+       QCA_WLAN_VENDOR_ATTR_RROPAVAIL_INFO_VSCAN_END,
+};
+
+/**
+ * enum qca_wlan_vendor_attr_rrop_info - Specifies vendor specific
+ * Representative RF Operating Parameter (RROP) information. It is sent for the
+ * vendor command QCA_NL80211_VENDOR_SUBCMD_GET_RROP_INFO. This information is
+ * intended for use by external Auto Channel Selection applications. It provides
+ * guidance values for some RF parameters that are used by the system during
+ * operation. These values could vary by channel, band, radio, and so on.
+ */
+enum qca_wlan_vendor_attr_rrop_info {
+       QCA_WLAN_VENDOR_ATTR_RROP_INFO_INVALID = 0,
+
+       /* Representative Tx Power List (RTPL) which has an array of nested
+        * values as per attributes in enum qca_wlan_vendor_attr_rtplinst.
+        */
+       QCA_WLAN_VENDOR_ATTR_RROP_INFO_RTPL = 1,
+
+       QCA_WLAN_VENDOR_ATTR_RROP_INFO_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_RROP_INFO_MAX =
+       QCA_WLAN_VENDOR_ATTR_RROP_INFO_AFTER_LAST - 1
+};
+
+/**
+ * enum qca_wlan_vendor_attr_rtplinst - Specifies attributes for individual list
+ * entry instances in the Representative Tx Power List (RTPL). It provides
+ * simplified power values intended for helping external Auto channel Selection
+ * applications compare potential Tx power performance between channels, other
+ * operating conditions remaining identical. These values are not necessarily
+ * the actual Tx power values that will be used by the system. They are also not
+ * necessarily the max or average values that will be used. Instead, they are
+ * relative, summarized keys for algorithmic use computed by the driver or
+ * underlying firmware considering a number of vendor specific factors.
+ */
+enum qca_wlan_vendor_attr_rtplinst {
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_INVALID = 0,
+
+       /* Primary channel number (u8) */
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_PRIMARY = 1,
+       /* Representative Tx power in dBm (s32) with emphasis on throughput. */
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_TXPOWER_THROUGHPUT = 2,
+       /* Representative Tx power in dBm (s32) with emphasis on range. */
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_TXPOWER_RANGE = 3,
+
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_RTPLINST_MAX =
+               QCA_WLAN_VENDOR_ATTR_RTPLINST_AFTER_LAST - 1,
+};
+
 #endif /* QCA_VENDOR_H */