STRUCT K3_RINGACC(9)

✨ struct k3_ringacc(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 — today's main character is struct k3_ringacc, aka the Rings accelerator descriptor. yes it's a struct. yes it's iconic. let's get into it 🎀

---

🌸 NAME 🌸

struct k3_ringacc — the Rings accelerator descriptor, fr fr 👑

---

🦋 SYNOPSIS 🦋

struct k3_ringacc {
    struct device *dev;
    struct k3_ringacc_proxy_gcfg_regs __iomem *proxy_gcfg;
    void __iomem *proxy_target_base;
    u32 num_rings;
    unsigned long *rings_inuse;
    struct ti_sci_resource *rm_gp_range;
    bool dma_ring_reset_quirk;
    u32 num_proxies;
    unsigned long *proxy_inuse;
    struct k3_ring *rings;
    struct list_head list;
    struct mutex req_lock;
    const struct ti_sci_handle *tisci;
    const struct ti_sci_rm_ringacc_ops *tisci_ring_ops;
    u32 tisci_dev_id;
    const struct k3_ringacc_ops *ops;
    bool dma_rings;
 };

like, copy it exactly pls, don't be out here editing struct definitions 💅

---

💜 Members 💜

so each of these fields is doing its own lil job and honestly they all ate:

• dev — pointer on RA device 🫶
• proxy_gcfg — the RA proxy global config registers, lowkey the control room ✨
• proxy_target_base — RA proxy datapath region, where the actual traffic happens 🚀
• num_rings — number of ring in RA (yes, singular "ring", we don't gatekeep grammar) 💀
• rings_inuse — bitfield for ring usage tracking, keeping receipts on who's using what 📋
• rm_gp_range — general purpose rings range from tisci 👑
• dma_ring_reset_quirk — DMA reset workaround enable, a little "we know, we know" flag 🙈
• num_proxies — number of RA proxies ⭐
• proxy_inuse — bitfield for proxy usage tracking, same energy as rings_inuse but for proxies 🎀
• rings — array of rings descriptors (struct k3_ring), the whole squad 🌈
• list — list of RAs in the system, everyone linked up 🦋
• req_lock — protect rings allocation, do NOT skip the lock bestie 🔒
• tisci — pointer ti-sci handle 🧚
• tisci_ring_ops — ti-sci rings ops 💫
• tisci_dev_id — ti-sci device id 🍓
• ops — SoC specific ringacc operation, the per-SoC special sauce 🔥
• dma_rings — indicate DMA ring (dual ring within BCDMA/PKTDMA), no cap it's a dual ring 💅

---

🌟 SEE ALSO 🌟

go read the kernel file ./drivers/soc/ti/k3-ringacc.c and also these fellow icons:

• struct k3_ring_rt_regs(9)
• struct k3_ring_fifo_regs(9)
• struct k3_ringacc_proxy_gcfg_regs(9)
• struct k3_ringacc_proxy_target_regs(9)
• struct k3_ring_state(9)
• struct k3_ring(9)
• struct k3_ringacc_soc_data(9)

---

ngl, the whole family lives in ./drivers/soc/ti and they're all worth a read 🫶

okay that's the page!! mwah 💋 this came from ./drivers/soc/ti, dated October 2026, and it's still serving struct k3_ringacc(9) realness. periodt 💅✨🎀