xref: /linux/Documentation/devicetree/bindings/mailbox/ti,k2g-message-manager.yaml (revision 8bfab832ad6905ba70e69bad87a78f6d90cce64a)
1*b568b683SEduard Bostina# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*b568b683SEduard Bostina%YAML 1.2
3*b568b683SEduard Bostina---
4*b568b683SEduard Bostina$id: http://devicetree.org/schemas/mailbox/ti,k2g-message-manager.yaml#
5*b568b683SEduard Bostina$schema: http://devicetree.org/meta-schemas/core.yaml#
6*b568b683SEduard Bostina
7*b568b683SEduard Bostinatitle: Texas Instruments Message Manager
8*b568b683SEduard Bostina
9*b568b683SEduard Bostinamaintainers:
10*b568b683SEduard Bostina  - Eduard Bostina <egbostina@gmail.com>
11*b568b683SEduard Bostina
12*b568b683SEduard Bostinadescription:
13*b568b683SEduard Bostina  The Texas Instruments Message Manager is a mailbox controller that has
14*b568b683SEduard Bostina  configurable queues selectable at SoC (System on Chip) integration. The
15*b568b683SEduard Bostina  Message manager is broken up into queues in different address regions
16*b568b683SEduard Bostina  that are called "proxies" - each instance is unidirectional and is
17*b568b683SEduard Bostina  instantiated at SoC integration level to indicate receive or transmit path.
18*b568b683SEduard Bostina
19*b568b683SEduard Bostinaproperties:
20*b568b683SEduard Bostina  compatible:
21*b568b683SEduard Bostina    const: ti,k2g-message-manager
22*b568b683SEduard Bostina
23*b568b683SEduard Bostina  reg:
24*b568b683SEduard Bostina    maxItems: 2
25*b568b683SEduard Bostina
26*b568b683SEduard Bostina  reg-names:
27*b568b683SEduard Bostina    items:
28*b568b683SEduard Bostina      - const: queue_proxy_region
29*b568b683SEduard Bostina      - const: queue_state_debug_region
30*b568b683SEduard Bostina
31*b568b683SEduard Bostina  "#mbox-cells":
32*b568b683SEduard Bostina    const: 2
33*b568b683SEduard Bostina    description:
34*b568b683SEduard Bostina      Contains the queue ID and proxy ID in that order referring to the
35*b568b683SEduard Bostina      transfer path.
36*b568b683SEduard Bostina
37*b568b683SEduard Bostina  interrupts:
38*b568b683SEduard Bostina    maxItems: 2
39*b568b683SEduard Bostina
40*b568b683SEduard Bostina  interrupt-names:
41*b568b683SEduard Bostina    items:
42*b568b683SEduard Bostina      - const: rx_005
43*b568b683SEduard Bostina      - const: rx_057
44*b568b683SEduard Bostina
45*b568b683SEduard Bostinarequired:
46*b568b683SEduard Bostina  - compatible
47*b568b683SEduard Bostina  - reg
48*b568b683SEduard Bostina  - reg-names
49*b568b683SEduard Bostina  - "#mbox-cells"
50*b568b683SEduard Bostina  - interrupts
51*b568b683SEduard Bostina  - interrupt-names
52*b568b683SEduard Bostina
53*b568b683SEduard BostinaadditionalProperties: false
54*b568b683SEduard Bostina
55*b568b683SEduard Bostinaexamples:
56*b568b683SEduard Bostina  - |
57*b568b683SEduard Bostina    #include <dt-bindings/interrupt-controller/arm-gic.h>
58*b568b683SEduard Bostina
59*b568b683SEduard Bostina    msgmgr@2a00000 {
60*b568b683SEduard Bostina        compatible = "ti,k2g-message-manager";
61*b568b683SEduard Bostina        #mbox-cells = <2>;
62*b568b683SEduard Bostina        reg-names = "queue_proxy_region", "queue_state_debug_region";
63*b568b683SEduard Bostina        reg = <0x02a00000 0x400000>, <0x028c3400 0x400>;
64*b568b683SEduard Bostina        interrupt-names = "rx_005", "rx_057";
65*b568b683SEduard Bostina        interrupts = <GIC_SPI 324 IRQ_TYPE_LEVEL_HIGH>,
66*b568b683SEduard Bostina                     <GIC_SPI 327 IRQ_TYPE_LEVEL_HIGH>;
67*b568b683SEduard Bostina    };
68