[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <CAA8EJpoRToOH-SvOf=iMqsuXkcSO-J74HsVF9pWVDde-72oaHQ@mail.gmail.com>
Date: Wed, 6 Mar 2024 21:51:37 +0200
From: Dmitry Baryshkov <dmitry.baryshkov@...aro.org>
To: Sriram Dash <quic_sriramd@...cinc.com>
Cc: andersson@...nel.org, konrad.dybcio@...aro.org, vkoul@...nel.org,
kishon@...nel.org, robh@...nel.org, krzysztof.kozlowski+dt@...aro.org,
conor+dt@...nel.org, gregkh@...uxfoundation.org, quic_wcheng@...cinc.com,
Thinh.Nguyen@...opsys.com, p.zabel@...gutronix.de,
linux-arm-msm@...r.kernel.org, linux-phy@...ts.infradead.org,
devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
linux-usb@...r.kernel.org, quic_psodagud@...cinc.com, quic_nkela@...cinc.com,
manivannan.sadhasivam@...aro.org, ulf.hansson@...aro.org,
sudeep.holla@....com, quic_shazhuss@...cinc.com
Subject: Re: [RFC 1/3] dt-bindings: usb: qcom,dwc3: Add support for multiple power-domains
On Wed, 6 Mar 2024 at 17:52, Sriram Dash <quic_sriramd@...cinc.com> wrote:
>
> On 3/6/2024 12:33 AM, Dmitry Baryshkov wrote:
> > On Tue, 5 Mar 2024 at 18:58, Sriram Dash <quic_sriramd@...cinc.com> wrote:
> >>
> >> Some target systems allow multiple resources to be managed by firmware.
> >> On these targets, tasks related to clocks, regulators, resets, and
> >> interconnects can be delegated to the firmware, while the remaining
> >> responsibilities are handled by Linux.
> >>
> >> To support the management of partial resources in Linux and leave the rest
> >> to firmware, multiple power domains are introduced. Each power domain can
> >> manage one or more resources, depending on the specific use case.
> >>
> >> These power domains handle SCMI calls to the firmware, enabling the
> >> activation and deactivation of firmware-managed resources.
> >>
> >> Signed-off-by: Sriram Dash <quic_sriramd@...cinc.com>
> >> ---
> >> .../phy/qcom,sc8280xp-qmp-usb3-uni-phy.yaml | 74 ++++++++++++++++------
> >> .../bindings/phy/qcom,usb-snps-femto-v2.yaml | 49 ++++++++++++--
> >> .../devicetree/bindings/usb/qcom,dwc3.yaml | 37 ++++++++++-
> >> 3 files changed, 130 insertions(+), 30 deletions(-)
> >>
> >> diff --git a/Documentation/devicetree/bindings/phy/qcom,sc8280xp-qmp-usb3-uni-phy.yaml b/Documentation/devicetree/bindings/phy/qcom,sc8280xp-qmp-usb3-uni-phy.yaml
> >> index 1e2d4dd..53b9ba9 100644
> >> --- a/Documentation/devicetree/bindings/phy/qcom,sc8280xp-qmp-usb3-uni-phy.yaml
> >> +++ b/Documentation/devicetree/bindings/phy/qcom,sc8280xp-qmp-usb3-uni-phy.yaml
> >> @@ -44,7 +44,32 @@ properties:
> >> maxItems: 5
> >>
> >> power-domains:
> >> - maxItems: 1
> >> + description: specifies a phandle to PM domain provider node
> >> + minItems: 1
> >> + maxItems: 2
> >> +
> >> + power-domain-names:
> >> + description:
> >> + A list of power domain name strings sorted in the same order as the
> >> + power-domains property.
> >> +
> >> + For platforms where some resource are firmware managed, the name
> >> + corresponding to the index of an SCMI domain provider can be
> >> + "usb_core" or "usb_transfer".
> >> + items:
> >> + - const: usb_core
> >> + - const: usb_transfer
> >> +
> >> + qmp,fw-managed:
> >> + description:
> >> + Some targets allow multiple resources to be managed by firmware.
> >> + On these targets, tasks related to clocks, regulators, resets, and
> >> + interconnects can be delegated to the firmware, while the remaining
> >> + responsibilities are handled by Linux.
> >> +
> >> + Decide if the target resources will be managed by firmware or High level
> >> + OS.
> >> + type: boolean
> >>
> >> resets:
> >> maxItems: 2
> >> @@ -70,14 +95,6 @@ properties:
> >> required:
> >> - compatible
> >> - reg
> >> - - clocks
> >> - - clock-names
> >> - - resets
> >> - - reset-names
> >> - - vdda-phy-supply
> >> - - vdda-pll-supply
> >> - - "#clock-cells"
> >> - - clock-output-names
> >> - "#phy-cells"
> >>
> >> allOf:
> >> @@ -86,6 +103,33 @@ allOf:
> >> compatible:
> >> contains:
> >> enum:
> >> + - qcom,sa8775p-qmp-usb3-uni-phy
> >> + - qcom,sc8280xp-qmp-usb3-uni-phy
> >> + - qcom,x1e80100-qmp-usb3-uni-phy
> >> + then:
> >> + required:
> >> + - power-domains
> >> +
> >> + - if:
> >> + not:
> >> + required:
> >> + - qmp,fw-managed
> >> + then:
> >> + required:
> >> + - clocks
> >> + - clock-names
> >> + - resets
> >> + - reset-names
> >> + - vdda-phy-supply
> >> + - vdda-pll-supply
> >> + - clock-output-names
> >> + - "#clock-cells"
> >> +
> >> + - if:
> >> + properties:
> >> + compatible:
> >> + contains:
> >> + enum:
> >> - qcom,ipq6018-qmp-usb3-phy
> >> - qcom,ipq8074-qmp-usb3-phy
> >> - qcom,ipq9574-qmp-usb3-phy
> >> @@ -144,18 +188,6 @@ allOf:
> >> - const: com_aux
> >> - const: pipe
> >>
> >> - - if:
> >> - properties:
> >> - compatible:
> >> - contains:
> >> - enum:
> >> - - qcom,sa8775p-qmp-usb3-uni-phy
> >> - - qcom,sc8280xp-qmp-usb3-uni-phy
> >> - - qcom,x1e80100-qmp-usb3-uni-phy
> >> - then:
> >> - required:
> >> - - power-domains
> >> -
> >> additionalProperties: false
> >>
> >> examples:
> >> diff --git a/Documentation/devicetree/bindings/phy/qcom,usb-snps-femto-v2.yaml b/Documentation/devicetree/bindings/phy/qcom,usb-snps-femto-v2.yaml
> >> index 0f200e3..ad2f08f 100644
> >> --- a/Documentation/devicetree/bindings/phy/qcom,usb-snps-femto-v2.yaml
> >> +++ b/Documentation/devicetree/bindings/phy/qcom,usb-snps-femto-v2.yaml
> >> @@ -49,6 +49,34 @@ properties:
> >> items:
> >> - const: ref
> >>
> >> + power-domains:
> >> + description: specifies a phandle to PM domain provider node
> >> + minItems: 1
> >> + maxItems: 2
> >> +
> >> + power-domain-names:
> >> + description:
> >> + A list of power domain name strings sorted in the same order as the
> >> + power-domains property.
> >> +
> >> + For platforms where some resource are firmware managed, the name
> >> + corresponding to the index of an SCMI domain provider can be
> >> + "usb_core" or "usb_transfer".
> >> + items:
> >> + - const: usb_core
> >> + - const: usb_transfer
> >> +
> >> + hsphy,fw-managed:
> >> + description:
> >> + Some targets allow multiple resources to be managed by firmware.
> >> + On these targets, tasks related to clocks, regulators, resets, and
> >> + interconnects can be delegated to the firmware, while the remaining
> >> + responsibilities are handled by Linux.
> >> +
> >> + Decide if the target resources will be managed by firmware or High level
> >> + OS.
> >> + type: boolean
> >> +
> >> resets:
> >> items:
> >> - description: PHY core reset
> >> @@ -154,12 +182,21 @@ required:
> >> - compatible
> >> - reg
> >> - "#phy-cells"
> >> - - clocks
> >> - - clock-names
> >> - - resets
> >> - - vdda-pll-supply
> >> - - vdda18-supply
> >> - - vdda33-supply
> >> +
> >> +
> >> +allOf:
> >> + - if:
> >> + not:
> >> + required:
> >> + - hsphy,fw-managed
> >> + then:
> >> + required:
> >> + - clocks
> >> + - clock-names
> >> + - resets
> >> + - vdda-pll-supply
> >> + - vdda18-supply
> >> + - vdda33-supply
> >>
> >> additionalProperties: false
> >>
> >> diff --git a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml
> >> index 63d150b..5bf3a29 100644
> >> --- a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml
> >> +++ b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml
> >> @@ -64,7 +64,31 @@ properties:
> >>
> >> power-domains:
> >> description: specifies a phandle to PM domain provider node
> >> - maxItems: 1
> >> + minItems: 1
> >> + maxItems: 2
> >> +
> >> + power-domain-names:
> >> + description:
> >> + A list of power domain name strings sorted in the same order as the
> >> + power-domains property.
> >> +
> >> + For platforms where some resource are firmware managed, the name
> >> + corresponding to the index of an SCMI domain provider can be
> >> + "usb_core" or "usb_transfer".
> >> + items:
> >> + - const: usb_core
> >> + - const: usb_transfer
> >> +
> >> + qcom,fw-managed:
> >> + description:
> >> + Some targets allow multiple resources to be managed by firmware.
> >> + On these targets, tasks related to clocks, regulators, resets, and
> >> + interconnects can be delegated to the firmware, while the remaining
> >> + responsibilities are handled by Linux.
> >> +
> >> + Decide if the target resources will be managed by firmware or High level
> >> + OS.
> >> + type: boolean
> >
> > I think this is an overkill. You know that SA8775 is going to use
> > SCMI-based clocks / PD management. Thus I'd suggest adding new
> > bindings file targeting qcom,sa8775-dwc3. Also you can drop the
> > qcom,fw-managed property at all, let the driver decide basing on the
> > compat string.
> >
> >
>
> Thank you for the suggestion Dmitry. I will include
> new compat string for SA8775 which will decide whether
> to use scmi based clock/ PD.
As a reminder:
- same hardware = same compatible string
- existing DT better to continue to work. Or ask for explicit
permission from Bjorn to break the ABI.
>
> >>
> >> required-opps:
> >> maxItems: 1
> >> @@ -148,13 +172,20 @@ required:
> >> - "#address-cells"
> >> - "#size-cells"
> >> - ranges
> >> - - clocks
> >> - - clock-names
> >> - interrupts
> >> - interrupt-names
> >>
> >> allOf:
> >> - if:
> >> + not:
> >> + required:
> >> + - qcom,fw-managed
> >> + then:
> >> + required:
> >> + - clocks
> >> + - clock-names
> >> +
> >> + - if:
> >> properties:
> >> compatible:
> >> contains:
> >> --
> >> 2.7.4
> >>
> >>
> >
> >
> > --
> > With best wishes
> > Dmitry
--
With best wishes
Dmitry
Powered by blists - more mailing lists