Documentation/devicetree/bindings/mailbox/sprd-mailbox.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: "http://devicetree.org/schemas/mailbox/sprd-mailbox.yaml#"
   5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   6
   7 title: Spreadtrum mailbox controller bindings
   8
   9 maintainers:
  10   - Orson Zhai <orsonzhai@gmail.com>
  11   - Baolin Wang <baolin.wang7@gmail.com>
  12   - Chunyan Zhang <zhang.lyra@gmail.com>
  13
  14 properties:
  15   compatible:
  16     enum:
  17       - sprd,sc9860-mailbox
  18       - sprd,sc9863a-mailbox
  19
  20   reg:
  21     items:
  22       - description: inbox registers' base address
  23       - description: outbox registers' base address
  24
  25   interrupts:
  26     minItems: 2
  27     maxItems: 3
  28
  29   interrupt-names:
  30     minItems: 2
  31     items:
  32       - const: inbox
  33       - const: outbox
  34       - const: supp-outbox
  35
  36   clocks:
  37     maxItems: 1
  38
  39   clock-names:
  40     items:
  41       - const: enable
  42
  43   "#mbox-cells":
  44     const: 1
  45
  46 required:
  47   - compatible
  48   - reg
  49   - interrupts
  50   - interrupt-names
  51   - "#mbox-cells"
  52   - clocks
  53   - clock-names
  54
  55 additionalProperties: false
  56
  57 examples:
  58   - |
  59     #include <dt-bindings/interrupt-controller/arm-gic.h>
  60     mailbox: mailbox@400a0000 {
  61       compatible = "sprd,sc9860-mailbox";
  62       reg = <0x400a0000 0x8000>, <0x400a8000 0x8000>;
  63       #mbox-cells = <1>;
  64       clock-names = "enable";
  65       clocks = <&aon_gate 53>;
  66       interrupts = <GIC_SPI 28 IRQ_TYPE_LEVEL_HIGH>, <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>;
  67       interrupt-names = "inbox", "outbox";
  68     };
  69 ...