STRUCT PANTHOR_FW_GLOBAL_IFACE(9)

💖 NAME 💖

struct panthor_fw_global_iface — the Firmware global interface, bestie ✨ (this is a page from the Kernel API Manual, and yes we are gonna get through it together 🫶)

---

🌸 SYNOPSIS 🌸

okay so here's the whole struct, no cap, every field exactly as it is:

struct panthor_fw_global_iface {
    spinlock_t lock;
    const struct panthor_fw_global_control_iface *control;
    struct panthor_fw_global_input_iface *input;
    const struct panthor_fw_global_output_iface *output;
 };

---

✨ Members ✨

• lock — this is the lock that protects access to the panthor_fw_global_input_iface::req field 🔒

it's needed so we can update the req field concurrently from the interrupt handler and the scheduler/FW management logic. like, two places touching it at once? we simply cannot let that happen bestie 💅

TODO: ideally we'd want to use a cmpxchg to update the req, but FW interface sections are mapped uncached/write-combined right now 😭 and using cmpxchg on such mappings leads to SError faults. revisit when we have 'SHARED' GPU mappings hooked up 👀

• control — Command stream group slot control interface 🎀

used to expose global FW properties.

this interface is read-only 🔒 (iconic, honestly)

• input — Global input interface 📥

used for host updates/events.

• output — Global output interface 📤

used for FW updates/events.

this interface is read-only 🔒 (again, hands off bestie)

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/panthor/panthor_fw.h struct panthor_fw_cs_iface(9)
• struct panthor_fw_csg_iface(9)
• panthor_fw_toggle_reqs(9)
• panthor_fw_update_reqs(9)

---

that's the whole page, you ate that 💅✨ this lil masterpiece lives in ./drivers/gpu/drm/panthor, dated October 2026, and it's literally titled struct panth...global_iface(9) — go off, king 👑💖