struct mbox_controller {

    struct device *dev;                                      // 特定mailbox驱动probe时赋值 dev = &pdev->dev

    const struct mbox_chan_ops *ops;                         // mailbox channel需要实现的功能函数

    struct mbox_chan *chans;                                 // mailbox channel指针数组

    int num_chans;                                           // mailbox channel个数

    bool txdone_irq;　　　　　　　　　　　　　　　　　　　　　　　　// 通过中断来判断上次传输是否完成

    bool txdone_poll;　　　　　　　　　　　　　　　　  　　　　　　// 通过poll机制来判断上次传输是否完成

    unsigned txpoll_period;                                  // POLL 周期, 以ms计

    struct mbox_chan *(*of_xlate)(struct mbox_controller *mbox,

                      const struct of_phandle_args *sp);     // 获取特定channel的回调函数

    /* Internal to API */

    struct hrtimer poll_hrt;

    struct list_head node;

};

struct mbox_chan {

    struct mbox_controller *mbox;                            // contronller指针

    unsigned txdone_method;

    struct mbox_client *cl;                                  // client指针

    struct completion tx_complete;                           //

    void *active_req;

    unsigned msg_count, msg_free;

    void *msg_data[MBOX_TX_QUEUE_LEN];

    spinlock_t lock; /* Serialise access to the channel */

    void *con_priv;

};

struct mbox_chan_ops {

    int (*send_data)(struct mbox_chan *chan, void *data);         // 发送数据（需要last data sent）

    int (*startup)(struct mbox_chan *chan);                       // 特定mailbox 启动

    void (*shutdown)(struct mbox_chan *chan);                     // 特定mailbox 关闭

    bool (*last_tx_done)(struct mbox_chan *chan);                 // 如果TXDONE_BY_POLL　该回调会被使用

    bool (*peek_data)(struct mbox_chan *chan);                    // 检测是否有数据

};

struct mbox_client {

    struct device *dev;                                           // client 设备

    bool tx_block;                                                // block until last data is all transmitted

    unsigned long tx_tout;                                        // max block period for timeout

    bool knows_txdone;                                            // txdone 回调，如果controller已经有txdone，则该配置无效

    void (*rx_callback)(struct mbox_client *cl, void *mssg);      // 收到数据

    void (*tx_prepare)(struct mbox_client *cl, void *mssg);　　　　// 准备数据

    void (*tx_done)(struct mbox_client *cl, void *mssg, int r);   // 检测txdone

};