GNU Linux-libre 4.14.266-gnu1
[releases.git] / Documentation / devicetree / bindings / timer / renesas,cmt.txt
1 * Renesas R-Car Compare Match Timer (CMT)
2
3 The CMT is a multi-channel 16/32/48-bit timer/counter with configurable clock
4 inputs and programmable compare match.
5
6 Channels share hardware resources but their counter and compare match value
7 are independent. A particular CMT instance can implement only a subset of the
8 channels supported by the CMT model. Channel indices represent the hardware
9 position of the channel in the CMT and don't match the channel numbers in the
10 datasheets.
11
12 Required Properties:
13
14   - compatible: must contain one or more of the following:
15     - "renesas,cmt-48-sh73a0" for the sh73A0 48-bit CMT
16                 (CMT1)
17     - "renesas,cmt-48-r8a7740" for the r8a7740 48-bit CMT
18                 (CMT1)
19     - "renesas,cmt-48" for all non-second generation 48-bit CMT
20                 (CMT1 on sh73a0 and r8a7740)
21                 This is a fallback for the above renesas,cmt-48-* entries.
22
23     - "renesas,r8a73a4-cmt0" for the 32-bit CMT0 device included in r8a73a4.
24     - "renesas,r8a73a4-cmt1" for the 48-bit CMT1 device included in r8a73a4.
25     - "renesas,r8a7790-cmt0" for the 32-bit CMT0 device included in r8a7790.
26     - "renesas,r8a7790-cmt1" for the 48-bit CMT1 device included in r8a7790.
27     - "renesas,r8a7791-cmt0" for the 32-bit CMT0 device included in r8a7791.
28     - "renesas,r8a7791-cmt1" for the 48-bit CMT1 device included in r8a7791.
29     - "renesas,r8a7793-cmt0" for the 32-bit CMT0 device included in r8a7793.
30     - "renesas,r8a7793-cmt1" for the 48-bit CMT1 device included in r8a7793.
31     - "renesas,r8a7794-cmt0" for the 32-bit CMT0 device included in r8a7794.
32     - "renesas,r8a7794-cmt1" for the 48-bit CMT1 device included in r8a7794.
33
34     - "renesas,rcar-gen2-cmt0" for 32-bit CMT0 devices included in R-Car Gen2.
35     - "renesas,rcar-gen2-cmt1" for 48-bit CMT1 devices included in R-Car Gen2.
36                 These are fallbacks for r8a73a4 and all the R-Car Gen2
37                 entries listed above.
38
39   - reg: base address and length of the registers block for the timer module.
40   - interrupts: interrupt-specifier for the timer, one per channel.
41   - clocks: a list of phandle + clock-specifier pairs, one for each entry
42     in clock-names.
43   - clock-names: must contain "fck" for the functional clock.
44
45
46 Example: R8A7790 (R-Car H2) CMT0 and CMT1 nodes
47
48         cmt0: timer@ffca0000 {
49                 compatible = "renesas,r8a7790-cmt0", "renesas,rcar-gen2-cmt0";
50                 reg = <0 0xffca0000 0 0x1004>;
51                 interrupts = <0 142 IRQ_TYPE_LEVEL_HIGH>,
52                              <0 142 IRQ_TYPE_LEVEL_HIGH>;
53                 clocks = <&mstp1_clks R8A7790_CLK_CMT0>;
54                 clock-names = "fck";
55         };
56
57         cmt1: timer@e6130000 {
58                 compatible = "renesas,r8a7790-cmt1", "renesas,rcar-gen2-cmt1";
59                 reg = <0 0xe6130000 0 0x1004>;
60                 interrupts = <0 120 IRQ_TYPE_LEVEL_HIGH>,
61                              <0 121 IRQ_TYPE_LEVEL_HIGH>,
62                              <0 122 IRQ_TYPE_LEVEL_HIGH>,
63                              <0 123 IRQ_TYPE_LEVEL_HIGH>,
64                              <0 124 IRQ_TYPE_LEVEL_HIGH>,
65                              <0 125 IRQ_TYPE_LEVEL_HIGH>,
66                              <0 126 IRQ_TYPE_LEVEL_HIGH>,
67                              <0 127 IRQ_TYPE_LEVEL_HIGH>;
68                 clocks = <&mstp3_clks R8A7790_CLK_CMT1>;
69                 clock-names = "fck";
70         };