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@xxxxxxxxx>
Reviewed-by: Niklas Söderlund <niklas.soderlund+renesas@xxxxxxxxxxxx>
> ---
> .../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@xxxxxxxxx>
> + - Magnus Damm <magnus.damm@xxxxxxxxx>
> +
> +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
>
--
Regards,
Niklas Söderlund
