u-boot/include/mailbox.h

11  * A mailbox is a hardware mechanism for transferring small fixed-size messages
15  * Data transfer is optional; a mailbox may consist solely of a notification
17  * FIFOs, rather than via RAM-based buffers. The mailbox API generally
21  * A mailbox channel is a bi-directional mechanism that can send a message or
24  * messages is defined by the mailbox implementation, or the remote entity with
27  * A driver that implements UCLASS_MAILBOX is a mailbox provider. A provider
28  * will often implement multiple separate mailbox channels, since the hardware
29  * it manages often has this capability. mailbox-uclass.h describes the
30  * interface which mailbox providers must implement.
32  * Mailbox consumers/clients generate and send, or receive and process,
39  * struct mbox_chan - A handle to a single mailbox channel.
42  * is managed solely by the mailbox API and mailbox drivers. A mailbox channel
43  * is initialized by "get"ing the mailbox. The channel struct is passed to all
44  * other mailbox APIs to identify which mailbox to operate upon.
46  * @dev: The device which implements the mailbox.
47  * @id: The mailbox channel ID within the provider.
49  * Currently, the mailbox API assumes that a single integer ID is enough to
50  * identify and configure any mailbox channel for any mailbox provider. If this
52  * either (a) add more fields to allow mailbox providers to store additional
68  * mbox_get_by_index - Get/request a mailbox by integer index
70  * This looks up and requests a mailbox channel. The index is relative to the
71  * client device; each device is assumed to have n mailbox channels associated
78  * @index:	The index of the mailbox channel to request, within the
86  * mbox_get_by_name - Get/request a mailbox by name
88  * This looks up and requests a mailbox channel. The name is relative to the
89  * client device; each device is assumed to have n mailbox channels associated
96  * @name:	The name of the mailbox channel to request, within the client's
105  * mbox_free - Free a previously requested mailbox channel.
114  * mbox_send - Send a message over a mailbox channel
123  *		mailbox provider. Providers that solely transfer notifications
130  * mbox_recv - Receive any available message from a mailbox channel
140  *		the mailbox provider. Providers that solely transfer