STRUCT IRIS_HFI_PACKET(9)

🦋 struct iris_hfi_packet(9) — Kernel API Manual 🦋

okay so bestie, we're in the Kernel API Manual today and the star of the show is struct iris_hfi_packet. keep up, this one's a whole vibe 💅

---

✨ NAME ✨

struct iris_hfi_packet — and honestly? the NAME line is literally just

struct iris_hfi_packet -

with nothing after the dash. no summary, no teaser, no nothing. mysterious main character energy fr fr 👑 (iykyk)

---

🎀 SYNOPSIS 🎀

here's the shape of it, copied exactly, no cap:

struct iris_hfi_packet {
    u32 size;
    u32 type;
    u32 flags;
    u32 payload_info;
    u32 port;
    u32 packet_id;
    u32 reserved[2];
    u32 payload[];
 };

---

💖 Members 💖

okay so let's go field by field, because every single one matters 🫶

• size — the size of the hfi_packet in bytes, and yes that includes the payload. don't forget the payload, bestie 😭
• type — one of the hfi_packet types below: HFI_CMD_*, HFI_PROP_*, HFI_ERROR_*, HFI_INFO_*, HFI_SYS_ERROR_*. pick your fighter 🌈
• flags — the hfi_packet flags, represented as bit masks. the host packet flags are "enum hfi_packet_host_flags" and the firmware packet flags are "enum hfi_packet_firmware_flags". two whole enum situations, slay ✨
• payload_info — payload information, indicated by "enum hfi_packet_payload_info". it's giving "the details about the payload" 💀
• port — the hfi_packet port type, indicated by "enum hfi_packet_port_type". heads up: this is a bitmask and may be applicable to multiple ports. so like, not just one port. many. iconic 🌸
• packet_id — the host hfi_packet contains a unique packet id. the firmware returns the host packet id in the response packet wherever applicable. and if it's not applicable? firmware sets it to zero. periodt 🔥
• reserved — reserved for future use. hands off, it's saving that space for later 🙈
• payload — a flexible array of payload having additional packet information. flexible = it does what it wants, lowkey 🦋

---

👀 SEE ALSO 👀

go touch some more kernel files, bestie:

• Kernel file ./drivers/media/platform/qcom/iris/iris_hfi_gen2_packet.h
• struct iris_hfi_header(9), struct iris_hfi_buffer(9)

---

ngl this whole header lives over at ./drivers/media/platform/qcom/... — the iris_hfi_gen2_packet.h one is your bestie for the full picture 🧚

and that's the tea, bestie 💜 this page came from that ./drivers/media/platform/qcom/... source and it's dated October 2026 — so yeah, future vibes only ⭐💅 bye!