STRUCT OMAP_SSI_CONTROLLER(9)

💅 NAME 💅

struct omap_ssi_controller — the OMAP SSI controller data, aka the main character struct of this whole driver era ✨ (this is page struct omap_ssi_controller(9) from the Kernel API Manual, hi bestie 🫶)

🎀 SYNOPSIS 🎀

okay so here's literally the whole struct, look at her go 💖

struct omap_ssi_controller {
    struct device           *dev;
    void __iomem            *sys;
    void __iomem            *gdd;
    struct clk              *fck;
    unsigned int            gdd_irq;
    struct tasklet_struct   gdd_tasklet;
    struct gdd_trn          gdd_trn[SSI_MAX_GDD_LCH];
    spinlock_t lock;
    struct notifier_block   fck_nb;
    unsigned long           fck_rate;
    u32 loss_count;
    u32 max_speed;
    u32 gdd_gcr;
    int (*get_loss)(struct device *dev);
    struct omap_ssi_port    **port;
  #ifdef CONFIG_DEBUG_FS;
    struct dentry *dir;
  #endif;
 };

🌸 Members 🌸

time for the member-by-member vibe check, no skips, we're doing all of them 💅

• dev — the device associated to the controller (HSI controller), her whole identity ngl 🪪
• sys — SSI I/O base address 📍
• gdd — GDD I/O base address 📍
• fck — SSI functional clock ⏰
• gdd_irq — IRQ line for GDD ⚡
• gdd_tasklet — bottom half for DMA transfers 🧚‍♀️ (she does the cleanup work, lowkey iconic)
• gdd_trn — array of GDD transaction data for ongoing GDD transfers 🚚
• lock — lock to serialize access to GDD 🔒 (one at a time bestie, we're civilized)
• fck_nb — DVFS notfifier block 📢 (spelled exactly like this in the source, we do not gatekeep)
• fck_rate — clock rate 💨
• loss_count — to follow if we need to restore context or not 👀 (she's keeping receipts)
• max_speed — maximum TX speed (Kb/s) set by the clients 🏎️
• gdd_gcr — SSI GDD saved context 🗂️
• get_loss — pointer to omap_pm_get_dev_context_loss_count, if any 📞
• port — array of pointers of the ports of the controller 🚪✨
• dir — debugfs SSI root directory 📁 (guarded by CONFIG_DEBUG_FS, that's why she's all wrapped up in the #ifdef)

🦋 SEE ALSO 🦋

go read these next bestie, the lore runs deep, iykyk 📚

Kernel file ./drivers/hsi/controllers/omap_ssi.h and also struct omap_ssm_ctx(9), struct omap_ssi_port(9), struct gdd_trn(9) 💜

ok that's the whole tour, every single field accounted for, nothing dropped, periodt 👑

alright bestie, that was struct omap_ssi_controller(9) from the Kernel API Manual — brought to you by ./drivers/hsi/controllers, dated October 2026 🌈⭐ mwah, go touch some registers 💋