Message ID | 20200221121022.30970-1-geert+renesas@glider.be (mailing list archive) |
---|---|
State | Superseded |
Delegated to: | Geert Uytterhoeven |
Headers | show |
Series | dt-bindings: power: rcar-sysc: Convert to json-schema | expand |
Hi Geert, Thanks for your work. On 2020-02-21 13:10:22 +0100, Geert Uytterhoeven wrote: > Convert the Renesas R-Car System Controller Device Tree binding > documentation to json-schema. > > Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be> Reviewed-by: Niklas Söderlund <niklas.soderlund+renesas@ragnatech.se> > --- > .../bindings/power/renesas,rcar-sysc.txt | 62 ---------------- > .../bindings/power/renesas,rcar-sysc.yaml | 73 +++++++++++++++++++ > 2 files changed, 73 insertions(+), 62 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt > create mode 100644 Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > > diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt > deleted file mode 100644 > index acb41fade926e2de..0000000000000000 > --- a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt > +++ /dev/null > @@ -1,62 +0,0 @@ > -DT bindings for the Renesas R-Car (RZ/G) System Controller > - > -== System Controller Node == > - > -The R-Car (RZ/G) System Controller provides power management for the CPU cores > -and various coprocessors. > - > -Required properties: > - - compatible: Must contain exactly one of the following: > - - "renesas,r8a7743-sysc" (RZ/G1M) > - - "renesas,r8a7744-sysc" (RZ/G1N) > - - "renesas,r8a7745-sysc" (RZ/G1E) > - - "renesas,r8a77470-sysc" (RZ/G1C) > - - "renesas,r8a774a1-sysc" (RZ/G2M) > - - "renesas,r8a774b1-sysc" (RZ/G2N) > - - "renesas,r8a774c0-sysc" (RZ/G2E) > - - "renesas,r8a7779-sysc" (R-Car H1) > - - "renesas,r8a7790-sysc" (R-Car H2) > - - "renesas,r8a7791-sysc" (R-Car M2-W) > - - "renesas,r8a7792-sysc" (R-Car V2H) > - - "renesas,r8a7793-sysc" (R-Car M2-N) > - - "renesas,r8a7794-sysc" (R-Car E2) > - - "renesas,r8a7795-sysc" (R-Car H3) > - - "renesas,r8a7796-sysc" (R-Car M3-W) > - - "renesas,r8a77961-sysc" (R-Car M3-W+) > - - "renesas,r8a77965-sysc" (R-Car M3-N) > - - "renesas,r8a77970-sysc" (R-Car V3M) > - - "renesas,r8a77980-sysc" (R-Car V3H) > - - "renesas,r8a77990-sysc" (R-Car E3) > - - "renesas,r8a77995-sysc" (R-Car D3) > - - reg: Address start and address range for the device. > - - #power-domain-cells: Must be 1. > - > - > -Example: > - > - sysc: system-controller@e6180000 { > - compatible = "renesas,r8a7791-sysc"; > - reg = <0 0xe6180000 0 0x0200>; > - #power-domain-cells = <1>; > - }; > - > - > -== PM Domain Consumers == > - > -Devices residing in a power area must refer to that power area, as documented > -by the generic PM domain bindings in > -Documentation/devicetree/bindings/power/power_domain.txt. > - > -Required properties: > - - power-domains: A phandle and symbolic PM domain specifier, as defined in > - <dt-bindings/power/r8a77*-sysc.h>. > - > - > -Example: > - > - L2_CA15: cache-controller@0 { > - compatible = "cache"; > - power-domains = <&sysc R8A7791_PD_CA15_SCU>; > - cache-unified; > - cache-level = <2>; > - }; > diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > new file mode 100644 > index 0000000000000000..8daa23e1c49a3f81 > --- /dev/null > +++ b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > @@ -0,0 +1,73 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: "http://devicetree.org/schemas/power/renesas,rcar-sysc.yaml#" > +$schema: "http://devicetree.org/meta-schemas/core.yaml#" > + > +title: DT bindings for the Renesas R-Car and RZ/G System Controller > + > +maintainers: > + - Geert Uytterhoeven <geert+renesas@glider.be> > + - Magnus Damm <magnus.damm@gmail.com> > + > +description: > + The R-Car (RZ/G) System Controller provides power management for the CPU > + cores and various coprocessors. > + > +properties: > + compatible: > + enum: > + - renesas,r8a7743-sysc # RZ/G1M > + - renesas,r8a7744-sysc # RZ/G1N > + - renesas,r8a7745-sysc # RZ/G1E > + - renesas,r8a77470-sysc # RZ/G1C > + - renesas,r8a774a1-sysc # RZ/G2M > + - renesas,r8a774b1-sysc # RZ/G2N > + - renesas,r8a774c0-sysc # RZ/G2E > + - renesas,r8a7779-sysc # R-Car H1 > + - renesas,r8a7790-sysc # R-Car H2 > + - renesas,r8a7791-sysc # R-Car M2-W > + - renesas,r8a7792-sysc # R-Car V2H > + - renesas,r8a7793-sysc # R-Car M2-N > + - renesas,r8a7794-sysc # R-Car E2 > + - renesas,r8a7795-sysc # R-Car H3 > + - renesas,r8a77961-sysc # R-Car M3-W+ > + - renesas,r8a77965-sysc # R-Car M3-N > + - renesas,r8a7796-sysc # R-Car M3-W > + - renesas,r8a77970-sysc # R-Car V3M > + - renesas,r8a77980-sysc # R-Car V3H > + - renesas,r8a77990-sysc # R-Car E3 > + - renesas,r8a77995-sysc # R-Car D3 > + > + reg: > + maxItems: 1 > + > + '#power-domain-cells': > + const: 1 > + > +required: > + - compatible > + - reg > + - '#power-domain-cells' > + > +additionalProperties: false > + > +examples: > + - | > + // System Controller node > + sysc: system-controller@e6180000 { > + compatible = "renesas,r8a7791-sysc"; > + reg = <0xe6180000 0x0200>; > + #power-domain-cells = <1>; > + }; > + > + - | > + // Power Domain consumers > + #include <dt-bindings/power/r8a7791-sysc.h> > + > + cache-controller-0 { > + compatible = "cache"; > + power-domains = <&sysc R8A7791_PD_CA15_SCU>; > + cache-unified; > + cache-level = <2>; > + }; > -- > 2.17.1 >
diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt deleted file mode 100644 index acb41fade926e2de..0000000000000000 --- a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt +++ /dev/null @@ -1,62 +0,0 @@ -DT bindings for the Renesas R-Car (RZ/G) System Controller - -== System Controller Node == - -The R-Car (RZ/G) System Controller provides power management for the CPU cores -and various coprocessors. - -Required properties: - - compatible: Must contain exactly one of the following: - - "renesas,r8a7743-sysc" (RZ/G1M) - - "renesas,r8a7744-sysc" (RZ/G1N) - - "renesas,r8a7745-sysc" (RZ/G1E) - - "renesas,r8a77470-sysc" (RZ/G1C) - - "renesas,r8a774a1-sysc" (RZ/G2M) - - "renesas,r8a774b1-sysc" (RZ/G2N) - - "renesas,r8a774c0-sysc" (RZ/G2E) - - "renesas,r8a7779-sysc" (R-Car H1) - - "renesas,r8a7790-sysc" (R-Car H2) - - "renesas,r8a7791-sysc" (R-Car M2-W) - - "renesas,r8a7792-sysc" (R-Car V2H) - - "renesas,r8a7793-sysc" (R-Car M2-N) - - "renesas,r8a7794-sysc" (R-Car E2) - - "renesas,r8a7795-sysc" (R-Car H3) - - "renesas,r8a7796-sysc" (R-Car M3-W) - - "renesas,r8a77961-sysc" (R-Car M3-W+) - - "renesas,r8a77965-sysc" (R-Car M3-N) - - "renesas,r8a77970-sysc" (R-Car V3M) - - "renesas,r8a77980-sysc" (R-Car V3H) - - "renesas,r8a77990-sysc" (R-Car E3) - - "renesas,r8a77995-sysc" (R-Car D3) - - reg: Address start and address range for the device. - - #power-domain-cells: Must be 1. - - -Example: - - sysc: system-controller@e6180000 { - compatible = "renesas,r8a7791-sysc"; - reg = <0 0xe6180000 0 0x0200>; - #power-domain-cells = <1>; - }; - - -== PM Domain Consumers == - -Devices residing in a power area must refer to that power area, as documented -by the generic PM domain bindings in -Documentation/devicetree/bindings/power/power_domain.txt. - -Required properties: - - power-domains: A phandle and symbolic PM domain specifier, as defined in - <dt-bindings/power/r8a77*-sysc.h>. - - -Example: - - L2_CA15: cache-controller@0 { - compatible = "cache"; - power-domains = <&sysc R8A7791_PD_CA15_SCU>; - cache-unified; - cache-level = <2>; - }; diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml new file mode 100644 index 0000000000000000..8daa23e1c49a3f81 --- /dev/null +++ b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml @@ -0,0 +1,73 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/power/renesas,rcar-sysc.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: DT bindings for the Renesas R-Car and RZ/G System Controller + +maintainers: + - Geert Uytterhoeven <geert+renesas@glider.be> + - Magnus Damm <magnus.damm@gmail.com> + +description: + The R-Car (RZ/G) System Controller provides power management for the CPU + cores and various coprocessors. + +properties: + compatible: + enum: + - renesas,r8a7743-sysc # RZ/G1M + - renesas,r8a7744-sysc # RZ/G1N + - renesas,r8a7745-sysc # RZ/G1E + - renesas,r8a77470-sysc # RZ/G1C + - renesas,r8a774a1-sysc # RZ/G2M + - renesas,r8a774b1-sysc # RZ/G2N + - renesas,r8a774c0-sysc # RZ/G2E + - renesas,r8a7779-sysc # R-Car H1 + - renesas,r8a7790-sysc # R-Car H2 + - renesas,r8a7791-sysc # R-Car M2-W + - renesas,r8a7792-sysc # R-Car V2H + - renesas,r8a7793-sysc # R-Car M2-N + - renesas,r8a7794-sysc # R-Car E2 + - renesas,r8a7795-sysc # R-Car H3 + - renesas,r8a77961-sysc # R-Car M3-W+ + - renesas,r8a77965-sysc # R-Car M3-N + - renesas,r8a7796-sysc # R-Car M3-W + - renesas,r8a77970-sysc # R-Car V3M + - renesas,r8a77980-sysc # R-Car V3H + - renesas,r8a77990-sysc # R-Car E3 + - renesas,r8a77995-sysc # R-Car D3 + + reg: + maxItems: 1 + + '#power-domain-cells': + const: 1 + +required: + - compatible + - reg + - '#power-domain-cells' + +additionalProperties: false + +examples: + - | + // System Controller node + sysc: system-controller@e6180000 { + compatible = "renesas,r8a7791-sysc"; + reg = <0xe6180000 0x0200>; + #power-domain-cells = <1>; + }; + + - | + // Power Domain consumers + #include <dt-bindings/power/r8a7791-sysc.h> + + cache-controller-0 { + compatible = "cache"; + power-domains = <&sysc R8A7791_PD_CA15_SCU>; + cache-unified; + cache-level = <2>; + };
Convert the Renesas R-Car System Controller Device Tree binding documentation to json-schema. Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be> --- .../bindings/power/renesas,rcar-sysc.txt | 62 ---------------- .../bindings/power/renesas,rcar-sysc.yaml | 73 +++++++++++++++++++ 2 files changed, 73 insertions(+), 62 deletions(-) delete mode 100644 Documentation/devicetree/bindings/power/renesas,rcar-sysc.txt create mode 100644 Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml