Lines Matching +full:implementation +full:- +full:defined
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 <[email protected]>
11 - Cristian Marussi <[email protected]>
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
36 Both PBX and MBX need to be present and defined in the DT description if you
48 - Doorbell Extension (DBE): DBE defines a type of channel called a Doorbell
51 When DBE is implemented, the number of DBCHs that an implementation of 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
72 When FCE is implemented, the number of FCHs that an implementation of the
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.
92 When FE is implemented, the number of FFCHs that an implementation of 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
122 number of channels effectively available is implementation defined and
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]+$'
151 - pattern: '^mbx-fch-xfer-[0-9]+$'
153 - pattern: '^mbx-fchgrp-xfer-[0-9]+$'
155 - pattern: '^mbx-ffch-xfer-[0-9]+$'
157 - pattern: '^pbx-dbch-xfer-ack-[0-9]+$'
159 - pattern: '^pbx-ffch-xfer-ack-[0-9]+$'
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";