PM: EM: Change the order of arguments in the .active_power() callback
authorLukasz Luba <lukasz.luba@arm.com>
Mon, 21 Mar 2022 09:57:25 +0000 (09:57 +0000)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Wed, 13 Apr 2022 14:26:17 +0000 (16:26 +0200)
The .active_power() callback passes the device pointer when it's called.
Aligned with a convetion present in other subsystems and pass the 'dev'
as a first argument. It looks more cleaner.

Adjust all affected drivers which implement that API callback.

Suggested-by: Ionela Voinescu <ionela.voinescu@arm.com>
Signed-off-by: Lukasz Luba <lukasz.luba@arm.com>
Reviewed-by: Ionela Voinescu <ionela.voinescu@arm.com>
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Documentation/power/energy-model.rst
drivers/cpufreq/mediatek-cpufreq-hw.c
drivers/cpufreq/scmi-cpufreq.c
drivers/opp/of.c
include/linux/energy_model.h
kernel/power/energy_model.c

index 49549aa..fd29ed2 100644 (file)
@@ -181,8 +181,8 @@ EM framework::
 
   -> drivers/cpufreq/foo_cpufreq.c
 
-  01   static int est_power(unsigned long *mW, unsigned long *KHz,
-  02                   struct device *dev)
+  01   static int est_power(struct device *dev, unsigned long *mW,
+  02                   unsigned long *KHz)
   03   {
   04           long freq, power;
   05
index 0a94c56..813cccb 100644 (file)
@@ -51,8 +51,8 @@ static const u16 cpufreq_mtk_offsets[REG_ARRAY_SIZE] = {
 };
 
 static int __maybe_unused
-mtk_cpufreq_get_cpu_power(unsigned long *mW,
-                         unsigned long *KHz, struct device *cpu_dev)
+mtk_cpufreq_get_cpu_power(struct device *cpu_dev, unsigned long *mW,
+                         unsigned long *KHz)
 {
        struct mtk_cpufreq_data *data;
        struct cpufreq_policy *policy;
index 919fa6e..6d2a4cf 100644 (file)
@@ -96,8 +96,8 @@ scmi_get_sharing_cpus(struct device *cpu_dev, struct cpumask *cpumask)
 }
 
 static int __maybe_unused
-scmi_get_cpu_power(unsigned long *power, unsigned long *KHz,
-                  struct device *cpu_dev)
+scmi_get_cpu_power(struct device *cpu_dev, unsigned long *power,
+                  unsigned long *KHz)
 {
        unsigned long Hz;
        int ret, domain;
index 440ab5a..485ea98 100644 (file)
@@ -1448,7 +1448,7 @@ EXPORT_SYMBOL_GPL(dev_pm_opp_get_of_node);
  * Returns 0 on success or a proper -EINVAL value in case of error.
  */
 static int __maybe_unused
-_get_dt_power(unsigned long *mW, unsigned long *kHz, struct device *dev)
+_get_dt_power(struct device *dev, unsigned long *mW, unsigned long *kHz)
 {
        struct dev_pm_opp *opp;
        unsigned long opp_freq, opp_power;
@@ -1482,8 +1482,8 @@ _get_dt_power(unsigned long *mW, unsigned long *kHz, struct device *dev)
  * Returns -EINVAL if the power calculation failed because of missing
  * parameters, 0 otherwise.
  */
-static int __maybe_unused _get_power(unsigned long *mW, unsigned long *kHz,
-                                    struct device *dev)
+static int __maybe_unused _get_power(struct device *dev, unsigned long *mW,
+                                    unsigned long *kHz)
 {
        struct dev_pm_opp *opp;
        struct device_node *np;
index 92e82a3..8419bff 100644 (file)
@@ -101,11 +101,11 @@ struct em_data_callback {
        /**
         * active_power() - Provide power at the next performance state of
         *              a device
+        * @dev         : Device for which we do this operation (can be a CPU)
         * @power       : Active power at the performance state
         *              (modified)
         * @freq        : Frequency at the performance state in kHz
         *              (modified)
-        * @dev         : Device for which we do this operation (can be a CPU)
         *
         * active_power() must find the lowest performance state of 'dev' above
         * 'freq' and update 'power' and 'freq' to the matching active power
@@ -117,8 +117,8 @@ struct em_data_callback {
         *
         * Return 0 on success.
         */
-       int (*active_power)(unsigned long *power, unsigned long *freq,
-                           struct device *dev);
+       int (*active_power)(struct device *dev, unsigned long *power,
+                           unsigned long *freq);
 
        /**
         * get_cost() - Provide the cost at the given performance state of
index 95a3b33..babefc7 100644 (file)
@@ -140,7 +140,7 @@ static int em_create_perf_table(struct device *dev, struct em_perf_domain *pd,
                 * lowest performance state of 'dev' above 'freq' and updates
                 * 'power' and 'freq' accordingly.
                 */
-               ret = cb->active_power(&power, &freq, dev);
+               ret = cb->active_power(dev, &power, &freq);
                if (ret) {
                        dev_err(dev, "EM: invalid perf. state: %d\n",
                                ret);