Documentation/devicetree/bindings/timer/renesas,tmu.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,tmu.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Renesas R-Mobile/R-Car Timer Unit (TMU)
   8
   9 maintainers:
  10   - Geert Uytterhoeven <geert+renesas@glider.be>
  11   - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
  12
  13 description:
  14   The TMU is a 32-bit timer/counter with configurable clock inputs and
  15   programmable compare match.
  16
  17   Channels share hardware resources but their counter and compare match value
  18   are independent. The TMU hardware supports up to three channels.
  19
  20 properties:
  21   compatible:
  22     items:
  23       - enum:
  24           - renesas,tmu-r8a7740  # R-Mobile A1
  25           - renesas,tmu-r8a774a1 # RZ/G2M
  26           - renesas,tmu-r8a774b1 # RZ/G2N
  27           - renesas,tmu-r8a774c0 # RZ/G2E
  28           - renesas,tmu-r8a774e1 # RZ/G2H
  29           - renesas,tmu-r8a7778  # R-Car M1A
  30           - renesas,tmu-r8a7779  # R-Car H1
  31           - renesas,tmu-r8a7795  # R-Car H3
  32           - renesas,tmu-r8a7796  # R-Car M3-W
  33           - renesas,tmu-r8a77961 # R-Car M3-W+
  34           - renesas,tmu-r8a77965 # R-Car M3-N
  35           - renesas,tmu-r8a77970 # R-Car V3M
  36           - renesas,tmu-r8a77980 # R-Car V3H
  37           - renesas,tmu-r8a77990 # R-Car E3
  38           - renesas,tmu-r8a77995 # R-Car D3
  39           - renesas,tmu-r8a779a0 # R-Car V3U
  40       - const: renesas,tmu
  41
  42   reg:
  43     maxItems: 1
  44
  45   interrupts:
  46     minItems: 2
  47     maxItems: 3
  48
  49   clocks:
  50     maxItems: 1
  51
  52   clock-names:
  53     const: fck
  54
  55   power-domains:
  56     maxItems: 1
  57
  58   resets:
  59     maxItems: 1
  60
  61   '#renesas,channels':
  62     description:
  63       Number of channels implemented by the timer.
  64     $ref: /schemas/types.yaml#/definitions/uint32
  65     enum: [ 2, 3 ]
  66     default: 3
  67
  68 required:
  69   - compatible
  70   - reg
  71   - interrupts
  72   - clocks
  73   - clock-names
  74   - power-domains
  75
  76 if:
  77   not:
  78     properties:
  79       compatible:
  80         contains:
  81           enum:
  82             - renesas,tmu-r8a7740
  83             - renesas,tmu-r8a7778
  84             - renesas,tmu-r8a7779
  85 then:
  86   required:
  87     - resets
  88
  89 additionalProperties: false
  90
  91 examples:
  92   - |
  93     #include <dt-bindings/clock/r8a7779-clock.h>
  94     #include <dt-bindings/interrupt-controller/arm-gic.h>
  95     #include <dt-bindings/power/r8a7779-sysc.h>
  96     tmu0: timer@ffd80000 {
  97             compatible = "renesas,tmu-r8a7779", "renesas,tmu";
  98             reg = <0xffd80000 0x30>;
  99             interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>,
 100                          <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>,
 101                          <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
 102             clocks = <&mstp0_clks R8A7779_CLK_TMU0>;
 103             clock-names = "fck";
 104             power-domains = <&sysc R8A7779_PD_ALWAYS_ON>;
 105             #renesas,channels = <3>;
 106     };