1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/timer/sifive,clint.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: SiFive Core Local Interruptor
8
9maintainers:
10  - Palmer Dabbelt <palmer@dabbelt.com>
11  - Anup Patel <anup.patel@wdc.com>
12
13description:
14  SiFive (and other RISC-V) SOCs include an implementation of the SiFive
15  Core Local Interruptor (CLINT) for M-mode timer and M-mode inter-processor
16  interrupts. It directly connects to the timer and inter-processor interrupt
17  lines of various HARTs (or CPUs) so RISC-V per-HART (or per-CPU) local
18  interrupt controller is the parent interrupt controller for CLINT device.
19  The clock frequency of CLINT is specified via "timebase-frequency" DT
20  property of "/cpus" DT node. The "timebase-frequency" DT property is
21  described in Documentation/devicetree/bindings/riscv/cpus.yaml
22
23properties:
24  compatible:
25    items:
26      - enum:
27          - sifive,fu540-c000-clint
28          - starfive,jh7100-clint
29          - canaan,k210-clint
30      - const: sifive,clint0
31
32    description:
33      Should be "<vendor>,<chip>-clint" and "sifive,clint<version>".
34      Supported compatible strings are -
35      "sifive,fu540-c000-clint" for the SiFive CLINT v0 as integrated
36      onto the SiFive FU540 chip, "canaan,k210-clint" for the SiFive
37      CLINT v0 as integrated onto the Canaan Kendryte K210 chip, and
38      "sifive,clint0" for the SiFive CLINT v0 IP block with no chip
39      integration tweaks.
40      Please refer to sifive-blocks-ip-versioning.txt for details
41
42  reg:
43    maxItems: 1
44
45  interrupts-extended:
46    minItems: 1
47
48additionalProperties: false
49
50required:
51  - compatible
52  - reg
53  - interrupts-extended
54
55examples:
56  - |
57    timer@2000000 {
58      compatible = "sifive,fu540-c000-clint", "sifive,clint0";
59      interrupts-extended = <&cpu1intc 3 &cpu1intc 7
60                             &cpu2intc 3 &cpu2intc 7
61                             &cpu3intc 3 &cpu3intc 7
62                             &cpu4intc 3 &cpu4intc 7>;
63       reg = <0x2000000 0x10000>;
64    };
65...
66