STRUCT MTK_SPI(9)

💖 struct mtk_spi(9) — the Kernel API Manual tea 🎀

okay so bestie, this page is from the Kernel API Manual and it's literally about struct mtk_spi — the SPI driver instance ✨ buckle up, it's a struct tour and honestly it's giving "backstage pass to the SPI controller" energy 💅

---

🌸 NAME 🌸

struct mtk_spi — SPI driver instance 🫶 that's it, that's the whole name, no notes.

---

✨ SYNOPSIS ✨

here's the whole struct, character for character, don't touch it, it's perfect:

struct mtk_spi {
    void __iomem *base;
    u32 state;
    int pad_num;
    u32 *pad_sel;
    struct clk *parent_clk, *sel_clk, *spi_clk, *spi_hclk;
    struct spi_transfer *cur_transfer;
    u32 xfer_len;
    u32 num_xfered;
    struct scatterlist *tx_sgl, *rx_sgl;
    u32 tx_sgl_len, rx_sgl_len;
    const struct mtk_spi_compatible *dev_comp;
    struct pm_qos_request qos_request;
    u32 spi_clk_hz;
    struct completion spimem_done;
    bool use_spimem;
    struct device *dev;
    dma_addr_t tx_dma;
    dma_addr_t rx_dma;
 };

---

👑 Members 👑

every single field, one by one, no skipping, we stay thorough 💜

• base — start address of the SPI controller registers 📍 like the front door of the controller, that's where everything lives.
• state — the SPI controller state 🌈 current mood of the controller, but make it u32.
• pad_num — how many pad_sel entries there are 🔢 (yes it's a count, yes it counts the next field, they're a package deal).
• pad_sel — groups of pins to select 📌 pin-selection groups, that's the whole vibe.
• parent_clk — parent of sel_clk 💫 the clock above the mux clock, the ancestor of it all.
• sel_clk — the SPI host mux clock 🕰️ mux clock for the SPI host, yes mux, yes that's a real word here.
• spi_clk — peripheral clock 🔔 the peripheral-side clock.
• spi_hclk — AHB bus clock 🚌 the AHB bus clock, bus clock, love that for it.
• cur_transfer — currently processed SPI transfer 🌀 the transfer that's being handled right now, main character energy.
• xfer_len — number of bytes to transfer 📏 how many bytes are on the to-do list.
• num_xfered — number of transferred bytes ✅ how many bytes have already been transferred.
• tx_sgl — TX transfer scatterlist 📤 the scatterlist for the TX transfer.
• rx_sgl — RX transfer scatterlist 📥 and the scatterlist for the RX transfer.
• tx_sgl_len — size of TX DMA transfer 📦 how big the TX DMA transfer is.
• rx_sgl_len — size of RX DMA transfer 🎁 how big the RX DMA transfer is.
• dev_comp — device data structure 🧬 the device data structure, const because we respect it.
• qos_request — QoS request ⚡ a QoS request, and it is what it is.
• spi_clk_hz — current SPI clock in Hz 🎵 the current SPI clock, measured in Hz, exact.
• spimem_done — SPI-MEM operation completion 🏁 the completion for the SPI-MEM operation — it fires when the op is done.
• use_spimem — enables SPI-MEM 🚦 the bool that turns SPI-MEM on.
• dev — device pointer 🔗 a pointer to the device.
• tx_dma — DMA start for SPI-MEM TX 🚀 the DMA start address for SPI-MEM TX.
• rx_dma — DMA start for SPI-MEM RX 🛬 and the DMA start address for SPI-MEM RX.

---

🦋 SEE ALSO 🦋

go peek at these, iykyk 👀

• Kernel file ./drivers/spi/spi-mt65xx.c
• struct mtk_spi_compatible(9)
• ./drivers/spi (the directory itself, say hi to it)

---

and that's the whole page, bestie 💖 no cap, every field accounted for, periodt 💅

fr fr read the source too, ./drivers/spi/spi-mt65xx.c is right there and it ate 💀

---

🎀 cute little sign-off 🎀 — this page lives under ./drivers/spi, and it's dated October 2026 ⭐ so yes, from the future, slay 🌈 bye bestie 💜🫶