STRUCT FSL_SSI(9)

💅 struct fsl_ssi(9) 💅

okay so bestie, welcome to the Kernel API Manual — this is the whole entire glow-up tour of struct fsl_ssi, which is literally just per-SSI private data and honestly? it's giving main character energy. every field, no skips, no cap. 🎀

✨ SYNOPSIS ✨

like, here's the whole struct, exactly as it lives, don't touch a single character:

struct fsl_ssi {
    struct regmap *regs;
    int irq;
    struct snd_soc_dai_driver cpu_dai_drv;
    unsigned int dai_fmt;
    u8 streams;
    u8 i2s_net;
    bool synchronous;
    bool use_dma;
    bool use_dual_fifo;
    bool use_dyna_fifo;
    bool has_ipg_clk_name;
    unsigned int fifo_depth;
    unsigned int slot_width;
    unsigned int slots;
    struct fsl_ssi_regvals regvals[2];
    struct clk *clk;
    struct clk *baudclk;
    unsigned int baudclk_streams;
    u32 regcache_sfcsr;
    u32 regcache_sacnt;
    struct snd_dmaengine_dai_dma_data dma_params_tx;
    struct snd_dmaengine_dai_dma_data dma_params_rx;
    dma_addr_t ssi_phys;
    struct imx_pcm_fiq_params fiq_params;
    struct platform_device *card_pdev;
    char card_name[32];
    u32 card_idx;
    struct fsl_ssi_dbg dbg_stats;
    const struct fsl_ssi_soc_data *soc;
    struct device *dev;
    u32 fifo_watermark;
    u32 dma_maxburst;
    struct mutex ac97_reg_lock;
    struct sdma_peripheral_config audio_config[2];
 };

🦋 Members 🦋

bestie, buckle up, because there's a lot of them and every single one is iconic in its own way:

• regs — Pointer to the regmap registers 💫
• irq — IRQ of this SSI
• cpu_dai_drv — CPU DAI driver for this device
• dai_fmt — DAI configuration this device is currently used with
• streams — Mask of current active streams: BIT(TX) and BIT(RX) 👑
• i2s_net — I2S and Network mode configurations of SCR register (this is the initial settings based on the DAI format)
• synchronous — Use synchronous mode — both of TX and RX use STCK and SFCK
• use_dma — DMA is used or FIQ with stream filter
• use_dual_fifo — DMA with support for dual FIFO mode
• use_dyna_fifo — DMA with support for multi FIFO script
• has_ipg_clk_name — If "ipg" is in the clock name list of device tree 🌸
• fifo_depth — Depth of the SSI FIFOs
• slot_width — Width of each DAI slot
• slots — Number of slots
• regvals — Specific RX/TX register settings
• clk — Clock source to access register
• baudclk — Clock source to generate bit and frame-sync clocks
• baudclk_streams — Active streams that are using baudclk
• regcache_sfcsr — Cache sfcsr register value during suspend and resume 😴
• regcache_sacnt — Cache sacnt register value during suspend and resume
• dma_params_tx — DMA transmit parameters
• dma_params_rx — DMA receive parameters
• ssi_phys — physical address of the SSI registers
• fiq_params — FIQ stream filtering parameters
• card_pdev — Platform_device pointer to register a sound card for PowerPC or to register a CODEC platform device for AC97
• card_name — Platform_device name to register a sound card for PowerPC or to register a CODEC platform device for AC97
• card_idx — The index of SSI to register a sound card for PowerPC or to register a CODEC platform device for AC97
• dbg_stats — Debugging statistics 🔍
• soc — SoC specific data
• dev — Pointer to pdev->dev
• fifo_watermark — The FIFO watermark setting. Notifies DMA when there are fifo_watermark or fewer words in TX fifo or fifo_watermark or more empty words in RX fifo. 🌊
• dma_maxburst — Max number of words to transfer in one go. So far, this is always the same as fifo_watermark.
• ac97_reg_lock — Mutex lock to serialize AC97 register access operations 🔒
• audio_config — configure for dma multi fifo script

ngl bestie, that dma_maxburst one is currently always the same as fifo_watermark — that's the docs talking, not me guessing. pls don't come for me. 🙈

💜 SEE ALSO 💜

Kernel file ./sound/soc/fsl/fsl_ssi.c, plus the whole friend group: FSLSSI_I2S_FORMATS(9), fsl_ssi_isr(9), fsl_ssi_config_enable(9), fsl_ssi_config_disable(9), fsl_ssi_setup_regvals(9), fsl_ssi_set_bclk(9), fsl_ssi_hw_params(9), fsl_ssi_set_dai_fmt(9), fsl_ssi_set_dai_tdm_slot(9), fsl_ssi_trigger(9), fsl_ssi_hw_init(9), fsl_ssi_hw_clean(9) — go read them, they ate. 🔥

🫶 that's the whole page babes! it came from the source tree at ./sound/soc/fsl, dated October 2026, and it's literally titled struct fsl_ssi(9) — slay, periodt. 💅✨