STRUCT SOF_IPC4_FW_DATA(9)

🌸 struct sof_ipc4_fw_data(9) 🌸

Okay bestie, welcome to the Kernel API Manual page for struct sof_ipc4_fw_data — literally the struct for IPC4-specific data. 🫶 This is the whole vibe: one struct, a bunch of fields, and every single one is listed below. No skipping, no cap.

✨ NAME ✨

struct sof_ipc4_fw_data — IPC4-specific data 💅

🦋 SYNOPSIS 🦋

struct sof_ipc4_fw_data {
    u32 manifest_fw_hdr_offset;
    struct xarray fw_lib_xa;
    void *nhlt;
    enum sof_ipc4_mtrace_type mtrace_type;
    u32 mtrace_log_bytes;
    int num_playback_streams;
    int num_capture_streams;
    int max_num_pipelines;
    u32 max_libs_count;
    bool fw_context_save;
    bool libraries_restored;
    int (*load_library)(struct snd_sof_dev *sdev, struct sof_ipc4_fw_library *fw_lib, bool reload);
    void (*intel_configure_mic_privacy)(struct snd_sof_dev *sdev, struct sof_ipc4_intel_mic_privacy_cap *caps);
    struct mutex pipeline_state_mutex;
};

🧚 Members 🧚

• manifest_fw_hdr_offset — the FW header offset in the manifest. ✨
• fw_lib_xa — XArray for firmware libraries, including basefw (ID = 0). It’s used to store the FW libraries and to manage the unique IDs of the libraries. 🗂️
• nhlt — the NHLT table, either from the BIOS or the topology manifest. 🌿
• mtrace_type — the mtrace type supported on the booted platform. 👑
• mtrace_log_bytes — log bytes as reported by the firmware via fw_config reply. 📝
• num_playback_streams — max number of playback DMAs, needed for CHAIN_DMA offset. 🔥
• num_capture_streams — max number of capture DMAs. 🎀
• max_num_pipelines — max number of pipelines. 🧵
• max_libs_count — Maximum number of libraries support by the FW including the base firmware. 💖
• fw_context_save — Firmware supports full context save and restore. 💾
• libraries_restored — The libraries have been retained during firmware boot. 🌈
• load_library — Callback function for platform dependent library loading. 🫶
• intel_configure_mic_privacy — this field is in the struct synopsis, but the original Members list gives no description for it, so I’m not inventing lore. 🙈
• pipeline_state_mutex — Mutex to protect pipeline triggers, ref counts, states and deletion. 🔒

👀 SEE ALSO 👀

Kernel file ./sound/soc/sof/ipc4-priv.h plus struct sof_ipc4_fw_module(9) and struct sof_ipc4_fw_library(9). Go read those next, bestie — iykyk. 🦋

Bye bestie! This iconic page comes from source/version ./sound/soc/sof, dated October 2026 — Kernel API Manual energy, signing off. 💅✨🎀