Documentation/devicetree/bindings/mailbox/st,sti-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/st,sti-mailbox.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: STMicroelectronics Mailbox Driver for STi platform
   8
   9 description:
  10   Each ST Mailbox IP currently consists of 4 instances of 32 channels.
  11   Messages are passed between Application and Remote processors using
  12   shared memory.
  13
  14 maintainers:
  15   - Patrice Chotard <patrice.chotard@foss.st.com>
  16
  17 properties:
  18   compatible:
  19     const: st,stih407-mailbox
  20
  21   reg:
  22     maxItems: 1
  23
  24   mbox-name:
  25     $ref: /schemas/types.yaml#/definitions/string
  26     description: name of the mailbox IP
  27
  28   interrupts:
  29     description: the irq line for the RX mailbox
  30     maxItems: 1
  31
  32   "#mbox-cells":
  33     const: 2
  34
  35 required:
  36   - compatible
  37   - reg
  38   - "#mbox-cells"
  39
  40 additionalProperties: false
  41
  42 examples:
  43   - |
  44     #include <dt-bindings/interrupt-controller/arm-gic.h>
  45     mailbox0: mailbox@8f00000  {
  46         compatible = "st,stih407-mailbox";
  47         reg = <0x8f00000 0x1000>;
  48         interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>;
  49         #mbox-cells = <2>;
  50         mbox-name = "a9";
  51     };
  52
  53 ...