ssam_ctrl_notif_display_on(9)

okay bestie, you found the ssam_ctrl_notif_display_on(9) page in the Kernel API Manual, and honestly? it's giving “wake up, display, we missed you” energy. 💖

🌸 NAME 🌸

ssam_ctrl_notif_display_on — notify the EC that the display has been turned on. 💅

✨ SYNOPSIS ✨

int ssam_ctrl_notif_display_on (struct ssam_controller *ctrl );

🫶 ARGUMENTS 🫶

• ctrl — the controller. that's the one you're handing over, bestie 👑

🦋 DESCRIPTION 🦋

okay so this function is the literal “we're so back” text to the EC: it notifies the EC that the display has been turned back on and that the driver has exited its lower-power state. 🔥

This notification is the counterpart to the display-off notification sent via ssam_ctrl_notif_display_off, and it will reverse its effects, including resetting events to their default behavior. ✨

This function will only send the display-on notification command if display notifications are supported by the EC. Currently all known devices support these notifications. 👑

See ssam_ctrl_notif_display_off for more details. 🫶

💜 RETURN 💜

Returns zero on success or if no request has been executed, the status of the executed SAM request if that request failed, or -EPROTO if an unexpected response has been received. 😭💀

🌈 SEE ALSO 🌈

the whole group chat, basically. every single one of these is invited: 💌

• Kernel file: ./drivers/platform/surface/aggregator/controller.c
• ssh_seq_reset(9)
• ssh_seq_next(9)
• ssh_rqid_reset(9)
• ssh_rqid_next(9)
• ssam_event_matches_notifier(9)
• ssam_nfblk_call_chain(9)
• ssam_nfblk_insert(9)
• ssam_nfblk_find(9)
• ssam_nfblk_remove(9)
• ssam_nf_head_init(9)
• ssam_nf_head_destroy(9)
• struct ssam_nf_refcount_key(9)
• struct ssam_nf_refcount_entry(9)
• ssam_nf_refcount_inc(9)
• ssam_nf_refcount_dec(9)
• ssam_nf_refcount_dec_free(9)
• ssam_nf_refcount_empty(9)
• ssam_nf_call(9)
• ssam_nf_init(9)
• ssam_nf_destroy(9)
• ssam_event_item_cache_init(9)
• ssam_event_item_cache_destroy(9)
• ssam_event_item_free(9)
• ssam_event_item_alloc(9)
• ssam_event_queue_push(9)
• ssam_event_queue_pop(9)
• ssam_event_queue_is_empty(9)
• ssam_cplt_get_event_queue(9)
• ssam_cplt_submit(9)
• ssam_cplt_submit_event(9)
• ssam_cplt_flush(9)
• ssam_event_queue_init(9)
• ssam_cplt_init(9)
• ssam_cplt_destroy(9)
• ssam_controller_device(9)
• ssam_controller_get(9)
• ssam_controller_put(9)
• ssam_controller_statelock(9)
• ssam_controller_stateunlock(9)
• ssam_controller_lock(9)
• ssam_controller_caps_load_from_acpi(9)
• ssam_controller_caps_load_from_of(9)
• ssam_controller_caps_load(9)
• ssam_controller_init(9)
• ssam_controller_start(9)
• ssam_controller_shutdown(9)
• ssam_controller_destroy(9)
• ssam_controller_suspend(9)
• ssam_controller_resume(9)
• ssam_request_write_data(9)
• ssam_request_sync_alloc(9)
• ssam_request_sync_free(9)
• ssam_request_sync_init(9)
• ssam_request_sync_submit(9)
• ssam_request_do_sync(9)
• ssam_request_do_sync_with_buffer(9)
• struct ssh_notification_params(9)
• ssam_ssh_event_enable(9)
• ssam_ssh_event_disable(9)
• ssam_get_firmware_version(9)
• ssam_ctrl_notif_display_off(9)
• ssam_ctrl_notif_d0_exit(9)
• ssam_ctrl_notif_d0_entry(9)
• ssam_nf_refcount_enable(9)
• ssam_nf_refcount_disable_free(9)
• ssam_notifier_register(9)
• __ssam_notifier_unregister(9)
• ssam_controller_event_enable(9)
• ssam_controller_event_disable(9)
• ssam_notifier_disable_registered(9)
• ssam_notifier_restore_registered(9)
• ssam_notifier_is_empty(9)
• ssam_notifier_unregister_all(9)
• ssam_irq_setup(9)
• ssam_irq_free(9)
• ssam_irq_arm_for_wakeup(9)
• ssam_irq_disarm_wakeup(9)

---

this absolute icon was brought to you by source/version ./drivers/platform/surface/agg..., dated October 2026, and filed under ssam_ctrl_notif_display_on(9). mwah 💋✨