xref: /freebsd/sys/contrib/device-tree/Bindings/interrupt-controller/loongson,liointc.yaml (revision 8d13bc63c0e1d50bc9e47ac1f26329c999bfecf0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/interrupt-controller/loongson,liointc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Loongson Local I/O Interrupt Controller
8
9maintainers:
10  - Jiaxun Yang <jiaxun.yang@flygoat.com>
11
12description: |
13  This interrupt controller is found in the Loongson-3 family of chips and
14  Loongson-2K series chips, as the primary package interrupt controller which
15  can route local I/O interrupt to interrupt lines of cores.
16  Be aware of the following points.
17  1.The Loongson-2K0500 is a single core CPU;
18  2.The Loongson-2K0500/2K1000 has 64 device interrupt sources as inputs, so we
19    need to define two nodes in dts{i} to describe the "0-31" and "32-61" interrupt
20    sources respectively.
21
22allOf:
23  - $ref: /schemas/interrupt-controller.yaml#
24
25properties:
26  compatible:
27    enum:
28      - loongson,liointc-1.0
29      - loongson,liointc-1.0a
30      - loongson,liointc-2.0
31
32  reg:
33    minItems: 1
34    maxItems: 3
35
36  reg-names:
37    items:
38      - const: main
39      - const: isr0
40      - const: isr1
41    minItems: 2
42
43  interrupt-controller: true
44
45  interrupts:
46    description:
47      Interrupt source of the CPU interrupts.
48    minItems: 1
49    maxItems: 4
50
51  interrupt-names:
52    description: List of names for the parent interrupts.
53    items:
54      pattern: int[0-3]
55    minItems: 1
56    maxItems: 4
57
58  '#interrupt-cells':
59    const: 2
60
61  loongson,parent_int_map:
62    description: |
63      This property points how the children interrupts will be mapped into CPU
64      interrupt lines. Each cell refers to a parent interrupt line from 0 to 3
65      and each bit in the cell refers to a child interrupt from 0 to 31.
66      If a CPU interrupt line didn't connect with liointc, then keep its
67      cell with zero.
68    $ref: /schemas/types.yaml#/definitions/uint32-array
69    minItems: 4
70    maxItems: 4
71
72required:
73  - compatible
74  - reg
75  - interrupts
76  - interrupt-names
77  - interrupt-controller
78  - '#interrupt-cells'
79  - loongson,parent_int_map
80
81
82unevaluatedProperties: false
83
84if:
85  properties:
86    compatible:
87      contains:
88        enum:
89          - loongson,liointc-2.0
90
91then:
92  properties:
93    reg:
94      minItems: 2
95      maxItems: 3
96
97  required:
98    - reg-names
99
100else:
101  properties:
102    reg:
103      maxItems: 1
104
105examples:
106  - |
107    iointc: interrupt-controller@3ff01400 {
108      compatible = "loongson,liointc-1.0";
109      reg = <0x3ff01400 0x64>;
110
111      interrupt-controller;
112      #interrupt-cells = <2>;
113
114      interrupt-parent = <&cpuintc>;
115      interrupts = <2>, <3>;
116      interrupt-names = "int0", "int1";
117
118      loongson,parent_int_map = <0xf0ffffff>, /* int0 */
119                                <0x0f000000>, /* int1 */
120                                <0x00000000>, /* int2 */
121                                <0x00000000>; /* int3 */
122
123    };
124
125...
126