bindings/interrupt-controller/samsung%2Cexynos4210-combiner.yaml

0001 # SPDX-License-Identifier: GPL-2.0
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/interrupt-controller/samsung,exynos4210-combiner.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: Samsung Exynos SoC Interrupt Combiner Controller
0008
0009 maintainers:
0010   - Krzysztof Kozlowski <krzk@kernel.org>
0011
0012 description: |
0013   Samsung's Exynos4 architecture includes a interrupt combiner controller which
0014   can combine interrupt sources as a group and provide a single interrupt
0015   request for the group. The interrupt request from each group are connected to
0016   a parent interrupt controller, such as GIC in case of Exynos4210.
0017
0018   The interrupt combiner controller consists of multiple combiners. Up to eight
0019   interrupt sources can be connected to a combiner. The combiner outputs one
0020   combined interrupt for its eight interrupt sources. The combined interrupt is
0021   usually connected to a parent interrupt controller.
0022
0023   A single node in the device tree is used to describe the interrupt combiner
0024   controller module (which includes multiple combiners). A combiner in the
0025   interrupt controller module shares config/control registers with other
0026   combiners. For example, a 32-bit interrupt enable/disable config register can
0027   accommodate up to 4 interrupt combiners (with each combiner supporting up to
0028   8 interrupt sources).
0029
0030 allOf:
0031   - $ref: /schemas/interrupt-controller.yaml#
0032
0033 properties:
0034   compatible:
0035     const: samsung,exynos4210-combiner
0036
0037   interrupt-controller: true
0038
0039   interrupts:
0040     minItems: 8
0041     maxItems: 32
0042
0043   "#interrupt-cells":
0044     description: |
0045       The meaning of the cells are:
0046         * First Cell: Combiner Group Number.
0047         * Second Cell: Interrupt number within the group.
0048     const: 2
0049
0050   reg:
0051     maxItems: 1
0052
0053   samsung,combiner-nr:
0054     description: |
0055       The number of interrupt combiners supported.  Should match number
0056       of interrupts set in "interrupts" property.
0057     $ref: /schemas/types.yaml#/definitions/uint32
0058     minimum: 8
0059     maximum: 32
0060     default: 16
0061
0062 required:
0063   - compatible
0064   - interrupt-controller
0065   - interrupts
0066   - "#interrupt-cells"
0067   - reg
0068
0069 additionalProperties: false
0070
0071 examples:
0072   - |
0073     #include <dt-bindings/interrupt-controller/arm-gic.h>
0074
0075     interrupt-controller@10440000 {
0076         compatible = "samsung,exynos4210-combiner";
0077         interrupt-controller;
0078         #interrupt-cells = <2>;
0079         reg = <0x10440000 0x1000>;
0080         interrupts = <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH>,
0081                      <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>,
0082                      <GIC_SPI 2 IRQ_TYPE_LEVEL_HIGH>,
0083                      <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>,
0084                      <GIC_SPI 4 IRQ_TYPE_LEVEL_HIGH>,
0085                      <GIC_SPI 5 IRQ_TYPE_LEVEL_HIGH>,
0086                      <GIC_SPI 6 IRQ_TYPE_LEVEL_HIGH>,
0087                      <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>,
0088                      <GIC_SPI 8 IRQ_TYPE_LEVEL_HIGH>,
0089                      <GIC_SPI 9 IRQ_TYPE_LEVEL_HIGH>,
0090                      <GIC_SPI 10 IRQ_TYPE_LEVEL_HIGH>,
0091                      <GIC_SPI 11 IRQ_TYPE_LEVEL_HIGH>,
0092                      <GIC_SPI 12 IRQ_TYPE_LEVEL_HIGH>,
0093                      <GIC_SPI 13 IRQ_TYPE_LEVEL_HIGH>,
0094                      <GIC_SPI 14 IRQ_TYPE_LEVEL_HIGH>,
0095                      <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;
0096     };