devm_ti_sci_get_by_phandle(9)

💖 devm_ti_sci_get_by_phandle (9) 💖

okay so real talk, this is a page from the Kernel API Manual and it's lowkey one of those little glue functions that makes the whole TI SCI thing work. bestie, let's get into it ✨

---

🌸 NAME 🌸

devm_ti_sci_get_by_phandle — the managed get-handle-but-via-phandle situation 🎀

---

🦋 SYNOPSIS 🦋

const struct ti_sci_handle * devm_ti_sci_get_by_phandle (struct device
*dev , const char *property );

like yes, that's the whole vibe. it hands you back a const struct ti_sci_handle * and it takes two args, no cap 💅

---

🌈 ARGUMENTS 🌈

• dev — the device pointer that's out here requesting the TISCI handle 🫶
• property — the property name that's holding the phandle on the TISCI node, iykyk

---

⭐ NOTE ⭐

okay this part is important, do NOT skip it 🙈

this one releases the handle once the device resources are no longer needed. and listen — it MUST NOT be released with ti_sci_put_handle. like, don't do it. that's not the move. 💀

also the function does not track individual clients of the framework, and it's expected to be maintained by the caller of the TI SCI protocol library. so yeah, that's on you, bestie. 👑

---

🔥 RETURN 🔥

0 if all went fine — else the corresponding error. that's it, that's the whole story 😭

---

💜 SEE ALSO 💜

the Kernel file ./drivers/firmware/ti_sci.c, plus honestly the entire friend group:

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_cmd_prepare_sleep(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), 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)

---

and that's the page!! 🧚 go forth and phandle responsibly 💖

this lil gem lives in ./drivers/firmware, dated October 2026, and yes it's still rocking the devm_ti_sci_get_by_phandle(9) name. periodt. 🍓👑