Commit faf66c22 authored by Yoshihiro Kaneko's avatar Yoshihiro Kaneko Committed by Rob Herring
Browse files

dt-bindings: pwm: renesas: tpu: convert bindings to json-schema



Convert Renesas R-Car Timer Pulse Unit PWM Controller bindings documentation
to json-schema.

Signed-off-by: default avatarYoshihiro Kaneko <ykaneko0929@gmail.com>
Reviewed-by: default avatarSimon Horman <horms+renesas@verge.net.au>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 2a197ce6
Loading
Loading
Loading
Loading
+0 −35
Original line number Diff line number Diff line
* Renesas R-Car Timer Pulse Unit PWM Controller

Required Properties:

  - compatible: must contain one or more of the following:
    - "renesas,tpu-r8a73a4": for R8A73A4 (R-Mobile APE6) compatible PWM controller.
    - "renesas,tpu-r8a7740": for R8A7740 (R-Mobile A1) compatible PWM controller.
    - "renesas,tpu-r8a7743": for R8A7743 (RZ/G1M) compatible PWM controller.
    - "renesas,tpu-r8a7744": for R8A7744 (RZ/G1N) compatible PWM controller.
    - "renesas,tpu-r8a7745": for R8A7745 (RZ/G1E) compatible PWM controller.
    - "renesas,tpu-r8a7790": for R8A7790 (R-Car H2) compatible PWM controller.
    - "renesas,tpu-r8a77970": for R8A77970 (R-Car V3M) compatible PWM
			      controller.
    - "renesas,tpu-r8a77980": for R8A77980 (R-Car V3H) compatible PWM
			      controller.
    - "renesas,tpu": for the generic TPU PWM controller; this is a fallback for
		     the entries listed above.

  - reg: Base address and length of each memory resource used by the PWM
    controller hardware module.

  - #pwm-cells: should be 3. See pwm.txt in this directory for a description of
    the cells format. The only third cell flag supported by this binding is
    PWM_POLARITY_INVERTED.

Please refer to pwm.txt in this directory for details of the common PWM bindings
used by client devices.

Example: R8A7740 (R-Mobile A1) TPU controller node

	tpu: pwm@e6600000 {
		compatible = "renesas,tpu-r8a7740", "renesas,tpu";
		reg = <0xe6600000 0x148>;
		#pwm-cells = <3>;
	};
+69 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/pwm/renesas,tpu-pwm.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Renesas R-Car Timer Pulse Unit PWM Controller

maintainers:
  - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>

properties:
  compatible:
    items:
      - enum:
          - renesas,tpu-r8a73a4   # R-Mobile APE6
          - renesas,tpu-r8a7740   # R-Mobile A1
          - renesas,tpu-r8a7743   # RZ/G1M
          - renesas,tpu-r8a7744   # RZ/G1N
          - renesas,tpu-r8a7745   # RZ/G1E
          - renesas,tpu-r8a7790   # R-Car H2
          - renesas,tpu-r8a7795   # R-Car H3
          - renesas,tpu-r8a7796   # R-Car M3-W
          - renesas,tpu-r8a77965  # R-Car M3-N
          - renesas,tpu-r8a77970  # R-Car V3M
          - renesas,tpu-r8a77980  # R-Car V3H
      - const: renesas,tpu

  reg:
    # Base address and length of each memory resource used by the PWM
    # controller hardware module.
    maxItems: 1

  interrupts:
    maxItems: 1

  '#pwm-cells':
    # should be 3. See pwm.txt in this directory for a description of
    # the cells format. The only third cell flag supported by this binding is
    # PWM_POLARITY_INVERTED.
    const: 3

  clocks:
    maxItems: 1

  power-domains:
    maxItems: 1

  resets:
    maxItems: 1

required:
  - compatible
  - reg
  - '#pwm-cells'

additionalProperties: false

examples:
  - |
    #include <dt-bindings/clock/r8a7740-clock.h>

    tpu: pwm@e6600000 {
        compatible = "renesas,tpu-r8a7740", "renesas,tpu";
        reg = <0xe6600000 0x148>;
        clocks = <&mstp3_clks R8A7740_CLK_TPU0>;
        power-domains = <&pd_a3sp>;
        #pwm-cells = <3>;
    };