xref: /freebsd/sys/contrib/device-tree/Bindings/timer/ti,keystone-timer.yaml (revision ae5de77ed78ae54d86cead5604869212e8008e6b)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/ti,keystone-timer.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: TI Keystone timer
8
9maintainers:
10  - Alexander A. Klimov <grandmaster@al2klimov.de>
11  - Ivan Khoronzhuk <ivan.khoronzhuk@ti.com>
12
13description: >
14  A 64-bit timer in the KeyStone architecture devices. The timer can be
15  configured as a general-purpose 64-bit timer, dual general-purpose 32-bit
16  timers. When configured as dual 32-bit timers, each half can operate in
17  conjunction (chain mode) or independently (unchained mode) of each other.
18
19  It is global timer is a free running up-counter and can generate interrupt
20  when the counter reaches preset counter values.
21
22  Documentation:
23  https://www.ti.com/lit/ug/sprugv5a/sprugv5a.pdf
24
25properties:
26  compatible:
27    const: ti,keystone-timer
28
29  reg:
30    maxItems: 1
31
32  interrupts:
33    maxItems: 1
34
35  interrupt-names:
36    items:
37      - const: irq
38
39  clocks:
40    maxItems: 1
41
42  clock-names:
43    items:
44      - const: timer
45
46required:
47  - compatible
48  - reg
49  - interrupts
50  - clocks
51
52additionalProperties: false
53
54examples:
55  - |
56    #include <dt-bindings/interrupt-controller/irq.h>
57
58    timer@22f0000 {
59        compatible = "ti,keystone-timer";
60        reg = <0x022f0000 0x80>;
61        interrupts = <110 IRQ_TYPE_EDGE_RISING>;
62        clocks = <&clktimer15>;
63    };
64