xref: /kernel/linux/linux-6.6/Documentation/devicetree/bindings/gpio/brcm,kona-gpio.yaml

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/gpio/brcm,kona-gpio.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Broadcom Kona family GPIO controller

description:
  The Broadcom GPIO Controller IP can be configured prior to synthesis to
  support up to 8 banks of 32 GPIOs where each bank has its own IRQ. The
  GPIO controller only supports edge, not level, triggering of interrupts.

maintainers:
  - Ray Jui <rjui@broadcom.com>

properties:
  compatible:
    items:
      - enum:
          - brcm,bcm11351-gpio
          - brcm,bcm21664-gpio
          - brcm,bcm23550-gpio
      - const: brcm,kona-gpio

  reg:
    maxItems: 1

  interrupts:
    minItems: 4
    maxItems: 6
    description:
      The interrupt outputs from the controller. There is one GPIO interrupt
      per GPIO bank. The number of interrupts listed depends on the number of
      GPIO banks on the SoC. The interrupts must be ordered by bank, starting
      with bank 0. There is always a 1:1 mapping between banks and IRQs.

  '#gpio-cells':
    const: 2

  '#interrupt-cells':
    const: 2

  gpio-controller: true

  interrupt-controller: true

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

allOf:
  - if:
      properties:
        compatible:
          contains:
            const: brcm,bcm11351-gpio
    then:
      properties:
        interrupts:
          minItems: 6
  - if:
      properties:
        compatible:
          contains:
            enum:
              - brcm,bcm21664-gpio
              - brcm,bcm23550-gpio
    then:
      properties:
        interrupts:
          maxItems: 4

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/interrupt-controller/irq.h>

    gpio@35003000 {
        compatible = "brcm,bcm11351-gpio", "brcm,kona-gpio";
        reg = <0x35003000 0x800>;
        interrupts = <GIC_SPI 106 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 115 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 114 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 113 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 112 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 111 IRQ_TYPE_LEVEL_HIGH>;
        #gpio-cells = <2>;
        #interrupt-cells = <2>;
        gpio-controller;
        interrupt-controller;
    };
...