STRUCT TI_QUEUE_INST(9)

🌸 NAME 🌸

okay so bestie, this is the struct ti_queue_inst(9) page from the Kernel API Manual, and it is literally the Description of a queue instance. Like, it’s giving “here’s the struct that describes a queue instance” and we’re gonna go through every single member together, no skips, no cap. 🫶

✨ SYNOPSIS ✨

here’s the whole struct, copied exactly so you can screenshot it and send it to the group chat:

struct ti_queue_inst {
    char name[30];
    u8 queue_id;
    u8 proxy_id;
    int irq;
    bool is_tx;
    void __iomem *queue_buff_start;
    void __iomem *queue_buff_end;
    void __iomem *queue_state;
    void __iomem *queue_ctrl;
    struct mbox_chan *chan;
    u32 *rx_buff;
    bool polled_rx_mode;
 };

💅 Members 💅

okay bestie, member-by-member, no skips, no cap:

• name — Queue Name 🌸
• queue_id — Queue Identifier as mapped on SoC ✨
• proxy_id — Proxy Identifier as mapped on SoC 🎀
• irq — IRQ for Rx Queue 🔥
• is_tx — bestie, the original page gives this one no description at all, so I’m not inventing one. It’s just there, mysterious and iconic. 👑
• queue_buff_start — First register of Data Buffer 💖
• queue_buff_end — Last (or confirmation) register of Data buffer 🦋
• queue_state — Queue status register ⭐
• queue_ctrl — Queue Control register 🎀
• chan — Mailbox channel 💌
• rx_buff — Receive buffer pointer allocated at probe, max_message_size 🌈
• polled_rx_mode — Use polling for rx instead of interrupts 👑

🌈 SEE ALSO 🌈

the original sends you to these, and I’m keeping every single one, fr fr:

• Kernel file ./drivers/mailbox/ti-msgmgr.c
• struct ti_msgmgr_valid_queue_desc(9)
• struct ti_msgmgr_desc(9)
• struct ti_msgmgr_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)

mwah 💋 — source/version: ./drivers/mailbox; date: October 2026. this struct ti_queue_inst(9) page ate and left no crumbs. 🎀👑