aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/interrupt-controller/brcm,bcm6345-l1-intc.yaml
blob: ca6a2ff43acdb6e7d3cf386c5c7fbc1600e004a2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/interrupt-controller/brcm,bcm6345-l1-intc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Broadcom BCM6345-style Level 1 interrupt controller

maintainers:
  - Simon Arlott <simon@octiron.net>

description: >
  This block is a first level interrupt controller that is typically connected
  directly to one of the HW INT lines on each CPU.

  Key elements of the hardware design include:

    - 32, 64 or 128 incoming level IRQ lines

    - Most onchip peripherals are wired directly to an L1 input

    - A separate instance of the register set for each CPU, allowing individual
      peripheral IRQs to be routed to any CPU

    - Contains one or more enable/status word pairs per CPU

    - No atomic set/clear operations

    - No polarity/level/edge settings

    - No FIFO or priority encoder logic; software is expected to read all
      2-4 status words to determine which IRQs are pending

  If multiple reg ranges and interrupt-parent entries are present on an SMP
  system, the driver will allow IRQ SMP affinity to be set up through the
  /proc/irq/ interface.  In the simplest possible configuration, only one
  reg range and one interrupt-parent is needed.

  The driver operates in native CPU endian by default, there is no support for
  specifying an alternative endianness.

properties:
  compatible:
    const: brcm,bcm6345-l1-intc

  reg:
    description: One entry per CPU core
    minItems: 1
    maxItems: 2

  interrupt-controller: true

  "#interrupt-cells":
    const: 1

  interrupts:
    description: One entry per CPU core
    minItems: 1
    maxItems: 2

required:
  - compatible
  - reg
  - interrupt-controller
  - '#interrupt-cells'
  - interrupts

additionalProperties: false

examples:
  - |
    interrupt-controller@10000000 {
        compatible = "brcm,bcm6345-l1-intc";
        reg = <0x10000020 0x20>,
              <0x10000040 0x20>;

        interrupt-controller;
        #interrupt-cells = <1>;

        interrupts = <2>, <3>;
    };