ENUM SSAM_CONTROLLER_STATE(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

✨ enum ssam_controller_state(9) ✨

okay so bestie, welcome to the Kernel API Manual page for enum ssam_controller_state β€” yes it's a 9, yes it's kernel-internal, and yes we're gonna read it together πŸ’…


πŸŽ€ NAME πŸŽ€

enum ssam_controller_state β€” the state values for &struct ssam_controller, aka the little mood ring that tells you what your Surface controller is going through πŸ¦‹


🌸 SYNOPSIS 🌸

enum ssam_controller_state {
    SSAM_CONTROLLER_UNINITIALIZED ,
    SSAM_CONTROLLER_INITIALIZED ,
    SSAM_CONTROLLER_STARTED ,
    SSAM_CONTROLLER_STOPPED ,
    SSAM_CONTROLLER_SUSPENDED

};

that's the whole enum, and it ate, no cap πŸ”₯ five states, that's it, that's the roster πŸ‘‘


πŸ’– Constants πŸ’–

okay so every single one of these is a possible vibe, let's go state by state:

  • SSAM_CONTROLLER_UNINITIALIZED β€” the controller hasn't been initialized yet, or it's already been deinitialized. so basically: not awake, or back to sleep. it's giving "no thoughts, head empty" 😭
  • SSAM_CONTROLLER_INITIALIZED β€” the controller is initialized, but it hasn't been started yet. like it's dressed and ready but still sitting on the bed, lowkey 🫢
  • SSAM_CONTROLLER_STARTED β€” it's been started and is ready to use. main character energy, fully online, slay ⭐
  • SSAM_CONTROLLER_STOPPED β€” the controller has been stopped. periodt, it's done for now πŸ’€
  • SSAM_CONTROLLER_SUSPENDED β€” the controller has been suspended. nap era, do not disturb πŸ™ˆ

πŸ¦‹ SEE ALSO πŸ¦‹

the whole friend group, go say hi πŸ’œ:

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

okay that's the page, bestie 🌈 and for the cute little sign-off: this one came from the source ./drivers/platform/surface/agg... and it's dated October 2026, so yeah, straight from the future, iconic πŸ§šπŸ’–πŸ’…

πŸ“¦ where this page comes from