Merge tag 'linux-kselftest-5.4-rc1.1' of git://git.kernel.org/pub/scm/linux/kernel...
[sfrench/cifs-2.6.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,r8a73a4-cmt0" for the 32-bit CMT0 device included in r8a73a4.
16     - "renesas,r8a73a4-cmt1" for the 48-bit CMT1 device included in r8a73a4.
17     - "renesas,r8a7740-cmt0" for the 32-bit CMT0 device included in r8a7740.
18     - "renesas,r8a7740-cmt1" for the 48-bit CMT1 device included in r8a7740.
19     - "renesas,r8a7740-cmt2" for the 32-bit CMT2 device included in r8a7740.
20     - "renesas,r8a7740-cmt3" for the 32-bit CMT3 device included in r8a7740.
21     - "renesas,r8a7740-cmt4" for the 32-bit CMT4 device included in r8a7740.
22     - "renesas,r8a7743-cmt0" for the 32-bit CMT0 device included in r8a7743.
23     - "renesas,r8a7743-cmt1" for the 48-bit CMT1 device included in r8a7743.
24     - "renesas,r8a7744-cmt0" for the 32-bit CMT0 device included in r8a7744.
25     - "renesas,r8a7744-cmt1" for the 48-bit CMT1 device included in r8a7744.
26     - "renesas,r8a7745-cmt0" for the 32-bit CMT0 device included in r8a7745.
27     - "renesas,r8a7745-cmt1" for the 48-bit CMT1 device included in r8a7745.
28     - "renesas,r8a77470-cmt0" for the 32-bit CMT0 device included in r8a77470.
29     - "renesas,r8a77470-cmt1" for the 48-bit CMT1 device included in r8a77470.
30     - "renesas,r8a774a1-cmt0" for the 32-bit CMT0 device included in r8a774a1.
31     - "renesas,r8a774a1-cmt1" for the 48-bit CMT devices included in r8a774a1.
32     - "renesas,r8a774c0-cmt0" for the 32-bit CMT0 device included in r8a774c0.
33     - "renesas,r8a774c0-cmt1" for the 48-bit CMT devices included in r8a774c0.
34     - "renesas,r8a7790-cmt0" for the 32-bit CMT0 device included in r8a7790.
35     - "renesas,r8a7790-cmt1" for the 48-bit CMT1 device included in r8a7790.
36     - "renesas,r8a7791-cmt0" for the 32-bit CMT0 device included in r8a7791.
37     - "renesas,r8a7791-cmt1" for the 48-bit CMT1 device included in r8a7791.
38     - "renesas,r8a7792-cmt0" for the 32-bit CMT0 device included in r8a7792.
39     - "renesas,r8a7792-cmt1" for the 48-bit CMT1 device included in r8a7792.
40     - "renesas,r8a7793-cmt0" for the 32-bit CMT0 device included in r8a7793.
41     - "renesas,r8a7793-cmt1" for the 48-bit CMT1 device included in r8a7793.
42     - "renesas,r8a7794-cmt0" for the 32-bit CMT0 device included in r8a7794.
43     - "renesas,r8a7794-cmt1" for the 48-bit CMT1 device included in r8a7794.
44     - "renesas,r8a7795-cmt0" for the 32-bit CMT0 device included in r8a7795.
45     - "renesas,r8a7795-cmt1" for the 48-bit CMT devices included in r8a7795.
46     - "renesas,r8a7796-cmt0" for the 32-bit CMT0 device included in r8a7796.
47     - "renesas,r8a7796-cmt1" for the 48-bit CMT devices included in r8a7796.
48     - "renesas,r8a77965-cmt0" for the 32-bit CMT0 device included in r8a77965.
49     - "renesas,r8a77965-cmt1" for the 48-bit CMT devices included in r8a77965.
50     - "renesas,r8a77970-cmt0" for the 32-bit CMT0 device included in r8a77970.
51     - "renesas,r8a77970-cmt1" for the 48-bit CMT devices included in r8a77970.
52     - "renesas,r8a77980-cmt0" for the 32-bit CMT0 device included in r8a77980.
53     - "renesas,r8a77980-cmt1" for the 48-bit CMT devices included in r8a77980.
54     - "renesas,r8a77990-cmt0" for the 32-bit CMT0 device included in r8a77990.
55     - "renesas,r8a77990-cmt1" for the 48-bit CMT devices included in r8a77990.
56     - "renesas,r8a77995-cmt0" for the 32-bit CMT0 device included in r8a77995.
57     - "renesas,r8a77995-cmt1" for the 48-bit CMT devices included in r8a77995.
58     - "renesas,sh73a0-cmt0" for the 32-bit CMT0 device included in sh73a0.
59     - "renesas,sh73a0-cmt1" for the 48-bit CMT1 device included in sh73a0.
60     - "renesas,sh73a0-cmt2" for the 32-bit CMT2 device included in sh73a0.
61     - "renesas,sh73a0-cmt3" for the 32-bit CMT3 device included in sh73a0.
62     - "renesas,sh73a0-cmt4" for the 32-bit CMT4 device included in sh73a0.
63
64     - "renesas,rcar-gen2-cmt0" for 32-bit CMT0 devices included in R-Car Gen2
65                 and RZ/G1.
66     - "renesas,rcar-gen2-cmt1" for 48-bit CMT1 devices included in R-Car Gen2
67                 and RZ/G1.
68                 These are fallbacks for r8a73a4, R-Car Gen2 and RZ/G1 entries
69                 listed above.
70     - "renesas,rcar-gen3-cmt0" for 32-bit CMT0 devices included in R-Car Gen3
71                 and RZ/G2.
72     - "renesas,rcar-gen3-cmt1" for 48-bit CMT devices included in R-Car Gen3
73                 and RZ/G2.
74                 These are fallbacks for R-Car Gen3 and RZ/G2 entries listed
75                 above.
76
77   - reg: base address and length of the registers block for the timer module.
78   - interrupts: interrupt-specifier for the timer, one per channel.
79   - clocks: a list of phandle + clock-specifier pairs, one for each entry
80     in clock-names.
81   - clock-names: must contain "fck" for the functional clock.
82
83
84 Example: R8A7790 (R-Car H2) CMT0 and CMT1 nodes
85
86         cmt0: timer@ffca0000 {
87                 compatible = "renesas,r8a7790-cmt0", "renesas,rcar-gen2-cmt0";
88                 reg = <0 0xffca0000 0 0x1004>;
89                 interrupts = <0 142 IRQ_TYPE_LEVEL_HIGH>,
90                              <0 142 IRQ_TYPE_LEVEL_HIGH>;
91                 clocks = <&mstp1_clks R8A7790_CLK_CMT0>;
92                 clock-names = "fck";
93         };
94
95         cmt1: timer@e6130000 {
96                 compatible = "renesas,r8a7790-cmt1", "renesas,rcar-gen2-cmt1";
97                 reg = <0 0xe6130000 0 0x1004>;
98                 interrupts = <0 120 IRQ_TYPE_LEVEL_HIGH>,
99                              <0 121 IRQ_TYPE_LEVEL_HIGH>,
100                              <0 122 IRQ_TYPE_LEVEL_HIGH>,
101                              <0 123 IRQ_TYPE_LEVEL_HIGH>,
102                              <0 124 IRQ_TYPE_LEVEL_HIGH>,
103                              <0 125 IRQ_TYPE_LEVEL_HIGH>,
104                              <0 126 IRQ_TYPE_LEVEL_HIGH>,
105                              <0 127 IRQ_TYPE_LEVEL_HIGH>;
106                 clocks = <&mstp3_clks R8A7790_CLK_CMT1>;
107                 clock-names = "fck";
108         };