一．device tree中的写法
二. mailbox框架 （driver/mailbox/mailbox.c）
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 };
三. mailbox client 流程
通过mbox_request_channel_byname 根据"mbox-names"申请channel
创建mbox设备
通过mbox设备的write read 函数访问controller
其中write 通过调用mbox_send_message，
add_to_rbuf拷贝msg到chan->msg_data[MAX = 20]
msg_submit读取msg_data[idx]，放到tx_prepare中，调用具体驱动的send message写寄存器
其中read 通过irq驱动
irq读取寄存器得到消息，调用mailbox.c中的mbox_chan_received_data，再调用client的rx_callback将得到的数据放到client->rx_buffer中
四. mailbox driver流程
配置controller属性:
申请chan，配置chan个数
配置of_xlate回调，获取chan
配置chan_ops
配置txdone判断方式
通过mailbox_controller_register 注册controller
五. 总结
driver 通过mbox_controller_register 注册controller
client 通过mbox_request_channel调用driver->startup
client 通过mbox_send_message调用driver->send_data，并等待txdone
driver 收到remote的中断读取数据调用mbox_chan_received_data将数据放到 client->rx_buffer中