Add new QCA vendor commands for thermal shutdown

Add new QCA vendor commands and attributes to get thermal information
and send thermal shutdown related commands. Indicates the driver to
enter the power saving mode or resume from the power saving mode based
on the given temperature and thresholds.

Signed-off-by: Jouni Malinen <jouni@codeaurora.org>

diff --git a/src/common/qca-vendor.h b/src/common/qca-vendor.h
index 44aef3eac6ff53020554313adc93d1effd1373dd..a66415ecf42cbc407b1a3ae6d5384ff6919b6989 100644 (file)
--- a/src/common/qca-vendor.h
+++ b/src/common/qca-vendor.h
@@ -429,6 +429,18 @@ enum qca_radiotap_vendor_ids {
  * @QCA_NL80211_VENDOR_SUBCMD_SET_QDEPTH_THRESH: Set MSDU queue depth threshold
  *     per peer per TID. Attributes for this command are define in
  *     enum qca_wlan_set_qdepth_thresh_attr.
+ * @QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD: Provides the thermal shutdown action
+ *     guide for WLAN driver. Request to suspend of driver and FW if the
+ *     temperature is higher than the suspend threshold; resume action is
+ *     requested to driver if the temperature is lower than the resume
+ *     threshold. In user poll mode, request temperature data by user. For test
+ *     purpose, getting thermal shutdown configuration parameters is needed.
+ *     Attributes for this interface are defined in
+ *     enum qca_wlan_vendor_attr_thermal_cmd.
+ * @QCA_NL80211_VENDOR_SUBCMD_THERMAL_EVENT: Thermal events reported from
+ *     driver. Thermal temperature and indication of resume completion are
+ *     reported as thermal events. The attributes for this command are defined
+ *     in enum qca_wlan_vendor_attr_thermal_event.
  */
 enum qca_nl80211_vendor_subcmds {
        QCA_NL80211_VENDOR_SUBCMD_UNSPEC = 0,
@@ -581,6 +593,9 @@ enum qca_nl80211_vendor_subcmds {
        QCA_NL80211_VENDOR_SUBCMD_GET_SAR_LIMITS = 164,
        QCA_NL80211_VENDOR_SUBCMD_WLAN_MAC_INFO = 165,
        QCA_NL80211_VENDOR_SUBCMD_SET_QDEPTH_THRESH = 166,
+       /* Thermal shutdown commands to protect wifi chip */
+       QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD = 167,
+       QCA_NL80211_VENDOR_SUBCMD_THERMAL_EVENT = 168,
 };
 
 
@@ -4954,4 +4969,135 @@ enum qca_wlan_vendor_attr_wake_stats {
                QCA_WLAN_VENDOR_GET_WAKE_STATS_AFTER_LAST - 1,
 };
 
+/**
+ * enum qca_wlan_vendor_attr_thermal_cmd - Vendor subcmd attributes to set
+ * cmd value. Used for NL attributes for data used by
+ * QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD sub command.
+ */
+enum qca_wlan_vendor_attr_thermal_cmd {
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_INVALID = 0,
+       /* The value of command, driver will implement different operations
+        * according to this value. It uses values defined in
+        * enum qca_wlan_vendor_attr_thermal_cmd_type.
+        * u32 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_VALUE = 1,
+
+       /* keep last */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_MAX =
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_AFTER_LAST - 1
+};
+
+/**
+ * qca_wlan_vendor_attr_thermal_cmd_type: Attribute values for
+ * QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_VALUE to the vendor subcmd
+ * QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD. This represents the
+ * thermal command types sent to driver.
+ * @QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_PARAMS: Request to
+ * get thermal shutdown configuration parameters for display. Parameters
+ * responded from driver are defined in
+ * enum qca_wlan_vendor_attr_get_thermal_params_rsp.
+ * @QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_TEMPERATURE: Request to
+ * get temperature. Host should respond with a temperature data. It is defined
+ * in enum qca_wlan_vendor_attr_thermal_get_temperature.
+ * @QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_SUSPEND: Request to execute thermal
+ * suspend action.
+ * @QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_RESUME: Request to execute thermal
+ * resume action.
+ */
+enum qca_wlan_vendor_attr_thermal_cmd_type {
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_PARAMS,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_TEMPERATURE,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_SUSPEND,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_RESUME,
+};
+
+/**
+ * enum qca_wlan_vendor_attr_thermal_get_temperature - vendor subcmd attributes
+ * to get chip temperature by user.
+ * enum values are used for NL attributes for data used by
+ * QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_TEMPERATURE command for data used
+ * by QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD sub command.
+ */
+enum qca_wlan_vendor_attr_thermal_get_temperature {
+       QCA_WLAN_VENDOR_ATTR_THERMAL_GET_TEMPERATURE_INVALID = 0,
+       /* Temperature value (degree Celsius) from driver.
+        * u32 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_GET_TEMPERATURE_DATA,
+
+       /* keep last */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_GET_TEMPERATURE_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_GET_TEMPERATURE_MAX =
+       QCA_WLAN_VENDOR_ATTR_THERMAL_GET_TEMPERATURE_AFTER_LAST - 1,
+};
+
+/**
+ * enum qca_wlan_vendor_attr_get_thermal_params_rsp - vendor subcmd attributes
+ * to get configuration parameters of thermal shutdown feature. Enum values are
+ * used by QCA_WLAN_VENDOR_ATTR_THERMAL_CMD_TYPE_GET_PARAMS command for data
+ * used by QCA_NL80211_VENDOR_SUBCMD_THERMAL_CMD sub command.
+ */
+enum qca_wlan_vendor_attr_get_thermal_params_rsp {
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_INVALID = 0,
+       /* Indicate if the thermal shutdown feature is enabled.
+        * NLA_FLAG attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_SHUTDOWN_EN,
+       /* Indicate if the auto mode is enabled.
+        * Enable: Driver triggers the suspend/resume action.
+        * Disable: User space triggers the suspend/resume action.
+        * NLA_FLAG attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_SHUTDOWN_AUTO_EN,
+       /* Thermal resume threshold (degree Celsius). Issue the resume command
+        * if the temperature value is lower than this threshold.
+        * u16 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_RESUME_THRESH,
+       /* Thermal warning threshold (degree Celsius). FW reports temperature
+        * to driver if it's higher than this threshold.
+        * u16 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_WARNING_THRESH,
+       /* Thermal suspend threshold (degree Celsius). Issue the suspend command
+        * if the temperature value is higher than this threshold.
+        * u16 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_SUSPEND_THRESH,
+       /* FW reports temperature data periodically at this interval (ms).
+        * u16 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_SAMPLE_RATE,
+
+       /* keep last */
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_MAX =
+       QCA_WLAN_VENDOR_ATTR_GET_THERMAL_PARAMS_RSP_AFTER_LAST - 1,
+};
+
+/**
+ * enum qca_wlan_vendor_attr_thermal_event - vendor subcmd attributes to
+ * report thermal events from driver to user space.
+ * enum values are used for NL attributes for data used by
+ * QCA_NL80211_VENDOR_SUBCMD_THERMAL_EVENT sub command.
+ */
+enum qca_wlan_vendor_attr_thermal_event {
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_INVALID = 0,
+       /* Temperature value (degree Celsius) from driver.
+        * u32 attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_TEMPERATURE,
+       /* Indication of resume completion from power save mode.
+        * NLA_FLAG attribute.
+        */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_RESUME_COMPLETE,
+
+       /* keep last */
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_AFTER_LAST,
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_MAX =
+       QCA_WLAN_VENDOR_ATTR_THERMAL_EVENT_AFTER_LAST - 1,
+};
+
 #endif /* QCA_VENDOR_H */