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/ti,pruss-intc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: TI PRU-ICSS Local Interrupt Controller
8
9maintainers:
10  - Suman Anna <s-anna@ti.com>
11
12description: |
13  Each PRU-ICSS has a single interrupt controller instance that is common
14  to all the PRU cores. Most interrupt controllers can route 64 input events
15  which are then mapped to 10 possible output interrupts through two levels
16  of mapping. The input events can be triggered by either the PRUs and/or
17  various other PRUSS internal and external peripherals. The first 2 output
18  interrupts (0, 1) are fed exclusively to the internal PRU cores, with the
19  remaining 8 (2 through 9) connected to external interrupt controllers
20  including the MPU and/or other PRUSS instances, DSPs or devices.
21
22  The property "ti,irqs-reserved" is used for denoting the connection
23  differences on the output interrupts 2 through 9. If this property is not
24  defined, it implies that all the PRUSS INTC output interrupts 2 through 9
25  (host_intr0 through host_intr7) are connected exclusively to the Arm interrupt
26  controller.
27
28  The K3 family of SoCs can handle 160 input events that can be mapped to 20
29  different possible output interrupts. The additional output interrupts (10
30  through 19) are connected to new sub-modules within the ICSSG instances.
31
32  This interrupt-controller node should be defined as a child node of the
33  corresponding PRUSS node. The node should be named "interrupt-controller".
34
35properties:
36  compatible:
37    enum:
38      - ti,pruss-intc
39      - ti,icssg-intc
40    description: |
41      Use "ti,pruss-intc" for OMAP-L13x/AM18x/DA850 SoCs,
42                              AM335x family of SoCs,
43                              AM437x family of SoCs,
44                              AM57xx family of SoCs
45                              66AK2G family of SoCs
46      Use "ti,icssg-intc" for K3 AM65x & J721E family of SoCs
47
48  reg:
49    maxItems: 1
50
51  interrupts:
52    minItems: 1
53    maxItems: 8
54    description: |
55      All the interrupts generated towards the main host processor in the SoC.
56      A shared interrupt can be skipped if the desired destination and usage is
57      by a different processor/device.
58
59  interrupt-names:
60    minItems: 1
61    maxItems: 8
62    items:
63      pattern: host_intr[0-7]
64    description: |
65      Should use one of the above names for each valid host event interrupt
66      connected to Arm interrupt controller, the name should match the
67      corresponding host event interrupt number.
68
69  interrupt-controller: true
70
71  "#interrupt-cells":
72    const: 3
73    description: |
74      Client users shall use the PRU System event number (the interrupt source
75      that the client is interested in) [cell 1], PRU channel [cell 2] and PRU
76      host_event (target) [cell 3] as the value of the interrupts property in
77      their node.  The system events can be mapped to some output host
78      interrupts through 2 levels of many-to-one mapping i.e. events to channel
79      mapping and channels to host interrupts so through this property entire
80      mapping is provided.
81
82  ti,irqs-reserved:
83    $ref: /schemas/types.yaml#definitions/uint8
84    description: |
85      Bitmask of host interrupts between 0 and 7 (corresponding to PRUSS INTC
86      output interrupts 2 through 9) that are not connected to the Arm interrupt
87      controller or are shared and used by other devices or processors in the
88      SoC. Define this property when any of 8 interrupts should not be handled
89      by Arm interrupt controller.
90        Eg: - AM437x and 66AK2G SoCs do not have "host_intr5" interrupt
91              connected to MPU
92            - AM65x and J721E SoCs have "host_intr5", "host_intr6" and
93              "host_intr7" interrupts connected to MPU, and other ICSSG
94              instances.
95
96required:
97 - compatible
98 - reg
99 - interrupts
100 - interrupt-names
101 - interrupt-controller
102 - "#interrupt-cells"
103
104additionalProperties: false
105
106examples:
107  - |
108    /* AM33xx PRU-ICSS */
109    pruss: pruss@0 {
110        compatible = "ti,am3356-pruss";
111        reg = <0x0 0x80000>;
112        #address-cells = <1>;
113        #size-cells = <1>;
114        ranges;
115
116        pruss_intc: interrupt-controller@20000 {
117            compatible = "ti,pruss-intc";
118            reg = <0x20000 0x2000>;
119            interrupts = <20 21 22 23 24 25 26 27>;
120            interrupt-names = "host_intr0", "host_intr1",
121                              "host_intr2", "host_intr3",
122                              "host_intr4", "host_intr5",
123                              "host_intr6", "host_intr7";
124            interrupt-controller;
125            #interrupt-cells = <3>;
126        };
127    };
128
129  - |
130
131    /* AM4376 PRU-ICSS */
132    #include <dt-bindings/interrupt-controller/arm-gic.h>
133    pruss@0 {
134        compatible = "ti,am4376-pruss";
135        reg = <0x0 0x40000>;
136        #address-cells = <1>;
137        #size-cells = <1>;
138        ranges;
139
140        interrupt-controller@20000 {
141            compatible = "ti,pruss-intc";
142            reg = <0x20000 0x2000>;
143            interrupt-controller;
144            #interrupt-cells = <3>;
145            interrupts = <GIC_SPI 20 IRQ_TYPE_LEVEL_HIGH>,
146                   <GIC_SPI 21 IRQ_TYPE_LEVEL_HIGH>,
147                   <GIC_SPI 22 IRQ_TYPE_LEVEL_HIGH>,
148                   <GIC_SPI 23 IRQ_TYPE_LEVEL_HIGH>,
149                   <GIC_SPI 24 IRQ_TYPE_LEVEL_HIGH>,
150                   <GIC_SPI 26 IRQ_TYPE_LEVEL_HIGH>,
151                   <GIC_SPI 27 IRQ_TYPE_LEVEL_HIGH>;
152            interrupt-names = "host_intr0", "host_intr1",
153                              "host_intr2", "host_intr3",
154                              "host_intr4",
155                              "host_intr6", "host_intr7";
156            ti,irqs-reserved = /bits/ 8 <0x20>; /* BIT(5) */
157        };
158    };
159