ish_fw_xfer_direct_dma(9)

✨ ish_fw_xfer_direct_dma(9) ✨

okay bestie, welcome to the Kernel API Manual 💅 today's main character is ish_fw_xfer_direct_dma(9) and honestly? she's kind of a big deal. 🎀

---

🌸 SYNOPSIS 🌸

int ish_fw_xfer_direct_dma (struct ishtp_cl_data *client_data ,
                            const struct firmware *fw ,
                            const struct shim_fw_info fw_info );

like, that's the whole signature. no cap. 🫶

---

🦋 ARGUMENTS 🦋

• client_data — the client data instance, aka her whole personality/lore. it's a struct ishtp_cl_data *, and yes you hand over the pointer. 💖
• fw — pointer to the firmware data struct chilling in host memory. think of it as the firmware's home address in RAM. const struct firmware *. 🏠
• fw_info — the loader firmware properties. she's a const struct shim_fw_info, passed straight up (not a pointer, not a vibe, just the struct). ✨

---

🔥 DESCRIPTION 🔥

so listen — host firmware load is a unique case, like genuinely one of a kind, because we need to download a large firmware image (200+ Kb, not a typo, that's a chunky girl 🍓). this function implements direct DMA transfer in the kernel and in the ISH firmware. the way that works is: it lets us overcome the ISH-TP 4 Kb limit 😭 and lets us DMA directly to ISH UMA at location of choice — yes, location of choice, she picks where she's sitting, main character energy fr fr. 👑

⚠️ heads up bestie: this function depends on corresponding support in the ISH firmware. no support = no slay. it's giving "you can't sit with us" 💀

---

⭐ RETURN ⭐

• 0 — success 🎉 ate and left no crumbs
• negative error code — failure 😭 something went wrong, check the vibes

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/hid/intel-ish-hid/ishtp-fw-loader.c — the whole friend group lives here 🫶
• enum ish_loader_commands(9)
• struct loader_msg_hdr(9)
• struct response_info(9)
• get_firmware_variant(9)
• loader_cl_send(9)
• process_recv(9)
• loader_cl_event_cb(9)
• ish_query_loader_prop(9)
• ish_fw_xfer_ishtp(9)
• ish_fw_start(9)
• load_fw_from_host(9)
• loader_init(9)
• loader_ishtp_cl_probe(9)
• loader_ishtp_cl_remove(9)
• loader_ishtp_cl_reset(9)

---

okay that's the whole page, ily, go DMA something directly 💜

— brought to you from ./drivers/hid/intel-ish-hid, dated October 2026, manual page ish_fw_xfer_direct_dma(9), and yes the date is in the future, we don't question it, periodt 💅✨