STRUCT SPI_NOR_CONTROLLER_OPS(9)

💅 struct spi_nor_controller_ops(9) 💅

okay so bestie, welcome to the Kernel API Manual — we're looking at struct spi_nor_controller_ops today and honestly? it's giving backstage-pass energy. 🎟️✨

🌸 NAME 🌸

struct spi_nor_controller_ops — the SPI NOR controller driver specific operations. literally the little hook table your controller driver fills in so the generic SPI NOR code knows how to actually talk to your hardware. no cap. 🦋

✨ SYNOPSIS ✨

struct spi_nor_controller_ops {
    int (*prepare)(struct spi_nor *nor);
    void (*unprepare)(struct spi_nor *nor);
    int (*read_reg)(struct spi_nor *nor, u8 opcode, u8 *buf, size_t len);
    int (*write_reg)(struct spi_nor *nor, u8 opcode, const u8 *buf, size_t len);
    ssize_t (*read)(struct spi_nor *nor, loff_t from, size_t len, u8 *buf);
    ssize_t (*write)(struct spi_nor *nor, loff_t to, size_t len, const u8 *buf);
    int (*erase)(struct spi_nor *nor, loff_t offs);
 };

it's just a struct full of function pointers and every single one of them gets a struct spi_nor *nor as its first argument. main character struct, honestly. 👑

🎀 Members 🎀

• prepare — [OPTIONAL] does some preparations for the read/write/erase/lock/unlock operations. like doing your skincare before the event, but for flash I/O. 🧖‍♀️
• unprepare — [OPTIONAL] does some post work after the read/write/erase/lock/unlock operations. the wind-down. the debrief. the "okay we're done here." 🫶
• read_reg — reads out the register. that's it, that's the whole vibe. 📖
• write_reg — writes data to the register. ✍️
• read — reads data from the SPI NOR. 📥
• write — writes data to the SPI NOR. 📤
• erase — erases a sector of the SPI NOR at the offset offs. and here's the tea ☕: if the driver doesn't provide this one, SPI NOR will send the erase opcode via write_reg instead. so it's lowkey optional but the fallback path is real. iykyk. 🔥

ngl bestie, prepare and unprepare are marked [OPTIONAL] — the rest are just... the job. no skipping. 💀

🦋 SEE ALSO 🦋

• Kernel file ./include/linux/mtd/spi-nor.h
• struct spi_nor_hwcaps(9)
• enum spi_nor_cmd_ext(9)
• struct spi_nor(9)
• spi_nor_scan(9)

and that's the whole page, bestie!! 🎉 go read spi-nor.h, it's literally right there. this lil gem lives in ./include/linux/mtd, dated October 2026, and the page itself is called struct spi_...ntroller_ops(9) (yes the ellipsis is canon, don't @ me). slay, bye! 💖🌈⭐