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/apple,aic2.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Apple Interrupt Controller 2
8
9 maintainers:
10 - Hector Martin <marcan@marcan.st>
11
12 description: |
13 The Apple Interrupt Controller 2 is a simple interrupt controller present on
14 Apple ARM SoC platforms starting with t600x (M1 Pro and Max).
15
16 It provides the following features:
17
18 - Level-triggered hardware IRQs wired to SoC blocks
19 - Single mask bit per IRQ
20 - Automatic masking on event delivery (auto-ack)
21 - Software triggering (ORed with hw line)
22 - Automatic prioritization (single event/ack register per CPU, lower IRQs =
23 higher priority)
24 - Automatic masking on ack
25 - Support for multiple dies
26
27 This device also represents the FIQ interrupt sources on platforms using AIC,
28 which do not go through a discrete interrupt controller. It also handles
29 FIQ-based Fast IPIs.
30
31 properties:
32 compatible:
33 items:
34 - const: apple,t6000-aic
35 - const: apple,aic2
36
37 interrupt-controller: true
38
39 '#interrupt-cells':
40 const: 4
41 description: |
42 The 1st cell contains the interrupt type:
43 - 0: Hardware IRQ
44 - 1: FIQ
45
46 The 2nd cell contains the die ID.
47
48 The next cell contains the interrupt number.
49 - HW IRQs: interrupt number
50 - FIQs:
51 - 0: physical HV timer
52 - 1: virtual HV timer
53 - 2: physical guest timer
54 - 3: virtual guest timer
55
56 The last cell contains the interrupt flags. This is normally
57 IRQ_TYPE_LEVEL_HIGH (4).
58
59 reg:
60 items:
61 - description: Address and size of the main AIC2 registers.
62 - description: Address and size of the AIC2 Event register.
63
64 reg-names:
65 items:
66 - const: core
67 - const: event
68
69 power-domains:
70 maxItems: 1
71
72 required:
73 - compatible
74 - '#interrupt-cells'
75 - interrupt-controller
76 - reg
77 - reg-names
78
79 additionalProperties: false
80
81 allOf:
82 - $ref: /schemas/interrupt-controller.yaml#
83
84 examples:
85 - |
86 soc {
87 #address-cells = <2>;
88 #size-cells = <2>;
89
90 aic: interrupt-controller@28e100000 {
91 compatible = "apple,t6000-aic", "apple,aic2";
92 #interrupt-cells = <4>;
93 interrupt-controller;
94 reg = <0x2 0x8e100000 0x0 0xc000>,
95 <0x2 0x8e10c000 0x0 0x4>;
96 reg-names = "core", "event";
97 };
98 };
Cache object: 38f67a35a4a2224ee2998d152532bb0d
|