STRUCT MTK_HSDMA_DEVICE(9)

🦋 struct mtk_hsdma_device(9) — the Kernel API Manual glow-up ✨

okay bestie, so we're in the Kernel API Manual and today's main character is struct mtk_hsdma_device(9). buckle up, this one's a struct, and it's literally the whole vibe of an HSDMA device. 🎀

---

✨ NAME ✨

struct mtk_hsdma_device — this is the struct that holds all the info describing an HSDMA device. it's giving "one struct to hold them all" and honestly? iconic. 👑

---

🌸 SYNOPSIS 🌸

like, here's the whole thing, verbatim, no cap:

struct mtk_hsdma_device {
    struct dma_device ddev;
    void __iomem *base;
    struct clk *clk;
    u32 irq;
    u32 dma_requests;
    struct mtk_hsdma_vchan *vc;
    struct mtk_hsdma_pchan *pc;
    refcount_t pc_refcnt;
    spinlock_t lock;
    const struct mtk_hsdma_soc *soc;
 };

---

💖 Members 💖

okay so let's go member by member, iykyk:

• ddev — an instance for struct dma_device. the DMA-side rep, fr fr.
• base — the mapped register I/O base. where the registers live. 📍
• clk — the clock that the device internals are using. gotta keep that heartbeat going ⏰
• irq — the IRQ that the device is using. it will interrupt you, and that's the point 💅
• dma_requests — the number of VCs the device supports. count 'em 🧮
• vc — the pointer to all the available VCs. all of them, together, squad goals 🫶
• pc — the pointer to the underlying PC. the one holding it down underneath 🌈
• pc_refcnt — tracks how many VCs are using the PC. a whole refcount just keeping score 😭
• lock — lock protecting against multiple VCs accessing the PC. one at a time, bestie, we don't do chaos here 🔒
• soc — the pointer to the area holding the differences among the various platforms. every platform's little quirks, filed neatly ⭐

---

🦋 SEE ALSO 🦋

kernel file ./drivers/dma/mediatek/mtk-hsdma.c, and the whole friend group:

• struct mtk_hsdma_pdesc(9)
• struct mtk_hsdma_vdesc(9)
• struct mtk_hsdma_cb(9)
• struct mtk_hsdma_ring(9)
• struct mtk_hsdma_pchan(9)
• struct mtk_hsdma_vchan(9)
• struct mtk_hsdma_soc(9)

go read them, they're all slay, no notes 💜

---

that's the whole page, bestie!! brought to you by ./drivers/dma/mediatek, the October 2026 edition, and the letter struct mtk_hsdma_device(9) — mwah, bye! 💅✨