1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/timer/sifiv 4 $id: http://devicetree.org/schemas/timer/sifive,clint.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: SiFive Core Local Interruptor 7 title: SiFive Core Local Interruptor
8 8
9 maintainers: 9 maintainers:
10 - Palmer Dabbelt <palmer@dabbelt.com> 10 - Palmer Dabbelt <palmer@dabbelt.com>
11 - Anup Patel <anup.patel@wdc.com> 11 - Anup Patel <anup.patel@wdc.com>
12 12
13 description: 13 description:
14 SiFive (and other RISC-V) SOCs include an im 14 SiFive (and other RISC-V) SOCs include an implementation of the SiFive
15 Core Local Interruptor (CLINT) for M-mode ti 15 Core Local Interruptor (CLINT) for M-mode timer and M-mode inter-processor
16 interrupts. It directly connects to the time 16 interrupts. It directly connects to the timer and inter-processor interrupt
17 lines of various HARTs (or CPUs) so RISC-V p 17 lines of various HARTs (or CPUs) so RISC-V per-HART (or per-CPU) local
18 interrupt controller is the parent interrupt 18 interrupt controller is the parent interrupt controller for CLINT device.
19 The clock frequency of CLINT is specified vi 19 The clock frequency of CLINT is specified via "timebase-frequency" DT
20 property of "/cpus" DT node. The "timebase-f 20 property of "/cpus" DT node. The "timebase-frequency" DT property is
21 described in Documentation/devicetree/bindin 21 described in Documentation/devicetree/bindings/riscv/cpus.yaml
22 22
23 T-Head C906/C910 CPU cores include an implem 23 T-Head C906/C910 CPU cores include an implementation of CLINT too, however
24 their implementation lacks a memory-mapped M 24 their implementation lacks a memory-mapped MTIME register, thus not
25 compatible with SiFive ones. 25 compatible with SiFive ones.
26 26
27 properties: 27 properties:
28 compatible: 28 compatible:
29 oneOf: 29 oneOf:
30 - items: 30 - items:
31 - enum: 31 - enum:
32 - canaan,k210-clint # Cana !! 32 - sifive,fu540-c000-clint
33 - sifive,fu540-c000-clint # SiFi !! 33 - starfive,jh7100-clint
34 - starfive,jh7100-clint # Star !! 34 - canaan,k210-clint
35 - starfive,jh7110-clint # Star !! 35 - const: sifive,clint0
36 - starfive,jh8100-clint # Star <<
37 - const: sifive,clint0 # SiFi <<
38 - items: 36 - items:
39 - enum: 37 - enum:
40 - allwinner,sun20i-d1-clint 38 - allwinner,sun20i-d1-clint
41 - sophgo,cv1800b-clint <<
42 - sophgo,cv1812h-clint <<
43 - sophgo,sg2002-clint <<
44 - thead,th1520-clint <<
45 - const: thead,c900-clint 39 - const: thead,c900-clint
46 - items: 40 - items:
47 - const: sifive,clint0 41 - const: sifive,clint0
48 - const: riscv,clint0 42 - const: riscv,clint0
49 deprecated: true 43 deprecated: true
50 description: For the QEMU virt machine 44 description: For the QEMU virt machine only
51 45
52 description: 46 description:
53 Should be "<vendor>,<chip>-clint", follo !! 47 Should be "<vendor>,<chip>-clint" and "sifive,clint<version>".
54 when compatible with a SiFive CLINT. Pl !! 48 Supported compatible strings are -
55 sifive-blocks-ip-versioning.txt for deta !! 49 "sifive,fu540-c000-clint" for the SiFive CLINT v0 as integrated
>> 50 onto the SiFive FU540 chip, "canaan,k210-clint" for the SiFive
>> 51 CLINT v0 as integrated onto the Canaan Kendryte K210 chip, and
>> 52 "sifive,clint0" for the SiFive CLINT v0 IP block with no chip
>> 53 integration tweaks.
>> 54 Please refer to sifive-blocks-ip-versioning.txt for details
56 55
57 reg: 56 reg:
58 maxItems: 1 57 maxItems: 1
59 58
60 interrupts-extended: 59 interrupts-extended:
61 minItems: 1 60 minItems: 1
62 maxItems: 4095 61 maxItems: 4095
63 62
64 additionalProperties: false 63 additionalProperties: false
65 64
66 required: 65 required:
67 - compatible 66 - compatible
68 - reg 67 - reg
69 - interrupts-extended 68 - interrupts-extended
70 69
71 examples: 70 examples:
72 - | 71 - |
73 timer@2000000 { 72 timer@2000000 {
74 compatible = "sifive,fu540-c000-clint", 73 compatible = "sifive,fu540-c000-clint", "sifive,clint0";
75 interrupts-extended = <&cpu1intc 3>, <&c 74 interrupts-extended = <&cpu1intc 3>, <&cpu1intc 7>,
76 <&cpu2intc 3>, <&c 75 <&cpu2intc 3>, <&cpu2intc 7>,
77 <&cpu3intc 3>, <&c 76 <&cpu3intc 3>, <&cpu3intc 7>,
78 <&cpu4intc 3>, <&c 77 <&cpu4intc 3>, <&cpu4intc 7>;
79 reg = <0x2000000 0x10000>; 78 reg = <0x2000000 0x10000>;
80 }; 79 };
81 ... 80 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.