STRUCT IWL_TOF_RANGE_REQ_CMD_V9(9)

💅 struct iwl_tof_range_req_cmd_v9(9) — Kernel API Manual, but make it make sense

okay bestie, so this is a page from the Kernel API Manual, and today's main character is struct iwl_tof_range_req_cmd_v9. Welcome to the group chat 🎀

---

✨ NAME ✨

struct iwl_tof_range_req_cmd_v9 — literally the start measurement cmd. that's it. that's the vibe. no cap 🔥

---

🌸 SYNOPSIS 🌸

here's the whole struct, copied exactly, character for character, because I would never do you dirty like that 💖

struct iwl_tof_range_req_cmd_v9 {
    __le32 initiator_flags;
    u8 request_id;
    u8 num_of_ap;
    u8 range_req_bssid[ETH_ALEN];
    u8 macaddr_mask[ETH_ALEN];
    u8 macaddr_template[ETH_ALEN];
    __le32 req_timeout_ms;
    __le32 tsf_mac_id;
    struct iwl_tof_range_req_ap_entry_v6 ap[IWL_TOF_MAX_APS];
};

---

🦋 Members 🦋

okay so every single field, one by one, because we do not skip. we simply do not ✨

• initiator_flags — see the flags in iwl_tof_initiator_flags. that's where the drama lives 👑
• request_id — a Token, incremented per request. the same Token gets sent back in the range response, so like… it's an ID bracelet but for packets. iconic 💅
• num_of_ap — number of APs to measure. and listen, it's an error if it's > IWL_TOF_MAX_APS. respect the limit or catch these hands 🙈
• range_req_bssid — the ranging request BSSID. yeah. that one 🫶
• macaddr_mask — bits set to 0 shall be copied from the MAC address template. bits set to 1 shall be randomized by the UMAC. so it's giving "half template, half chaos" and honestly? obsessed 🌈
• macaddr_template — the MAC address template used for the non-randomized bits. the stable friend in this friendship 🍓
• req_timeout_ms — requested timeout of the response, in units of milliseconds. this is the session time for completing the measurement. so like, the deadline. the "finish this by 8pm or I'm leaving the mall" energy ⏰
• tsf_mac_id — reports the measurement start time for each ap in terms of the TSF of this mac id. set it to 0xff to disable TSF reporting. 0xff is the off switch, and that's the whole bit 💀
• ap — per-AP request data, see struct iwl_tof_range_req_ap_entry_v2. ^^ go read that one next, bestie, it's a whole other page 🌸

---

🧚 SEE ALSO 🧚

this list is LONG and honestly she ate, so here's every single reference, all of them, in order, no crumbs left behind 🔥

• Kernel file ./drivers/net/wireless/intel/iwlwifi/fw/api/location.h
• enum iwl_location_subcmd_ids(9)
• enum iwl_location_frame_format(9)
• enum iwl_location_bw(9)
• enum iwl_location_format_bw(9)
• struct iwl_tof_config_cmd(9)
• enum iwl_tof_bandwidth(9)
• enum iwl_tof_responder_cmd_valid_field(9)
• enum iwl_tof_responder_cfg_flags(9)
• struct iwl_tof_responder_config_cmd_v6(9)
• struct iwl_tof_responder_config_cmd_v7(9)
• struct iwl_tof_responder_config_cmd_v8(9)
• struct iwl_tof_responder_config_cmd_v9(9)
• struct iwl_tof_responder_config_cmd(9)
• struct iwl_tof_responder_dyn_config_cmd_v2(9)
• enum iwl_responder_dyn_cfg_valid_flags(9)
• struct iwl_tof_responder_dyn_config_cmd(9)
• struct iwl_tof_range_req_ext_cmd(9)
• enum iwl_tof_location_query(9)
• enum iwl_initiator_ap_flags(9)
• struct iwl_tof_range_req_ap_entry_v3(9)
• struct iwl_tof_range_req_ap_entry_v4(9)
• enum iwl_location_cipher(9)
• struct iwl_tof_range_req_ap_entry_v6(9)
• struct iwl_tof_range_req_ap_entry_v7(9)
• struct iwl_tof_range_req_ap_entry_v8(9)
• struct iwl_tof_range_req_ap_entry_v9(9)
• struct iwl_tof_range_req_ap_entry(9)
• enum iwl_tof_response_mode(9)
• enum iwl_tof_initiator_flags(9)
• struct iwl_tof_range_req_cmd_v5(9)
• struct iwl_tof_range_req_cmd_v7(9)
• struct iwl_tof_range_req_cmd_v8(9)
• struct iwl_tof_range_req_cmd_v11(9)
• struct iwl_tof_range_req_cmd_v12(9)
• struct iwl_tof_range_req_cmd_v13(9)
• struct iwl_tof_range_req_cmd(9)
• enum iwl_tof_entry_status(9)
• struct iwl_tof_range_rsp_ap_entry_ntfy_v3(9)
• struct iwl_tof_range_rsp_ap_entry_ntfy_v4(9)
• struct iwl_tof_range_rsp_ap_entry_ntfy_v5(9)
• struct iwl_tof_range_rsp_ap_entry_ntfy_v7(9)
• struct iwl_tof_range_rsp_ap_entry_ntfy(9)
• enum iwl_tof_response_status(9)
• struct iwl_tof_range_rsp_ntfy_v5(9)
• struct iwl_tof_range_rsp_ntfy_v6(9)
• struct iwl_tof_range_rsp_ntfy_v7(9)
• struct iwl_tof_range_rsp_ntfy_v9(9)
• struct iwl_tof_range_rsp_ntfy(9)
• struct iwl_tof_mcsi_notif(9)
• struct iwl_tof_range_abort_cmd(9)
• struct iwl_ftm_responder_stats(9)

---

and that's the page, bestie 🫶 the source lives at ./drivers/net/wireless/intel/i... and this whole thing is dated October 2026, so like… from the future?? anyway, struct iwl_tof_range_req_cmd_v9(9), sign-off complete, mwah 💖🎀💜