drivers/mailbox/mtk-vcp-mailbox.c

Source file repositories/reference/linux-study-clean/drivers/mailbox/mtk-vcp-mailbox.c

File Facts

System
Linux kernel
Corpus path
drivers/mailbox/mtk-vcp-mailbox.c
Extension
.c
Size
4180 bytes
Lines
171
Domain
Driver Families
Bucket
drivers/mailbox
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct mtk_vcp_mbox {
	struct mbox_controller mbox;
	void __iomem *base;
	struct device *dev;
	const struct mtk_vcp_mbox_cfg *cfg;
	struct mtk_ipi_info ipi_recv;
	struct mbox_chan chans;
};

struct mtk_vcp_mbox_cfg {
	u16 set_in;
	u16 clr_out;
};

static irqreturn_t mtk_vcp_mbox_irq_thread(int irq, void *data)
{
	struct mtk_vcp_mbox *priv = data;

	/* get irq status */
	priv->ipi_recv.irq_status = readl(priv->base + priv->cfg->clr_out);

	__ioread32_copy(priv->ipi_recv.msg, priv->base,
			MTK_VCP_MBOX_SLOT_MAX_SIZE / 4);

	mbox_chan_received_data(&priv->chans, &priv->ipi_recv);

	/* clear irq status */
	writel(priv->ipi_recv.irq_status, priv->base + priv->cfg->clr_out);

	return IRQ_HANDLED;
}

static struct mbox_chan *mtk_vcp_mbox_xlate(struct mbox_controller *mbox,
					    const struct of_phandle_args *sp)
{
	if (sp->args_count)
		return ERR_PTR(-EINVAL);

	return &mbox->chans[0];
}

static int mtk_vcp_mbox_send_data(struct mbox_chan *chan, void *data)
{
	struct mtk_vcp_mbox *priv = chan->con_priv;
	struct mtk_ipi_info *ipi_info = data;
	u32 status;

	if (!ipi_info->msg) {
		dev_err(priv->dev, "msg buffer is NULL.\n");
		return -EINVAL;
	}

	status = readl(priv->base + priv->cfg->set_in);
	if (status & BIT(ipi_info->index)) {
		dev_warn(priv->dev, "mailbox IPI %d is busy.\n", ipi_info->id);
		return -EBUSY;
	}

	if (ipi_info->slot_ofs + ipi_info->len > MTK_VCP_MBOX_SLOT_MAX_SIZE)
		return -EINVAL;
	__iowrite32_copy(priv->base + ipi_info->slot_ofs, ipi_info->msg,
			 ipi_info->len);

	writel(BIT(ipi_info->index), priv->base + priv->cfg->set_in);

	return 0;
}

static bool mtk_vcp_mbox_last_tx_done(struct mbox_chan *chan)
{
	struct mtk_ipi_info *ipi_info = chan->active_req;
	struct mtk_vcp_mbox *priv = chan->con_priv;

	return !(readl(priv->base + priv->cfg->set_in) & BIT(ipi_info->index));
}

static const struct mbox_chan_ops mtk_vcp_mbox_chan_ops = {
	.send_data	= mtk_vcp_mbox_send_data,
	.last_tx_done	= mtk_vcp_mbox_last_tx_done,
};

static int mtk_vcp_mbox_probe(struct platform_device *pdev)
{
	struct device *dev = &pdev->dev;
	struct mtk_vcp_mbox *priv;
	struct mbox_controller *mbox;
	int ret, irq;

	priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
	if (!priv)

Annotation

Implementation Notes