STRUCT CS_DSP_CLIENT_OPS(9)

💅 struct cs_dsp_client_ops(9) — client callbacks

okay so bestie, welcome to struct cs_dsp_client_ops(9) from the Kernel API Manual (section 9, yes, the kernel one 🐧). this is the little bundle of function pointers that lets a cs_dsp client get pinged when stuff happens — and the whole point is that it can do its thing atomically ✨. let's get into it.

🌸 SYNOPSIS

struct cs_dsp_client_ops {
    int (*control_add)(struct cs_dsp_coeff_ctl *ctl);
    void (*control_remove)(struct cs_dsp_coeff_ctl *ctl);
    int (*pre_run)(struct cs_dsp *dsp);
    int (*post_run)(struct cs_dsp *dsp);
    void (*pre_stop)(struct cs_dsp *dsp);
    void (*post_stop)(struct cs_dsp *dsp);
    void (*watchdog_expired)(struct cs_dsp *dsp);
 };

like, exactly that. no cap, copy it character for character if you're typing it out 🫶

🎀 Members

• control_add — int (*control_add)(struct cs_dsp_coeff_ctl *ctl); — called under the pwr_lock when a control is created 👑
• control_remove — void (*control_remove)(struct cs_dsp_coeff_ctl *ctl); — called under the pwr_lock when a control is destroyed 💀
• pre_run — int (*pre_run)(struct cs_dsp *dsp); — called under the pwr_lock by cs_dsp_run before the core is started 🏁
• post_run — int (*post_run)(struct cs_dsp *dsp); — called under the pwr_lock by cs_dsp_run after the core is started 🔥
• pre_stop — void (*pre_stop)(struct cs_dsp *dsp); — called under the pwr_lock by cs_dsp_stop before the core is stopped 🛑
• post_stop — void (*post_stop)(struct cs_dsp *dsp); — called under the pwr_lock by cs_dsp_stop after the core is stopped 🌙
• watchdog_expired — void (*watchdog_expired)(struct cs_dsp *dsp); — called when a watchdog expiry is detected ⏰😭

bestie pls note: all of the pwr_lock ones are called while holding that lock. that's the whole vibe — atomic, no racing, no chaos. act accordingly 💅

🦋 Description

these callbacks give the cs_dsp client an opportunity to respond to events, or to perform actions atomically 💖. that's literally it, that's the whole flex. it's giving "here's your moment, do it safely" energy.

✨ SEE ALSO

kernel file ./include/linux/firmware/cirrus/cs_dsp.h, plus: struct cs_dsp_region(9), struct cs_dsp_alg_region(9), struct cs_dsp_coeff_ctl(9), struct cs_dsp(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) — go read them, iykyk 📚🌈

mwah 💋 this page lives in ./include/linux/firmware/cirrus, dated October 2026, and it's struct cs_dsp_client_ops(9) — go slay your firmware, bestie 🧚⭐