ishtp_hbm_start_wait(9)

💅 ishtp_hbm_start_wait(9) — kernel API manual, but make it make sense

okay so bestie, we're in the kernel API manual ishtp_hbm_start_wait(9) and honestly? this one's short and sweet. no cap. let's get into it 🎀

---

✨ NAME ✨

ishtp_hbm_start_wait — literally just wait for the HBM start message. that's the whole gig. she waits. it's giving patient main character energy 🕰️

---

🌸 SYNOPSIS 🌸

int ishtp_hbm_start_wait (struct ishtp_device *dev );

ok so it takes one thing and it gives you back an int. cute, simple, iconic.

---

🦋 ARGUMENTS 🦋

• dev — the ISHTP device instance. like, the actual device you're doing this for. she needs to know which device we're waiting on, iykyk 💖

---

💜 DESCRIPTION 💜

Wait for the HBM start message from firmware.

that's it. that's the whole vibe. you call her, she waits for firmware to hit you with that HBM start message, and then she comes back and tells you how it went. no extra drama, no side quests. lowkey refreshing honestly 🙈✨

---

🔥 RETURN 🔥

• 0 — HBM start is/was received. slay. we ate. 👑
• timeout error — otherwise. she waited, firmware didn't show up, and now you get a timeout error. not her fault, she did her best 😭💀

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/hid/intel-ish-hid/ishtp/hbm.c — the source file, go read it, it's right there
• ishtp_hbm_fw_cl_allocate(9)
• ishtp_hbm_cl_hdr(9)
• ishtp_hbm_cl_addr_equal(9)
• ishtp_hbm_start_req(9)
• ishtp_hbm_enum_clients_req(9)
• ishtp_hbm_prop_req(9)
• ishtp_hbm_stop_req(9)
• ishtp_hbm_cl_flow_control_req(9)
• ishtp_hbm_cl_disconnect_req(9)
• ishtp_hbm_cl_disconnect_res(9)
• ishtp_hbm_cl_connect_req(9)
• ishtp_hbm_cl_connect_res(9)
• ishtp_hbm_fw_disconnect_req(9)
• ishtp_hbm_dma_xfer_ack(9)
• ishtp_hbm_dma_xfer(9)
• ishtp_hbm_dispatch(9)
• bh_hbm_work_fn(9)
• recv_hbm(9)
• ishtp_loader_recv_msg(9)
• recv_fixed_cl_msg(9)
• fix_cl_hdr(9)
• ishtp_send_suspend(9)
• ishtp_send_resume(9)
• ishtp_query_subscribers(9)

like, the whole hbm friend group fr fr 🫶 go say hi to all of them.

---

real talk though: she returns 0 when HBM start is/was received, and a timeout error if not. those are the only two outcomes, no in-between, no "maybe". periodt. 💅

---

that's the page!! source lives in ./drivers/hid/intel-ish-hid/ishtp, dated October 2026, and the manual is ishtp_hbm_start_wait(9). mwah, go forth and wait for your HBM start message bestie 🧚💖⭐