STRUCT CS_DSP(9)

💖 struct cs_dsp(9) 💖

okay so this page is from the Kernel API Manual, and it’s literally the configuration and state of a Cirrus Logic DSP. bestie, this struct is the main character energy for a whole DSP instance — every field is right here, no cap. 🎀

✨ NAME ✨

struct cs_dsp — Configuration and state of a Cirrus Logic DSP.

🌸 SYNOPSIS 🌸

       struct cs_dsp {
           const char *name;
           int rev;
           int num;
           int type;
           struct device *dev;
           struct regmap *regmap;
           const struct cs_dsp_ops *ops;
           const struct cs_dsp_client_ops *client_ops;
           unsigned int base;
           unsigned int base_sysinfo;
           unsigned int sysclk_reg;
           unsigned int sysclk_mask;
           unsigned int sysclk_shift;
           bool no_core_startstop;
           struct list_head alg_regions;
           const char *fw_name;
           unsigned int fw_id;
           unsigned int fw_id_version;
           unsigned int fw_vendor_id;
           const struct cs_dsp_region *mem;
           int num_mems;
           int wmfw_ver;
           bool booted;
           bool running;
           bool hibernating;
           struct list_head ctl_list;
           struct mutex pwr_lock;
           unsigned int lock_regions;
         #ifdef CONFIG_DEBUG_FS;
           struct dentry *debugfs_root;
           const char *wmfw_file_name;
           const char *bin_file_name;
         #endif;
        };

💅 Members 💅

okay bestie, field-by-field tea time. ☕

• name — the name of the DSP instance. literally its little nametag. 🏷️
• rev — revision of the DSP. ✨
• num — DSP instance number. which one is this? this number. 🔢
• type — type of DSP. 💫
• dev — driver model representation of the device. the device’s driver-model rep, slay. 🫶
• regmap — register map of the device. 🗺️
• ops — function pointers for internal callbacks. 🔧
• client_ops — function pointers for client callbacks. 🫱
• base — address of the DSP registers. 📍
• base_sysinfo — address of the sysinfo register (Halo only). halo only, bestie, don’t forget. 🪄
• sysclk_reg — address of the sysclk register (ADSP1 only). ADSP1 only! ⏰
• sysclk_mask — mask of frequency bits within sysclk register (ADSP1 only). ADSP1 only again. 🎚️
• sysclk_shift — shift of frequency bits within sysclk register (ADSP1 only). ADSP1 only, periodt. 🔀
• alg_regions — list of currently loaded algorithm regions. 🧠
• fw_name — name of the current firmware. 🏷️
• fw_id — ID of the current firmware, obtained from the wmfw. 🆔
• fw_id_version — version of the firmware, obtained from the wmfw. 🔢
• fw_vendor_id — vendor of the firmware, obtained from the wmfw. 🏢
• mem — DSP memory region descriptions. 💾
• num_mems — number of memory regions in this DSP. 🧮
• booted — flag indicating DSP has been configured. ✅
• running — flag indicating DSP is executing firmware. 🏃
• ctl_list — controls defined within the loaded DSP firmware. 🎛️
• pwr_lock — lock used to serialize accesses. 🔒
• lock_regions — enable MPU traps on specified memory regions. 🚨
• debugfs_root — debugfs directory for this DSP instance. 🪲
• wmfw_file_name — filename of the currently loaded firmware. 📄
• bin_file_name — filename of the currently loaded coefficients. 📦

🦋 SEE ALSO 🦋

Kernel file ./include/linux/firmware/cirrus/cs_dsp.h — plus these linked icons, bestie: struct cs_dsp_region(9), struct cs_dsp_alg_region(9), struct cs_dsp_coeff_ctl(9), struct cs_dsp_client_ops(9), struct cs_dsp_wseq(9), struct cs_dsp_chunk(9), cs_dsp_chunk(9), cs_dsp_chunk_end(9), cs_dsp_chunk_bytes(9), cs_dsp_chunk_valid_addr(9). no cap, read the whole squad. 🌈

okay that’s the whole page, bestie. source/version is ./include/linux/firmware/cirrus, date is October 2026, and yes this is the struct cs_dsp(9) page from the Kernel API Manual. go off, DSP icon. 💅✨