Documentation/devicetree/bindings/gpio/brcm,kona-gpio.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/gpio/brcm,kona-gpio.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Broadcom Kona family GPIO controller
   8
   9 description:
  10   The Broadcom GPIO Controller IP can be configured prior to synthesis to
  11   support up to 8 banks of 32 GPIOs where each bank has its own IRQ. The
  12   GPIO controller only supports edge, not level, triggering of interrupts.
  13
  14 maintainers:
  15   - Ray Jui <rjui@broadcom.com>
  16
  17 properties:
  18   compatible:
  19     items:
  20       - enum:
  21           - brcm,bcm11351-gpio
  22           - brcm,bcm21664-gpio
  23           - brcm,bcm23550-gpio
  24       - const: brcm,kona-gpio
  25
  26   reg:
  27     maxItems: 1
  28
  29   interrupts:
  30     minItems: 4
  31     maxItems: 6
  32     description:
  33       The interrupt outputs from the controller. There is one GPIO interrupt
  34       per GPIO bank. The number of interrupts listed depends on the number of
  35       GPIO banks on the SoC. The interrupts must be ordered by bank, starting
  36       with bank 0. There is always a 1:1 mapping between banks and IRQs.
  37
  38   '#gpio-cells':
  39     const: 2
  40
  41   '#interrupt-cells':
  42     const: 2
  43
  44   gpio-controller: true
  45
  46   interrupt-controller: true
  47
  48 required:
  49   - compatible
  50   - reg
  51   - interrupts
  52   - '#gpio-cells'
  53   - '#interrupt-cells'
  54   - gpio-controller
  55   - interrupt-controller
  56
  57 allOf:
  58   - if:
  59       properties:
  60         compatible:
  61           contains:
  62             const: brcm,bcm11351-gpio
  63     then:
  64       properties:
  65         interrupts:
  66           minItems: 6
  67   - if:
  68       properties:
  69         compatible:
  70           contains:
  71             enum:
  72               - brcm,bcm21664-gpio
  73               - brcm,bcm23550-gpio
  74     then:
  75       properties:
  76         interrupts:
  77           maxItems: 4
  78
  79 additionalProperties: false
  80
  81 examples:
  82   - |
  83     #include <dt-bindings/interrupt-controller/arm-gic.h>
  84     #include <dt-bindings/interrupt-controller/irq.h>
  85
  86     gpio@35003000 {
  87         compatible = "brcm,bcm11351-gpio", "brcm,kona-gpio";
  88         reg = <0x35003000 0x800>;
  89         interrupts = <GIC_SPI 106 IRQ_TYPE_LEVEL_HIGH>,
  90                      <GIC_SPI 115 IRQ_TYPE_LEVEL_HIGH>,
  91                      <GIC_SPI 114 IRQ_TYPE_LEVEL_HIGH>,
  92                      <GIC_SPI 113 IRQ_TYPE_LEVEL_HIGH>,
  93                      <GIC_SPI 112 IRQ_TYPE_LEVEL_HIGH>,
  94                      <GIC_SPI 111 IRQ_TYPE_LEVEL_HIGH>;
  95         #gpio-cells = <2>;
  96         #interrupt-cells = <2>;
  97         gpio-controller;
  98         interrupt-controller;
  99     };
 100 ...