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           - renesas,tmu-r8a779f0 # R-Car S4-8
  41           - renesas,tmu-r8a779g0 # R-Car V4H
  42       - const: renesas,tmu
  43
  44   reg:
  45     maxItems: 1
  46
  47   interrupts:
  48     minItems: 2
  49     maxItems: 3
  50
  51   clocks:
  52     maxItems: 1
  53
  54   clock-names:
  55     const: fck
  56
  57   power-domains:
  58     maxItems: 1
  59
  60   resets:
  61     maxItems: 1
  62
  63   '#renesas,channels':
  64     description:
  65       Number of channels implemented by the timer.
  66     $ref: /schemas/types.yaml#/definitions/uint32
  67     enum: [ 2, 3 ]
  68     default: 3
  69
  70 required:
  71   - compatible
  72   - reg
  73   - interrupts
  74   - clocks
  75   - clock-names
  76   - power-domains
  77
  78 if:
  79   not:
  80     properties:
  81       compatible:
  82         contains:
  83           enum:
  84             - renesas,tmu-r8a7740
  85             - renesas,tmu-r8a7778
  86             - renesas,tmu-r8a7779
  87 then:
  88   required:
  89     - resets
  90
  91 additionalProperties: false
  92
  93 examples:
  94   - |
  95     #include <dt-bindings/clock/r8a7779-clock.h>
  96     #include <dt-bindings/interrupt-controller/arm-gic.h>
  97     #include <dt-bindings/power/r8a7779-sysc.h>
  98     tmu0: timer@ffd80000 {
  99             compatible = "renesas,tmu-r8a7779", "renesas,tmu";
 100             reg = <0xffd80000 0x30>;
 101             interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>,
 102                          <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>,
 103                          <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
 104             clocks = <&mstp0_clks R8A7779_CLK_TMU0>;
 105             clock-names = "fck";
 106             power-domains = <&sysc R8A7779_PD_ALWAYS_ON>;
 107             #renesas,channels = <3>;
 108     };