[PATCH V11 0/7] PM / Domains: Performance state support

[Viresh Kumar]

Hi,

This version contains the changes we discussed during Linaro Connect.

Some platforms have the capability to configure the performance state of
their power domains. The process of configuring the performance state is
pretty much platform dependent and we may need to work with a wide range
of configurables.  For some platforms, like Qcom, it can be a positive
integer value alone, while in other cases it can be voltage levels, etc.

The power-domain framework until now was only designed for the idle
state management of the device and this needs to change in order to
reuse the power-domain framework for active state management of the
devices.

The first patch updates the genpd framework to supply new APIs to
support active state management and the second patch uses them from the
OPP core. The third patch adds a new API to the OPP core to get
performance state corresponding to OPPs (This should rather come via DT
and would be removed once we have fixed bindings for performance
states).

Rest of the patches [4-7/7] are included to show how user drivers would
end up using the new APIs and these patches aren't ready to get merged
yet and are marked clearly like that. Moreover some of them may go via
SoC specific trees instead of the PM tree.

This is currently tested by:
- /me by hacking the kernel a bit with virtual power-domains for the ARM
  64 hikey platform.
- Rajendra Nayak, on msm8996 platform (Qcom) with MMC controller.

Thanks Rajendra for helping me testing this out.

I also had a chat with Rajendra and we should be able to get a Qualcomm
specific power domain driver (which uses these changes) in coming weeks.

I am targeting the first 3 patches for 4.15-rc1, if possible.

Pushed here as well:

https://git.linaro.org/people/viresh.kumar/linux.git/log/?h=opp/genpd-performance-state

Rebased over: pm/linux-next

V10->V11:
- Dropped propagation to master domains of a subdomain, as we don't have
  such requirements yet and we may not have 1 to 1 relation between the
  states of subdomains and masters.
- Updated genpd API to get performance state directly instead of
  frequency. The conversion of frequency to performance state is now
  done by OPP core instead, which is more logical.
- Only the mmc patch is kept and other user patches are dropped, anyway
  none of those is getting merged right now.
- Updates to the rpm power domain driver and a new OPP driver is added
  as well.

V9->V10:
- Performance state of masters is updated before the state of the genpd
  (Ulf).
- 2/7 and 3/7 are swapped.

V8->V9:
- Renamed genpd callbacks and internal routines.
- dev_pm_genpd_has_performance_state() simplified a lot and doesn't
  check master hierarchy now. Rather a new patch (2/7) is added to
  take care of that and WARN if no master has set
  genpd_set_performance_state() callback.
- Update is propagated to the masters even if the genpd's callback is
  already called.
- Exit _genpd_reeval_performance_state() early if no state change is
  required and it gets an additional argument (new state of the
  device/subdomain).
- Taken care of genpd on/off cases.
- s/parent/master everywhere in comments and logs.
- Better explanations in logs, comments etc.
- All the other patches (3-7/7) are same as V8. (Just minor update in
  5/7 to use the updated callback names).

V7->V8:
- Ulf helped a lot in reviewing V7 and pointed out couple of issues,
  specially in locking while dealing with a hierarchy of power domains.
- All those locking issues are sorted out now, even for the complex
  cases.
- genpd_lookup_dev() is used in pm_genpd_has_performance_state() to make
  sure we have a valid genpd available for the device.
- Validation of performance state callbacks isn't done anymore in
  pm_genpd_init() as it gets called very early and the binding of
  subdomains to their parent domains happens later. This is handled in
  pm_genpd_has_performance_state() now, which is called from user
  drivers.
- User driver changes (not to be merged) are included for the first time
  here, to demonstrate how changes would look finally.

V6->V7:
- Almost a rewrite, only two patches against 9 in earlier version.
- No bindings updated now and domain's performance state aren't passed
  via DT for now (until we know how users are going to use it).
- We also skipped the QoS framework completely and new APIs are provided
  directly by genpd.

V5->V6:
- Use freq/voltage in OPP table as it is for power domain and don't
  create "domain-performance-level" property
- Create new "power-domain-opp" property for the devices.
- Take care of domain providers that provide multiple domains and extend
  "operating-points-v2" property to contain a list of phandles
- Update code according to those bindings.

V4->V5:
- Only 3 patches were resent and 2 of them are Acked from Ulf.

V3->V4:
- Use OPP table for genpd devices as well.
- Add struct device to genpd, in order to reuse OPP infrastructure.
- Based over: https://marc.info/?l=linux-kernel&m=148972988002317&w=2
- Fixed examples in DT document to have voltage in target,min,max order.

V2->V3:
- Based over latest pm/linux-next
- Bindings and code are merged together
- Lots of updates in bindings
  - the performance-states node is present within the power-domain now,
    instead of its phandle.
  - performance-level property is replaced by "reg".
  - domain-performance-state property of the consumers contain an
    integer value now instead of phandle.
- Lots of updates to the code as well
  - Patch "PM / QOS: Add default case to the switch" is merged with
    other patches and the code is changed a bit as well.
  - Don't pass 'type' to dev_pm_qos_add_notifier(), rather handle all
    notifiers with a single list. A new patch is added for that.
  - The OPP framework patch can be applied now and has proper SoB from
    me.
  - Dropped "PM / domain: Save/restore performance state at runtime
    suspend/resume".
  - Drop all WARN().
  - Tested-by Rajendra nayak.

V1->V2:
- Based over latest pm/linux-next
- It is mostly a resend of what is sent earlier as this series hasn't
  got any reviews so far and Rafael suggested that its better I resend
  it.
- Only the 4/6 patch got an update, which was shared earlier as reply to
  V1 as well. It has got several fixes for taking care of power domain
  hierarchy, etc.

--
viresh


Rajendra Nayak (3):
  soc: qcom: rpmpd: Add driver to model cx/mx power domains
  soc: qcom: rpmpd: Add support for set performance state
  mmc: sdhci-msm: Adapt the driver to use OPPs to set clocks/performance
    state

Viresh Kumar (4):
  PM / Domains: Add support to select performance-state of domains
  OPP: Support updating performance state of device's power domain
  OPP: Add dev_pm_opp_{un}register_get_pstate_helper()
  OPP: qcom: Add support to get performance states corresponding to OPPs

 .../devicetree/bindings/power/qcom,rpmpd.txt       |   9 +
 arch/arm64/boot/dts/qcom/msm8996.dtsi              |  39 +++
 drivers/base/power/domain.c                        | 179 ++++++++++-
 drivers/clk/qcom/gcc-msm8996.c                     |   8 +-
 drivers/mmc/host/sdhci-msm.c                       |  39 ++-
 drivers/opp/Makefile                               |   2 +
 drivers/opp/core.c                                 | 135 ++++++++-
 drivers/opp/debugfs.c                              |   3 +
 drivers/opp/opp.h                                  |   6 +
 drivers/opp/qcom-rpmpd.c                           | 107 +++++++
 drivers/soc/qcom/Kconfig                           |   9 +
 drivers/soc/qcom/Makefile                          |   1 +
 drivers/soc/qcom/rpmpd.c                           | 330 +++++++++++++++++++++
 include/linux/pm_domain.h                          |  13 +
 include/linux/pm_opp.h                             |  10 +
 15 files changed, 873 insertions(+), 17 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/power/qcom,rpmpd.txt
 create mode 100644 drivers/opp/qcom-rpmpd.c
 create mode 100644 drivers/soc/qcom/rpmpd.c

-- 
2.7.4