STRUCT TI_MSGMGR_INST(9)

💖 NAME 💖

struct ti_msgmgr_inst — it's literally the Description of a Message Manager Instance, bestie. That's the whole vibe.

---

✨ SYNOPSIS ✨

okay so here's the whole struct, character for character, no cap:

struct ti_msgmgr_inst {
    struct device *dev;
    const struct ti_msgmgr_desc *desc;
    void __iomem *queue_proxy_region;
    void __iomem *queue_state_debug_region;
    void __iomem *queue_ctrl_region;
    u8 num_valid_queues;
    struct ti_queue_inst *qinsts;
    struct mbox_controller mbox;
    struct mbox_chan *chans;
 };

---

🎀 Members 🎀

time for the main characters, one by one 🫶

• dev — the device pointer that corresponds to the Message Manager instance. iconic, foundational, the moment.
• desc — the Description of the SoC integration. yes it's a whole description inside the description, we love nesting 💅
• queue_proxy_region — the Queue proxy region where queue buffers are located. this is where the buffers actually live.
• queue_state_debug_region — the Queue status register regions. debug o'clock 🌸
• queue_ctrl_region — the Queue Control register regions. control queen 👑
• num_valid_queues — Number of valid queues defined for the processor. it's a u8, she's petite.
• qinsts — Array of valid Queue Instances for the Processor.
• mbox — the Mailbox Controller.
• chans — Array for channels corresponding to the Queue Instances. (yes the original ends that one with a period, keeping it, periodt 💀)

---

🌈 Note 🌈

lowkey important: other queues are probably reserved for other processors in the SoC. so like… not everything is yours, share the group chat.

---

🦋 SEE ALSO 🦋

the whole friend group, all linked, go read them:

• Kernel file ./drivers/mailbox/ti-msgmgr.c struct
• ti_msgmgr_valid_queue_desc(9)
• struct ti_msgmgr_desc(9)
• struct ti_queue_inst(9)
• ti_msgmgr_queue_get_num_messages(9)
• ti_msgmgr_queue_is_error(9)
• ti_msgmgr_queue_rx_interrupt(9)
• ti_msgmgr_queue_peek_data(9)
• ti_msgmgr_last_tx_done(9)
• ti_msgmgr_send_data(9)
• ti_msgmgr_queue_rx_irq_req(9)
• ti_msgmgr_queue_startup(9)
• ti_msgmgr_queue_shutdown(9)
• ti_msgmgr_of_xlate(9)
• ti_msgmgr_queue_setup(9)

---

and that's the whole page bestie, we ate and left zero crumbs 🍓

k bye, this lived in ./drivers/mailbox and was dated October 2026, ty for coming to my ted talk 💜