Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: interrupt-controller: Convert ARM VIC to json-schema
Convert the ARM VIC binding document to DT schema format using
json-schema.
Cc: Rob Herring <robh@kernel.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Sudeep Holla <sudeep.holla@arm.com>
Link: https://lore.kernel.org/r/20210617205317.3060163-1-sudeep.holla@arm.com
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Sudeep Holla
and committed by
Rob Herring
b7705ba6
7b25995f
+81
-41
-41
Documentation/devicetree/bindings/interrupt-controller/arm,vic.txt
-41
Documentation/devicetree/bindings/interrupt-controller/arm,vic.txt
···
1
-
* ARM Vectored Interrupt Controller
2
-
3
-
One or more Vectored Interrupt Controllers (VIC's) can be connected in an ARM
4
-
system for interrupt routing. For multiple controllers they can either be
5
-
nested or have the outputs wire-OR'd together.
6
-
7
-
Required properties:
8
-
9
-
- compatible : should be one of
10
-
"arm,pl190-vic"
11
-
"arm,pl192-vic"
12
-
- interrupt-controller : Identifies the node as an interrupt controller
13
-
- #interrupt-cells : The number of cells to define the interrupts. Must be 1 as
14
-
the VIC has no configuration options for interrupt sources. The cell is a u32
15
-
and defines the interrupt number.
16
-
- reg : The register bank for the VIC.
17
-
18
-
Optional properties:
19
-
20
-
- interrupts : Interrupt source for parent controllers if the VIC is nested.
21
-
- valid-mask : A one cell big bit mask of valid interrupt sources. Each bit
22
-
represents single interrupt source, starting from source 0 at LSb and ending
23
-
at source 31 at MSb. A bit that is set means that the source is wired and
24
-
clear means otherwise. If unspecified, defaults to all valid.
25
-
- valid-wakeup-mask : A one cell big bit mask of interrupt sources that can be
26
-
configured as wake up source for the system. Order of bits is the same as for
27
-
valid-mask property. A set bit means that this interrupt source can be
28
-
configured as a wake up source for the system. If unspecied, defaults to all
29
-
interrupt sources configurable as wake up sources.
30
-
31
-
Example:
32
-
33
-
vic0: interrupt-controller@60000 {
34
-
compatible = "arm,pl192-vic";
35
-
interrupt-controller;
36
-
#interrupt-cells = <1>;
37
-
reg = <0x60000 0x1000>;
38
-
39
-
valid-mask = <0xffffff7f>;
40
-
valid-wakeup-mask = <0x0000ff7f>;
41
-
};
+81
Documentation/devicetree/bindings/interrupt-controller/arm,vic.yaml
+81
Documentation/devicetree/bindings/interrupt-controller/arm,vic.yaml
···
1
+
# SPDX-License-Identifier: GPL-2.0
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/interrupt-controller/arm,vic.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: ARM Vectored Interrupt Controller
8
+
9
+
maintainers:
10
+
- Rob Herring <robh@kernel.org>
11
+
12
+
description: |+
13
+
One or more Vectored Interrupt Controllers (VIC's) can be connected in an
14
+
ARM system for interrupt routing. For multiple controllers they can either
15
+
be nested or have the outputs wire-OR'd together.
16
+
17
+
allOf:
18
+
- $ref: /schemas/interrupt-controller.yaml#
19
+
20
+
properties:
21
+
compatible:
22
+
enum:
23
+
- arm,pl190-vic
24
+
- arm,pl192-vic
25
+
- arm,versatile-vic
26
+
27
+
interrupt-controller: true
28
+
29
+
"#interrupt-cells":
30
+
const: 1
31
+
description:
32
+
The number of cells to define the interrupts. It must be 1 as the
33
+
VIC has no configuration options for interrupt sources. The single
34
+
cell defines the interrupt number.
35
+
36
+
reg:
37
+
maxItems: 1
38
+
39
+
interrupts:
40
+
maxItems: 1
41
+
42
+
valid-mask:
43
+
description:
44
+
A one cell big bit mask of valid interrupt sources. Each bit
45
+
represents single interrupt source, starting from source 0 at
46
+
LSb and ending at source 31 at MSb. A bit that is set means
47
+
that the source is wired and clear means otherwise. If unspecified,
48
+
defaults to all valid.
49
+
$ref: /schemas/types.yaml#/definitions/uint32
50
+
51
+
valid-wakeup-mask:
52
+
description:
53
+
A one cell big bit mask of interrupt sources that can be configured
54
+
as wake up source for the system. Order of bits is the same as for
55
+
valid-mask property. A set bit means that this interrupt source
56
+
can be configured as a wake up source for the system. If unspecied,
57
+
defaults to all interrupt sources configurable as wake up sources.
58
+
$ref: /schemas/types.yaml#/definitions/uint32
59
+
60
+
required:
61
+
- compatible
62
+
- reg
63
+
- interrupt-controller
64
+
- "#interrupt-cells"
65
+
66
+
additionalProperties: false
67
+
68
+
examples:
69
+
- |
70
+
// PL192 VIC
71
+
vic0: interrupt-controller@60000 {
72
+
compatible = "arm,pl192-vic";
73
+
interrupt-controller;
74
+
#interrupt-cells = <1>;
75
+
reg = <0x60000 0x1000>;
76
+
77
+
valid-mask = <0xffffff7f>;
78
+
valid-wakeup-mask = <0x0000ff7f>;
79
+
};
80
+
81
+
...