STRUCT SPEAR_SMI(9)

💅 struct spear_smi(9) — the Kernel API Manual tea 🎀

okay so bestie, welcome to the Kernel API Manual, page struct spear_smi(9). this is the structure that holds literally everything the SMI (that's the Serial Memory Interface, iykyk) needs to keep track of itself. think of it as the main character struct — every other spear function is lowkey just orbiting it ✨

---

🌸 NAME 🌸

struct spear_smi — the structure for the SMI device, no cap 💜

---

🦋 SYNOPSIS 🦋

here's the whole vibe, exactly as it lives in the kernel:

struct spear_smi {
    struct clk *clk;
    u32 status;
    unsigned long clk_rate;
    struct mutex lock;
    void __iomem *io_base;
    struct platform_device *pdev;
    wait_queue_head_t cmd_complete;
    u32 num_flashes;
    struct spear_snor_flash *flash[MAX_NUM_FLASH_CHIP];
 };

look at her. iconic. 🫶

---

👑 Members 👑

okay so each field, one by one, no skipping, we don't do that here 💅

• clk — the functional clock. the literal heartbeat, girlie is keeping time ⏰
• status — the current status register of the SMI. it's giving "how are we doing right now" 💀
• clk_rate — the functional clock rate of the SMI. default is SMI_MAX_CLOCK_FREQ, so that's the number you get unless someone changes it 🏃‍♀️
• lock — the lock that prevents parallel access of the SMI. one at a time, bestie, we take turns 🙈
• io_base — base address for the registers of the SMI. the address of the address-y stuff 📍
• pdev — the platform device. the actual device she belongs to 🎀
• cmd_complete — the queue you wait on for command completion of the NOR-flash. it's literally "wait here until the flash is done" energy ⏳
• num_flashes — the number of flashes actually present on the board. not the theoretical max, the real ones 🌈
• flash — separate structure for each Serial NOR-flash attached to the SMI. yes it's an array: struct spear_snor_flash *flash[MAX_NUM_FLASH_CHIP], one slot per chip 🍓

---

⭐ SEE ALSO ⭐

go read the kernel file ./drivers/mtd/devices/spear_smi.c (that's the source of truth, fr fr), plus these sibling pages — collect them all like pokémon:

• struct spear_snor_flash(9)
• spear_smi_read_sr(9)
• spear_smi_wait_till_ready(9)
• spear_smi_int_handler(9)
• spear_smi_hw_init(9)
• get_flash_index(9)
• spear_smi_write_enable(9)
• spear_smi_erase_sector(9)
• spear_mtd_erase(9)
• spear_mtd_read(9)
• spear_mtd_write(9)
• spear_smi_probe_flash(9)
• spear_smi_probe(9)
• spear_smi_remove(9)

ngl, that's a lot of friends. hydrate before you start clicking through them 💧

---

okay that's the whole page, you ate that 🍽️ this little beauty comes from ./drivers/mtd/devices, dated October 2026 — and yes the manual name up top was Kernel API Manual, told you at the start, i promised and i delivered 🫡💖 go read the real source and slay ✨🧚‍♀️