STRUCT IWL_RX_MPDU_DESC_V3(9)

✨ struct iwl_rx_mpdu_desc_v3 — RX MPDU descriptor ✨

okay bestie, sit down, hydrate, and let's talk about struct iwl_rx_mpdu_desc_v3 💅 this is straight out of the Kernel API Manual (section 9, iwlwifi country 🦋) and it's the RX MPDU descriptor — it's giving "the little receipt the hardware hands you after a frame arrives" energy. no cap.

---

🌸 SYNOPSIS 🌸

struct iwl_rx_mpdu_desc_v3 {
    union {
      __le32 filter_match;
      __le32 phy_data3;
    };
    union {
      __le32 rss_hash;
      __le32 phy_data2;
    };
    __le32 partial_hash;
    __be16 raw_xsum;
    __le16 reserved_xsum;
    __le32 rate_n_flags;
    u8 energy_a;
    u8 energy_b;
    u8 channel;
    u8 mac_context;
    __le32 gp2_on_air_rise;
    union {
      __le64 tsf_on_air_rise;
      struct {
        __le32 phy_data0;
        __le32 phy_data1;
      };
    };
    __le32 phy_data5;
    __le32 reserved[1];
 };

like, look at all those anonymous unions — someone was absolutely showing off and honestly? slay 🎀

---

👑 Members 👑

🫶 the unnamed union (filter side)

• {unnamed_union} — anonymous, mysterious, doesn't need a name, main character energy honestly. it's anonymous.
• filter_match — filter match value ✨
• phy_data3 — depends on info type (see phy_data1) — yes bestie it's pointing you at itself in advance, iykyk.

🦋 the unnamed union (hash side)

• {unnamed_union} — also anonymous. two unnamed unions in one struct and not a single name between them, we love a lowkey icon.
• rss_hash — RSS hash value 🔥
• phy_data2 — depends on info type (see phy_data1) — same deal.

💜 the middle bits

• partial_hash — 31:0 ip/tcp header hash w/o some fields (such as IP SRC addr). so it's a hash, but it ghosted a few fields, no big deal 💀
• raw_xsum — raw xsum value
• reserved_xsum — reserved high bits in the raw checksum (don't touch, it's reserved, hands off 🙈)
• rate_n_flags — RX rate/flags encoding ⭐
• energy_a — energy chain A 🌈
• energy_b — energy chain B 🌈
• channel — channel number
• mac_context — MAC context mask 🎀
• gp2_on_air_rise — GP2 timer value on air rise (INA)

🧚 the on-air-rise union, part two electric boogaloo

• {unnamed_union} — anonymous again. three for three, obsessed.
• tsf_on_air_rise — TSF value on air rise (INA), and heads up: only valid if IWL_RX_MPDU_PHY_TSF_OVERLOAD isn't set ⚠️
• {unnamed_struct} — anonymous struct hanging out inside the union, living its best life.

💖 the nested struct squad

• phy_data0 — depends on info_type, see phy_data1
• phy_data1 — valid only if IWL_RX_MPDU_PHY_TSF_OVERLOAD is set, see enum iwl_rx_phy_data1. read that twice bestie, the conditional is load-bearing 🫶

🌟 the stragglers

• phy_data5 — valid only if IWL_RX_MPDU_PHY_TSF_OVERLOAD is set, see enum iwl_rx_phy_data5.
• reserved — reserved. it's reserved. that's the whole thing. periodt 💅

ngl there's a lot of "depends on info type" and "valid only if IWL_RX_MPDU_PHY_TSF_OVERLOAD is set" going on here — that's not me being vague, that's genuinely the contract. check the flag before you trust those fields, fr fr. 😭

---

🔥 SEE ALSO 🔥

all the lore, all the siblings — go read these, they're literally in the kernel file ./drivers/net/wireless/intel/iwlwifi/fw/api/rx.h:

• struct iwl_rx_phy_info(9)
• struct iwl_rx_mpdu_res_start(9)
• enum iwl_rx_phy_flags(9)
• enum iwl_mvm_rx_status(9)
• struct iwl_rx_mpdu_desc_v1(9)
• struct iwl_rx_mpdu_desc(9)
• struct iwl_rx_no_data(9)
• struct iwl_rx_no_data_ver_3(9)
• enum iwl_bar_frame_release_sta_tid(9)
• enum iwl_bar_frame_release_ba_info(9)
• struct iwl_bar_frame_release(9)
• struct iwl_rss_config_cmd(9)
• struct iwl_rxq_sync_cmd(9)
• struct iwl_rxq_sync_notification(9)
• enum iwl_mvm_pm_event(9)
• struct iwl_mvm_pm_state_notification(9)
• struct iwl_ba_window_status_notif(9)
• struct iwl_rfh_queue_data(9)
• struct iwl_rfh_queue_config(9)
• struct iwl_beacon_filter_notif_v1(9)
• struct iwl_beacon_filter_notif(9)
• struct iwl_rx_phy_air_sniffer_ntfy(9)

like, that's a whole friend group 💖

---

🎀 cute sign-off 🎀

that's the whole page, bestie — this one came from ./drivers/net/wireless/intel/i... (the path, she's long), dated October 2026, sitting pretty in the Kernel API Manual. go forth, parse those descriptors, and remember: reserved means reserved 💅✨🦋

bye bestie, drink some water 🫶