skl_pcode_request(9)

💖 skl_pcode_request 💖

okay so this is a page from the Kernel API Manual — yes bestie, the Kernel API Manual, we're in the big leagues now — and it's all about skl_pcode_request, which is literally the function that "sends a PCODE request until acknowledgment". like it just keeps knocking until somebody answers the door 🚪✨

---

✨ SYNOPSIS ✨

int skl_pcode_request (struct intel_uncore *uncore , u32 mbox , u32
       request , u32 reply_mask , u32 reply , int timeout_base_ms );

that's the whole vibe, no cap. 🫶

---

🎀 ARGUMENTS 🎀

• uncore — the uncore. that's it, that's the description. iconic minimalism honestly 💅
• mbox — the PCODE mailbox ID that this request is being sent to 📬
• request — the request ID, like the little name tag on your request 🏷️
• reply_mask — the mask used to check whether the request got acknowledged 🔍
• reply — the value used to check whether the request got acknowledged ✅
• timeout_base_ms — the timeout for polling with preemption enabled ⏰

---

🌸 DESCRIPTION 🌸

so the way this works: it keeps resending the request to mbox until one of three things happens — PCODE acknowledges it, PCODE reports an error, or an overall timeout of timeout_base_ms+50 ms expires. 😭

the request counts as acknowledged once the PCODE reply dword equals reply after applying reply_mask. got it? mask first, then compare. that's the whole check, fr fr. ✨

the polling happens in two phases, and this part matters:

1. first it polls with preemption enabled for timeout_base_ms 🧚
2. if that times out, it goes for another 50 ms with preemption disabled 💀

and what do you get back?

• returns 0 on success 🎉
• returns -ETIMEDOUT in case of a timeout ⏳
• returns <0 in case of some other error as reported by PCODE 🚨

no cap, the two-phase polling is real — the first round keeps preemption on, and only the extra 50 ms goes preemption-off. don't mix those up bestie 🫶

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/i915/intel_pcode.c — go read it, iykyk 📖🔥

---

and that's the page!! 🌈 source and version vibes come courtesy of ./drivers/gpu/drm/i915, dated October 2026, and this whole thing is skl_pcode_request(9) — slay, bye bestie 💜🦋🎀