Lines Matching +full:9 +full:- +full:channel
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
53 order and discoverable at run-time.
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
63 Channel (FCH). FCH is intended for lower overhead communication between
65 to update the channel value at any time, regardless of whether the previous
66 value has been seen by the Receiver. When the Receiver reads the channel's
67 content it gets the last value written to the channel.
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
88 - Transfers which require the Receiver to provide acknowledgment.
89 - Transfers which have in-band payload.
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]+$'
144 description: PBX/MBX FIFO Channel <N> Low Tide interrupt
145 - pattern: '^ffch-high-tide-[0-9]+$'
146 description: PBX/MBX FIFO Channel <N> High Tide interrupt
147 - pattern: '^ffch-flush-[0-9]+$'
148 description: PBX/MBX FIFO Channel <N> Flush interrupt
149 - pattern: '^mbx-dbch-xfer-[0-9]+$'
150 description: MBX Doorbell Channel <N> Transfer interrupt
151 - pattern: '^mbx-fch-xfer-[0-9]+$'
153 - pattern: '^mbx-fchgrp-xfer-[0-9]+$'
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':
165 extension type, the second is for the channel number while the third
168 Extension types constants are defined in <dt-bindings/arm/mhuv3-dt.h>.
175 mboxes = <&mhu DBE_EXT 0 5>; // DBE, Doorbell Channel Window 0, doorbell 5.
176 mboxes = <&mhu DBE_EXT 7>; // DBE, Doorbell Channel Window 1, doorbell 7.
179 mboxes = <&mhu FE_EXT 1 0>; // FE, FIFO Channel Window 1.
180 mboxes = <&mhu FE_EXT 7 0>; // FE, FIFO Channel Window 7.
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";