xref: /freebsd/sys/contrib/device-tree/Bindings/mailbox/st,sti-mailbox.yaml (revision cb7aa33ac6cd46a5434798e50363136e64f3ae98)
1*cb7aa33aSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*cb7aa33aSEmmanuel Vadot%YAML 1.2
3*cb7aa33aSEmmanuel Vadot---
4*cb7aa33aSEmmanuel Vadot$id: http://devicetree.org/schemas/mailbox/st,sti-mailbox.yaml#
5*cb7aa33aSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*cb7aa33aSEmmanuel Vadot
7*cb7aa33aSEmmanuel Vadottitle: STMicroelectronics Mailbox Driver for STi platform
8*cb7aa33aSEmmanuel Vadot
9*cb7aa33aSEmmanuel Vadotdescription:
10*cb7aa33aSEmmanuel Vadot  Each ST Mailbox IP currently consists of 4 instances of 32 channels.
11*cb7aa33aSEmmanuel Vadot  Messages are passed between Application and Remote processors using
12*cb7aa33aSEmmanuel Vadot  shared memory.
13*cb7aa33aSEmmanuel Vadot
14*cb7aa33aSEmmanuel Vadotmaintainers:
15*cb7aa33aSEmmanuel Vadot  - Patrice Chotard <patrice.chotard@foss.st.com>
16*cb7aa33aSEmmanuel Vadot
17*cb7aa33aSEmmanuel Vadotproperties:
18*cb7aa33aSEmmanuel Vadot  compatible:
19*cb7aa33aSEmmanuel Vadot    const: st,stih407-mailbox
20*cb7aa33aSEmmanuel Vadot
21*cb7aa33aSEmmanuel Vadot  reg:
22*cb7aa33aSEmmanuel Vadot    maxItems: 1
23*cb7aa33aSEmmanuel Vadot
24*cb7aa33aSEmmanuel Vadot  mbox-name:
25*cb7aa33aSEmmanuel Vadot    $ref: /schemas/types.yaml#/definitions/string
26*cb7aa33aSEmmanuel Vadot    description: name of the mailbox IP
27*cb7aa33aSEmmanuel Vadot
28*cb7aa33aSEmmanuel Vadot  interrupts:
29*cb7aa33aSEmmanuel Vadot    description: the irq line for the RX mailbox
30*cb7aa33aSEmmanuel Vadot    maxItems: 1
31*cb7aa33aSEmmanuel Vadot
32*cb7aa33aSEmmanuel Vadot  "#mbox-cells":
33*cb7aa33aSEmmanuel Vadot    const: 2
34*cb7aa33aSEmmanuel Vadot
35*cb7aa33aSEmmanuel Vadotrequired:
36*cb7aa33aSEmmanuel Vadot  - compatible
37*cb7aa33aSEmmanuel Vadot  - reg
38*cb7aa33aSEmmanuel Vadot  - "#mbox-cells"
39*cb7aa33aSEmmanuel Vadot
40*cb7aa33aSEmmanuel VadotadditionalProperties: false
41*cb7aa33aSEmmanuel Vadot
42*cb7aa33aSEmmanuel Vadotexamples:
43*cb7aa33aSEmmanuel Vadot  - |
44*cb7aa33aSEmmanuel Vadot    #include <dt-bindings/interrupt-controller/arm-gic.h>
45*cb7aa33aSEmmanuel Vadot    mailbox0: mailbox@8f00000  {
46*cb7aa33aSEmmanuel Vadot        compatible = "st,stih407-mailbox";
47*cb7aa33aSEmmanuel Vadot        reg = <0x8f00000 0x1000>;
48*cb7aa33aSEmmanuel Vadot        interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>;
49*cb7aa33aSEmmanuel Vadot        #mbox-cells = <2>;
50*cb7aa33aSEmmanuel Vadot        mbox-name = "a9";
51*cb7aa33aSEmmanuel Vadot    };
52*cb7aa33aSEmmanuel Vadot
53*cb7aa33aSEmmanuel Vadot...
54