Lines Matching +full:data +full:- +full:transfer
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10 - Sudeep Holla <sudeep.holla@arm.com>
11 - Cristian Marussi <cristian.marussi@arm.com>
27 - Configure the MHU
28 - Send Transfers to the Receiver
29 - Optionally receive acknowledgment of a Transfer from the Receiver
32 - Configure the MHU
33 - Receive Transfers from the Sender
34 - Optionally acknowledge Transfers sent by the Sender
48 - Doorbell Extension (DBE): DBE defines a type of channel called a Doorbell
49 Channel (DBCH). DBCH enables a single bit Transfer to be sent from the
50 Sender to Receiver. The Transfer indicates that an event has occurred.
53 order and discoverable at run-time.
56 Transfers at once using a single DBCH, so long as each Transfer uses
58 Optionally, data may be transmitted through an out-of-band shared memory
62 - FastChannel Extension (FCE): FCE defines a type of channel called a Fast
69 knowing if, or when, the Receiver will act on the Transfer.
73 MHU can support is between 1-1024, if the FastChannel word-size is 32-bits,
74 or between 1-512, when the FastChannel word-size is 64-bits.
76 Note that the number of FCHs and the word-size are implementation defined,
77 not configurable but discoverable at run-time.
78 Optionally, data may be transmitted through an out-of-band shared memory
80 mechanism which carries also a pointer to such out-of-band data, but this
83 - FIFO Extension (FE): FE defines a Channel type called a FIFO Channel (FFCH).
85 - Multiple Transfers to the Receiver without having to wait for the
86 previous Transfer to be acknowledged by the Receiver, as long as the
87 FIFO has room for the Transfer.
88 - Transfers which require the Receiver to provide acknowledgment.
89 - Transfers which have in-band payload.
90 In all cases, the data is guaranteed to be observed by the Receiver in the
95 the access-granularity are implementation defined, not configurable but
96 discoverable at run-time.
97 Optionally, additional data may be transmitted through an out-of-band shared
114 interrupt-names:
120 extensions. All interrupts of the MHU are level-sensitive.
121 Some of these optional interrupts are defined per-channel, where the
123 run-time discoverable.
124 In the following names are enumerated using patterns, with per-channel
132 - combined
133 - mbx-fch-xfer-<N> but only if mbx-fcgrp-xfer-<N> is not implemented.
139 - const: combined
141 - const: combined-ffch
143 - pattern: '^ffch-low-tide-[0-9]+$'
145 - pattern: '^ffch-high-tide-[0-9]+$'
147 - pattern: '^ffch-flush-[0-9]+$'
149 - pattern: '^mbx-dbch-xfer-[0-9]+$'
150 description: MBX Doorbell Channel <N> Transfer interrupt
151 - pattern: '^mbx-fch-xfer-[0-9]+$'
152 description: MBX FastChannel <N> Transfer interrupt
153 - pattern: '^mbx-fchgrp-xfer-[0-9]+$'
154 description: MBX FastChannel <N> Group Transfer interrupt
155 - pattern: '^mbx-ffch-xfer-[0-9]+$'
156 description: MBX FIFO Channel <N> Transfer interrupt
157 - pattern: '^pbx-dbch-xfer-ack-[0-9]+$'
158 description: PBX Doorbell Channel <N> Transfer Ack interrupt
159 - pattern: '^pbx-ffch-xfer-ack-[0-9]+$'
160 description: PBX FIFO Channel <N> Transfer Ack interrupt
162 '#mbox-cells':
168 Extension types constants are defined in <dt-bindings/arm/mhuv3-dt.h>.
187 - compatible
188 - reg
189 - interrupts
190 - interrupt-names
191 - '#mbox-cells'
196 - |
197 #include <dt-bindings/interrupt-controller/arm-gic.h>
200 #address-cells = <2>;
201 #size-cells = <2>;
205 #mbox-cells = <3>;
208 interrupt-names = "combined", "pbx-dbch-xfer-ack-1",
209 "ffch-high-tide-0";
216 #mbox-cells = <3>;
219 interrupt-names = "combined", "mbx-dbch-xfer-1", "ffch-low-tide-0";