Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: clock: renesas: div6: Convert to json-schema

Convert the Renesas CPG DIV6 Clock Device Tree binding documentation to
json-schema.

Drop R-Car Gen2 compatible values, which were obsoleted by the unified
"Renesas Clock Pulse Generator / Module Standby and Software Reset" DT
bindings.
Update the example to match reality.

Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Stephen Boyd <sboyd@kernel.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Niklas Söderlund <niklas.soderlund+renesas@ragnatech.se>
Link: https://lore.kernel.org/r/20200507075026.31941-1-geert+renesas@glider.be

+60 -40
+60
Documentation/devicetree/bindings/clock/renesas,cpg-div6-clock.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/clock/renesas,cpg-div6-clock.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Renesas CPG DIV6 Clock 8 + 9 + maintainers: 10 + - Geert Uytterhoeven <geert+renesas@glider.be> 11 + 12 + description: 13 + The CPG DIV6 clocks are variable factor clocks provided by the Clock Pulse 14 + Generator (CPG). Their clock input is divided by a configurable factor from 1 15 + to 64. 16 + 17 + properties: 18 + compatible: 19 + items: 20 + - enum: 21 + - renesas,r8a73a4-div6-clock # R-Mobile APE6 22 + - renesas,r8a7740-div6-clock # R-Mobile A1 23 + - renesas,sh73a0-div6-clock # SH-Mobile AG5 24 + - const: renesas,cpg-div6-clock 25 + 26 + reg: 27 + maxItems: 1 28 + 29 + clocks: 30 + oneOf: 31 + - maxItems: 1 32 + - maxItems: 4 33 + - maxItems: 8 34 + description: 35 + For clocks with multiple parents, invalid settings must be specified as 36 + "<0>". 37 + 38 + '#clock-cells': 39 + const: 0 40 + 41 + clock-output-names: true 42 + 43 + required: 44 + - compatible 45 + - reg 46 + - clocks 47 + - '#clock-cells' 48 + 49 + additionalProperties: false 50 + 51 + examples: 52 + - | 53 + #include <dt-bindings/clock/r8a73a4-clock.h> 54 + sdhi2_clk: sdhi2_clk@e615007c { 55 + compatible = "renesas,r8a73a4-div6-clock", "renesas,cpg-div6-clock"; 56 + reg = <0xe615007c 4>; 57 + clocks = <&pll1_div2_clk>, <&cpg_clocks R8A73A4_CLK_PLL2S>, <0>, 58 + <&extal2_clk>; 59 + #clock-cells = <0>; 60 + };
-40
Documentation/devicetree/bindings/clock/renesas,cpg-div6-clocks.txt
··· 1 - * Renesas CPG DIV6 Clock 2 - 3 - The CPG DIV6 clocks are variable factor clocks provided by the Clock Pulse 4 - Generator (CPG). Their clock input is divided by a configurable factor from 1 5 - to 64. 6 - 7 - Required Properties: 8 - 9 - - compatible: Must be one of the following 10 - - "renesas,r8a73a4-div6-clock" for R8A73A4 (R-Mobile APE6) DIV6 clocks 11 - - "renesas,r8a7740-div6-clock" for R8A7740 (R-Mobile A1) DIV6 clocks 12 - - "renesas,r8a7790-div6-clock" for R8A7790 (R-Car H2) DIV6 clocks 13 - - "renesas,r8a7791-div6-clock" for R8A7791 (R-Car M2-W) DIV6 clocks 14 - - "renesas,r8a7793-div6-clock" for R8A7793 (R-Car M2-N) DIV6 clocks 15 - - "renesas,r8a7794-div6-clock" for R8A7794 (R-Car E2) DIV6 clocks 16 - - "renesas,sh73a0-div6-clock" for SH73A0 (SH-Mobile AG5) DIV6 clocks 17 - and "renesas,cpg-div6-clock" as a fallback. 18 - - reg: Base address and length of the memory resource used by the DIV6 clock 19 - - clocks: Reference to the parent clock(s); either one, four, or eight 20 - clocks must be specified. For clocks with multiple parents, invalid 21 - settings must be specified as "<0>". 22 - - #clock-cells: Must be 0 23 - 24 - 25 - Optional Properties: 26 - 27 - - clock-output-names: The name of the clock as a free-form string 28 - 29 - 30 - Example 31 - ------- 32 - 33 - sdhi2_clk: sdhi2_clk@e615007c { 34 - compatible = "renesas,r8a73a4-div6-clock", "renesas,cpg-div6-clock"; 35 - reg = <0 0xe615007c 0 4>; 36 - clocks = <&pll1_div2_clk>, <&cpg_clocks R8A73A4_CLK_PLL2S>, 37 - <0>, <&extal2_clk>; 38 - #clock-cells = <0>; 39 - clock-output-names = "sdhi2ck"; 40 - };