STRUCT SSAM_CONTROLLER(9)

💅 struct ssam_controller(9) — like, the Kernel API Manual bestie ✨

okay so this is a page from the Kernel API Manual, and we're talking about struct ssam_controller — the SSAM controller device itself. yes, the whole main character. let's get into it 🫶

---

🌸 NAME 🌸

struct ssam_controller — the SSAM controller device, no cap 💖

---

✨ SYNOPSIS ✨

here's the struct in all its glory, bestie — copy it exactly, don't @ me:

struct ssam_controller {
    struct kref kref;
    struct rw_semaphore lock;
    enum ssam_controller_state state;
    struct ssh_rtl rtl;
    struct ssam_cplt cplt;
    struct {
      struct ssh_seq_counter seq;
      struct ssh_rqid_counter rqid;
    } counter;
    struct {
      int num;
      bool wakeup_enabled;
    } irq;
    struct ssam_controller_caps caps;
 };

---

🎀 Members 🎀

• kref — the reference count of the controller. like a little tally of who's holding onto it 💅
• lock — the main lock for the controller, and it's lowkey the bouncer at the club: it guards all the state changes so nothing gets messy 🔥
• state — literally just the controller state. that's it, that's the vibe ✨
• rtl — the request transport layer for SSH I/O. the whole delivery pipeline, iconic 🦋
• cplt — the completion system for SSH/SSAM events and asynchronous requests. it's giving "we'll let you know when it's done" energy 🌸
• counter — safe SSH message ID counters. keeping the IDs cute and collision-free 💖
  • counter.seq — the sequence ID counter ✨
  • counter.rqid — the request ID counter ⭐
• irq — the wakeup IRQ resources 🎀
  • irq.num — the wakeup IRQ number, literally just the number 😌
  • irq.wakeup_enabled — whether wakeup by IRQ is enabled during suspend. yes/no, that's the whole thing 🙈
• caps — the controller device capabilities. what it can do, its whole skill set 👑

---

🌈 SEE ALSO 🌈

go look at the kernel file ./drivers/platform/surface/aggregator/controller.h for the real ones, plus all these besties:

• struct ssh_seq_counter(9)
• struct ssh_rqid_counter(9)
• struct ssam_nf_head(9)
• struct ssam_nf(9)
• struct ssam_event_item(9)
• struct ssam_event_queue(9)
• struct ssam_event_target(9)
• struct ssam_cplt(9)
• enum ssam_controller_state(9)
• struct ssam_controller_caps(9)
• ssam_controller_receive_buf(9)
• ssam_controller_write_wakeup(9)

---

fr fr, that's the whole page. every member, every field, nothing skipped 💀

k bye bestie, this came from ./drivers/platform/surface/agg..., dated October 2026, and it's the struct ssam_controller(9) page 💜🧚‍♀️