STRUCT K3_RING(9)

💖 NAME 💖

okay so welcome to the Kernel API Manual, bestie — today's main character is struct k3_ring(9). struct k3_ring — RA Ring descriptor. That's the name drop, and yes it's giving kernel-internals royalty. 👑

✨ SYNOPSIS ✨

The struct, exactly as it is, no edits, no cap:

       struct k3_ring {
           struct k3_ring_rt_regs __iomem *rt;
           struct k3_ring_fifo_regs __iomem *fifos;
           struct k3_ringacc_proxy_target_regs  __iomem *proxy;
           dma_addr_t ring_mem_dma;
           void *ring_mem_virt;
           const struct k3_ring_ops *ops;
           u32 size;
           enum k3_ring_size elm_size;
           enum k3_ring_mode mode;
           u32 flags;
         #define K3_RING_FLAG_BUSY       BIT(1);
         #define K3_RING_FLAG_SHARED     BIT(2);
         #define K3_RING_FLAG_REVERSE    BIT(3);
           struct k3_ring_state state;
           u32 ring_id;
           struct k3_ringacc       *parent;
           u32 use_count;
           int proxy_id;
           struct device   *dma_dev;
           u32 asel;
         #define K3_ADDRESS_ASEL_SHIFT   48;
        };

Also peep the flag define besties living inside the struct code: K3_RING_FLAG_BUSY, K3_RING_FLAG_SHARED, K3_RING_FLAG_REVERSE, and K3_ADDRESS_ASEL_SHIFT. They're all right there above, periodt. 🚩

💅 Members 💅

Every field, no skips, no cap:

• rt — Ring control/status registers. The bossy little control center. 🎛️
• fifos — Ring queues registers. Queue energy fr fr. 🚦
• proxy — Ring Proxy Datapath registers. Proxy era. 🛰️
• ring_mem_dma — Ring buffer dma address. Literal and important. 🧠
• ring_mem_virt — Ring buffer virt address. Virtual bestie. 🫧
• ops — Ring operations. The operation squad. ⚙️
• size — Ring size in elements. Count elements, not vibes. 🔢
• elm_size — Size of the ring element. Element-size check. 📏
• mode — Ring mode. Mode unlocked. 🎚️
• flags — flags. Yes, lowercase flags — I'm not adding lore. 🚩
• state — Ring state. State of mind, but for the ring. 💫
• ring_id — Ring Id. ID check! 🪪
• parent — Pointer on struct k3_ringacc. Family-tree moment. 🌳
• use_count — Use count for shared rings. Shared-ring accountability. 👯
• proxy_id — RA Ring Proxy Id (only if K3_RINGACC_RING_USE_PROXY). Conditional icon. 🎯
• dma_dev — device to be used for DMA API (allocation, mapping). DMA device duties. 🛠️
• asel — Address Space Select value for physical addresses. Address-space selector, periodt. 🗺️

🌈 SEE ALSO 🌈

Kernel file ./drivers/soc/ti/k3-ringacc.c is your reference bestie, and these are the related pages: 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_ringacc(9), struct k3_ringacc_soc_data(9). Go read them if you want the full lore. 💖

That's it, bestie 💖 — this page comes from ./drivers/soc/ti, it's dated October 2026, and it's all about struct k3_ring(9). Periodt. 🎀✨