STRUCT SSAM_CONTROLLER_CAPS(9)

✨ struct ssam_controller_caps(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 today we're looking at struct ssam_controller_caps and honestly? it's giving "receipts from ACPI" and i'm obsessed.

---

🌸 NAME 🌸

struct ssam_controller_caps — Controller device capabilities. literally what your controller can do, all written down 🎀

---

🦋 SYNOPSIS 🦋

struct ssam_controller_caps {
    u32 ssh_power_profile;
    u32 ssh_buffer_size;
    u32 screen_on_sleep_idle_timeout;
    u32 screen_off_sleep_idle_timeout;
    u32 d3_closes_handle:1;
 };

no cap, that's the whole struct. five fields. count 'em 💅

---

🌈 Members 🌈

okay let's go through the members one by one, don't skip, we do not skip here 🫶

• ssh_power_profile — the SSH power profile. that's it, that's the field. power profile vibes ⚡
• ssh_buffer_size — the SSH driver's UART buffer size. how much room the driver's got to hold stuff 💾
• screen_on_sleep_idle_timeout — the SAM UART screen-on sleep idle timeout. i.e. the timeout for idling while the screen is on ✨
• screen_off_sleep_idle_timeout — the SAM UART screen-off sleep idle timeout. same deal but the screen is off 🌙
• d3_closes_handle — SAM closes the UART handle in D3. yes it's a bitfield (:1), yes that's iconic 💀

---

🧚 Description 🧚

so like, this whole struct is just controller and SSH device capabilities found in ACPI 🌸 that's the entire plot. ACPI tells you what the hardware can do, and this is where you keep the receipts 🔥

---

👑 SEE ALSO 👑

go read these next bestie, they're all right here in the kernel file ./drivers/platform/surface/aggregator/controller.h 💖

• 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(9)
• ssam_controller_receive_buf(9)
• ssam_controller_write_wakeup(9)

---

and that's the whole page, mwah 💋 this came from ./drivers/platform/surface/agg... and it's dated October 2026, filed under struct ssam_controller_caps(9) — periodt, go read a manpage bestie 🎀🦋✨