dt-bindings: irqchip: convert Samsung Exynos IRQ combiner to dtschema

* Samsung Exynos Interrupt Combiner Controller

Samsung's Exynos4 architecture includes a interrupt combiner controller which

can combine interrupt sources as a group and provide a single interrupt request

for the group. The interrupt request from each group are connected to a parent

interrupt controller, such as GIC in case of Exynos4210.

The interrupt combiner controller consists of multiple combiners. Up to eight

interrupt sources can be connected to a combiner. The combiner outputs one

combined interrupt for its eight interrupt sources. The combined interrupt

is usually connected to a parent interrupt controller.

A single node in the device tree is used to describe the interrupt combiner

controller module (which includes multiple combiners). A combiner in the

interrupt controller module shares config/control registers with other

combiners. For example, a 32-bit interrupt enable/disable config register

can accommodate up to 4 interrupt combiners (with each combiner supporting

up to 8 interrupt sources).

Required properties:

- compatible: should be "samsung,exynos4210-combiner".

- interrupt-controller: Identifies the node as an interrupt controller.

- #interrupt-cells: should be <2>. The meaning of the cells are

	* First Cell: Combiner Group Number.

	* Second Cell: Interrupt number within the group.

- reg: Base address and size of interrupt combiner registers.

- interrupts: The list of interrupts generated by the combiners which are then

    connected to a parent interrupt controller. The format of the interrupt

    specifier depends in the interrupt parent controller.

Optional properties:

- samsung,combiner-nr: The number of interrupt combiners supported. If this

  property is not specified, the default number of combiners is assumed

  to be 16.

Example:

	The following is a an example from the Exynos4210 SoC dtsi file.

	combiner:interrupt-controller@10440000 {

		compatible = "samsung,exynos4210-combiner";

		interrupt-controller;

		#interrupt-cells = <2>;

		reg = <0x10440000 0x1000>;

		interrupts = <0 0 0>, <0 1 0>, <0 2 0>, <0 3 0>,

			     <0 4 0>, <0 5 0>, <0 6 0>, <0 7 0>,

			     <0 8 0>, <0 9 0>, <0 10 0>, <0 11 0>,

			     <0 12 0>, <0 13 0>, <0 14 0>, <0 15 0>;

	};

# SPDX-License-Identifier: GPL-2.0

%YAML 1.2

---

$id: http://devicetree.org/schemas/interrupt-controller/samsung,exynos4210-combiner.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung Exynos SoC Interrupt Combiner Controller

maintainers:

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>

description: |

  Samsung's Exynos4 architecture includes a interrupt combiner controller which

  can combine interrupt sources as a group and provide a single interrupt

  request for the group. The interrupt request from each group are connected to

  a parent interrupt controller, such as GIC in case of Exynos4210.

  The interrupt combiner controller consists of multiple combiners. Up to eight

  interrupt sources can be connected to a combiner. The combiner outputs one

  combined interrupt for its eight interrupt sources. The combined interrupt is

  usually connected to a parent interrupt controller.

  A single node in the device tree is used to describe the interrupt combiner

  controller module (which includes multiple combiners). A combiner in the

  interrupt controller module shares config/control registers with other

  combiners. For example, a 32-bit interrupt enable/disable config register can

  accommodate up to 4 interrupt combiners (with each combiner supporting up to

  8 interrupt sources).

allOf:

  - $ref: /schemas/interrupt-controller.yaml#

properties:

  compatible:

    const: samsung,exynos4210-combiner

  interrupt-controller: true

  interrupts:

    minItems: 8

    maxItems: 32

  "#interrupt-cells":

    description: |

      The meaning of the cells are:

        * First Cell: Combiner Group Number.

        * Second Cell: Interrupt number within the group.

    const: 2

  reg:

    maxItems: 1

  samsung,combiner-nr:

    description: |

      The number of interrupt combiners supported.  Should match number

      of interrupts set in "interrupts" property.

    $ref: /schemas/types.yaml#/definitions/uint32

    minimum: 8

    maximum: 32

    default: 16

required:

  - compatible

  - interrupt-controller

  - interrupts

  - "#interrupt-cells"

  - reg

additionalProperties: false

examples:

  - |

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    interrupt-controller@10440000 {

        compatible = "samsung,exynos4210-combiner";

        interrupt-controller;

        #interrupt-cells = <2>;

        reg = <0x10440000 0x1000>;

        interrupts = <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 2 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 4 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 5 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 6 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 8 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 9 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 10 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 11 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 12 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 13 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 14 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;

    };