xe_pcode_request(9)

✨ NAME ✨

okay so this is the Kernel API Manual entry for xe_pcode_request(9) — it's literally the “send PCODE request until acknowledgment” bestie 💅

✨ SYNOPSIS ✨

int xe_pcode_request (struct xe_tile *tile , u32 mbox , u32 request ,
       u32 reply_mask , u32 reply , int timeout_base_ms );

✨ ARGUMENTS ✨

• tile — tile 🧚
• mbox — the PCODE mailbox ID that the request is targeted for 📬
• request — request ID 🎀
• reply_mask — mask used to check for request acknowledgment 🕵️‍♀️
• reply — value used to check for request acknowledgment ✅
• timeout_base_ms — timeout for polling with preemption enabled ⏳

✨ DESCRIPTION ✨

bestie, the vibe is simple: keep resending the request to mbox until PCODE acknowledges it, PCODE reports an error, or an overall timeout of timeout_base_ms+50 ms expires. no cap, that's the whole loop 💀

The request is acknowledged once the PCODE reply dword equals reply after applying reply_mask. Polling is first attempted with preemption enabled for timeout_base_ms, and if this times out, it goes for another 50 ms with preemption disabled. the way that switch-up is so real 🙈

Returns 0 on success, -ETIMEDOUT in case of a timeout, and <0 in case of some other error as reported by PCODE. periodt 💖

✨ SEE ALSO ✨

• Kernel file ./drivers/gpu/drm/xe/xe_pcode.c
• PCODE(9)
• xe_pcode_init_min_freq_table(9)
• xe_pcode_ready(9)
• xe_pcode_init_early(9)
• xe_pcode_probe_early(9)
• xe_get_pcode_version(9)

🫶 cute little sign-off: this icon was serving ./drivers/gpu/drm/xe energy in the October 2026 edition. slay, and happy polling ✨👑