STRUCT IL_CFG(9)

💅 struct il_cfg(9) — Kernel API Manual ✨

okay so this is a page from the Kernel API Manual and it's all about struct il_cfg(9) — the config struct for the iwlegacy driver. bestie, it's a big one, but we're gonna get through it together 🫶

---

🌸 NAME 🌸

struct il_cfg —

and that's it. that's the whole NAME section. the description after the dash is literally empty, no cap 💀 so consider this your official vibe check: the name is struct il_cfg, and the manpage authors left the one-liner blank. iconic of them honestly.

---

✨ SYNOPSIS ✨

here's the whole struct, character for character, do not touch:

struct il_cfg {
    const char *name;
    const char *fw_name_pre;
    const unsigned int ucode_api_max;
    const unsigned int ucode_api_min;
    u8 valid_tx_ant;
    u8 valid_rx_ant;
    unsigned int sku;
    u16 eeprom_ver;
    u16 eeprom_calib_ver;
    const struct il_mod_params *mod_params;
    struct il_base_params *base_params;
    u8 scan_rx_antennas[NUM_NL80211_BANDS];
    enum il_led_mode led_mode;
    int eeprom_size;
    int num_of_queues;
    int num_of_ampdu_queues;
    u32 pll_cfg_val;
    bool set_l0s;
    bool use_bsm;
    u16 led_compensation;
    int chain_noise_num_beacons;
    unsigned int wd_timeout;
    bool temperature_kelvin;
    const bool ucode_tracing;
    const bool sensitivity_calib_by_driver;
    const bool chain_noise_calib_by_driver;
    const u32 regulatory_bands[7];
 };

look at all those fields. she's got range 💅

---

🎀 Members 🎀

• fw_name_pre — the firmware filename prefix. this is a "before" picture, not the whole name, okay? the api version and the extension (.ucode) get added onto it before the file is loaded from disk. so the filename ends up built like fw_name_pre<api>.ucode — prefix, then api, then .ucode. slay 💖
• ucode_api_max — the highest version of the uCode API that the driver supports. the ceiling. the limit. the "don't even try it" line 🔥
• ucode_api_min — the lowest version of the uCode API that the driver supports. the floor 🧚
• led_mode — here's the mapping, memorize it: 0=blinking, 1=On(RF On)/Off(RF Off). that's it, that's the whole scale ⭐

---

🦋 Description 🦋

so the whole point here: we enable the driver to be backward compatible wrt API version. the driver says which APIs it supports — ucode_api_max is the highest, ucode_api_min is the lowest — and firmware will only be loaded if it has a supported API version. no supported version? no firmware. bye 🙈

once it does load, the firmware's API version gets stored in il_priv, which is the whole reason the driver can make runtime changes based on which firmware version is actually in use. main character energy for il_priv honestly 👑

for example, lowkey this is the whole flow:

if (IL_UCODE_API(il->ucode_ver) >= 2) { Driver interacts with Firmware API version >= 2.  } else { Driver interacts with Firmware API version 1.  }

(yes that's how it's formatted in the original, i'm not touching it, it's perfect as is 💀)

and the ideal usage of this whole infrastructure? treat a new ucode API release as a new hardware revision. like, that's the dream. that is, through utilizing the il_hcmd_utils_ops etc., we accommodate different command structures and flows between hardware versions as well as their API versions. so the hardware version and the API version both get a seat at the table 🫶

---

💜 SEE ALSO 💜

first up, the actual file this lives in: Kernel file ./drivers/net/wireless/intel/iwlegacy/common.h

and then the whole friend group, all of them, in order, no one gets left out:

• struct il_device_cmd(9)
• struct il_device_cmd_huge(9)
• struct il_rx_queue(9)
• struct il_ht_agg(9)
• struct il_vif_priv(9)
• struct il_hw_params(9)
• il_clear_driver_stations(9)
• il_sta_id_or_broadcast(9)
• il_queue_inc_wrap(9)
• il_queue_dec_wrap(9)
• il_beacon_time_mask_low(9)
• il_beacon_time_mask_high(9)
• struct il_rb_status(9)
• struct il_tfd_tb(9)
• struct il_tfd(9)
• struct il_rate_scale_data(9)
• struct il_scale_tbl_info(9)
• struct il_lq_sta(9)
• il3945_rate_scale_init(9)

---

🌈 sign-off 🌈

this page came to you from ./drivers/net/wireless/intel/i... (the path got cut off, we don't know the rest, that's just how the footer is, don't come for me 😭) and it's dated October 2026. go forth and configure your structs, bestie. periodt 💅✨🎀