rzv2h_cpg_get_pll_pars(9)

💅 rzv2h_cpg_get_pll_pars(9) — or, how to find the perfect PLL parameters 💅

okay bestie, so this is a page from the kernel API manual — section 9, obviously — and it's about one function in the clock world. yes, we're being technical and cute at the same time, it's called range 💖

---

✨ NAME ✨

rzv2h_cpg_get_pll_pars — literally finds the best combination of PLL parameters for a given frequency. that's the whole vibe. that's the job. 🎀

---

🦋 SYNOPSIS 🦋

bool rzv2h_cpg_get_pll_pars (const struct rzv2h_pll_limits *limits ,
struct rzv2h_pll_pars *pars , u64 freq_millihz );

like, that's the signature, don't come for me about it, it's exactly like this ✨

---

🌸 ARGUMENTS 🌸

• limits — a pointer to the structure holding all the limits</> for the PLL parameters. this is the rules of the game, bestie. respect them.
• pars — a pointer to the structure where the best calculated PLL parameter values get stored. it's the output seat. the main character of storage. 👑
• freq_millihz — the target output frequency, measured in millihertz. yes, millihertz. that's a lot of hertz, ngl 😭

---

💜 DESCRIPTION 💜

so here's the tea: this function calculates the best set of PLL parameters — and those are M, K, P, S, iconic quadruple, no cap — to hit the desired frequency. 🎯

and the reason it's iterating instead of just doing math is honestly so valid: there's no direct formula to calculate the PLL parameters, because it's an open system of equations. so instead of a one-line glow-up, this function goes the iterative route to determine the best solution. 🧚

and what counts as "best"? a solution that minimizes the error — as in desired frequency - actual frequency. that's the metric, that's the moment, that's the whole point. periodt. 💅

---

🔥 RETURN 🔥

• true — a valid set of parameter values was found. slay. ✅
• false — otherwise, bestie. no valid set. it's giving "try again" 💀

---

🫶 SEE ALSO 🫶

• Kernel file ./drivers/clk/renesas/rzv2h-cpg-lib.c — go read the source, iykyk 📖

---

⭐ friendly reminder that this is the kernel API — the details here are exact and copy-paste-able for a reason. keep the names, keep the types, keep the vibes 🌈

---

and that's a wrap, bestie 🎀 — brought to you by ./drivers/clk/renesas, dated October 2026, and this little manpage is rzv2h_cpg_get_pll_pars(9) signing off. mwah! 💖✨🍓