tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: interrupt-controller: Convert apm,xgene1-msi to DT schema
Convert the Applied Micro X-Gene MSI controller binding to DT schema
format. MSI controllers go in interrupt-controller directory so move the
schema there.
Link: https://lore.kernel.org/r/20250710180757.2970583-1-robh@kernel.org
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
+55
-69
+54
Documentation/devicetree/bindings/interrupt-controller/apm,xgene1-msi.yaml
+54
Documentation/devicetree/bindings/interrupt-controller/apm,xgene1-msi.yaml
···
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/apm,xgene1-msi.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: AppliedMicro X-Gene v1 PCIe MSI controller
8
+
9
+
maintainers:
10
+
- Toan Le <toan@os.amperecomputing.com>
11
+
12
+
properties:
13
+
compatible:
14
+
const: apm,xgene1-msi
15
+
16
+
msi-controller: true
17
+
18
+
reg:
19
+
maxItems: 1
20
+
21
+
interrupts:
22
+
maxItems: 16
23
+
24
+
required:
25
+
- compatible
26
+
- msi-controller
27
+
- reg
28
+
- interrupts
29
+
30
+
additionalProperties: false
31
+
32
+
examples:
33
+
- |
34
+
msi@79000000 {
35
+
compatible = "apm,xgene1-msi";
36
+
msi-controller;
37
+
reg = <0x79000000 0x900000>;
38
+
interrupts = <0x0 0x10 0x4>,
39
+
<0x0 0x11 0x4>,
40
+
<0x0 0x12 0x4>,
41
+
<0x0 0x13 0x4>,
42
+
<0x0 0x14 0x4>,
43
+
<0x0 0x15 0x4>,
44
+
<0x0 0x16 0x4>,
45
+
<0x0 0x17 0x4>,
46
+
<0x0 0x18 0x4>,
47
+
<0x0 0x19 0x4>,
48
+
<0x0 0x1a 0x4>,
49
+
<0x0 0x1b 0x4>,
50
+
<0x0 0x1c 0x4>,
51
+
<0x0 0x1d 0x4>,
52
+
<0x0 0x1e 0x4>,
53
+
<0x0 0x1f 0x4>;
54
+
};
-68
Documentation/devicetree/bindings/pci/xgene-pci-msi.txt
-68
Documentation/devicetree/bindings/pci/xgene-pci-msi.txt
···
1
-
* AppliedMicro X-Gene v1 PCIe MSI controller
2
-
3
-
Required properties:
4
-
5
-
- compatible: should be "apm,xgene1-msi" to identify
6
-
X-Gene v1 PCIe MSI controller block.
7
-
- msi-controller: indicates that this is an X-Gene v1 PCIe MSI controller node
8
-
- reg: physical base address (0x79000000) and length (0x900000) for controller
9
-
registers. These registers include the MSI termination address and data
10
-
registers as well as the MSI interrupt status registers.
11
-
- reg-names: not required
12
-
- interrupts: A list of 16 interrupt outputs of the controller, starting from
13
-
interrupt number 0x10 to 0x1f.
14
-
- interrupt-names: not required
15
-
16
-
Each PCIe node needs to have property msi-parent that points to an MSI
17
-
controller node
18
-
19
-
Examples:
20
-
21
-
SoC DTSI:
22
-
23
-
+ MSI node:
24
-
msi@79000000 {
25
-
compatible = "apm,xgene1-msi";
26
-
msi-controller;
27
-
reg = <0x00 0x79000000 0x0 0x900000>;
28
-
interrupts = <0x0 0x10 0x4>
29
-
<0x0 0x11 0x4>
30
-
<0x0 0x12 0x4>
31
-
<0x0 0x13 0x4>
32
-
<0x0 0x14 0x4>
33
-
<0x0 0x15 0x4>
34
-
<0x0 0x16 0x4>
35
-
<0x0 0x17 0x4>
36
-
<0x0 0x18 0x4>
37
-
<0x0 0x19 0x4>
38
-
<0x0 0x1a 0x4>
39
-
<0x0 0x1b 0x4>
40
-
<0x0 0x1c 0x4>
41
-
<0x0 0x1d 0x4>
42
-
<0x0 0x1e 0x4>
43
-
<0x0 0x1f 0x4>;
44
-
};
45
-
46
-
+ PCIe controller node with msi-parent property pointing to MSI node:
47
-
pcie0: pcie@1f2b0000 {
48
-
device_type = "pci";
49
-
compatible = "apm,xgene-storm-pcie", "apm,xgene-pcie";
50
-
#interrupt-cells = <1>;
51
-
#size-cells = <2>;
52
-
#address-cells = <3>;
53
-
reg = < 0x00 0x1f2b0000 0x0 0x00010000 /* Controller registers */
54
-
0xe0 0xd0000000 0x0 0x00040000>; /* PCI config space */
55
-
reg-names = "csr", "cfg";
56
-
ranges = <0x01000000 0x00 0x00000000 0xe0 0x10000000 0x00 0x00010000 /* io */
57
-
0x02000000 0x00 0x80000000 0xe1 0x80000000 0x00 0x80000000>; /* mem */
58
-
dma-ranges = <0x42000000 0x80 0x00000000 0x80 0x00000000 0x00 0x80000000
59
-
0x42000000 0x00 0x00000000 0x00 0x00000000 0x80 0x00000000>;
60
-
interrupt-map-mask = <0x0 0x0 0x0 0x7>;
61
-
interrupt-map = <0x0 0x0 0x0 0x1 &gic 0x0 0xc2 0x1
62
-
0x0 0x0 0x0 0x2 &gic 0x0 0xc3 0x1
63
-
0x0 0x0 0x0 0x3 &gic 0x0 0xc4 0x1
64
-
0x0 0x0 0x0 0x4 &gic 0x0 0xc5 0x1>;
65
-
dma-coherent;
66
-
clocks = <&pcie0clk 0>;
67
-
msi-parent= <&msi>;
68
-
};
+1
-1
MAINTAINERS
+1
-1
MAINTAINERS
···
19146
19146
L: linux-pci@vger.kernel.org
19147
19147
L: linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
19148
19148
S: Maintained
19149
-
F: Documentation/devicetree/bindings/pci/xgene-pci-msi.txt
19149
+
F: Documentation/devicetree/bindings/interrupt-controller/apm,xgene1-msi.yaml
19150
19150
F: drivers/pci/controller/pci-xgene-msi.c
19151
19151
19152
19152
PCI NATIVE HOST BRIDGE AND ENDPOINT DRIVERS