STRUCT MEI_HW_OPS(9)

💅 struct mei_hw_ops(9) — the Kernel API Manual, bestie edition ✨

okay so picture this: it's struct mei_hw_ops, and it lives in the Kernel API Manual, and it is literally the blueprint for "hw specific ops" 🎀 like, this is the struct that tells your driver how to talk to its actual hardware. every hook you could possibly need, all in one adorable little bundle. iykyk.

---

✨ SYNOPSIS ✨

here's the whole thing, character for character, no cap:

struct mei_hw_ops {
    bool (*host_is_ready)(struct mei_device *dev);
    bool (*hw_is_ready)(struct mei_device *dev);
    int (*hw_reset)(struct mei_device *dev, bool enable);
    int (*hw_start)(struct mei_device *dev);
    int (*hw_config)(struct mei_device *dev);
    int (*fw_status)(struct mei_device *dev, struct mei_fw_status
*fw_sts);
    int (*trc_status)(struct mei_device *dev, u32 *trc);
    enum mei_pg_state (*pg_state)(struct mei_device *dev);
    bool (*pg_in_transition)(struct mei_device *dev);
    bool (*pg_is_enabled)(struct mei_device *dev);
    void (*intr_clear)(struct mei_device *dev);
    void (*intr_enable)(struct mei_device *dev);
    void (*intr_disable)(struct mei_device *dev);
    void (*synchronize_irq)(struct mei_device *dev);
    int (*hbuf_free_slots)(struct mei_device *dev);
    bool (*hbuf_is_ready)(struct mei_device *dev);
    u32 (*hbuf_depth)(const struct mei_device *dev);
    int (*write)(struct mei_device *dev, const void *hdr, size_t
hdr_len, const void *data, size_t data_len);
    int (*rdbuf_full_slots)(struct mei_device *dev);
    u32 (*read_hdr)(const struct mei_device *dev);
    int (*read)(struct mei_device *dev, unsigned char *buf, unsigned
long len);
 };

like, look at her. twenty-one function pointers. main character energy fr fr. 👑

---

🌸 Members 🌸

okay bestie, let's go through every single one, because we do NOT skip:

• host_is_ready — query for host readiness 🫶 (is the host awake and vibing?)
• hw_is_ready — query if hw is ready ✨ (is the hardware itself good to go?)
• hw_reset — reset hw 🔄
• hw_start — start hw after reset 🚀 (post-reset glow-up)
• hw_config — configure hw 🎀
• fw_status — get fw status registers 📋
• trc_status — get trc status register 🔍
• pg_state — power gating state of the device 💤
• pg_in_transition — is device now in pg transition 🦋 (mid-nap, basically)
• pg_is_enabled — is power gating enabled 🔋
• intr_clear — clear pending interrupts 🧹
• intr_enable — enable interrupts 🔔
• intr_disable — disable interrupts 🔕
• synchronize_irq — synchronize irqs 🎵 (everybody on beat, periodt)
• hbuf_free_slots — query for write buffer empty slots 🕳️
• hbuf_is_ready — query if write buffer is empty 🫙 (yes, it says "is ready" but the vibe is "is empty" — that's what the page says, don't come for me)
• hbuf_depth — query for write buffer depth 📏
• write — write a message to FW 📨 (send it, bestie)
• rdbuf_full_slots — query how many slots are filled 🧺
• read_hdr — get first 4 bytes (header) 🏷️
• read — read a buffer from the FW 📥

highkey obsessed with how tidy this list is. every op accounted for. 💜

---

🦋 SEE ALSO 🦋

if you wanna go deeper (and you do), the Kernel file to peek at is ./drivers/misc/mei/mei_dev.h, and these besties are all in the same orbit:

• enum mei_dev_pxp_mode(9)
• enum mei_dev_reset_to_pxp(9)
• enum mei_cb_file_ops(9)
• enum mei_cl_io_mode(9)
• struct mei_dma_dscr(9)
• struct mei_me_client(9)
• struct mei_cl_cb(9)
• struct mei_cl_vtag(9)
• struct mei_cl(9)
• enum mei_pg_event(9)
• enum mei_pg_state(9)
• struct mei_fw_version(9)
• enum mei_dev_kind(9)
• struct mei_device(9)
• mei_data2slots(9)
• mei_hbm2slots(9)
• mei_slots2data(9)
• mei_fw_status_str(9)
• kind_is_gsc(9)
• kind_is_gscfi(9)

---

ok that's the whole page, nothing skipped, nothing invented, all 21 members and all 20 SEE ALSO refs present and accounted for 💯

---

and that's a wrap, bestie!! 🎀 this legendary page lives under ./drivers/misc/mei, and it's dated October 2026 — so go forth, wire up your hw ops, and slay 💅✨🌈