xref: /freebsd/sys/contrib/device-tree/Bindings/timer/sifive,clint.yaml (revision 7ef62cebc2f965b0f640263e179276928885e33d)
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    oneOf:
26      - items:
27          - enum:
28              - sifive,fu540-c000-clint
29              - starfive,jh7100-clint
30              - canaan,k210-clint
31          - const: sifive,clint0
32      - items:
33          - const: sifive,clint0
34          - const: riscv,clint0
35        deprecated: true
36        description: For the QEMU virt machine only
37
38    description:
39      Should be "<vendor>,<chip>-clint" and "sifive,clint<version>".
40      Supported compatible strings are -
41      "sifive,fu540-c000-clint" for the SiFive CLINT v0 as integrated
42      onto the SiFive FU540 chip, "canaan,k210-clint" for the SiFive
43      CLINT v0 as integrated onto the Canaan Kendryte K210 chip, and
44      "sifive,clint0" for the SiFive CLINT v0 IP block with no chip
45      integration tweaks.
46      Please refer to sifive-blocks-ip-versioning.txt for details
47
48  reg:
49    maxItems: 1
50
51  interrupts-extended:
52    minItems: 1
53    maxItems: 4095
54
55additionalProperties: false
56
57required:
58  - compatible
59  - reg
60  - interrupts-extended
61
62examples:
63  - |
64    timer@2000000 {
65      compatible = "sifive,fu540-c000-clint", "sifive,clint0";
66      interrupts-extended = <&cpu1intc 3>, <&cpu1intc 7>,
67                            <&cpu2intc 3>, <&cpu2intc 7>,
68                            <&cpu3intc 3>, <&cpu3intc 7>,
69                            <&cpu4intc 3>, <&cpu4intc 7>;
70       reg = <0x2000000 0x10000>;
71    };
72...
73