ti_sci_cmd_prepare_sleep(9)

💖 NAME 💖

okay bestie, this is the ti_sci_cmd_prepare_sleep(9) page from the Kernel API Manual, and its whole personality is: Prepare system for system suspend 😴💤 no cap, that's the job.

🦋 SYNOPSIS 🦋

the signature is giving “firmware business” and it goes exactly like this:

int ti_sci_cmd_prepare_sleep (const struct ti_sci_handle *handle , u8
mode , u32 ctx_lo , u32 ctx_hi , u32 debug_flags );

✨ ARGUMENTS ✨

• handle — pointer to TI SCI handle 🫶
• mode — Device identifier 👀
• ctx_lo — Low part of address for context save 📥
• ctx_hi — High part of address for context save 📤
• debug_flags — Debug flags to pass to firmware 🐞

💅 RETURN 💅

0 if all went well — slay ✨ otherwise it returns the appropriate error value, and you can go cry about it 😭

🌈 SEE ALSO 🌈

the whole extended fam is here, no cap:

• Kernel file: ./drivers/firmware/ti_sci.c
• struct ti_sci_xfer(9)
• struct ti_sci_xfers_info(9)
• struct ti_sci_desc(9)
• struct ti_sci_irq(9)
• struct ti_sci_info(9)
• ti_sci_debug_show(9)
• ti_sci_debugfs_create(9)
• ti_sci_dump_header_dbg(9)
• ti_sci_rx_callback(9)
• ti_sci_get_one_xfer(9)
• ti_sci_put_one_xfer(9)
• ti_sci_do_xfer(9)
• ti_sci_cmd_get_revision(9)
• ti_sci_is_response_ack(9)
• ti_sci_set_device_state(9)
• ti_sci_get_device_state(9)
• ti_sci_cmd_get_device(9)
• ti_sci_cmd_get_device_exclusive(9)
• ti_sci_cmd_idle_device(9)
• ti_sci_cmd_idle_device_exclusive(9)
• ti_sci_cmd_put_device(9)
• ti_sci_cmd_dev_is_valid(9)
• ti_sci_cmd_dev_get_clcnt(9)
• ti_sci_cmd_dev_is_idle(9)
• ti_sci_cmd_dev_is_stop(9)
• ti_sci_cmd_dev_is_on(9)
• ti_sci_cmd_dev_is_trans(9)
• ti_sci_cmd_set_device_resets(9)
• ti_sci_cmd_get_device_resets(9)
• ti_sci_set_clock_state(9)
• ti_sci_cmd_get_clock_state(9)
• ti_sci_cmd_get_clock(9)
• ti_sci_cmd_idle_clock(9)
• ti_sci_cmd_put_clock(9)
• ti_sci_cmd_clk_is_auto(9)
• ti_sci_cmd_clk_is_on(9)
• ti_sci_cmd_clk_is_off(9)
• ti_sci_cmd_clk_set_parent(9)
• ti_sci_cmd_clk_get_parent(9)
• ti_sci_cmd_clk_get_num_parents(9)
• ti_sci_cmd_clk_get_match_freq(9)
• ti_sci_cmd_clk_set_freq(9)
• ti_sci_cmd_clk_get_freq(9)
• ti_sci_msg_cmd_query_fw_caps(9)
• ti_sci_cmd_set_io_isolation(9)
• ti_sci_msg_cmd_lpm_wake_reason(9)
• ti_sci_cmd_set_device_constraint(9)
• ti_sci_cmd_set_latency_constraint(9)
• ti_sci_cmd_lpm_abort(9)
• ti_sci_get_resource_range(9)
• ti_sci_cmd_get_resource_range(9)
• ti_sci_cmd_get_resource_range_from_shost(9)
• ti_sci_manage_irq(9)
• ti_sci_irq_hash(9)
• ti_sci_irq_equal(9)
• ti_sci_set_irq(9)
• ti_sci_free_irq(9)
• ti_sci_cmd_set_irq(9)
• ti_sci_cmd_set_event_map(9)
• ti_sci_cmd_free_irq(9)
• ti_sci_cmd_free_event_map(9)
• ti_sci_cmd_rm_ring_cfg(9)
• ti_sci_cmd_rm_psil_pair(9)
• ti_sci_cmd_rm_psil_unpair(9)
• ti_sci_cmd_rm_udmap_tx_ch_cfg(9)
• ti_sci_cmd_rm_udmap_rx_ch_cfg(9)
• ti_sci_cmd_rm_udmap_rx_flow_cfg(9)
• ti_sci_cmd_proc_request(9)
• ti_sci_cmd_proc_release(9)
• ti_sci_cmd_proc_handover(9)
• ti_sci_cmd_proc_set_config(9)
• ti_sci_cmd_proc_set_control(9)
• ti_sci_cmd_proc_get_status(9)
• ti_sci_get_handle(9)
• ti_sci_put_handle(9)
• devm_ti_sci_get_handle(9)
• ti_sci_get_by_phandle(9)
• devm_ti_sci_get_by_phandle(9)
• ti_sci_get_free_resource(9)
• ti_sci_release_resource(9)
• ti_sci_get_num_resources(9)
• devm_ti_sci_get_resource_sets(9)
• devm_ti_sci_get_of_resource(9)
• devm_ti_sci_get_resource(9)

that’s the whole vibe 💖 this page lives under ./drivers/firmware, dated October 2026, and it’s still out here as ti_sci_cmd_prepare_sleep(9). go suspend something responsibly bestie 🫶🎀