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

dt-bindings: timer: renesas,tpu: Convert to json-schema

Convert the Renesas H8/300 Timer Pulse Unit Device Tree binding
documentation to json-schema.

Correct clock-names, as "peripheral_clk" is the name of the supplier,
and all users use "fck".

Note that there are two different bindings for the TPU, both using
"renesas,tpu": this one for using the TPU as a clock source (used on
H8/300), and a second use for using the TPU as a PWM controller (used on
ARM). To avoid conflicts, both bindings are marked with the appropriate
"select" logic, to check for the absence respectively presence of the
"#pwm-cells" property.

Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Rob Herring <robh@kernel.org>
Acked-by: Yoshinori Sato <ysato@users.sourceforge.jp>
Link: https://lore.kernel.org/r/1c33e62c3a74979c3ca9580176e6cf89384caea9.1620648868.git.geert+renesas@glider.be
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Geert Uytterhoeven and committed by
Rob Herring
d1dd2167 d91133ed

+65 -21
+9
Documentation/devicetree/bindings/pwm/renesas,tpu-pwm.yaml
··· 9 9 maintainers: 10 10 - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com> 11 11 12 + select: 13 + properties: 14 + compatible: 15 + contains: 16 + const: renesas,tpu 17 + required: 18 + - compatible 19 + - '#pwm-cells' 20 + 12 21 properties: 13 22 compatible: 14 23 items:
-21
Documentation/devicetree/bindings/timer/renesas,tpu.txt
··· 1 - * Renesas H8/300 Timer Pulse Unit 2 - 3 - The TPU is a 16bit timer/counter with configurable clock inputs and 4 - programmable compare match. 5 - This implementation support only cascade mode. 6 - 7 - Required Properties: 8 - 9 - - compatible: must contain "renesas,tpu" 10 - - reg: base address and length of the registers block in 2 channel. 11 - - clocks: a list of phandle, one for each entry in clock-names. 12 - - clock-names: must contain "peripheral_clk" for the functional clock. 13 - 14 - 15 - Example: 16 - tpu: tpu@ffffe0 { 17 - compatible = "renesas,tpu"; 18 - reg = <0xffffe0 16>, <0xfffff0 12>; 19 - clocks = <&pclk>; 20 - clock-names = "peripheral_clk"; 21 - };
+56
Documentation/devicetree/bindings/timer/renesas,tpu.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/timer/renesas,tpu.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Renesas H8/300 Timer Pulse Unit 8 + 9 + maintainers: 10 + - Yoshinori Sato <ysato@users.sourceforge.jp> 11 + 12 + description: 13 + The TPU is a 16bit timer/counter with configurable clock inputs and 14 + programmable compare match. 15 + This implementation supports only cascade mode. 16 + 17 + select: 18 + properties: 19 + compatible: 20 + contains: 21 + const: renesas,tpu 22 + '#pwm-cells': false 23 + required: 24 + - compatible 25 + 26 + properties: 27 + compatible: 28 + const: renesas,tpu 29 + 30 + reg: 31 + items: 32 + - description: First channel 33 + - description: Second channel 34 + 35 + clocks: 36 + maxItems: 1 37 + 38 + clock-names: 39 + const: fck 40 + 41 + required: 42 + - compatible 43 + - reg 44 + - clocks 45 + - clock-names 46 + 47 + additionalProperties: false 48 + 49 + examples: 50 + - | 51 + tpu: tpu@ffffe0 { 52 + compatible = "renesas,tpu"; 53 + reg = <0xffffe0 16>, <0xfffff0 12>; 54 + clocks = <&pclk>; 55 + clock-names = "fck"; 56 + };