omap_rproc_mbox_callback(9)

💖 omap_rproc_mbox_callback(9) 💖

okay so welcome to the Kernel API Manual entry for this one, bestie — it's literally the inbound mailbox message handler, and it's giving “small but important” 🫶

🌸 NAME 🌸

omap_rproc_mbox_callback — inbound mailbox message handler ✨

🦋 SYNOPSIS 🦋

void omap_rproc_mbox_callback (struct mbox_client *client , void *data
);

🎀 ARGUMENTS 🎀

• client — mailbox client pointer used for requesting the mailbox channel 💌
• data — mailbox payload 📦

🔥 DESCRIPTION 🔥

Okay so this handler is invoked by omap's mailbox driver whenever a mailbox message is received. Usually, the mailbox payload simply contains the index of the virtqueue that is kicked by the remote processor, and we let the remoteproc core handle it. no cap, that's the usual flow.

In addition to virtqueue indices, we also have some out-of-band values that indicate different events. Those values are deliberately very big so they don't coincide with virtqueue indices — iykyk, it's a whole collision-avoidance vibe 💅.

🌈 SEE ALSO 🌈

Kernel file: ./drivers/remoteproc/omap_remoteproc.c

Also, all the structs and functions below are linked up — ngl, this list is long but we keep every single one 🫶:

• struct omap_rproc_boot_data(9)
• struct omap_rproc_mem(9)
• struct omap_rproc_timer(9)
• struct omap_rproc(9)
• struct omap_rproc_mem_data(9)
• struct omap_rproc_dev_data(9)
• omap_rproc_request_timer(9)
• omap_rproc_start_timer(9)
• omap_rproc_stop_timer(9)
• omap_rproc_release_timer(9)
• omap_rproc_get_timer_irq(9)
• omap_rproc_ack_timer_irq(9)
• omap_rproc_watchdog_isr(9)
• omap_rproc_enable_timers(9)
• omap_rproc_disable_timers(9)
• omap_rproc_write_dsp_boot_addr(9)
• omap_rproc_da_to_va(9)

source/version: ./drivers/remoteproc — dated October 2026. mwah 🎀✨