From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
To: Rob Herring <robh@kernel.org>
Cc: linuxarm@huawei.com, mauro.chehab@huawei.com,
John Stultz <john.stultz@linaro.org>,
Manivannan Sadhasivam <mani@kernel.org>,
Andy Gross <agross@kernel.org>,
Bjorn Andersson <bjorn.andersson@linaro.org>,
Lee Jones <lee.jones@linaro.org>, Stephen Boyd <sboyd@kernel.org>,
Josh Cartwright <joshc@codeaurora.org>,
linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] dt-bindings: convert spmi.txt to spmi.yaml
Date: Tue, 25 Aug 2020 11:29:12 +0200 [thread overview]
Message-ID: <20200825112912.4fca31ad@coco.lan> (raw)
In-Reply-To: <20200819230812.GB2090217@bogus>
Em Wed, 19 Aug 2020 17:08:12 -0600
Rob Herring <robh@kernel.org> escreveu:
> On Wed, Aug 19, 2020 at 05:20:06PM +0200, Mauro Carvalho Chehab wrote:
> > Convert the SPMI bus documentation to JSON/yaml.
> >
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> > ---
> >
> > Rob,
> >
> > As promissed, this patch converts the spmi.txt generic bus bindings to
> > html.
>
> Thanks!
>
> >
> > .../bindings/mfd/qcom,spmi-pmic.txt | 2 +-
> > .../bindings/spmi/qcom,spmi-pmic-arb.txt | 4 +-
> > .../devicetree/bindings/spmi/spmi.txt | 41 ------------
> > .../devicetree/bindings/spmi/spmi.yaml | 62 +++++++++++++++++++
> > 4 files changed, 65 insertions(+), 44 deletions(-)
> > delete mode 100644 Documentation/devicetree/bindings/spmi/spmi.txt
> > create mode 100644 Documentation/devicetree/bindings/spmi/spmi.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/mfd/qcom,spmi-pmic.txt b/Documentation/devicetree/bindings/mfd/qcom,spmi-pmic.txt
> > index fffc8fde3302..79367a43b27d 100644
> > --- a/Documentation/devicetree/bindings/mfd/qcom,spmi-pmic.txt
> > +++ b/Documentation/devicetree/bindings/mfd/qcom,spmi-pmic.txt
> > @@ -37,7 +37,7 @@ Required properties:
> > or generalized "qcom,spmi-pmic".
> > - reg: Specifies the SPMI USID slave address for this device.
> > For more information see:
> > - Documentation/devicetree/bindings/spmi/spmi.txt
> > + Documentation/devicetree/bindings/spmi/spmi.yaml
> >
> > Required properties for peripheral child nodes:
> > - compatible: Should contain "qcom,xxx", where "xxx" is a peripheral name.
> > diff --git a/Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb.txt b/Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb.txt
> > index e16b9b5afc70..ca645e21fe47 100644
> > --- a/Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb.txt
> > +++ b/Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb.txt
> > @@ -7,8 +7,8 @@ devices to control a single SPMI master.
> > The PMIC Arbiter can also act as an interrupt controller, providing interrupts
> > to slave devices.
> >
> > -See spmi.txt for the generic SPMI controller binding requirements for child
> > -nodes.
> > +See Documentation/devicetree/bindings/spmi/spmi.yaml for the generic SPMI
> > +controller binding requirements for child nodes.
> >
> > See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for
> > generic interrupt controller binding documentation.
> > diff --git a/Documentation/devicetree/bindings/spmi/spmi.txt b/Documentation/devicetree/bindings/spmi/spmi.txt
> > deleted file mode 100644
> > index 4bb10d161a27..000000000000
> > --- a/Documentation/devicetree/bindings/spmi/spmi.txt
> > +++ /dev/null
> > @@ -1,41 +0,0 @@
> > -System Power Management Interface (SPMI) Controller
> > -
> > -This document defines a generic set of bindings for use by SPMI controllers. A
> > -controller is modelled in device tree as a node with zero or more child nodes,
> > -each representing a unique slave on the bus.
> > -
> > -Required properties:
> > -- #address-cells : must be set to 2
> > -- #size-cells : must be set to 0
> > -
> > -Child nodes:
> > -
> > -An SPMI controller node can contain zero or more child nodes representing slave
> > -devices on the bus. Child 'reg' properties are specified as an address, type
> > -pair. The address must be in the range 0-15 (4 bits). The type must be one of
> > -SPMI_USID (0) or SPMI_GSID (1) for Unique Slave ID or Group Slave ID respectively.
> > -These are the identifiers "statically assigned by the system integrator", as
> > -per the SPMI spec.
> > -
> > -Each child node must have one and only one 'reg' entry of type SPMI_USID.
> > -
> > -#include <dt-bindings/spmi/spmi.h>
> > -
> > - spmi@.. {
> > - compatible = "...";
> > - reg = <...>;
> > -
> > - #address-cells = <2>;
> > - #size-cells = <0>;
> > -
> > - child@0 {
> > - compatible = "...";
> > - reg = <0 SPMI_USID>;
> > - };
> > -
> > - child@7 {
> > - compatible = "...";
> > - reg = <7 SPMI_USID
> > - 3 SPMI_GSID>;
> > - };
> > - };
> > diff --git a/Documentation/devicetree/bindings/spmi/spmi.yaml b/Documentation/devicetree/bindings/spmi/spmi.yaml
> > new file mode 100644
> > index 000000000000..8d72796b9bec
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/spmi/spmi.yaml
> > @@ -0,0 +1,62 @@
> > +# SPDX-License-Identifier: GPL-2.0
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/spmi/spmi.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: System Power Management Interface (SPMI) Controller
> > +
> > +maintainers:
> > + - Josh Cartwright <joshc@codeaurora.org>
> > +
> > +description: |
> > + The System Power Management (SPMI) controller is a 2-wire bus defined
> > + by the MIPI Alliance for power management control to be used on SoC designs.
> > +
> > + SPMI controllers are modelled in device tree using a generic set of
> > + bindings defined here, plus any bus controller specific properties, if
> > + needed.
> > +
> > + Each SPMI controller has zero or more child nodes (up to 16 ones), each
> > + one representing an unique slave at the bus.
> > +
> > +properties:
> > + $nodename:
> > + pattern: "spmi@[0-9a-f]+"
>
> Just "spmi@.*" as we shouldn't assume unit-address details of the parent
> bus.
Ok.
>
> > +
> > + compatible:
> > + description: filled by the SPMI bus controller
> > +
> > + reg:
> > + maxItems: 1
>
> No need for 'reg' and 'compatible' here. Those will be covered by
> specific SPMI controller schemas.
Ok. I was in doubt about those, as the original .txt file had it with
a <...>.
> But you do need:
>
> "#address-cells":
> const: 2
>
> "#size-cells":
> const: 0
Ok.
>
> > +
> > +patternProperties:
> > + "@([0-9]|1[0-5])$":
>
> While buses define their own unit-address format, unit addresses are
> normally hex.
I don't have a strong preference here. Yet, as this bus can have only up
to 16 child (starting from 0), I guess decimal would make more sense.
>
> > + description: up to 16 child PMIC nodes
>
> type: object
>
> Need to also define 'reg' constraints as defined by the bus:
>
> properties:
> reg:
> minItems: 1
> maxItems: 2 #??? Not sure about this. Is it 1 SPMI_USID and 1 \
> SPMI_GSID entry at most?
I guess so. Currently, no devices use SPMI_GSID. I guess that we
can place maxItems: 2. If later needed, this could be changed in
the future.
> items:
> items:
> - minimum: 0
> maximum: 0xf
> - enum: [ 0, 1 ]
>
> > +
> > +required:
> > + - compatible
> > + - reg
> > +
> > +examples:
> > + - |
> > + #include <dt-bindings/spmi/spmi.h>
> > +
> > + spmi@.. {
> > + compatible = "...";
> > + reg = <...>;
>
> Example has to build now. Just drop these 2 properties.
OK.
>
> > +
> > + #address-cells = <2>;
> > + #size-cells = <0>;
> > +
> > + child@0 {
> > + compatible = "...";
> > + reg = <0 SPMI_USID>;
> > + };
> > +
> > + child@7 {
> > + compatible = "...";
> > + reg = <7 SPMI_USID
> > + 3 SPMI_GSID>;
> > + };
> > + };
> > --
> > 2.26.2
> >
> >
Thanks,
Mauro
next prev parent reply other threads:[~2020-08-25 9:29 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-08-19 15:20 [PATCH] dt-bindings: convert spmi.txt to spmi.yaml Mauro Carvalho Chehab
2020-08-19 22:38 ` Rob Herring
2020-08-19 23:08 ` Rob Herring
2020-08-25 9:29 ` Mauro Carvalho Chehab [this message]
2020-08-26 4:16 ` Mauro Carvalho Chehab
2020-08-26 4:36 ` [PATCH v2] " Mauro Carvalho Chehab
2020-09-08 22:52 ` Rob Herring
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200825112912.4fca31ad@coco.lan \
--to=mchehab+huawei@kernel.org \
--cc=agross@kernel.org \
--cc=bjorn.andersson@linaro.org \
--cc=devicetree@vger.kernel.org \
--cc=john.stultz@linaro.org \
--cc=joshc@codeaurora.org \
--cc=lee.jones@linaro.org \
--cc=linux-arm-msm@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linuxarm@huawei.com \
--cc=mani@kernel.org \
--cc=mauro.chehab@huawei.com \
--cc=robh@kernel.org \
--cc=sboyd@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).