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/interrupt-c 4 $id: http://devicetree.org/schemas/interrupt-controller/msi-controller.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: MSI controller 7 title: MSI controller
8 8
9 maintainers: 9 maintainers:
10 - Marc Zyngier <maz@kernel.org> 10 - Marc Zyngier <maz@kernel.org>
11 11
12 description: | 12 description: |
13 An MSI controller signals interrupts to a CP 13 An MSI controller signals interrupts to a CPU when a write is made
14 to an MMIO address by some master. An MSI co 14 to an MMIO address by some master. An MSI controller may feature a
15 number of doorbells. 15 number of doorbells.
16 16
17 properties: 17 properties:
18 "#msi-cells": 18 "#msi-cells":
19 description: | 19 description: |
20 The number of cells in an msi-specifier, 20 The number of cells in an msi-specifier, required if not zero.
21 21
22 Typically this will encode information r 22 Typically this will encode information related to sideband data,
23 and will not encode doorbells or payload 23 and will not encode doorbells or payloads as these can be
24 configured dynamically. 24 configured dynamically.
25 25
26 The meaning of the msi-specifier is defi 26 The meaning of the msi-specifier is defined by the device tree
27 binding of the specific MSI controller. 27 binding of the specific MSI controller.
28 enum: [0, 1] 28 enum: [0, 1]
29 29
30 msi-controller: 30 msi-controller:
31 description: 31 description:
32 Identifies the node as an MSI controller 32 Identifies the node as an MSI controller.
33 $ref: /schemas/types.yaml#/definitions/fla 33 $ref: /schemas/types.yaml#/definitions/flag
34 34
35 msi-ranges: 35 msi-ranges:
36 description: 36 description:
37 A list of <phandle intspec span> tuples, 37 A list of <phandle intspec span> tuples, where "phandle" is the
38 parent interrupt controller, "intspec" i 38 parent interrupt controller, "intspec" is the starting/base
39 interrupt specifier and "span" is the si 39 interrupt specifier and "span" is the size of the
40 range. Multiple ranges can be provided. 40 range. Multiple ranges can be provided.
41 $ref: /schemas/types.yaml#/definitions/pha 41 $ref: /schemas/types.yaml#/definitions/phandle-array
42 42
43 dependencies: 43 dependencies:
44 "#msi-cells": [ msi-controller ] 44 "#msi-cells": [ msi-controller ]
45 45
46 additionalProperties: true 46 additionalProperties: true
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.