devm_v4l2_s...k_get_legacy(9)

💅 devm_v4l2_sensor_clk_get_legacy — like, the whole manual, but make it make sense

okay so this is a page from the Kernel API Manual, and honestly? the vibe is legacy driver energy. bestie, this one's a look back, not a look forward — i'll explain 🌸

---

✨ NAME ✨

devm_v4l2_sensor_clk_get_legacy — lookup and obtain a reference to a clock producer for a camera sensor. that's it, that's the whole job 🎀

---

🦋 SYNOPSIS 🦋

struct clk * devm_v4l2_sensor_clk_get_legacy (struct device *dev , const
char *id , bool fixed_rate , unsigned long clk_rate );

literally the whole signature, character for character, no notes 👑

---

🌸 ARGUMENTS 🌸

• dev — device for v4l2 sensor clock "consumer". yeah the quotes are in the original, she's being ✨quoted✨
• id — clock consumer ID. the name it goes by, iykyk
• fixed_rate — interpret the clk_rate as a fixed rate or default rate. so it's giving "which meaning of clk_rate are we using today" 🤔
• clk_rate — the clock rate. the number. the frequency. her 💅

---

💖 DESCRIPTION 💖

so this function behaves the same way as devm_v4l2_sensor_clk_get — same energy, same everything — except that it extends the behaviour on ACPI platforms to all platforms. no cap, that's the whole flex 🌈

the function also provides the ability to set the clock rate to a fixed frequency by setting fixed_rate to true and specifying the fixed frequency in clk_rate. OR, alternative vibe: use a default clock rate when the "clock-frequency" property is absent by setting fixed_rate to false and specifying the default frequency in clk_rate. pick your fighter 🫶

⚠️ okay this part matters: setting fixed_rate to true and clk_rate to 0 is an error. like, that combo is not it. don't do it 🚫

huge caveat time, and i mean it: this function is meant to support legacy behaviour in existing drivers only. it must not be used in any new driver. periodt. if you're writing something new, this is not your girl 🙈

returns a pointer to a struct clk on success, or an error pointer on failure. classic 🎯

---

👑 SEE ALSO 👑

kernel file ./include/media/v4l2-common.h, plus the whole friend group:

• v4l2_ctrl_query_fill(9)
• enum v4l2_i2c_tuner_type(9)
• v4l2_i2c_new_subdev(9)
• v4l2_i2c_new_subdev_board(9)
• v4l2_i2c_subdev_set_name(9)
• v4l2_i2c_subdev_init(9)
• v4l2_i2c_subdev_addr(9)
• v4l2_i2c_tuner_addrs(9)
• v4l2_i2c_subdev_unregister(9)
• v4l2_spi_new_subdev(9)
• v4l2_spi_subdev_init(9)
• v4l2_spi_subdev_unregister(9)
• v4l_bound_align_image(9)
• v4l2_find_nearest_size_conditional(9)
• v4l2_find_nearest_size(9)
• v4l2_g_parm_cap(9)
• v4l2_s_parm_cap(9)
• enum v4l2_pixel_encoding(9)
• struct v4l2_format_info(9)
• v4l2_get_link_freq(9)
• v4l2_get_active_data_lanes(9)
• v4l2_link_freq_to_bitmap(9)
• devm_v4l2_sensor_clk_get(9)

---

and that's the page!! source is ./include/media, dated October 2026 — mwah, go read the non-legacy one if you're starting something new, ily, bye 🧚💜